# Cline 代码重构教程：提取重复函数与行为回归

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

## 1. 下载并复现基线
把 lesson.zip 解压到独立目录，阅读 before/app.py 和 test_app.py。运行前版测试，保存退出码；本任务目标是：将会员和普通订单的重复金额逻辑提取为一个 helper，保持现有返回类型、折扣和运费不变。
```sh
cd before
python3 -m unittest -v
```

## 2. 在工具中限定上下文
先记录重构前测试通过，再让 Cline 在 Plan 中列出重复处与新增 helper。切 Act 后只接受 app.py 的结构调整；Compare 检查公开函数签名不变，不要把运费乘折扣。

## 3. 提交明确任务书
下载 prompt.txt，核对允许修改的文件后提交给 Cline。参考实现只作为对照，先自己完成任务，不把教材补丁冒充工具生成。
```sh
提取 _total helper 消除重复计算，保留 guest_total/member_total 对外接口和行为；运费不打折。只改 app.py，不修改 tests。
```

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

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

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

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