Module friends 

友链 CRUD 与前台列表的 Leptos server function。 友链管理：Leptos server functions。

前台 /friends 读取可见友链（list_friend_links，走 moka 缓存 + SSR 缓存失效， 与文章/标签同架构）；后台 /admin/friends 做完整 CRUD。 鉴权走 cookie session（get_current_admin_user），与其它后台 server-fn 一致。

排序用整数 sort_order（越小越靠前）；删除为物理删除（无回收站/软删除， 友链无审计需求）。

Structs

CreateFriendLink

Serialized arguments for the create_friend_link server function.

DeleteFriendLink

Serialized arguments for the delete_friend_link server function.

ListAllFriendLinks

Serialized arguments for the list_all_friend_links server function.

ListFriendLinks

Serialized arguments for the list_friend_links server function.

UpdateFriendLink

Serialized arguments for the update_friend_link server function.

Functions

create_friend_link

新增友链。仅 admin。

delete_friend_link

删除友链（物理删除）。仅 admin。

invalidate_friend_links_views 🔒

写操作后的统一视图失效：友链 moka 缓存 + /friends SSR 缓存 + 全局世代号。

is_local_asset_url 🔒

是否为安全的本地素材路径：/uploads/ 之后非空，且不含二次 / 开头、..、\0。

list_all_friend_links

后台友链列表（含停用项，按 sort_order 升序）。仅 admin。

list_friend_links

前台友链列表（仅活跃，按 sort_order 升序）。

row_to_friend_link 🔒

把 friend_links 行解析为 FriendLink。

trim_fields 🔒

归一化 name / url / description 的空白（校验通过后调用）。

update_friend_link

更新友链（含启用状态）。仅 admin。

validate_link 🔒

校验友链字段并返回归一化后的头像 URL。