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 已是白话文案——前端原样展示即可