fix: allow page clarification turns without delivery error

2026-07-24 17:37:05 +08:00
parent 54637beffb
commit 412e5f149b
5 changed files with 103 additions and 2 deletions
@@ -50,6 +50,31 @@

 ---

+## 3. 页面需求澄清：禁止误报“未生成 public HTML”
+
+### 症状
+
+- 用户只说「帮我生成一个页面吧」，没有给出主题或内容
+- 助手正常追问页面类型、主题或素材
+- Finish 后却显示红色错误条：「页面任务未生成 public HTML 交付物，不能标记成功」
+
+### 根因与必须保留
+
+`agent-run-gateway.mjs` 的页面交付守卫曾把所有页面意图都视为本轮必须交付 HTML，
+没有区分“信息足够、可执行的页面任务”和“只能先澄清的泛化请求”。
+
+- 必须使用用户消息 `metadata.displayText` 判断请求本身，不能让内部 routing / skill 前缀影响判定
+- 「帮我生成一个页面吧」这类没有主题的泛化请求允许以澄清回复正常结束
+- 「帮我做一个秋夜诗 H5 页面」等已有主题的任务仍须 fail closed：没有本轮 `public/*.html` 就不能标记成功
+- Page Data 任务的交付守卫不受此例外影响
+
+### 守卫
+
+- 单测：`chat-skills.test.mjs`、`agent-run-gateway.test.mjs`
+- 综合验证：`npm run verify:h5-session-patches`
+
+---
+
 ## 发版 / CI 必跑命令

 ```bash