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

745 Commits

Author SHA1 Message Date
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
5612f16425 feat(assets): 封面「从素材库选择」联动 
- AssetPickerModal：素材网格（最新 60 + 搜索）单击回填封面 URL，
  内嵌「上传新图」（复用 upload_image_file，成功即选中，
  失败留在 modal 内提示），上传期间置位 cover_uploading 拦截保存
- CoverUploader 空态加「素材库」入口（与「输入链接」并列）
 2026-07-24 16:32:43 +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
2b048b94a3 fix(utils): sleep_ms 的 cfg guard 对齐 feature 模型，修复 web-only 构建失败
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
sleep_ms 原用 #[cfg(not(target_arch = "wasm32"))] guard tokio::time::sleep，
但 tokio 是 server-only 的 optional 依赖。此 guard 会在「非 wasm32 主机 + 仅
web feature」组合（如 cargo build --no-default-features --features web）下
误激活，此时 tokio 未引入，导致编译失败。

该 bug 长期被 [dev-dependencies] tokio 掩盖——cargo test / 开发构建总能拿到
tokio，只有发布/生产构建（排除 dev-deps）才暴露。符合 AGENTS.md 第 1 条
dual-target gating 标准：触及 server-only 依赖的代码必须用 #[cfg(feature = "server")]
而非 target_arch 区分。

修复：tokio 版本改为 #[cfg(all(feature = "server", not(target_arch = "wasm32")))]，
并为无效构建组合「非 wasm32 且非 server」补一个 panic stub（该组合不是有效部署
目标，web feature 真实构建目标即 wasm32；stub 仅保证符号可编译，运行时不会触发）。

调用点 runner.rs 的 server 占位分支（通过 sleep_ms 继承同一问题）无需改动——
它只在 server target 下编译运行，sleep_ms 修复后其调用自然可编译。
 2026-07-24 10:52:51 +08:00
xfy
5a10b07bff fix(router): 修复错误冒泡触发的 404 页「返回首页」卡死 
PostDetail 对不存在的 slug 抛出 ServerFnError(404) 后，ErrorLayout 的
ErrorBoundary 捕获错误并在 fallback 渲染 NotFound。此时 ErrorBoundary 持有错误，
根据 Dioxus 0.7.9 的渲染逻辑（有错则永远渲染 fallback，不渲染 children/Outlet），
点击 Link 切换路由虽更新了 URL，但页面仍停留在 fallback，表现为「URL 变了页面不变」。

根因：ErrorBoundary 捕获错误后不会自动恢复，必须显式调用 clear_errors() 才能
重新渲染 children。原实现用 Link 导航无法干预点击时机清除错误。

修复：NotFound 与 ErrorLayout 的通用错误 fallback 中，「返回首页」改用 button，
onclick 内先 clear_errors() 清除错误边界，再 navigator().push 导航。
- NotFound 通过 try_consume_context::<ErrorContext>() 获取可能存在的错误边界：
  路由匹配命中的 404 无错误（clear_errors 是 no-op），错误冒泡的 404 才需清除。
- ErrorLayout 的 handle_error 闭包参数本身就是 ErrorContext，clone 后在按钮内使用。
 2026-07-24 10:34:18 +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
67406f661a refactor(middleware): 抽出 ssr_generation/version_headers 中间件到 middleware.rs 
main.rs 的 serve() 闭包内有两个内联 async fn 中间件
（ssr_generation_middleware、version_headers_middleware），与已抽出到
middleware.rs 的 add_cache_control/admin_guard 同类却散落在入口，无法独立测试。

将其移入 middleware.rs 作为 pub(crate) 函数，serve() 闭包改用全路径
crate::middleware::xxx 引用（与现有中间件一致），行为不变。

签名归一：原内联用 axum::http::Request<Body>，迁移后改用
axum::extract::Request（与 add_cache_control/admin_guard 一致；二者是同一
类型的别名，from_fn 接受不变）。

