docs: 补充本地验收和部署说明

2026-07-03 15:33:49 +08:00
parent f8fddf1eb3
commit a8f5eeaff5
3 changed files with 246 additions and 0 deletions
@@ -720,6 +720,23 @@ chore: 整理 Docker 启动与部署配置
 docs: 补充本地验收和部署说明
 ```

+完成记录：
+
+```text
+完成日期：2026-07-03
+相关 commit：docs: 补充本地验收和部署说明
+验证命令：
+- .venv/bin/python -m pytest tests/unit/test_docs.py -q
+- .venv/bin/python -m pytest tests/unit tests/integration -q
+- curl -f http://localhost:8000/health
+验收结论：
+- 新增 docs/UserGuide.md，覆盖启动、创建任务、小规模验收、默认规模验收、报告查看、导出、常见问题和数据库重置。
+- 用户指南明确固定入口 http://localhost:8000，说明不要临时改 8001。
+- 文档说明 API Key 缺失、任务长期 running、评论数量少于上限、报告摘要失败等排查方式。
+- 新增文档测试，防止关键章节被误删。
+遗留问题：无；进入 WO-10 发布候选验收。
+```
+
 ### WO-10 发布候选版本验收

 优先级：P0