# 进度日志

<!--
  做什么：你的会话日志——按时间顺序记录你做了什么、何时做的、发生了什么。
  为什么：回答"5 问重启测试"中的"我做了什么？"。帮助你在中断后恢复工作。
  何时：完成每个阶段或遇到错误后更新。比 task_plan.md 更详细。
-->

## 会话：[日期]
<!--
  做什么：本次工作会话的日期。
  为什么：帮助追踪工作发生的时间，便于在时间间隔后恢复。
  示例：2026-01-15
-->

### 阶段 1：[标题]
<!--
  做什么：本阶段所采取措施的详细日志。
  为什么：提供已完成工作的上下文，便于恢复或调试。
  何时：在完成该阶段的过程中更新，或至少在完成时更新。
-->
- **状态：**进行中
- **开始时间：**[时间戳]
<!--
  状态：与 task_plan.md 相同（待处理、进行中、已完成）
  时间戳：本阶段的开始时间（例如："2026-01-15 10:00"）
-->
- 已采取措施：
  <!--
    做什么：你执行的具体操作列表。
    示例：
      - 创建 todo.py 基本结构
      - 实现添加功能
      - 修复 FileNotFoundError
  -->
  -
- 已创建/修改的文件：
  <!--
    做什么：你创建或更改了哪些文件。
    为什么：快速参考哪些文件被修改过。有助于调试和审阅。
    示例：
      - todo.py（已创建）
      - todos.json（由应用创建）
      - task_plan.md（已更新）
  -->
  -

### 阶段 2：[标题]
<!--
  做什么：与阶段 1 相同的结构，用于下一阶段。
  为什么：为每个阶段保留单独的日志条目，以清晰追踪进度。
-->
- **状态：**待处理
- 已采取措施：
  -
- 已创建/修改的文件：
  -

## 测试结果
<!--
  做什么：你运行的测试表格，包括预期结果和实际结果。
  为什么：记录功能验证情况。有助于发现回归问题。
  何时：在测试功能时更新，尤其是在阶段 4（测试与验证）期间。
  示例：
    | 添加任务 | python todo.py add "Buy milk" | 任务已添加 | 任务已成功添加 | ✓ |
    | 列出任务 | python todo.py list | 显示所有任务 | 显示所有任务 | ✓ |
-->
| 测试 | 输入 | 预期结果 | 实际结果 | 状态 |
|------|------|----------|----------|------|
|      |      |          |          |      |

## 错误日志
<!--
  做什么：每个遇到的错误的详细日志，包含时间戳和解决尝试。
  为什么：比 task_plan.md 的错误表更详细。有助于从错误中学习。
  何时：错误发生时立即添加，即使很快修复了也要记录。
  示例：
    | 2026-01-15 10:35 | FileNotFoundError | 1 | 添加了文件存在性检查 |
    | 2026-01-15 10:37 | JSONDecodeError | 2 | 添加了空文件处理 |
-->
<!-- 保留所有错误——它们有助于避免重复 -->
| 时间戳 | 错误 | 尝试次数 | 解决方案 |
|--------|------|----------|----------|
|        |      | 1        |          |

## 5 问重启检查
<!--
  做什么：五个问题，用于验证你的上下文是否完整。如果你能回答这些问题，说明工作轨道正确。
  为什么：这就是"重启测试"——如果你能回答全部 5 个问题，就能有效恢复工作。
  何时：定期更新，尤其是在中断后或上下文重置后恢复工作时。

  5 个问题：
  1. 我在哪里？→ task_plan.md 中的当前阶段
  2. 我要去哪里？→ 剩余阶段
  3. 目标是什么？→ task_plan.md 中的目标陈述
  4. 我学到了什么？→ 参见 findings.md
  5. 我做了什么？→ 参见 progress.md（本文件）
-->
<!-- 如果你能回答这些问题，说明上下文是完整的 -->
| 问题 | 答案 |
|------|------|
| 我在哪里？ | 阶段 X |
| 我要去哪里？ | 剩余阶段 |
| 目标是什么？ | [目标陈述] |
| 我学到了什么？ | 参见 findings.md |
| 我做了什么？ | 参见上文 |

---
<!--
  提醒：
  - 完成每个阶段或遇到错误后更新
  - 要详细——这是你的"发生了什么"日志
  - 包含错误的时间戳，以追踪问题发生的时间
-->
*完成每个阶段或遇到错误后更新*