挂载点说明（版本头置于最外层合并 router）留在 main.rs 调用处注释，描述的是
挂载决策而非函数本身。
 2026-07-23 13:56:51 +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
68e290a9fe feat(write): 新建文章默认发布状态改为直接发布 
将 /admin/write 新建模式的默认发布状态从「存为草稿」改为「直接发布」。
编辑模式仍回填文章实际状态，不受影响。
 2026-07-23 10:10:51 +08:00
xfy
52e5ee2736 feat(admin): 代码试运行沙箱加 bun 语言按钮 
SUPPORTED_LANGS 追加 'bun'（仅 canonical key，不展示别名以免按钮拥挤），
default_source 加 bun 分支——示例用 TypeScript 类型注解(:string / :number)
体现 bun 跑 TS 的语言特性。

aliases(js/ts/rs 等)经 normalize_lang 归一即命中此处某项，按钮无需重复。
 2026-07-21 15:24:41 +08:00
xfy
864c813c6d feat(code-runner): 高亮层补 bun 别名、CodeMirror 加 TS 模式 
syntect 高亮别名表(highlight.rs)加 ('bun','ts')：bun 运行器跑的是
TypeScript，归一化后用 ts 扩展名命中 TypeScript.sublime-syntax。

CodeMirror buildLanguageExtension(codemirror-editor/editor.ts)新增
bun/typescript/ts 分支 → javascript({ typescript: true })，让 bun 代码块
在阅读器侧编辑器获得 TS 类型感知高亮。归一化后 CodeRunner 实际只传
canonical key，但保留别名分支作防御（CodeMirror 也在 SQL 控制台等场景用）。

两边都补了测试：highlight_code_resolves_bun_alias_to_typescript 锁定
'bun' 与 'ts' 输出一致；CodeMirror 经 tsc --noEmit + vite build 通过。
 2026-07-21 15:23:47 +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
ccee9131a9 fix(highlight): 编译期内嵌自定义语法，修复线上 Docker 镜像代码高亮缺失 
生产镜像是 FROM scratch 的静态 musl 二进制，运行时不存在 syntaxes/ 目录；
CARGO_MANIFEST_DIR 烘焙的是构建机路径（Docker 内为 /build），运行时
add_from_folder 必然失败，Kotlin/Swift/TypeScript/TSX/JSX/Zig/Vue 七种
语言静默回退为纯文本。

改为 include_str! 编译期嵌入 .sublime-syntax，彻底消除运行时文件依赖；
新增两个守护测试：内嵌列表与 syntaxes/ 目录一致性、自定义语法均已加载。
 2026-07-21 14:10:38 +08:00
xfy
156b51d697 feat(highlight): 文章页代码块支持 Vue SFC 语法高亮
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
阅读侧(syntect)此前对 ```vue 回退纯文本:syntect 默认集无 Vue
语法、syntaxes/ 无定义、别名表无 vue 条目。

官方 Vue Component.sublime-syntax 因 extends: Packages/HTML/...
用 Sublime Text 包路径,syntect 的 add_from_folder 解析不了(实测
panic),无法直接采用。改为自包含实现:

- syntaxes/Vue.sublime-syntax:自包含 Vue SFC 语法。<template>/
  <script>/<style> 三段在 main 入口按标签名分流(syntect context
  切换后无法回看标签名)。script 按 lang 属性经前瞻分流
  ts/tsx→source.ts、其余→source.js;style 统一 embed source.css
  (scss/less 无对应 scope,因 CSS 是超集兼容);template 内 {{ }}
  插值 embed source.js,其余走内置 HTML 语法。
- 关键约束(syntect 5.3 实测):embed 规则必须用纯净 match+embed+
  escape 写法,附加 pop/embed_scope 会破坏 embed 使其静默回退纯文本;
  escape 用 lookahead 不消费闭合标签。

编辑器侧(lowlight@3.3.0)与阅读侧是独立链路。lowlight 依赖的
highlight.js 11 早已移除 vue grammar,common/all 均不含;
highlightjs-vue 包停在 2019 年 1.0.0 且用旧版 hljsDefineVue 全局
API,与 lowlight@3 的 ESM register 不兼容。故编辑器侧用 registerAlias
把 vue 注册为 xml 别名兜底(template 段按 XML 着色,script/style 段
不精确但不抛 Unknown language);读者看到的阅读侧仍是完整高亮。

src/highlight.rs 别名表加 vue 条目(兜底大写 ```Vue 边界),新增 3 个
Vue 高亮单测(SFC 三段 / lang=ts 走 TS / 大小写别名)。
 2026-07-17 11:42:55 +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
