From 17a5c9ec1cb4ecb3ed501f51ad0ed73f307fa184 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Tue, 20 Oct 2026 21:43:55 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20Task8/9=20=E6=B6=88=E8=B4=B9=E6=96=B9?= =?UTF-8?q?=E5=A4=87=E5=BF=98=EF=BC=88=E4=BA=94=E9=94=AE=E5=BD=A2=E7=8A=B6?= =?UTF-8?q?/retry=E5=B1=95=E7=A4=BA=E7=AD=96=E7=95=A5=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- docs/superpowers/plans/2026-10-20-site-import.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/superpowers/plans/2026-10-20-site-import.md b/docs/superpowers/plans/2026-10-20-site-import.md index 10472ad..05e949d 100644 --- a/docs/superpowers/plans/2026-10-20-site-import.md +++ b/docs/superpowers/plans/2026-10-20-site-import.md @@ -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 已是白话文案——前端原样展示即可