xfy/yggdrasil
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
1,129 Commits 1 Branch 8 Tags
Commit Graph

284 Commits

Author SHA1 Message Date
xfy
60360f6b49 fix(mcp): reveal/revoke 令牌时将字符串 id 解析为 Uuid 
reveal_mcp_token / revoke_mcp_token 把前端传来的 String id 直接绑到
$1::uuid，tokio-postgres 解析参数类型为 uuid 后拒绝 String，报
'cannot convert between the Rust type String and the Postgres type uuid'
导致 /api/reveal_mcp_token 500。

参照 assets/delete.rs 的做法，绑定前用 uuid::Uuid::parse_str 转换；
解析失败按令牌不存在处理（reveal 返回 None、revoke 静默无操作），
与函数既有的'避免探测'语义一致。
 2026-07-28 14:42:14 +08:00
xfy
9eac025b3e feat(mcp): 完整工具面 + token 管理 + 管理页（T2-T5 并行实现 + 合并） 
T2 token 管理（src/api/mcp_tokens.rs）：create/list/reveal/revoke + get_mcp_client_configs
服务端函数，均经 get_current_admin_user 鉴权；TokenLifetime 枚举（1/7/30/90天/永不过期）。
src/mcp/config.rs 生成 4 种客户端配置（Claude Code/Cursor/Cline/通用 + CLI）。
src/pages/admin/mcp.rs 令牌管理页：列表 + 新建表单 + 一次性明文展示/重查 + 撤销 +
配置片段卡片。路由 /admin/mcp，导航项加入 admin_layout。

T3 read 工具 + Resources（tools/read.rs, resources.rs）：search_posts/get_post/list_tags
（read 作用域，仅已发布）；published-post Resources（post://{slug}，游标分页）。
search_published 提取为共享函数。

T4 write 工具（tools/{posts,comments,tags,media}.rs）：create/update/publish/trash/delete_post、
评论审核、标签 CRUD、媒体 base64 上传（WebP 转码 + 去重）。复用既有 helper 的 SQL 与
缓存失效（moka + ssr_cache）。write 作用域，可读草稿。

T5 admin 工具（tools/{settings,runner}.rs）：get/update_settings、run_code（沙箱执行）。
admin 作用域。

合并（server.rs）：用 rmcp tool_router 的「命名路由 + 组合」模式，7 个工具组在
YggMcpServer 上 impl，combined_router 用 + 合并成单一 ServerHandler。各工具组鉴权
独立，经 Extension<Parts> 读 McpPrincipal + scope.grants 校验。

新增依赖 base64 0.22（媒体上传解码）。验证：server/web 双目标编译通过、clippy
--all-features -D warnings 干净、659 单测 + 1 集成全绿（+20 新测试）。
 2026-07-28 11:53:32 +08:00
xfy
5743c7a581 feat(upload): 上传图片按内容 SHA-256 去重，重复上传复用已登记素材
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
assets 新增 content_hash 列（唯一索引，迁移 016；存量行保持 NULL
不参与去重）。上传在安全性校验后、转码前对原始字节算 SHA-256：
命中即刷新 created_at/updated_at（重启 7 天清理保护窗）并返回
已有 URL，跳过 GIF/WebP 验证、转码与落盘。并发同内容上传由唯一
索引 + INSERT ... ON CONFLICT DO NOTHING 兜底，落败者删落盘文件
复用胜出者路径。命中响应带 reused: true。仅精确去重，视觉相似
检测（pHash）有意不做。
 2026-07-27 13:25:26 +08:00
xfy
775c58a9e6 feat(admin): 素材页支持多选与批量删除 
卡片勾选框：仅未引用素材可选（与单删保护语义一致），hover 显现、
有选择时常显，选中卡片加主题色 ring；stop_propagation 防触发灯箱。
批量条：已选计数 / 全选本页(可切换取消本页) / 清除 / 删除所选
（两步确认），选择跨翻页与筛选保留。

服务端新增 BatchDeleteAssets：一次查询取引用存在性，被引用的跳过，
其余删文件（NotFound 容忍）+ 批量删 DB 行 + 清派生缓存，返回
删除/跳过/释放/失败统计。
 2026-07-27 11:40:02 +08:00
xfy
d610fd5837 feat(admin): 素材页「孤儿」更名为「未引用」 
与「引用中」对仗更自然。覆盖统计行、筛选 tab、清理按钮、
清理结果横幅、卡片徽章及 purge 服务端消息；代码标识符
（orphan_count / purge_orphan_assets 等）保持不变。
 2026-07-27 11:16:59 +08:00
xfy
fa40f4bd95 fix(assets): uuid 参数序列化失败导致上传 500 
tokio-postgres 将 $1::uuid 的参数推断为 uuid 类型，String 无法
序列化（缺类型桥接），INSERT assets 报 error serializing parameter 0，
补偿删文件后返回 500。list/delete/purge/rebuild 的 $1::uuid 与
ANY($1::uuid[]) 全是同一颗未引爆的雷。

正路：tokio-postgres 启用 with-uuid-1，SQL 侧去掉全部 ::uuid cast，
Rust 侧全程 Uuid 类型，仅在 serde DTO 边界（WASM 共享模型）转 String；
外部传入的 id 在边界 parse_str，非法 id 走业务错误而非 500。
 2026-07-24 17:04:35 +08:00
xfy
8f75a64bfd fix(assets): SUM(size_bytes) 显式转 bigint 修复列表 500 
Postgres 的 SUM(bigint) 返回 NUMERIC，tokio-postgres 反序列化为
i64 时类型不匹配，row.get(3) 直接 panic（release 的 panic=abort
下会崩掉整个进程）。COALESCE(..., 0)::bigint 修正。
 2026-07-24 16:50:30 +08:00
