待决问题面板 Long-Yin-Zi/task-decision

task-decision · 本轮工作 & 待拍板

装上它之后：AI 每轮不再在正文里堆一长串「需要你拍板的问题」，而是把「本轮总结 + 待决问题」收进右侧边栏的一个 tab —— 你一次选完、每题都能写备注、点一下提交，答案自动带着问题标题发回会话，AI 接着干活。

解决的核心痛点：多轮开发里 AI 经常一次抛出 3~5 个决策点，散落在正文里，容易漏答、答错题号；回传时 AI 又容易忘记「q1 到底问的是什么」。

功能

- 右侧独立面板：本轮摘要 + 全部待决问题集中一处，不再淹没在正文里
- 单选 / 多选：按问题类型渲染，勾选框区分圆形（单选）与方形（多选）
- 每题一个常驻备注框：选项都不满意？不选任何选项、只写一句自己的想法也能提交
- 提交前校验：既没选、也没写备注的题会被标红拦住，不会漏答
- 回传带问题标题：q1（问题标题）: 选 b「…」；整题备注：…，AI 拿到就能对上题
- 提交后自动收起侧边栏：把注意力还给 AI 的回复
- 提交后只读回放：已提交的轮次把「选了哪几项、每题备注、整体补充」原样列出来，核对时不用翻聊天记录
- 每题可加附件：图片/文件可以 Ctrl+V 粘贴、或点「添加附件」选；图片内联发出，其他文件走 DSH 自带的上传服务；提交时按题分组，哪道题的附件就跟在哪道题的文字后面
- 可以取消整轮：底栏「取消本轮」（提交占 2/3、取消占 1/3），点两次确认把这一批问题整个划掉，面板变成「已取消」、右侧栏自动收起；AI 下一轮登记新问题时自动恢复
- 防重复提交：同步锁 + 「本轮已提交」双闸，连点/关掉再开都不会重复发送
- 失败可重试：发送失败保留已填内容，一键重试
- 中英双语：文案走 locale 表，跟随 DSH 语言

安装

前置：已安装 DeepSeek Harness (dsh)。

⚠️ 适用面：仅桌面端 DSH 验证过。 作者只用桌面端（内嵌 Web UI 的 DSH）开发与测试；浏览器里单独部署的 dsh web 没有验证过，能不能用目前未知。

从 GitHub 源码安装

profile 名换成你自己的（桌面端一般是 desktop）
dsh plugin --profile desktop add github:Long-Yin-Zi/task-decision

安装完成后重启 DSH（宿主半部在启动时加载）。

关于 package.json 里的 dsh.client.platform = "web"：这是 DSH 客户端加载器的硬性校验（只接受字符串 "web"），桌面端也同样满足；它 不代表本插件「只支持网页端」，也不代表网页端可用。

本插件没有发布到 npm（DSH 插件中心只收能用包名一行安装的包），所以只能走上面的 GitHub 源码安装。

使用

1. 正常对话。每轮结束时 AI 会调用 gate_ask 工具登记摘要与问题。
2. 聊天流里只出现一行卡片：📋 本轮有待拍板项，见右侧面板，同时右侧自动打开「本轮工作 & 待拍板」。
3. 逐题选择；如果选项都不合适，直接在那一题的备注框里写你的想法（此时可不选）。
4. 需要给某道题附截图/文档？在那道题的备注框里 Ctrl+V 粘贴，或点「添加附件」选择。
5. 点「提交拍板」→ 回传自动发回当前会话 → 面板自动收起。
6. 面板被关掉后，点会话页头右侧的「拍板」按钮可重新打开；已提交的轮次不会再让你重复提交。
7. 这一轮的问题不用处理了？点「提交拍板」右边那个「取消本轮」，再点一下「确认取消」就会把整轮划掉、右侧栏自动收起（只影响这个面板，不会往会话里发任何东西）。

截图

面板展开：本轮摘要 + 待拍板问题

右侧边栏里的完整面板：上方是「本轮摘要」，下方是「待拍板问题」逐题卡片。
每题可以选选项、写整题备注、粘贴截图或文件（Ctrl+V / 「添加附件」），底部「提交拍板」固定在底栏，选好后一提交就把结构化回传发回当前会话。

它是怎么工作的

模型每轮结束前调用工具 gate_ask({ summary, questions }) ↓ 聊天流里只显示一行卡片：📋 本轮有待拍板项，见右侧面板 [打开面板] ↓ 页头探针从 tool-result 的 argsRaw 解析出 gate，写入模块 store ↓ 自动打开右侧 tab「本轮工作 & 待拍板」 ↓ 用户选选项 / 写整题备注 → 点「提交拍板」 ↓
ctx.sessions.scope(sessionId).conversation.send("【拍板回传】…")
↓
面板自动收起，AI 继续干活

为什么用工具调用而不是正文标记块

v0.1 用 标记块，但 DSH 的聊天渲染器会把 HTML 注释原样转义显示，聊天流里会出现一大坨 JSON。改成工具调用后：聊天里是标准工具卡片（只显示一行），参数是结构化 JSON，客户端从 argsRaw 解析，不用从正文抠文本。

回传格式

【拍板回传】 q1（学生全流程收尾做哪些）: 选 b「…」、c「…」；整题备注：优先做风险低的 q2（推进节奏）: 选 a「做完一项再汇报」（整体补充：……）

- 保留题号 + 问题标题 + 选项 id：AI 才能既对上「哪道题」，也知道「选了什么」
- 未选项；整题备注：… 表示用户否掉了所有选项、按备注执行

