Files
marqdo/doc/design/code-volume-audit.md
T
cflmy 69fcdd6227 docs: 代码体量审计 — 53k 行构成、已清 14.5k 冗余、剩余为特性面
把账算清楚,避免行数多=冗余多的误判:
- src 53,072(其中 5,220 是内联测试)+ plugins/crates 15,423
- 最大的 10 个文件逐一标注性质(html.rs 4,451 行里 3,861 是页面皮肤字符串)
- 已清除 14,235 + ~400 行,逐项列提交号
- 顺带修出的 4 个真实缺陷(Access 隐式判别值、escape_js_string 漏 U+2028/2029、
  view 双 handler 路由、HOST id 稀疏无测试守护)
- 剩余可精简项:插件 ABI SDK(~550)、html 皮肤(~250)、debug_page(~120)、
  HostFn 五表(~450),合计约总量 2%,标注风险
- 结论:继续压体量的正确方向是砍特性,而不是在特性内部找重复(已找完)
2026-10-22 15:44:37 +08:00

5.1 KiB
Raw Blame History

代码体量审计:53k 行里哪些是特性、哪些是冗余

状态 实施记录(精简依据与进度)
日期 2026-10-22
结论 冗余已清 ~14.5k 行;剩余体量主要是特性面,不是废弃物

1. 当前账目

部分 行数 说明
src/ 53,072 其中 5,220 是内联测试(#[cfg(test)])
plugins/ + crates/ 15,423 5 个 ABI 插件 + wasm crate
合计 Rust 68,495

最大的 10 个文件:

行数 文件 性质
4,451 src/view/html.rs 3,861 行是 CSS/HTML 字符串(页面皮肤)
2,691 src/parse/mod.rs 解析器主体 + 412 行内联测试
2,194 src/parse/expr.rs 表达式解析 + 465 行内联测试
2,063 src/host/foreign_doc.rs 外部语言内核(python/node 文档执行)
2,052 src/host/dispatch.rs 202 个宿主函数的五张元数据表
1,968 src/host/foreign.rs 外部进程/会话管理
1,925 src/interp.rs 树遍历求值器
1,913 src/view/render.rs 渲染
1,309 src/formula/mod.rs $$…$$ 公式求值
1,168 src/view/annot.rs 注解/映射

2. 已清除的冗余(14.5k 行)

# 项 行数 提交
1 plugins/web-rust-archive/(31 文件,非 workspace 成员、默认不构建、被 Go libweb 取代) 14,235 13012ca
2 as_text × 18 份复制(两种措辞)→ 一个 host::as_text ~100 8b0ea9e
3 catalog.rs 的 4 个助手(与 knowledge::util 逐字相同) ~70 8b0ea9e
4 view 路由 34 臂 → 2 张表(handle / handle_debug) 99 8b0ea9e
5 无调用点死代码 ×5(parse_italic_assign 等) ~50 a14a6e2
6 转义重复:URL 编码器 2 份、escape_js_string 2 份(debug 副本漏 U+2028/2029) ~40 9324032
7 AST 遍历器 3 份 → ast::walk_stmts / ast::stmt_line ~50 deac53d

顺带修出的真实缺陷(不是行数问题,是正确性问题):

缺陷 发现方式
Access 变体只有隐式判别值(重排即错位) 新加的一致性测试
HOST id 空间稀疏——不是 bug,但此前无测试守护 同上(测试先报"不连续",核实后改成"稀疏但可还原")
escape_js_string 的 debug 副本漏转义 U+2028/2029(JS 里是换行符) 对比两份实现
view 路由分布在两个 handler,只改一个会让 debug 路由全 405 改完实测 HTTP

3. 剩余体量为什么不是"冗余"

逐项核过,剩下的都是功能,删掉就是砍特性:

区域 行数 为什么保留
view/ 合计 ~12,000 live server + notebook UI:路由、渲染、注解、调试面板、执行报告;审计确认是 feature-gated 的一等 CLI 面
host/foreign* ~5,100 外部语言内核(python/node 持久会话、快照、中断);qdagent 的沙箱执行依赖
parse/ ~4,900 词法/语法主体 + 内联测试
bytecode/ 1,921 第二后端;72 处测试引用(含双后端一致性)
knowledge/ ~4,000 catalog / EKC / 指纹;marqdo catalog 的输出有 golden 测试
formula/ 1,741 $$…$$ 公式;与 ast::Expr 是不同类型的两套求值器(不可合并)
host/dispatch.rs 2,052 202 个宿主函数的元数据 + 分派;call_host 是 202 个一行臂
view/html.rs 4,451 其中 3,861 是页面皮肤字符串

4. 剩余可精简项(已定位,未做)

项 可删 风险 说明
插件 ABI 前言共享 crate ~450–550 中 5 个插件各抄一份 MarqdoHostApi + statics + host_strdup/set_out/set_err/host_query_json(每插件约 140 行,约 60% 相同);需同步 rebuild .so 并跑 gold
view/html.rs notebook 皮肤重复声明基础 CSS 规则 ~250 中 纯视觉,无测试覆盖,需人工比对浏览器效果
debug_page.rs 复刻 shell 布局(layout_debug / debug_css) ~120 中 与大页面共用 head/topbar/nav,只是配色不同
HostFn 五张表合一(enum/from_u16/from_name/name/params) ~450 中 现已有一致性测试守护漂移,收益主要是行数
内联测试迁到 tests/ 0(不减少总量) 低 只让 src 变薄,总量不变

判断:这些加起来约 1.3k 行(总量的 2%),收益边际递减;其中插件 SDK 最值得做(消除 5 份漂移), 其余属于"可以但不必"。


5. 与设计的关系

精简的目的不是数字好看,而是不让冗余掩盖设计:

  • 已消除的都是重复实现(同一逻辑多份 → 必然漂移)
  • 保留的都是单一实现的特性能耐
  • 每一条删改都跑全量测试:605 → 609 passed / 0 failed,编译零警告

如果后续还要压体量,正确的方向是砍特性(例如 view 的调试面板、formula 引擎), 而不是继续在特性内部找"重复"——那已经找完了。