feat(ask-user): 提交前复核与草稿保留

[tt-a1i]

结论

保留 OpenPI 现有 ask_user schema（1–3 题、互斥选项、parent-only）。从 @juicesharp/rpiv-ask-user-question 借鉴 TUI：Submit 汇总未答项、overlay 收起后草稿仍在、RPC 走 host dialog。不做成第二套问卷产品，不安装第二套 ask-user 包。

本轮未安装、未运行该包。Pi 继续拥有 install / update / uninstall。不提议新安装器。

事实

冻结身份（last-seen 2026-09-08）：

包	版本 / 日期	来源
@juicesharp/rpiv-ask-user-question	npm 2.9.0（2026-09-01）	https://www.npmjs.com/package/@juicesharp/rpiv-ask-user-question · https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question

公开 README 声明的 TUI 模式（未在本轮执行）：

• 多问题 tabs；
• Submit tab 汇总答案并标未回答项；
• 自由输入 / Notes 草稿在切换选项后保留；
• RPC / ACP 使用 host dialog；non-interactive 模式直接移除工具。

OpenPI 现状（extensions/ask-user/，对照本 checkout）：

• 已有顺序作答 + 提交前 review screen；review 可重开任一题；
• Esc 关闭整次问卷时，不向模型返回答案（dismissed）；
• ask_user / human_handoff 已在 CHILD_EXCLUDED_TOOL_NAMES（parent-only）。

2026-08-09 审计 P1 已建议：保留名称与 schema，最小改进顺序为 Submit review → 草稿保持 → collapse transcript → RPC degradation。本 Issue 承接该 P1，不改写审计结论。

推断

现有 review screen 已经挡住「未复核就提交」。仍缺的是 juicesharp 级的 未答汇总、dismiss/collapse 后草稿仍在、RPC host dialog。这些是 TUI / host 投影，不是新问卷 schema，也不需要第二套工具名。

「草稿保留」指 overlay 被收起或误关后再打开时，用户已选/已写的内容还在。模型侧 dismiss 仍必须是 dismissed，不能把未提交草稿当成答案。

建议

1. 保持 ask_user 参数与 1–3 / 互斥选项不变；不做 multi-select（会改 schema）。
2. TUI：Submit 汇总未答项；dismiss/collapse 后草稿可恢复。
3. RPC：host dialog；无 UI 时 fail-closed 移除或拒绝工具，不假装已回答。
4. child 分类不变：继续 parent-only。
5. 不引入 @narumitw/pi-tui-kit 依赖，除非 Ask User 与 Plan manager 之后出现第三个相同交互（审计原结论）。

未知

• RPC / Web 投影下 host dialog 与现有 Web ask 流的重叠（[Roadmap] OpenPI Web：像 Codex / Kimi Code 一样的本地浏览器 Agent 工作台 #76 / [Tracking] OpenPI Web UI/UX：体验改进与社区反馈 #455 是 Web 面，本 Issue 先定 TUI + RPC 降级）。
• juicesharp 草稿保留是否跨 tool call，还是仅限同一次 overlay（本轮未运行）。

验收

• TUI 提交前复核：Submit 汇总可见未答项（现有 review screen 可复用，但必须达到「未答可见、不能漏提交」）
• overlay dismiss / collapse 后草稿仍在；模型侧 dismiss 仍不返回答案
• 仍为 parent-only；CHILD_EXCLUDED_TOOL_NAMES 分类不变
• 不引入第二套 ask-user 包或第二套工具名
• 不改 1–3 题 schema，不做 multi-select

关联

• 2026-08-09 审计 P1（Ask User）
• 现有 extensions/ask-user/
• OpenPI 产品哲学：Build for Model Leverage #299 / Capability Shape and Harness Value：什么时候该用 Primitive、Skill、Subagent 或 Workflow？ #314
• setup 闸门缺一档：允许 agent 提议一轮 setup，由用户按键确认 #39（setup 确认闸门；不是本工具）
• 研究记录（本 checkout，未提交）：docs/research/PI_COMMUNITY_PLUGIN_SURVEY_2026-09-08.md

[sowen1023]

我来认领 #499 的 TUI“草稿恢复 + 未答项复核”子范围，请维护者确认并分配给 @sowen1023。

计划：

• 先核对当前 upstream main 的 ask_user 实现，复用已有提交前 review screen，补齐未答项的明确展示与提交校验，不重复建设问卷流程。
• 明确问卷身份、草稿恢复入口和清理生命周期，支持 overlay dismiss/collapse 后恢复已选内容及自由输入；防止旧草稿串到不同问卷或 Session。
• 保持模型侧 dismiss 返回 dismissed，未明确提交的草稿不作为答案返回；Session 切换、关闭及过期边界不推断用户选择。
• 保持现有 1–3 题、互斥选项 schema 和 parent-only 分类，不新增工具名、不引入第二套 ask-user 包。
• 补充状态与 TUI 回归测试、真实交互验证，并运行 bun run check 与 bun run test。

RPC host dialog / Web 适配先不混入首个 PR，需另行核对 Pi 原生入口及与现有 Web 工作的重叠。首个 PR 使用 Refs #499，明确已完成范围及剩余工作，不提前声明整个 Issue 完成。

[tt-a1i]

源码对照实验（2026-09-09，只读 clone，未 pi install、未运行）。记录：本 checkout 的 docs/research/EXPERIMENT_ASK_USER_UX_2026-09-09.md。不替换 08-09 审计 / 09-08 目录调研。

冻结身份：OpenPI a9b40f0；@juicesharp/rpiv-ask-user-question npm 2.9.0 / 59100c7；pi-ask-user 0.15.0 / 705fdc6；pi-interview 0.12.0 / 0b64f4c；官方 examples earendil-works/pi@6160683。

相对本 Issue 正文的缺口修正：当前 ask_user 已经有提交前 review、同一次 UI 内草稿、以及 RPC select/input + review；ask_user / human_handoff 已是 parent-only。仍缺的 TUI 是 overlay collapse 后再打开草稿仍在（现实现是 editor-replacement，不是 overlay）。juicesharp 草稿只活在这一次 overlay session，不是跨 tool call。

保持 1–3 / 互斥 schema。借 TUI：未答可见且 不能漏提交（不要抄 juicesharp 2.9.0 的部分提交）、collapse、RPC 继续走 host dialog。不要装对照包，尤其不要装会撞名的 pi-ask-user。不要把 pi-interview 当产品抄：第二安装器、settings.json 第二配置面、隐式模型调用、预选 recommended、取消/超时当成「按推荐继续」。

@sowen1023 的首 PR 范围（复用 review、collapse 身份、dismiss 不交草稿、RPC/Web 另开）与上述一致；不要提前关整期。