- migrate labels 接受多个 PATH(与 labels 一致);全仓干跑幂等: lib/ext/cli/examples/public 均为 0,tests 仅剩刻意保留的 classic 样例 1 处 - 审计修正: * html.rs 皮肤"重复声明基础 CSS" —— 实测 312 vs 128 条规则、选择器零重叠,不成立 * debug_page "复刻 shell" —— 仅 head/favicon 约 10 行相似,它没有 nav/topbar,不成立 * HostFn 五表合一标记为已完成(−404 行) - 结论:可机械消除的重复已清完;剩余体量全是特性实现 全仓校验:63 个文件 check 零诊断(label.* 全 0); cargo test --release 609 passed / 0 failed。" && timeout 300 git push origin main 2>&1 | tail -1
104 lines
5.2 KiB
Markdown
104 lines
5.2 KiB
Markdown
# 代码体量审计:53k 行里哪些是特性、哪些是冗余
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **实施记录**(精简依据与进度) |
|
||
| 日期 | 2026-10-22 |
|
||
| 结论 | 冗余已清 ~14.5k 行;**剩余体量主要是特性面**,不是废弃物 |
|
||
|
||
---
|
||
|
||
## 1. 当前账目
|
||
|
||
| 部分 | 行数 | 说明 |
|
||
|------|------|------|
|
||
| `src/` | **52,668** | 其中约 **5,200** 是内联测试(`#[cfg(test)]`) |
|
||
| `plugins/` + `crates/` | **14,700** | 5 个 ABI 插件(含共享 SDK)+ wasm crate |
|
||
| 合计 Rust | **67,368** | |
|
||
|
||
最大的 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 文档执行) |
|
||
| 1,648 | `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~~ | **已完成**:[change-plugin-sdk.md](change-plugin-sdk.md),净减 674 行,注册项 0 差异 |
|
||
| ~~HostFn 五表合一~~ | **已完成**:[change-hostfn-table.md](change-hostfn-table.md),−404 行,203 项逐字节一致 |
|
||
| `view/html.rs` 皮肤"重复声明基础 CSS" | **审计判断不成立**:实测基础样式 312 条规则、notebook 128 条,**选择器零重叠**,无重复可删 |
|
||
| `debug_page.rs` "复刻 shell" | **判断基本不成立**:只在 head/favicon 上有约 10 行相似;它没有 nav/topbar,是独立极简页 |
|
||
| 内联测试迁到 `tests/` | 不减总量,只让 `src` 变薄;不做 |
|
||
|
||
**结论(修正后)**:可机械消除的重复**已经清完**。剩余体量全是特性实现,
|
||
要再压只能砍功能(例如 `view` 调试面板、`formula` 引擎),不是"找重复"。
|
||
|
||
**判断**:这些加起来约 1.3k 行(总量的 2%),收益边际递减;其中插件 SDK 最值得做(消除 5 份漂移),
|
||
其余属于"可以但不必"。
|
||
|
||
---
|
||
|
||
## 5. 与设计的关系
|
||
|
||
精简的目的不是数字好看,而是**不让冗余掩盖设计**:
|
||
|
||
- 已消除的都是**重复实现**(同一逻辑多份 → 必然漂移)
|
||
- 保留的都是**单一实现的特性能耐**
|
||
- 每一条删改都跑全量测试:`605 → 609 passed / 0 failed`,编译零警告
|
||
|
||
如果后续还要压体量,正确的方向是**砍特性**(例如 `view` 的调试面板、`formula` 引擎),
|
||
而不是继续在特性内部找"重复"——那已经找完了。
|