/refactor-clean

重构清理 (Refactor Clean)

安全地识别并移除死代码（Dead Code），每一步都通过测试验证。

第 1 步：检测死代码

根据项目类型运行分析工具：

| 工具 (Tool) | 发现内容 | 命令 (Command) | |------|--------------|---------| | knip | 未使用的导出、文件、依赖 | `npx knip` | | depcheck | 未使用的 npm 依赖 | `npx depcheck` | | ts-prune | 未使用的 TypeScript 导出 | `npx ts-prune` | | vulture | 未使用的 Python 代码 | `vulture src/` | | deadcode | 未使用的 Go 代码 | `deadcode ./...` | | cargo-udeps | 未使用的 Rust 依赖 | `cargo +nightly udeps` |

如果没有可用工具，使用 Grep 查找导入次数为零的导出：

# 查找导出，然后检查它们是否在任何地方被导入

第 2 步：发现结果分类

将发现的结果按安全层级排序：

| 层级 (Tier) | 示例 | 动作 (Action) | |------|----------|--------| | **安全 (SAFE)** | 未使用的工具函数、测试辅助程序、内部函数 | 放心删除 | | **慎重 (CAUTION)** | 组件、API 路由、中间件 | 验证是否存在动态导入或外部使用者 | | **危险 (DANGER)** | 配置文件、入口点、类型定义 | 动之前先调查清楚 |

第 3 步：安全删除循环

对于每个 **安全 (SAFE)** 项目：

1. **运行完整测试套件** — 建立基准（全部通过） 2. **删除死代码** — 使用编辑工具进行手术式移除 3. **重新运行测试套件** — 验证没有引入破坏 4. **如果测试失败** — 立即通过 `git checkout -- <file>` 还原并跳过此项 5. **如果测试通过** — 移至下一项

第 4 步：处理 **慎重 (CAUTION)** 项目

在删除 **慎重 (CAUTION)** 项目之前：

• 搜索动态导入：`import()`、`require()`、`__import__`
• 搜索字符串引用：路由名称、配置中的组件名称
• 检查是否从公共包 API 导出
• 验证没有外部使用者（如果已发布，检查依赖项）

第 5 步：合并重复项

移除死代码后，寻找：

• 近似重复的函数（相似度 >80%） — 合并为一个
• 冗余的类型定义 — 进行统一
• 没有任何价值的包装函数 — 将其内联 (Inline)
• 毫无意义的重新导出 (Re-exports) — 移除间接层

第 6 步：总结

报告结果：

死代码清理 (Dead Code Cleanup)
──────────────────────────────
已删除：   12 个未使用的函数
           3 个未使用文件
           5 个未使用的依赖
已跳过：   2 项（测试失败）
已节省：   移除约 450 行代码
──────────────────────────────
所有测试均已通过 ✅

规则 (Rules)

• **在运行测试之前严禁删除代码**
• **一次只执行一次删除** — 原子化更改使回滚更容易
• **不确定则跳过** — 宁可保留死代码，也不要破坏生产环境
• **清理时不要进行重构** — 关注点分离（先清理，后重构）