xfy
45d70e1dc6 refactor(assets): 清理 lint，对齐项目惯例 
- api/assets/mod.rs 按 posts/comments 惯例加
  #![allow(clippy::unused_unit, deprecated, unused_imports)]
  （#[server] 宏固有噪音）
- 页面交互导入按 target_arch = wasm32 门控；组件级放行非 WASM 未用绑定
- 合并 check_upload_dimensions 进 upload_dimensions（单函数返回尺寸，
  消除死代码），测试同步更名
 2026-07-24 16:44:47 +08:00
xfy
0c47e87d30 feat(assets): 全量重建索引 
- rebuild_assets_index：扫 uploads/（跳过点目录）→ upsert assets
  （xmax=0 判别新增；技术字段 IS DISTINCT FROM 才更新，保留 alt，
  幂等重跑 updated=0）→ 删文件已消失的行 → 全表扫 posts 重建 refs
- 磁盘扫描与 header 尺寸读取移入 spawn_blocking
- extract_asset_paths 提升 pub(crate) 供重建复用同一提取逻辑
- 前端「重建索引」按钮（进行中禁点，结果进横幅）
 2026-07-24 16:27:02 +08:00
xfy
799455da43 feat(assets): 删除保护、孤儿清理与 alt 编辑 
- delete_asset：引用中业务拒绝（Ok(success:false) + 引用文章列表），
  孤儿硬删除（文件 + DB 行级联 refs + 派生缓存）
- purge_orphan_assets：一键清理无引用且超过 7 天保护窗的素材，
  容忍单项文件删除失败，返回数量/释放字节/失败数
- update_asset_alt：管理性 alt 编辑
- invalidate_asset_caches：IMAGE_CACHE 前缀批量失效 + 尺寸缓存失效；
  磁盘派生缓存（哈希命名不可枚举）由既有清理任务回收
- 前端：卡片操作区三态（复制/alt/删除 ↔ alt 编辑 ↔ 确认删除），
  顶栏「清理孤儿」两步确认（带数量与总大小），操作结果横幅
 2026-07-24 16:23:00 +08:00
xfy
99b96e7a0c feat(assets): 素材管理只读列表页 
- list_assets：引用状态筛选 + filename/alt 搜索 + 时间/大小排序 +
  分页（60/页），一次响应带齐 tabs 计数与可清理孤儿统计
- /admin/assets 网格页：?thumb=300x300 缩略图卡片 + 引用徽标，
  单路由客户端分页（对齐管理文章模式），导航加「素材」入口
 2026-07-24 16:15:19 +08:00
xfy
0c811efd4d feat(assets): 素材注册表数据层 
- migration 015：assets 元数据注册表 + asset_refs 引用关联表
- upload_image 落盘后登记 assets（失败补偿删文件）；尺寸校验复用
  upload_dimensions 一次解析同时返回 (w,h)
- sync_asset_refs 镜像 sync_tags：文章 create/update 事务内
  解析 content_html + cover_image 的 /uploads/ 路径重建引用
- Asset/AssetDto/AssetFilter/AssetSort 共享模型，id 以 String 承载
  （SQL 侧 ::uuid cast，避免 uuid crate 进 WASM 构建）
 2026-07-24 16:07:07 +08:00
xfy
690e00e194 refactor(unwrap): 消除非测试代码中的裸 .unwrap()，改为带不变量说明的 .expect() 
panic="abort" 下任何 panic 直接杀进程，与 unwrap 的「稍后处理」语义冲突。
本轮把所有可证不变量的裸 unwrap 改写为带说明的 expect，并修复 time.rs 中
u32→i32 转换在大 ms 值下的潜在溢出 panic（clamp 到 i32::MAX）。

- src/utils/time.rs: sleep_ms 的 ms.try_into().unwrap() 改为 clamp 到
  i32::MAX，避免超大延时值溢出；window/set_timeout 的 expect 补充上下文说明
- src/utils/text.rs: 6 个静态正则的 unwrap 改为 expect，统一说明「编译期校验」
- src/api/{auth,comments/helpers}.rs: EMAIL_REGEX 同上
- src/api/markdown.rs: IMG_RE / TABLE_RE 同上
- src/api/rate_limit.rs: NonZeroU32::new(val.max(1)) 与 Quota::with_period
  补充不变量说明
- src/api/image.rs: HeaderValue::from_str(&etag).unwrap() 改为 expect 说明
  etag 仅含 ASCII hex；复用 etag_value 避免 clone
- src/middleware.rs: 静态 302 重定向响应的 unwrap 改为 expect
- src/components/post/post_content.rs、src/theme.rs: WASM 上下文 window().unwrap()
  改为 expect 说明仅浏览器执行

