7 Commits

Author	SHA1	Message	Date
xfy	d1013dfa08	refactor(mhchem): re! 宏编译失败降级为不匹配，补上 panic=abort 缺失的防御 ... 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	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	bcd13958ac	feat(katex): 移植 mhchem 化学公式转译器(\ce/\pu → LaTeX) ... 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