3831d1af01 feat(header): 搜索入口改为图标按钮
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
将前台 Header 文本导航中的「搜索」项移除，改在 Header 右侧（主题切换按钮
左边）以放大镜图标 Link 呈现。样式与 ThemeToggle 对齐（圆形 padding、
currentColor 图标），适配明暗主题。

- nav.rs: 导航项列表去掉 Search，更新文档注释
- header.rs: 新增 SearchIconLink 组件（SVG 内联，fill=currentColor）
- frontend_layout.rs: right_content 在 ThemeToggle 前插入 SearchIconLink
 2026-07-17 10:28:39 +08:00
xfy
bdfc7a19e9 feat(mermaid): 流程图主题切换跟随 VT 圆形扩散动画 
此前 mermaid.render() 异步,而 VT 回调同步,Dioxus effect 重跑发生在 VT 回调
之后的微任务,导致动画期间流程图不变、动画结束后才瞬切。

利用 startViewTransition 回调可返回 Promise 的特性(浏览器等其 resolve 才拍
NEW 快照、播动画),让 VT 回调等 mermaid 重渲染完成,新主题流程图进入快照,
圆形扩散覆盖整页含 mermaid 区域。

改动:
- theme-transition.ts: 新增 onThemeChange registry(回调可返回 Promise)。
  notifyThemeChange 遍历 registry 收集 Promise 返回聚合结果;THEME_CHANGE_EVENT
  事件保留(给 codemirror/xterm 同步换肤,向后兼容)。
  startThemeTransition 的 VT 回调改为 async,await notifyThemeChange 聚合 Promise,
  确保异步换肤组件(mermaid)完成后再拍 NEW 快照。
  applyResolvedTheme(跟随系统瞬切)不等 registry,保持瞬切语义。
- mermaid.ts: 顶层注册 onThemeChange 订阅,listener 调 rerenderExistingBlocks 并
  返回其 Promise,供 VT 回调等待。initMermaid/rerenderExistingBlocks 返回 Promise。
- post_content.rs: VT 期间(is-theme-transitioning)跳过 __initMermaid 调用,避免
  Dioxus effect 抢先重渲染穿透伪元素快照(照搬 code_runner/runner.rs 守卫);
  动画结束后 effect 重跑做幂等兜底。
- theme-transition.test.ts: VT callback 签名 void→Promise<void>,新增 registry
  等待测试 + 降级路径不等 registry 测试。
 2026-07-16 16:58:27 +08:00
xfy
6eb7a743e5 fix(mermaid): 主题切换时重渲染已渲染的流程图 
mermaid 把颜色烤进 SVG 内联样式，无法靠 CSS 原地切主题。此前 initMermaid
的幂等守卫一刀切跳过所有已渲染块，导致切主题后流程图停留在首次渲染的主题。

改动：
- initMermaid 改为双路径分发：未渲染块(<code>还在)走 IntersectionObserver
  懒加载；已渲染块(pre 内容已是 SVG)按 dataset.mermaidSource 缓存源码重渲染，
  同主题幂等跳过，主题变化才重渲染。
