背景
当前仓库已经完成多轮 contract / runtime / testing 收敛,但随着功能迭代和重构推进,仍可能残留未再被引用的 helper、常量、分支或测试脚手架。此类死代码会带来几个问题:
- 增加阅读和维护负担
- 放大后续重构时的误判成本
- 让 SSOT 边界变得不清晰
- 让测试和文档更难判断哪些行为仍然真实生效
当前评估快照:
- HEAD snapshot:
f3be3fff1b29bfe7989eaf7f64227e5a7610c499
复现 / 现状
- 对全仓执行静态扫描与定义/引用对照。
- 核查是否存在:
- 已无调用方的函数/方法/常量
- 重构后遗留但不再参与 runtime 的 helper
- 测试辅助中不再被任何测试引用的死代码
- 文档或 contract 中已移除语义对应的旧实现残留
预期结果
- 识别并清理全仓安全可删的死代码。
- 不把未来可能使用但当前由动态分发/反射/框架隐式依赖的逻辑误删。
- 保持运行时行为、公开 contract 和测试基线不回归。
验收标准
- 删除一批确认无引用、无运行时用途的死代码。
- 对于疑似但无法静态确认安全删除的代码,给出明确保留理由。
uv run pre-commit run --all-files 通过。
uv run pytest 通过。
背景
当前仓库已经完成多轮 contract / runtime / testing 收敛,但随着功能迭代和重构推进,仍可能残留未再被引用的 helper、常量、分支或测试脚手架。此类死代码会带来几个问题:
当前评估快照:
f3be3fff1b29bfe7989eaf7f64227e5a7610c499复现 / 现状
预期结果
验收标准
uv run pre-commit run --all-files通过。uv run pytest通过。