迭代模板 / 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

{
  "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

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 查询并在前端展示。