- 渲染逻辑抽到 renderBlock：用全局自增 renderCounter 生成唯一 id，避开 mermaid
  残留的 d-前缀布局节点冲突(#357)与同页 marker id 冲突(#5741)；替换前清空
  pre.innerHTML 确保亮/暗两版 SVG 不并存。
- source 存进 dataset.mermaidSource 供重渲染回取（此时 <code> 已被 SVG 替换）。

触发机制不变：post_content.rs 的 use_effect 读 use_resolved_theme() 建订阅，
主题切换时重跑重调 __initMermaid 传入新 theme；mermaid.ts 据此决定是否重渲染。
 2026-07-16 16:42:04 +08:00
xfy
45122fc687 fix(post): scrollToHash 增加一次性守卫，切主题不再跳回 URL hash
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
PostContent 的 use_effect 读取 resolved_theme() 建立订阅，主题切换时重跑
（为重跑 mermaid 主题）。但该 effect 同时调用 __scrollToHash，主题切换会
把页面跳回 URL hash 位置——即使该 hash 早已不在用户视野。

scrollToHash 是首屏异步取数后的补救滚动（弥补骨架屏阶段标题 DOM 缺失导致的
原生 fragment-scroll 失效），本质上是一次性的，不应随主题切换重跑。增加
did_scroll 信号守卫，仅首次 effect 运行时调用。
 2026-07-16 16:22:42 +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
78a8d188d1 fix(admin): 重建结果消息改绝对定位,避免撑高容器顶起按钮 
RebuildCacheBar 原用 flex-col 把「已重建 x 篇文章」消息排在按钮下方,
参与文档流。其祖先 header 为 md:items-end(底边固定),消息出现时
新增高度全部转化为按钮上移,「重建内容/重建全部」被顶起、「发布文章」
相对下沉,三者错位。

改为外层 relative + 消息 absolute top-full 脱离文档流:出现/消失都
不影响按钮行高度,布局稳定。双 target 编译通过。
 2026-07-16 14:36:33 +08:00
xfy
70edc5e46c feat(frontend): mermaid 流程图懒加载渲染 
mermaid 无官方 SSR 支持,采用客户端 IntersectionObserver 懒加载:服务端
markdown.rs 只产出普通 <pre><code class="language-mermaid"> 代码块,
前端在块进视口时动态 import 独立 bundle(~1MB)渲染成 SVG。

新增 libs/mermaid-renderer/:mermaid 11.16 IIFE bundle,输出 public/mermaid/
yggdrasil-core/mermaid.ts:扫描 language-mermaid 块,视口可见时动态 import
  /mermaid/mermaid.js(单例缓存),mermaid.initialize 适配 light/dark 主题,
  securityLevel=strict;渲染失败加 .mermaid-error class 保留源码;幂等守卫
post-content.ts:initCopyButtons 跳过 language-mermaid 块(图无需 copy)
post_content.rs:use_effect 调 __initMermaid('.post-content', theme),
  读 use_resolved_theme() 传主题并建立订阅

新增 6 个 mermaid 单测(扫描/主题/幂等/非mermaid/未命中/错误回退)。
550 Rust + 28 前端测试全过,双 target 编译通过。
 2026-07-16 14:22:43 +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
debe7dabe3 fix(test): Docker 集成测试在无 daemon 环境优雅跳过而非失败
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
docker.rs 的 4 个 test_run_in_container_* 此前直接 unwrap Docker 客户端，
在没有 Docker daemon 的环境（如 CI、纯服务端交叉编译检查）会 panic 失败，
拖累整套 cargo test 的退出码——即便这些测试本就无法在那里运行。

加 require_docker() 守卫：socket 缺失（DOCKER_CLIENT == None）或 daemon
无响应（轻量 version() 探测）时返回 None，测试 eprintln + 提前 return。

选动态探测而非 #[ignore]：#[ignore] 会在所有环境一律跳过、需
cargo test --ignored 显式触发；探测守卫让测试在有 Docker 时自动运行，
在无 Docker 的 CI 上静默放行，且在 --nocapture 下可见跳过原因。

验证：cargo test --bin yggdrasil 从 535 passed / 4 failed → 539 passed / 0 failed。
 2026-07-16 13:22:49 +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
d1c41e8fc5 fix(wasm): hooks 模块移出 server gate，双端可见
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
mod hooks 原被 cfg(feature = "server") 包裹，WASM 前端无法引用 hooks 中的
代码。移出后 server 与 WASM 两端均能访问 hooks 模块。

同步修正 backup.rs 的 import 排序（cargo fmt 自动调整）
 2026-07-16 11:37:13 +08:00
xfy
5b6cb7d796 feat(middleware): COMPRESSION_ALGORITHMS 默认值改为 off 
未设置环境变量时不再默认启用全部压缩算法，改为默认关闭。显式设为
"all" 或具体算法组合仍可按需开启。

- src/middleware.rs: fallback 由 "all" 改为 "off"，同步更新文档注释
  与默认值测试（compression_default_env_is_all → _is_off）
- .env.example: 示例值与说明同步更新
 2026-07-16 11:33:14 +08:00
xfy
593c0322bc fix(server): 端口被占用时优雅退出而非 panic 
dioxus::server::serve() 内部对 TcpListener::bind 失败直接
unwrap（dioxus-server 0.7.9 launch.rs:143），端口占用会触发
裸 panic + SIGABRT。在迁移完成后、serve() 前先探测同一地址，
失败走统一的 exit(1) 路径并给出可操作的提示（lsof / PORT）。
 2026-07-16 11:23:45 +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
5b183007a7 perf(server): 用 mimalloc 替换系统全局分配器 
多线程高频小对象分配场景下,mimalloc 吞吐显著优于系统 malloc,且对全静态
musl 链接友好(生产 Docker 镜像即 musl 目标)。选 mimalloc 而非 jemalloc:
本项目生产 server 是全静态 musl 二进制,jemalloc 在 musl 上有 pthread_getname_np
(musl<1.2.3)/unprefixed-malloc 符号冲突的已知坑。

cfg 双门控(与项目双目标编译约定一致):
- feature=server:分配器只服务端二进制需要
- not(wasm32):mimalloc_rust 在 wasm32 上无法编译(Issue #76),前端走默认分配器

mimalloc 声明为 optional + 经 server feature 启用,与 argon2/uuid 等 server-only
依赖同栏位。验证:server native + WASM 双目标编译通过 + clippy 零告警。
musl 目标受本机无 musl-gcc 限制,需 Docker 内构建验证(同 zenwebp 等任何 C 依赖)。
 2026-07-16 10:53:51 +08:00
xfy
c6cb401522 refactor(admin): 拆分 system.rs 为 system/ 目录（按 tab 分文件）
Some checks failed
CI / check (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details 
pages/admin/system.rs 单文件 1792 行装 5 个 tab（数据库状态/服务器状态/SQL控制台/导出/备份恢复），按已有 api/database/ 的对称模式拆成 system/ 目录。

关键前提（已验证）：5 个 tab 状态完全独立、互不共享，切换时父组件用 key 强制卸载，零跨文件状态耦合。

拆分结构（与 api/database/mod.rs 全路径风格对称）:
- system/mod.rs: SystemTab enum + System 入口 + format_bytes(pub(super),3 tab 共用) + tests
- system/db_status.rs: DbStatusTab
- system/server_status.rs: ServerStatusTab + format_uptime(仅它用)
- system/sql_console.rs: SqlConsoleTab(codemirror_bridge 依赖)
- system/export.rs: ExportTab + urlencode(wasm32)
- system/backup.rs: BackupTab + BackupRow + urlencode_dl(自包含,不再跨文件依赖 export.rs)

路由侧零改动: admin/mod.rs 的 pub mod system + pub use system::System 不变(Rust 自动认 system/mod.rs)。双目标编译 + clippy 严格 + dx check + SystemTab 测试全部通过。
 2026-07-15 18:28:39 +08:00