保留的 unwrap/expect（合理不变量，已在注释中说明）：
- DB_POOL LazyLock 闭包（已有详细注释 + validate_database_url 前置校验）
- csrf.rs 静态 forbidden 响应
- highlight.rs syntect 内置 Plain Text 语法
- bin/generate_highlight_css 构建工具
- comments/* 的 #[cfg(not(server))] unreachable!() WASM stub
 2026-07-23 18:26:19 +08:00
xfy
d1013dfa08 refactor(mhchem): re! 宏编译失败降级为不匹配，补上 panic=abort 缺失的防御
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
re! 宏原先 LazyLock::new(|| Regex::new($pat).unwrap())，在 panic="abort" 下
任何正则转录错误（如曾经的 ". __* " InvalidClass）都会直接杀进程，且 to_tex
的 catch_unwind 在 abort 模式下无法兜住。

引入 compile_or_log(pat) -> Option<Regex>：编译失败记 tracing::error 日志
并返回 None（绝不 panic）。封装为 CompiledPat(Option<Regex>) newtype，把
「坏正则降级为不匹配」的语义集中在一处：

  - captures_head(input) -> Option<Captures>：坏正则/未匹配统一 None
  - is_match(input) -> bool：坏正则/未匹配统一 false

re! 宏改为产出 &CompiledPat，调用方直接 re!("...").captures_head(...) /
.is_match(...)，无需再到处写 re_ref(...)? 或手写 None 回退。状态机遇到
坏模式自然退到 "else" 兜底分支产出原样字符，不影响整体渲染。

适配点：Pat::Re、pat_match_head、match_pattern 的 re_match 闭包、
pat_enumber/state_of_aggregation/amount/formula、1/2 动作、mhchem_tables.rs
的 ce_action、3 个 static LETTERS/GREEK/ONE_GREEK_RE。

回归测试 compile_or_log_degrades_bad_regex_without_panic 断言坏正则返回 None
不 panic。clippy 干净，622 测试全过。
 2026-07-23 18:16:22 +08:00
xfy
a03fbac88c fix(mhchem): 修复 find_observe_end 逐字节扫描多字节字符的 panic 
find_observe_end 用 `let bytes = input.as_bytes(); let mut i = start; while i < len { ...; i += 1; }`
逐字节步进，对每个位置做 `&input[i..]` 切片与 `bytes[i] as char` 花括号判定。
化学公式若含多字节 UTF-8 字符（如中文「浓」占 3 字节），i 会落在字符内部：

  - `&input[i..]` 触发 `byte index N is not a char boundary; it is inside '浓'` panic；
  - 在 panic=abort 下直接 SIGABRT 杀进程；
  - `bytes[i] as char` 把多字节字符首字节误判为花括号，还静默损坏输出。

触发路径：rebuild_content_html 重建含中文化学式（如 \ce{浓H2SO4}）的文章时崩溃。

修复：改用 `input.char_indices().skip_while(...)` 按字符边界步进，i 始终落在
char 边界上，`a` 直接是解出的 char。start 校验对齐到边界后跳过。

新增：
- 回归测试 ce_multibyte_char_in_braces_does_not_panic：覆盖触发输入。
- 保护性测试 ce_arbitrary_multibyte_does_not_panic：穷举 emoji/日韩文/组合字符/
  四字节区，覆盖花括号/方括号/\frac/$...$ 全部走 find_observe_end 的路径。

注：多字节字符的状态机转译输出质量（如 ce("浓H2SO4") 的字符重复）是独立的
既有问题，mhchemParser 本为 ASCII 化学符号设计；本提交只修 panic，不扩大范围。
 2026-07-23 18:00:41 +08:00
xfy
feaf76bcd9 fix(mhchem): 修复 ". __* " 正则转录错误导致的 panic=abort 崩溃 
mhchem 转译器中 ". __* " 模式的 regex 被误抄成
  ^([.\u{22C5}\u{00B7}\u{2022}|[*])\s*
即把 alternation 的 `|` 放进了字符类内部。fancy-regex 把 `[...|[*]`
当作单个畸形字符类，报 ParseError(20, InvalidClass)；`re!` 宏的
`.unwrap()` 因此 panic。

上游 mhchemParser 4.2.2 是 `[...]|[*]`（alternation 在类外），修正为
  ^([.\u{22C5}\u{00B7}\u{2022}]|[*])\s*

触发路径：用户提交含 `\ce{·}`/`\ce{•}`/`\ce{.}` 等化学式的文章 →
render_markdown_enhanced → katex::render_* → expand_chem → mhchem::ce，
首次编译该 LazyLock 正则即 panic。

关键放大因素：本项目 release profile 为 panic="abort"，`to_tex` 内的
`std::panic::catch_unwind` 在此设置下无法捕获 panic，进程直接 SIGABRT。
修正了 `ce`/`pu` 的文档注释，不再谎称"绝不 panic"。

新增：
- 回归测试 ce_dot_bullet_bond_inputs_dont_panic：覆盖触发输入。
- 保护性测试 all_match_patterns_compile：强制编译 match_pattern 全部分支，
  任何同类转录错误在测试期而非生产期暴露。
 2026-07-23 17:49:20 +08:00
xfy
3e9a3aa70d docs(mhchem): 修复模块级文档中的 broken intra-doc links 
cargo doc 在 --document-private-items 下报 7 个 unresolved link 警告，
全部源自 src/api/mhchem.rs 的模块级 //! 文档：

- 公开 API ce/pu 用简写 [`ce`] 无法解析，改用全路径链接
  [`ce`](crate::api::mhchem::ce) / [`pu`](crate::api::mhchem::pu)。
- 私有项 Buffer/Parsed/Field/find_observe_groups/build_transitions 即便
  写全路径也无法被 intra-doc link 解析器识别（rustdoc 对私有项的限制），
  改回普通反引号代码，不再生成链接。这些是模块内部实现细节，本就无需
  跨项跳转。

修复后 make doc 零警告。
 2026-07-23 17:48:06 +08:00
xfy
f2216119ae chore(markdown): 格式化测试中的长字符串字面量
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details
2026-07-23 16:30:31 +08:00
xfy
485d4b1cc4 fix(markdown): 修复移动端表格无法横向滚动 
宽表格在移动端被外层 <main> 的 overflow-hidden 直接裁掉，既看不到也滚不到。
根因是三层叠加：裸 table 无滚动容器、外层裁剪、th 强制 nowrap 加剧超宽。

- markdown.rs: 新增 wrap_tables，给每个 table 套 <div class=table-wrap>
  滚动容器（仿 wrap_images_with_blur 模式，sanitizer 放行 div+class）
- input.css: .table-wrap 设 overflow-x:auto；table 加 min-width:100% 让宽表
  撑开触发滚动；768px 下对旧文章裸 table (.md-content > div > table) 兜底
  block 化，新文章因多一层 div 不受影响、圆角视觉完整
- frontend_layout.rs: main 的 overflow-hidden 改 overflow-x-clip，只裁 x
  且不建滚动容器，让内部 .table-wrap 滚动生效

旧文章经 CSS 兜底立即修复；新文章用渲染器包裹视觉完整。可在 /admin/posts
点 rebuild all 让旧文章也升级到 div 包裹。
 2026-07-23 16:07:11 +08:00
xfy
db74a96de1 style: 格式化 Rust 与 TS 代码 2026-07-23 13:34:27 +08:00
xfy
17d596c512 refactor: 清理死代码与冗余，修复 mhchem 模块的 clippy 阻断 
mhchem 机械移植引入了一个 deny-by-default 的 useless_attribute 硬错误
（mhchem_tables.rs 顶部的 outer #[allow] 挂在 use 语句上），导致
make lint / CI check job 失败。顺带清理同模块的死代码与风格项，以及仓库
内其他确认无引用的死代码。

- mhchem_tables.rs: 删除无效 outer allow、未使用的 `use super::*`、
  pq_action 未用形参 buf→_buf；v.get(0)→v.first()
- mhchem.rs: 删除从未调用的 Field::empty；修正 &*RE→&RE、Default 字段
  重赋值；Parsed/Out 加 large_enum_variant allow（镜像上游结构，
  经 Vec 进堆，非栈热路径）
- codemirror_bridge.rs: 删除 SqlSchema/SqlTable 上过期的 dead_code
  allow——get_db_schema 早已消费这两个类型
- ssr_cache.rs: 删除生产路径从未调用的 invalidate_ssr_home（首页已由
  invalidate_ssr_all_public 覆盖），修正相关注释与测试
- auth.rs: 删除预留给未实现用户管理功能的 invalidate_user_sessions

验证：cargo clippy --all-targets --all-features -- -D warnings 通过；
mhchem/ssr_cache 共 20 项测试通过。
 2026-07-23 13:32:46 +08:00
xfy
6276bab6c6 fix(sanitizer): 允许 KaTeX 渲染所需的 svg 与 path 标签及绘图属性
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
KaTeX 在 SSR 渲染根号(\sqrt)、矩阵竖线/括号(\begin{pmatrix})、大括号、上/下括号、箭头等复杂公式时，通过 <svg> 和 <path> 绘制线条与图标。

原先 HTML 消毒器 (sanitizer) 的标签白名单中未包含 svg / path，导致 lol_html 过滤正文与评论 HTML 时将 <svg> 和 <path> 剥离，致使根号顶线与矩阵括号丢失。

改动：
1. DEFAULT_ALLOWED_TAGS 增加 svg / path 标签放行
2. Sanitizer 属性白名单放行 svg (xmlns, width, height, viewbox, preserveaspectratio, style) 与 path (d) 绘图属性
3. 补充 sanitizer 与 markdown 单元测试防御回归
 2026-07-23 13:27:13 +08:00
xfy
bcd13958ac feat(katex): 移植 mhchem 化学公式转译器(\ce/\pu → LaTeX)
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
katex-rs 默认无 mhchem 解析器,\ce/\pu 化学公式渲染为红字(实测正确页面 648
的 137 个公式中 32 处化学公式坏掉,含 \ce×24 + \pu×8)。

从 mhchemParser 4.2.2(Apache-2.0)机械移植状态机转译器为纯 Rust:
- src/api/mhchem.rs:数据模型 + 模式匹配 + go() 主循环 + texify 输出 + 公开 API
- src/api/mhchem_tables.rs:14 个状态机转移表 + 机器局部动作(ce/pu/...)
- 模式含 lookahead (?=)/(?!),Rust regex crate 不支持,故用 fancy-regex
  (已被 syntect 间接引入,此处显式声明为直接 server 依赖)
- ce/pu 包裹 catch_unwind,任何内部异常回退原样输出,绝不 panic
- katex.rs 新增 expand_chem:渲染前嵌套花括号配对扫描 \ce/\pu 预转译
- 行尾 ^ 气体符号转译为 \uparrow,消解原 mhchem 解析错误
- 8 个 mhchem 单测 + 5 个 katex 集成测试(水/反应箭头/气体箭头/单位/络离子)
 2026-07-23 12:23:53 +08:00
xfy
5e5583fe20 feat(katex): 注册 16 个物理学宏表 
katex-rs 默认 Settings 无物理宏表，\vu \dv \dd \pdv \divg \curl \grad
\qty \RR \ZZ \NN \QQ \CC \bra \ket \braket \expval \abs \norm 渲染为红字
（实测正确页面 648 的 137 个公式中 48 处物理宏坏掉）。

- 新增 physics_macros() 表（MacroDefinition::StaticStr，参数自动推导）
- inline_settings/display_settings 构造后注入物理宏
- 刻意差异：\divg（散度）不复用 \div（除号），两者并存
- 覆写内置 \bra/\ket/\braket 为物理语义版本
- 6 个物理宏单测覆盖数集/微积分/Dirac 记号/向量/范数
 2026-07-23 11:55:38 +08:00
xfy
68ac629f44 fix(sql-console): 写操作后全量失效相关缓存 
SQL 控制台执行 UPDATE/DELETE 等 SQL 直改 DB 时绕过了 server function 的
正常缓存失效路径，导致 moka 单篇缓存（TTL 600s）与 SSR 磁盘缓存继续吐出
陈旧数据（含已删除文章），近 10 分钟的陈旧窗口。

- execute_sql 执行成功后，若含写语句则全量失效文章/搜索/评论缓存 +
  SSR 公开页磁盘缓存 + bump 全局世代号
- cache.rs 新增 invalidate_all_comments（评论列表 + 待审数）
- 抽 writes_affect_cache 纯函数 + 3 个单测覆盖写/只读/混合语句
 2026-07-23 11:49:52 +08:00
xfy
22d226d4e8 feat(code-runner): 添加语言别名归一化与 bun 运行器注册 
新增 normalize_lang 别名表，把读者/作者习惯的语言简写归一到 canonical key:
- js / javascript → node
- rs              → rust
- ts / typescript → bun

归一化在 markdown 渲染期(parse_fence_info)即完成，使 data-lang、
ExecRequest.language、ExecResult.language、LANGUAGES.get 全程只见到
canonical 名(python/node/go/rust/bun)，避免前端用别名调 StartExec 时
查表落空。execute.rs 的 start_exec / start_exec_stream 在 spawn 前显式
normalize_lang，保证 ExecResult.language 回显 canonical。

同时注册 bun 语言(canonical)：镜像 yggdrasil-runner-bun，run_cmd
'bun run /code/main.ts'，默认资源与 node 对齐(256MB/5s)。Dockerfile
与 build-runners.sh 跟进。

测试覆盖三处协同契约：languages.rs 的 normalize_lang 别名表、
execute.rs 的 validate 接受别名、markdown.rs 的 data-lang 归一化。
 2026-07-21 15:21:58 +08:00
xfy
6fee07df1f feat(markdown): 文章页脚注完整支持(语义化 + back-link + 样式) 
切换到 pulldown-cmark 的 GFM 脚注模式(与 GitHub 行为一致),并用自定义
事件渲染器替换默认输出,补齐语义化结构与无障碍属性:

- 解析:Options::all() 同时置 ENABLE_OLD_FOOTNOTES(bit 9|2),使
  has_gfm_footnotes() 返回 false 走 OLD 模式。remove(OLD) 会连
  ENABLE_FOOTNOTES 一起清掉(OLD 位掩码含 bit 2),故 remove 后须
  insert(ENABLE_FOOTNOTES) 单独加回。
- 渲染:事件循环新增 FootnoteReference / Start/End FootnoteDefinition
  三个分支。引用处 <sup class="fn-ref" id="fnref:{label}-{n}"> 带
  role="doc-noteref";定义处 <aside role="doc-footnote"
  aria-labelledby="..."> 取代默认 <div>;End 处按引用次数输出 N 个
  back-link(↩、↩²、↩³…)指向各自引用位置,role="doc-backlink"。
- 编号:按 label 首次出现顺序分配(1,2,3…),与定义位置无关。第一遍
  遍历顺带统计(复用现有两遍遍历模式,零额外扫描成本)。
- id 安全:footnote_id() 保留 label 原文(不转拼音),仅把 ASCII 标点
  /空格转 -,确保 ref↔def 双向一致且不破坏 HTML 属性。

sanitizer:放行 <section> 与 aria-labelledby;修复 is_safe_url 对
含冒号锚点(如 #fn:label)的误判——fragment 内冒号不是 scheme 分隔符,
# 开头的 URL 优先按锚点放行。

input.css:仿 blockquote 视觉语言(左侧边框 + 次级文本色)补脚注样式,
复用 paper 色彩变量,暗色模式自动适配。
 2026-07-17 10:57:40 +08:00
xfy
445b92f407 fix(mermaid): 改用 script 标签加载 IIFE bundle,修正全局变量取值 
根因:mermaid bundle 是 IIFE 格式(与项目其他前端库一致),挂全局变量
而非 ES module export。但 mermaid.ts 错用了 import() 取 .default——
IIFE 无 export,mod.default 是 undefined,导致 mermaid.initialize 调用
TypeError,流程图永远不渲染(数学公式不受影响,因为是服务端渲染)。

修复:
- mermaid.ts: loadMermaidBundle 改用动态注入 <script src=/mermaid/mermaid.js>
  标签,加载后从 window.MermaidRenderer 取(与 codemirror/lightbox 的
  Reflect::get(window,...) 模式一致)
- mermaid-renderer/index.ts: 显式 globalThis.MermaidRenderer = mermaid,
  避免 vite IIFE 把 export default 编译成 .default 多一层
- markdown.rs: mermaid 代码块跳过 syntect 高亮(无语法定义且会包 <span>
  污染 textContent),直接输出转义纯源码

前端 28 测试 + Rust 557 测试 + 双 target 编译通过。
 2026-07-16 15:36:07 +08:00
xfy
438a5e1046 fix(ssr): 文章写入后物理删除 SSR 磁盘缓存,根治'重建后内容不更新' 
Dioxus 0.7 增量渲染器把每路由 SSR 结果落盘到 static/<route>/index/<hash>.html,
只暴露 invalidate_after(ttl) 一个失效手段,无按路由失效的公开 API。
之前 bump_global_generation 在 Dioxus 0.7 不生效(ssr_cache.rs 注释已承认),
导致文章重建/编辑后,即便 DB content_html 已是新内容,SSR 缓存仍返回旧页面,
最长滞后 SSR_CACHE_SECS(默认 3600s)。本次 katex/mermaid 渲染不生效即因此。

修复:在 ssr_cache.rs 新增物理删除缓存的函数:
- invalidate_ssr_route(route): 删 static/<route>/ (含路径穿越防护)
- invalidate_ssr_all_public(): 删 static/ 下除 .well-known/admin 外全部
- invalidate_ssr_home(): 删 static/index/ (细粒度,allow dead_code)

所有写路径(create/update/rebuild/delete/trash)在事务提交后调用:
- 单篇操作失效 /post/{slug} + 全量公开页(列表项变化影响首页/归档/标签)
- 批量操作直接全量失效

世代号保留作 X-SSR-Generation 可观测性,实际失效靠删文件。
顺带修 katex.rs 的 clippy(field_reassign_with_default)+ cmp_owned。

556 Rust 测试 + clippy -D warnings + 双 target 编译通过。
 2026-07-16 15:11:34 +08:00
xfy
84f6223c68 feat(markdown): 评论支持数学公式渲染 
- comments/markdown.rs: 开启 ENABLE_MATH,InlineMath/DisplayMath 事件
  渲染成 katex HTML 注入事件流(评论不用块级 <p> 包裹,保持紧凑)
- sanitizer.rs: 评论路径 span 白名单加 style(KaTeX 内联定位 style 需保留,
  与文章正文 sanitizer.rs:382 对齐)
- 新增 3 个评论公式测试(内联/块级/style 保留)

双 target 编译通过,24 个评论测试 + 36 个 sanitizer 测试全过。
 2026-07-16 14:12:20 +08:00
xfy
95fe9d862d feat(markdown): 文章支持数学公式 SSR 渲染 
render_markdown_enhanced 事件循环新增 InlineMath/DisplayMath 分支:
- $...$ 内联公式调 katex::render_inline 注入 span
- $$...$$ 块级公式用 <p class="math-display"> 包裹 katex 输出
- 标题内公式按内联渲染,不产生块级 <p>

pulldown-cmark 的 Options::all() 已含 ENABLE_MATH,无需改 options。
新增 5 个端到端测试(内联/块级/标题内/坏公式不破坏全文)。
双 target 编译通过,16 个 markdown 测试全过。
 2026-07-16 14:11:05 +08:00
xfy
891a576dc0 feat(deps): 引入 katex-rs 服务端数学公式渲染 
纯 Rust 的 katex-rs 0.2.4 重实现 KaTeX,把 TeX 公式渲染成 HTML span,
供后续 pulldown-cmark 的 InlineMath/DisplayMath 事件调用。

- Cargo.toml: katex-rs 作为 optional dep 经 server feature 启用
- src/api/katex.rs: thread_local 缓存 KatexContext/Settings(因含 RefCell
  宏表非 Sync,不能放全局 static);OutputFormat::Html 避开 MathML 标签
  使 sanitizer 无需开白名单;throw_on_error=false 防坏公式中断全文
- src/api/mod.rs: #[cfg(feature="server")] 注册 katex 模块

双 target 编译通过(server + wasm32),4 个单测通过。
 2026-07-16 14:09:14 +08:00
xfy
fa8b1d9968 test: 补齐安全关键路径的单元测试盲区 
针对前期测试评估发现的高性价比纯函数与安全不变量盲区补测，
共新增 35 个回归测试（全部通过），分布如下：

- infra/docker.rs (+5): 扩展 build_host_config 的隔离断言——cap_drop=ALL、
  security_opt=no-new-privileges、pids_limit=64、memory_swap==memory（禁 swap）、
  tmpfs 的 exec 仅落在 /tmp、ulimits 只保留 nofile（无 nproc）。这些配置若被
  误删会让容器隔离悄悄失效，此前 test_host_config_generation 仅断言 cpu/memory。

- api/code_runner/execute.rs (+8): validate_exec_request 此前零测试。覆盖
  语言白名单（大小写/空白容忍、多 token 拒绝、未注册拒绝）、源码大小边界
  （恰好 max 放行 / max+1 拒绝）、校验顺序（语言优先于大小）。

- api/database/export.rs (+12): is_simple_ident / parse_source 此前零测试。
  覆盖表名白名单（SQL 注入 / 路径穿越 / Unicode 拒绝）、query: 来源的只读
  AST 校验（INSERT/UPDATE/DELETE/DROP/TRUNCATE/CREATE/ALTER/GRANT 全拦截）。

- api/sanitizer.rs (+10): 补 XSS 攻击向量回归——事件处理器属性（onerror/onload/
  onclick + 大小写混淆）、script/style 连内容移除、iframe/object/svg/form 等
  危险标签整体移除、javascript:/vbscript: scheme（含 HTML 实体编码绕过）、
  data URI 在文章正文路径（allow_data_uri=false）的拒绝、svg data URI 风险点锁定。

顺带记录一个既有可维护性问题：docker.rs 的 4 个 test_run_in_container_*
依赖真实 Docker daemon，无 daemon 环境会失败而非跳过，建议后续加 #[ignore]
或 daemon 探测守卫。本次未改动它们。
 2026-07-16 11:55:58 +08:00
xfy
c2263e6bf1 chore(lint): 修复 rust-1.97 clippy useless_borrows_in_formatting 告警
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
新版 clippy 在 format! 参数的冗余 & 上新增 lint(与 mimalloc 改动无关),
移除 export.rs 的 &table_name 以保持 make lint 零告警。
 2026-07-16 10:53:59 +08:00
xfy
5a88531543 refactor(api): 收敛 mod.rs 逐行 allow 为文件级 #![allow] 
api/posts/mod.rs(7处) 与 api/comments/mod.rs(3处) 在 pub use 行上方逐行加 #[allow(unused_imports)],而文件顶部已有 #![allow(clippy::unused_unit, deprecated)]。这些 allow 经核实真实必要(消费侧 server fn 多仅在 WASM 路径,SSR 编译时 unused),故收敛为 #![allow(..., unused_imports)] 等价替代,删掉 10 处逐行 attribute。clippy 严格模式 -D warnings 通过。
 2026-07-15 18:16:49 +08:00
xfy
65a7b1226f style: 全项目格式规范化（cargo fmt）+ Docker daemon 断连容错 
- 全项目 .rs 统一 cargo fmt 排版（换行/缩进/参数分行/导入排序）
- infra/docker: DOCKER_CLIENT 连接失败不 panic，降级返回 None
  （博客不依赖 Docker，panic=abort 下会导致整个进程崩溃）
- infra/mod: 去除多余空行
- database/mod: 模块声明按字母序重新排序
 2026-07-15 17:22:06 +08:00
xfy
acfdfb03f5 fix(image): 为 ImageFmt 别名补上 #[cfg(feature = "server")] 门控 
type ImageFmt = image::ImageFormat 未加 server feature 门控，
而 image crate 是 server-only 可选依赖。WASM 构建 (web feature)
解析到该别名时找不到 image crate，报 E0433。

detect_format (唯一使用方) 已有 #[cfg(feature = "server")]，
测试也在 #[cfg(all(test, feature = "server"))] 下，别名只需对齐门控。
 2026-07-15 13:30:38 +08:00
xfy
8efd8c8021 perf(image): cache_key 单次拼接 + detect_format 零分配后缀匹配
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
cache_key：旧实现 vec![path.to_string()] + 最多 6 个 format! + join，
最坏 9 次堆分配（path clone + 6 个参数 String + Vec 指针数组 + join String）。
改用 with_capacity + write! 直写，1 次分配。每次未命中缓存的图片请求都走。

detect_format：旧实现对整条路径 to_lowercase() 分配 String，只为查后缀。
改用 rsplit('.').next() 取后缀 + eq_ignore_ascii_case 零分配匹配。
每次图片请求调用 1-2 次。

注：rotate 在 resize 之前是刻意设计（让 w/h 作用于旋转后的最终方向），
不动以保持 URL 语义与缓存一致性。
 2026-07-15 11:48:59 +08:00
xfy
b269fcf205 perf(posts): list/search 零 capacity Vec 改 collect 预分配 + helpers retain 
list.rs 5 处、search.rs 1 处用 Vec::new()+循环 push，初始 capacity 为 0，
循环触发多次指数 realloc。rows.iter().map().collect() 用 slice 迭代器的
精确 size_hint 一次性预分配。首页/列表/搜索/标签分页路径。

helpers.rs row_to_post_list_item / row_to_post_full：tags 从
into_iter().filter().collect() 改 retain 原地过滤。unwrap_or_default()
已返回 owned Vec，旧写法重建第二个 Vec。每行文章记录省一次 Vec 分配。

顺带修 slugify 一个 dead store（prev_dash=false 后被 true 无条件覆盖）。
 2026-07-15 11:46:56 +08:00
xfy
a41a1d3ae1 perf(markdown): 消除双解析 + format! 改 write! 直写 
双解析：旧实现对同一份 md 调两次 Parser::new_ext（一遍收集标题、
一遍生成 HTML），等于两倍的 tokenize + 解析 CPU。现 collect 成
Vec<Event> 一次，两遍遍历复用（Event 内含 CowStr 借用 md 切片，
collect 后仍可重复借用）。解析 CPU 减半。

format! → write!：标题开始/结束、TOC li、runnable pre、language class
共 5 处在循环内用 format! 拼接 HTML 片段，每次先分配临时 String 再
push_str 复制进去、临时串立即丢弃。改用 write!(html, ...) 直写目标
String，零中间分配。N 个标题省约 3N 次临时分配。

顺带：html 与 toc_html 用 with_capacity 预分配（旧 String::new 多次 realloc）。

全部 68 个 markdown 测试通过。
 2026-07-15 11:41:55 +08:00
xfy
d4f8b463d2 perf(slug): slugify 单遍状态机重写，分配 4→1 
旧实现 4 次堆分配、3 遍扫描：
1. title.to_lowercase() 分配整串 String（中文/符号根本不受影响却全量拷）
2. split('-').filter().collect::<Vec<&str>>() 分配 Vec
3. parts.join('-') 再分配 String
4. slug.chars().take(100).collect() 截断又分配

新实现用 prev_dash 状态机在单遍内完成：拼音成词、ASCII 小写化、
分隔符合并去首尾、按 char 截断到 100。1 次预分配、1 遍扫描。

与同仓库 markdown.rs::slugify_heading 的单遍写法对齐。
全部 27 个 slug 测试通过（含拼音边界、连续 dash、首尾 dash、下划线保留）。
 2026-07-15 11:38:54 +08:00
xfy
604febde98 perf(upload): 消除 data.to_vec() 多次全文件深拷贝 
data 是引用计数的 Bytes，clone 廉价（原子 +1）。
- validate 路径：data.to_vec() → data.clone()，省一次全文件拷贝
- 转码闭包：original_data = data.to_vec() → data.clone()，
  仅在「保留原格式」回退分支才 to_vec() 出落盘所需 Vec<u8>
- 路径拼接：用 chrono DelayedFormat 内联，省 year/month/day 三个中间 String

5MB 图片上传：转码成功路径从 10MB 堆分配降到 0（仅 Bytes 引用计数）；
回退路径从 10MB 降到 5MB。
 2026-07-15 11:28:21 +08:00
xfy
6837b4cfa2 refactor(image): 合并维度读取函数，共享 image_reader_limits 
提取 read_webp_dimensions / read_image_dimensions 两个核心函数，
read_dimensions_by_mime 与 read_dimensions_from_bytes 各自只负责
格式映射（MIME→format / 扩展名→format），消除 zenwebp 调用与
into_dimensions 逻辑的双份实现。

附带收紧：read_dimensions_from_bytes 原用 with_guessed_format() 猜测
格式，现改为按扩展名显式匹配，避免猜测错误。

image_reader_limits() 改为 pub(crate)，upload.rs 的内联 limits 构造
（4 行逐字重复）改为调用共享函数。
 2026-07-14 15:13:21 +08:00
xfy
fade4e180f refactor: 删除死代码 CommentActions 组件 
components/comments/actions.rs (CommentActions) 零引用——评论管理
操作（通过/垃圾/删除）已在 pages/admin/comments.rs 用 BTN_SOLID_*
常量实现，actions.rs 是遗留的重复实现。

原计划将它的内联按钮样式提取为 BTN_PILL_* 常量统一，但确认零引用后
直接删除整个文件更干净。trash_comment re-export 补 allow(unused_imports)
（wasm-only import 在 server 构建触发的已知模式）。
 2026-07-14 15:09:41 +08:00
xfy
804bcfb7b7 refactor(upload): 抽取 upload_error() 消除 15 处 JSON 错误响应样板 
upload.rs 中 14 处 return Err((StatusCode::X, Json(json!({"success":
false, "error": MSG})))) + 1 处 map_err 同款 tuple，全部替换为
upload_error(status, msg) 单行调用。helper 接受 impl Serialize，
兼容 &str / String / 字面量等调用形式。
 2026-07-14 14:53:18 +08:00
xfy
8da678b3b4 refactor(cache): 抽取 invalidate_post_metadata() 封装 4 行失效组合 
文章写操作后总要一起失效 lists/tags/stats/search 四项元数据缓存。
新增 invalidate_post_metadata() 封装这个固定组合，替换 create/delete/
update/trash 中的 8 处重复 4 行序列。

保留定向失效（invalidate_post_by_slug / invalidate_tag_posts_for）
和批量回退路径（invalidate_all_post_caches + invalidate_search_results）
的显式调用——它们是按实际涉及数据细粒度控制的，不应被封装吞掉。
 2026-07-14 14:44:00 +08:00
xfy
22750ef89e refactor(api): 为 Response 类型添加构造器，消除 51 处样板 
CreatePostResponse 新增 err()/ok()/ok_msg() 构造器，消除 posts/
 下 34 处 { success, message, post_id, slug } 字面量构造。

CommentResponse 新增 error()/ok()/created() 构造器，消除 comments/
 下 17 处 { success, message, error_code, comment_id, ... } 字面量构造。

构造器只在 server function body 内调用，WASM 端因 cfg gate 剥离了
调用点，故加 #[cfg_attr(not(feature="server"), allow(dead_code))]。

行为完全不变（505 测试全过），代码量净减约 300 行样板。
 2026-07-14 14:36:56 +08:00
xfy
16caa7dd9e fix(comments): 统一 escape_html，修复代码块单引号未转义 
comments/markdown.rs 的本地 html_escape 只转义 4 个字符（漏单引号），
与规范实现 utils::html::escape_html（5 字符，'→&#x27;）不一致。

删除本地副本，改用 crate::utils::html::escape_html。评论代码块里的
单引号现在会被正确转义，与其他上下文的转义行为统一。
 2026-07-14 14:29:53 +08:00
xfy
b39afbb616 refactor: 删除死代码 (delayed_loading.rs / ui.rs EmptyState / 未用 re-export) 
- 删除 src/hooks/delayed_loading.rs：未在 hooks/mod.rs 注册，已被
  DelayedSkeleton 组件取代（mod.rs 注释已说明）
- 删除 src/components/ui.rs 的 EmptyState：零调用者，所有实际用法
  都走功能更全的 components/empty_state.rs::EmptyState
- 删除 api/posts/mod.rs 末尾的 render_markdown_enhanced / slug 工具
  re-export：调用方均使用完整路径 crate::api::{markdown,slug}::*，
  这两个跨模块短路径无引用
- 删除 api/comments/mod.rs 的 render_comment_markdown re-export：
  调用方用完整路径 crate::api::comments::markdown::render_comment_markdown

保留 auth.rs::invalidate_user_sessions：有完整文档说明的预留基础设施
（角色变更/封禁场景），非遗留垃圾。
 2026-07-14 14:27:31 +08:00
xfy
56f599574f feat(slug): 中文标题自动转拼音生成 URL slug 
文章 URL slug 与 markdown 标题锚点此前会吃掉中文字符：纯中文标题
退化成时间戳，混入 ascii 时只剩 ascii 片段。

引入 pinyin crate（纯 Rust、零依赖，安全交叉编译到 musl/FreeBSD），
slugify 与 slugify_heading 在字符过滤前先尝试 to_pinyin()：
- 汉字 → 无声调拼音，每字成词用 - 分隔（你好 → ni-hao）
- ASCII 字母数字与 -/_ 保留
- 多音字取默认读音，博客场景足够

示例：你好世界 → ni-hao-shi-jie；Rust 入门指南 → rust-ru-men-zhi-nan

is_valid_slug 不变（原本就允许 Unicode），手动输入中文 slug 仍可用。
pinyin 为 server-only optional 依赖，不进 WASM bundle。
 2026-07-13 18:04:35 +08:00