Module refs 

评论与头像的素材引用登记（写入时锁定并核对素材）。 评论与头像的素材引用登记。

写入评论、用户头像、友链头像时，先在同一事务内锁定并核对引用的素材， 再把引用写进对应的外键引用表；素材删除与孤儿清理只查引用表判定。

Structs

LockedAssets 🔒

一组素材路径在本事务内的锁定结果。

Constants

MISSING_AVATAR_ASSET 🔒

头像 URL 指向未登记或已删除的素材。

MISSING_COMMENT_ASSET 🔒

评论正文引用了未登记或已删除的素材。

Functions

avatar_asset_path 🔒

本地头像 URL（/uploads/<path>）→ 素材相对路径；外链或空返回 None。

insert_comment_refs 🔒

登记新评论引用的素材（须已由 lock_assets_by_path 锁定）。

lock_assets_by_path 🔒

按相对路径锁定素材行，供随后在同一事务内写入引用。

sync_friend_avatar_ref 🔒

友链头像引用改为 asset_id（None 表示无本地头像引用）。

sync_user_avatar_ref 🔒

用户头像引用改为 asset_id（None 表示无本地头像引用）。