Skip to main content

Module helpers

Module helpers 

Source
Expand description

文章模块内部辅助函数。

提供数据库行到 Post 模型的转换、标签同步与标签清洗等工具函数。 仅在 feature = "server" 启用的服务端构建中可用。

Structs§

RenderedFields 🔒
Markdown 渲染 + 度量派生的完整结果。

Statics§

ASSET_PATH_RE 🔒
匹配 HTML/Markdown 中出现的本地上传图片路径,捕获组为相对路径 (如 2026/07/24/153000.<uuid>.webp,不含 /uploads/ 前缀与 query)。 覆盖 blur-img 双层结构的 src 与 data-src。

Functions§

clean_tags 🔒
清洗标签列表:去头尾空白、过滤空字符串并去重(保留原始顺序)。
extract_asset_paths 🔒
从文章 HTML 与封面 URL 中提取全部引用的本地上传图片相对路径(去重)。
fetch_post_tags 🔒
取指定文章的全部标签名(按 post_tags 关联)。R5:此前 9+ 处重复同一条 SQL。
fetch_post_tags_batch 🔒
批量取多篇文章的标签名并集(去重)。用于批量删除/清空回收站的缓存失效。
render_post_fields 🔒
渲染 Markdown 并派生全部度量字段(R4)。
render_post_fields_minimal 🔒
渲染 Markdown 并仅派生重建所需的最小字段(R4)。
row_to_post_full 🔒
将数据库行转换为完整文章详情。
row_to_post_list_item 🔒
将数据库行转换为轻量列表项 DTO。
sync_asset_refs 🔒
在事务中同步文章的素材引用关联(asset_refs)。
sync_tags 🔒
在事务中同步文章的标签关联。