文件结构

| 文件 | 作用 |
| index.js | 宿主半部：注册 gate_ask 工具 + 注入系统提示词规则 |
| client.js | 浏览器半部：解析、页头探针、右侧 tab、面板 UI、提交与回传 |
| cordis.patch.yml | 组合补丁：向 DSH 插件表插入本插件一行 |
| locale/zh.json、locale/en.json | 界面文案 |
| icon.svg | 插件图标 |
| design/ui-spec.md | 面板设计与交互规格（设计文档，可选读） |

权限与外部服务

- 不发起任何网络请求：不访问第三方接口、不上传任何数据
- 不主动读写你的文件：面板本身不扫描磁盘、不碰工作区；只有你亲自粘贴/选中的文件才会由 DSH 自带的 fileUpload 服务保存（图片随消息内联后由宿主规范化存入附件库；普通文件存到 harness 主目录，模型按需读取）
- 外部交互：把「拍板回传」（文字 + 你选定的附件）发回当前会话，走 DSH 自己的发送通道；插件自己不发起网络请求
- 唯一注册的宿主能力：一个工具（gate_ask）与一段系统提示词规则

兼容性

| 项 | 说明 |
| DSH 目标版本 | 在 0.2.1-rc.2（nightly）桌面端验证 |
| 客户端载体 | 仅桌面端验证；浏览器单独部署的 dsh web 未测试，是否可用未知 |
| dsh.client.platform | 必须是 "web"：DSH 客户端加载器的硬性校验，桌面端同样满足（不代表网页端可用） |
| 平台 | Windows / macOS / Linux（纯 JS，无原生依赖） |
| 依赖 | 无第三方运行时依赖（react 由 DSH 宿主提供） |

⚠️ 作者只在桌面端使用和测试；网页端（浏览器里单独跑的 dsh web）未知。在网页端遇到问题，不代表桌面端有问题。

版本

| 版本 | 内容 |
| 0.6.5 | 确认取消后右侧栏自动收起（延迟 250ms 让用户看到“已取消”状态，与提交成功后的行为一致） |
| 0.6.4 | 底栏按钮比例改为「提交拍板 2/3、取消本轮 1/3」 |
| 0.6.3 | 「取消本轮」从底栏角落的小灰字改成跟「提交拍板」并列的按钮（初始五五开），确认文案缩成「确认取消」 |
| 0.6.2 | ① 新增「取消本轮」：两步确认后整轮划掉，面板转「已取消」，角标归零，AI 下一轮自动恢复 ② 滚动性能：面板组件加浅比较 memo（避免宿主重渲染时重建整棵题卡树）、 节点只创建一次、.wg-scroll 加 will-change/contain |
| 0.6.1 | 去掉拖拽入口：DSH 在 document 冒泡阶段接管了拖拽事件，全窗口弹遮罩、松手直接上传到左侧聊天框，题卡拿不到事件；所以只保留 Ctrl+V 粘贴 与 「添加附件」 两种入口，并在「已知边界」里写明 |
| 0.6.0 | ① 插件改名为 task-decision ② 每题支持附件：Ctrl+V 粘贴 / 拖拽 / 点按钮选文件 ③ 图片内联 base64、普通文件走后台上传并引用 receiptId ④ 回传按题分组（先文字后附件），模型能分清哪个附件属于哪道题 ⑤ 已提交后附件一并只读回放 |
| 0.5.0 | ① 提交后只读回放（选项、每题备注、整题备注、整体补充；关掉面板再打开也看得到）② 删掉遗留的 CSS / CSS2 两份死样式，全插件只留一份 ③ 补全中英文字典并真正注册给 locale 服务（英文界面不再回落成中文） |
| 0.4.1 | ① 每题常驻备注框（不选也能提交）② 回传带上问题标题 ③ 提交后自动收起右侧栏 ④ 防重复提交（同步锁 + 本轮已提交闸） |
| 0.4.0 | 按 design/ui-spec.md 重做面板：头/尾固定、只有中间滚动；主按钮反色；勾选框改 CSS 圆/方；题号徽标、进度条、未选校验、错误条 + 重试 |
| 0.3.0 | 发送通道修复（binding.session.prompt 优先、conversation 兜底）+ 页头常驻「拍板」入口 |
| 0.2.0 | 改用工具 gate_ask 登记，聊天流里只显示一行卡片 |
| 0.1.0 | 首版：正文标记块 + 右侧 tab |

已知边界

- 宿主半部（index.js）改动需要重启 DSH 才会重新加载工具与提示词；客户端改动刷新页面即可。
- ctx.sidebarRight 不在客户端服务目录里，自动开 tab 用 ctx.get('sidebarRight') 懒取；拿不到就只注册 tab、不自动弹。
- 收起侧边栏依赖 sidebarRight.actionsFor(sessionId).setExpanded(sessionId,false)（内部面），DSH 升级若改名会退化为"不自动收起"，不影响提交。
- 残留的 v0.1 文本标记块解析仍保留，作为兼容路径。
- 拖拽附件不可用：DSH 自己会在 document 冒泡阶段接管 dragenter/dragover/drop（全窗口遮罩 → 松手进左侧聊天框），题卡收不到事件；要恢复拖拽得先在 window 捕获阶段拦截，本次未做。

许可证

MIT © 2026 tdcy

本项目为社区插件，与 DeepSeek AI 无隶属关系。