# Aider 多文件重构教程：函数改名与旧入口兼容检查

Aider 多文件重构教程按本页输入、步骤与检查复现。已真实运行 Python 标准库测试、参考补丁与负例拒绝；未执行 Aider 模型会话。

## 1. 下载并复现基线
把 lesson.zip 解压到独立目录，阅读 before/app.py 和 test_app.py。运行前版测试，保存退出码；本任务目标是：在三文件练习中新增清晰函数名，保留旧调用兼容并更新内部导入；核对调用者、测试与 diff 文件集合。
```sh
cd before
python3 -m unittest -v
```

## 2. 在工具中限定上下文
在 Aider 使用 /add app.py consumer.py，/read-only test_app.py README.md；先核对可改文件集合，再要求引入 normalize_sku 并保留 clean 兼容入口。添加文件不代表可以修改只读测试。

## 3. 提交明确任务书
下载 prompt.txt，核对允许修改的文件后提交给 Aider。参考实现只作为对照，先自己完成任务，不把教材补丁冒充工具生成。
```sh
将内部调用更新为 normalize_sku，并保留 clean 作为兼容 wrapper。只允许 app.py、consumer.py 两文件变化；不要修改 tests。检查所有调用入口。
```

## 4. 逐文件查看差异
对照 reference.patch 检查逻辑与公开接口。若工具改动测试以绕过错误，先恢复测试；只看“完成”提示不能确认行为正确。
```sh
git diff -- app.py
```

## 5. 运行目标检查
在自己的修改目录运行同一测试，不用 fixed 的通过结果代替你的结果。金额/日期/字段/边界用例都必须执行；运行日志要保存实际退出码。
```sh
python3 -m unittest -v
```

## 6. 核对参考结果与负例
教材 verify.py 会读取 before/fixed 的真实文件并执行 unittest，然后在临时副本中故意破坏代码，确认测试返回非零。已真实运行 Python 标准库测试、参考补丁与负例拒绝；未执行 Aider 模型会话。
```sh
python3 verify.py
```

## 7. 保存练习结果
记录自己的工具版本、实际修改 diff、测试退出码和仍需人工复核的点。init-git.py 只初始化下载包里的 before 目录，不触碰其他仓库；在确认当前练习文件后运行。
```sh
python3 init-git.py
```