5.4 KiB
Agent Note: Ask-question Web 呈现
Status: implemented
English | 中文
问题
Web GUI 已经可以通过 QuestionComposer 的输入区接管收集回答，但其周边的会话记录呈现在三个方面是错的。待回答的问题会渲染两次：一次是输入区接管，一次是早于接管存在的只读 PendingCard 占位卡片。已结算的 ask_user_question 调用渲染为通用 "Tool call" 行并直接倾倒原始 args JSON，因此两种输入区裁决 —— 用户放弃整组问题（ASK_CANCELLED）与问题待回答期间轮次被打断（ASK_ABORTED）—— 都显示为无名的红点失败。而且输入区自身的界面文案（分页、按钮、占位符、校验反馈）是硬编码中文，而周边客户端已通过 dsh-client-locale 实现双语。
另外，输入区视觉也偏离了当前设计：自定义回答需展开才能输入、多选除尾部对勾外没有可见标识、分页挂在头部、还有从模型文本里解析 （可多选） 标题后缀的约定。
决定
一个待回答的问题恰好拥有两个界面：输入区接管收集回答，会话记录中一个专门的 ask_user_question toolview 行陈述交互结果。该行与 todo_write 完全一样注册进带 key 的 conversation.chat.toolview 槽位，并复用共享的 ToolRow（外观、运行扫光、前导展开）。其摘要是交互裁决而非参数：运行中显示 waiting，结算后从结果 JSON 得出 N/M answered（被跳过的回答 —— selected 为空且无 custom —— 不计入），ASK_CANCELLED 显示 cancelled，ASK_ABORTED 显示 interrupted 并沿用共享的琥珀色 stopped 语义。畸形或截断的结果回退到通用摘要。PendingCard 收窄为 PendingWait<'approval'>，ChatView 将待处理列表过滤为仅审批等待，占位卡片从此只服务于仍在路线图上的审批接管。
输入区重设计将分页移到底部操作区旁，多选选项渲染显式复选框，单选保留编号行，并用始终可见的自定义输入行取代展开式自定义入口（无选项问题用多行文本框）。删除 parseQuestionTitle 的多选后缀约定；multi_select 已是结构化元数据，标题原样渲染。
输入区界面文案实现双语：插件在 dsh-client-locale 的 question 命名空间下注册中英词典，并通过槽位 inject face 向条目提供绑定命名空间的翻译器和作为 hooks 舱源的 locale 快照，语言切换时已挂载的输入区会重新渲染。校验反馈以词典 key 存储、切换时重新翻译；载体失败消息与所有模型撰写的问题/选项文本原样渲染。
两个相邻修复随行。所有通用 toolview 前导图标（含悬停箭头）现在统一继承三级标签色 —— 删除了 others 变体的二级色覆盖和独立的箭头颜色规则，只保留有意为之的 cordis 业务主色强调。客户端 dev-watch 打包器用 addWatchFile 注册每个 CSS 模块，因为虚拟模块间接层此前使仅改 CSS 的编辑对 watcher 不可见。
曾考虑的替代方案
继续通过 PendingCard 渲染问题。 否决：该卡片是接管存在之前的只读占位，导致同一内容显示两份且其中一份不可作答。toolview 行加接管同时覆盖了记录与收集两个面。
在会话记录行内联显示问题或回答。 否决：输入区接管拥有问题渲染与回答收集，而行的约定（todo_write）是单行、详情在面板。因此行只报告结果，正如 todo 行报告计数而面板拥有列表。
用通用错误形态渲染 ASK_CANCELLED/ASK_ABORTED。 否决：放弃是用户自己的主动操作，打断是共享的停止手势；两者都是预期结果而非工具失败。命名裁决（且中止保持琥珀色 stopped 语义）与其他被打断的工具调用的呈现一致。
现在就翻译行内裁决文案。 依明确的产品决定推迟：本次改动中行的 waiting/answered/cancelled/interrupted 字符串保持英文；输入区界面文案的国际化落地是因为其仅中文的文案在 en 语言下本就是错的。
保留标题后缀的多选约定。 否决：multi_select 是结构化请求元数据且复选框标识已承载该信号，从模型文本解析 （可多选） 是脆弱的重复通道。
后果
ask_user_question 与 todo_write 现在共同示范预期的 toolview 模式：复用 ToolRow、从调用参数或结果 JSON 做带形状校验回退的摘要、通过带 key 的槽位注册。专用的 todo-row.module.css 已删除。
行内裁决字符串是问题流程仅剩的硬编码英文面；将其本地化是推迟的后续工作。在审批输入区接管交付之前，PendingCard 仍是可见但不可操作的审批占位。
ui-question 新增 dsh-client-locale 依赖和此前没有的 inject face；其契约（QuestionComposerInjected）与消费者一起放在 contract/slots.ts。
验证
ui-conversation 测试钉住行的 waiting/answered/skipped/cancelled/interrupted/回退矩阵、仅审批的待处理过滤和槽位注册；ui-question 测试钉住重设计的输入区（复选框多选、始终可见的自定义行、底部分页、词典 key 反馈重翻译、IME 安全的 Enter）以及插件的词典注册与 inject face；ui-primitives 测试钉住图标集。组装后的 Web GUI 在真实会话中演练了回答、取消与轮次打断路径。