# CHANGELOG.md 模板

```markdown
# CHANGELOG.md - {项目名称} 开发进度

> 创建时间: {日期}
> 最后更新: {日期}

---

## 当前状态: {状态摘要}

**进度**: {X/Y 任务完成，Z%}

**当前里程碑**: {里程碑名称}

**阻塞问题**: {无 或 描述阻塞}

**下一步行动**: 
1. {下一个具体任务}
2. {再下一个任务}

**Ralph Loop 状态**:
```
迭代: {N}/20
成功标准: {具体标准}
```

---

## 测试状态

| 模块 | 通过 | 失败 | 跳过 | 最后运行 |
|------|------|------|------|----------|
| {模块1} | {N} | {N} | {N} | {日期} |

**快速测试**: ✅ 通过 / ❌ 失败

---

## 完成的任务

### {日期}: {任务名称}

**改动**:
- {改动1}
- {改动2}

**验证**:
- 测试: {测试结果}
- 精度: {如适用}

**提交**: `{commit_hash}`

---

## 进行中的任务

### {任务名称}

**当前进度**: {描述}

**已完成**:
- [x] {子任务}

**待完成**:
- [ ] {子任务}

**阻塞**: {无 或 描述}

---

## 失败的方法

> ⚠️ 重要：记录失败的方法，防止后续会话重复尝试

### {方法名称} - {日期}

**尝试**: {简述尝试了什么}

**结果**: {为什么失败}

**根本原因**: {深入分析}

**教训**: {应该怎么做}

**相关代码/文件**: {路径}

---

## 关键检查点

### 精度表

| 指标 | 目标 | 当前 | 状态 |
|------|------|------|------|
| {指标1} | {目标值} | {当前值} | ✅/❌ |

### 里程碑

| 里程碑 | 目标日期 | 完成日期 | 状态 |
|--------|----------|----------|------|
| {里程碑1} | {日期} | {日期} | ✅ |

---

## 已知限制

1. **{限制标题}**
   - 描述: {详细描述}
   - 影响: {影响范围}
   - 可能的解决方案: {思路}
   - 优先级: 高/中/低

---

## Bug 追踪

### 已修复

| ID | 描述 | 根本原因 | 修复日期 |
|----|------|----------|----------|
| #1 | {描述} | {原因} | {日期} |

### 待修复

| ID | 描述 | 优先级 | 状态 |
|----|------|--------|------|
| #2 | {描述} | 高 | 待开始 |

---

## 会话日志

### Session {N} - {日期}

**时长**: {X小时}

**完成**:
- {完成的任务}

**发现**:
- {发现的问题或洞察}

**下次继续**:
- {下一步}

---

## 版本历史

- {日期}: 项目初始化
- {日期}: {重大更新}
```
