refactor-plan

重构计划

在进行任何代码更改之前制定详细计划。

说明

1. 在准备计划期间不要编辑文件。
2. 搜索代码库以了解当前状态。阅读足够的实现、测试、配置和文档，使计划针对该仓库具体化。
3. 识别受影响的文件、所有权边界、依赖关系以及可能隐藏的耦合。
4. 按安全顺序规划更改。优先考虑契约和类型，然后是实现，接着是调用者，再是测试，最后是清理。
5. 在阶段之间包含验证步骤，以及最终的验证命令。
6. 为风险最高的阶段包含回滚或恢复步骤。
7. 使用以下格式输出完整计划。
8. 在计划后停止并请求确认，然后再实施。如果用户已经要求你实施，仍然先制定计划并等待确认，除非他们明确表示在计划后无需审查即可继续。

如果请求过于模糊而无法安全规划，请提出简洁的澄清问题，而不是编辑文件。

输出格式

## 重构计划：[标题]

### 当前状态
[简要描述当前工作方式]

### 目标状态
[简要描述更改后的工作方式]

### 受影响的文件
| 文件 | 更改类型 | 依赖关系 |
|------|----------|----------|
| 路径 | 修改/创建/删除 | 阻塞 X，被 Y 阻塞 |

### 执行计划

#### 阶段 1：类型和接口
- [ ] 步骤 1.1：[操作] 在 `file.ts` 中
- [ ] 验证：[如何检查是否成功]

#### 阶段 2：实现
- [ ] 步骤 2.1：[操作] 在 `file.ts` 中
- [ ] 验证：[如何检查]

#### 阶段 3：测试
- [ ] 步骤 3.1：更新 `file.test.ts` 中的测试
- [ ] 验证：运行 `npm test`

#### 阶段 4：清理
- [ ] 删除弃用的代码
- [ ] 更新文档

### 回滚计划
如果出现问题：
1. [撤销步骤]
2. [撤销步骤]

### 风险
- [潜在问题及缓解措施]

在计划之后，询问：“我可以开始阶段 1 吗？”