docs: Task8/9 消费方备忘（五键形状/retry展示策略）

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-20 21:43:55 +08:00
parent 57adf8e2a6
commit 17a5c9ec1c
1 changed files with 5 additions and 0 deletions
@@ -403,3 +403,8 @@ class TestBuild:
 - 异常映射：`ImportRateLimited`→429「导入太频繁…」/ `ConcurrentLimit`→409「已有导入任务进行中…」/ `LookupError`→404 / `ValueError`→409（非 generate-failed 态 retry）
 - GET 轮询消费字段：`state`（pending/crawling/generating/done/failed）、`phase`、`pages_fetched`、`draft`、`error`；done 时 draft 为 spec §4 草稿包
 - FetchError 已白话化（评审修复）——API 层无需再翻译
+
+## Task 8/9 消费方备忘（Task 7 评审折入）
+- GET 响应五键：`status`（pending/crawling/generating/done/failed）/`phase`/`pages`/`draft`（仅 done）/`error`——**无 failed_phase**；前端 retry 按钮对 failed 一律展示，后端 409 兜底判形态
+- POST 返回 200（非 201）；retry 形态带 task_id 时忽略 url 字段（前端单形态发送即可）
+- 频控 429 / 并发 409 的 detail 已是白话文案——前端原样展示即可