# 迭代模板 / Iteration Template

本模板用于通过 `POST /api/iterations` 写入一次迭代记录，便于版本审计与发布节奏管理。

---

## 1. 模板字段 / Fields
- `version`：版本号（如 `v1.2.0`）
- `title`：迭代标题（功能名称或里程碑）
- `summary`：迭代摘要（简述新增/修复）
- `docs`：关联文档路径（如 `docs/08-system-architecture.md`）
- `author`：负责人或提交人

服务端会自动生成：
- `id`：迭代 ID
- `created_at`：创建时间（UTC+8，RFC3339）

---

## 2. JSON 示例 / JSON Example
```json
{
  "version": "v1.2.0",
  "title": "知识库自动进化上线",
  "summary": "接入 SearXNG + Qwen3-Max，并完成 GraphRAG 增量索引。",
  "docs": [
    "docs/19-graphrag-searxng.md",
    "docs/20-knowledge-base-architecture.md"
  ],
  "author": "admin"
}
```

---

## 3. 调用示例 / cURL Example
```bash
curl -X POST https://bid.hao.work/docs/api/iterations \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "v1.2.0",
    "title": "知识库自动进化上线",
    "summary": "接入 SearXNG + Qwen3-Max，并完成 GraphRAG 增量索引。",
    "docs": [
      "docs/19-graphrag-searxng.md",
      "docs/20-knowledge-base-architecture.md"
    ],
    "author": "admin"
  }'
```

---

如需展示迭代历史，可使用 `GET /api/iterations` 查询并在前端展示。