前言¶
在 DSH 里用一句「帮我做个插件」或「修一下报错」发出去，模型往往会再追问目标、范围、验收方式；每一轮澄清都占对话 token，答偏了还要返工。常见做法是自己在脑子里补全再写长 prompt，或直接在对话里多轮来回——两种都费事，前者还依赖经验。
任务澄清器（dsh-task-clarifier）把澄清挪到发送任务之前：在客户端用短问答补齐关键维度，右侧实时拼出结构化任务书，再复制或填入新对话执行。澄清过程不调用 Host、不请求模型，页面指标会标明「本页澄清 0 token」。它不负责让模型更聪明，而是尽量让第一次发出的指令就够完整。
这是什么¶
- 名称：dsh-task-clarifier（任务澄清器）
- 维护者：Sun-0306
- 分类：客户端（DSH 本地 bundle，纯 JavaScript，无构建、无第三方依赖）
- 版本 / 许可：0.1.0 · MIT
- 包名 / patch 行 id：
dsh-task-clarifier/task-clarifier - 目录页：skillhub 插件页
- 源码：GitHub · Sun-0306/dsh-task-clarifier
一句话描述需求 → 回答若干自适应问题 → 得到可直接使用的 Markdown 任务书。数据只写入本机浏览器 localStorage，不上传。
核心功能¶
澄清全程在浏览器本地¶
意图分类、事实抽取、选题、任务书组装、token 估算均为确定性规则（正则、权重、固定问题库），无 Host 请求、无模型调用。Host 侧 index.js 的 apply() 为空，不注册路由、不调用模型。
少问：自动识别句中已有信息¶
从原句识别 URL、路径、技术栈、篇幅、读者、风格、禁止项、「当前目录」等；命中的维度写入任务书并跳过对应问题，以 chip 展示在问答页。否定子句不会误当正事实（例如「不要用 Python，改用 Node」只把 Node 记为技术栈，并把「不要用 Python」写入 avoid）。
三种澄清深度¶
| 模式 | 实质问题总上限（含已答） | 说明 |
|---|---|---|
| 快速 | 3 | 目标较清楚、想尽快出发 |
| 标准（默认） | 5 | 多数任务 |
| 深度 | 8 | 一次做对、返工成本高 |
每个意图另有 4–7 道专属问题 + 共享题「最看重哪一点」；问题库共 55 道实质题 + 1 张确认卡。意图分 10 类（如 build、fix、analyze 等），领域用于追加执行约定（如代码类「只改相关文件，不做无关重构」）。
标准版与极简版任务书¶
右侧预览可切换渲染长度，内容同源。标准版按「任务 / 交付物 / 验收标准 / 执行约定」等章节输出，空章节省略；极简版压成「任务：/ 交付：/ …」一行式文本。「信息不足时」可选：按默认做（默认）、先列假设、或停下来问我——会改写任务书里的执行约定文案。
入口与交付对话¶
左侧栏与「插件」「定时任务」同列，标签任务澄清（order: 40）。工作台为左问答、右预览；窄屏上下堆叠。「复制任务书」得 Markdown；「开始执行」把任务书填入新对话 composer 草稿并切到对话页，不会自动发送。缺少工作区 / 布局服务时，「开始执行」退化为复制。
历史与设置¶
进度、最近 24 条任务、澄清深度 / 风格 / 假设策略等存于 localStorage（键名如 dsh-task-clarifier.session.v1、history.v1、settings.v1）。卸载插件不删浏览器站点数据。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议自行查看源码与 MIT 许可证。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
本机 bundle 安装示例（路径需换成你机器上的绝对路径）：
plugin_manager action=install_bundle target=/Users/sunchujun/Desktop/deepseek/dsh-task-clarifier
也可在 Web GUI「插件 → 添加插件」选择本地目录。安装后重启 DSH 并刷新页面，左侧出现「任务澄清」。依赖 DSH Web 客户端的插槽、布局、工作区、侧栏与语言服务（package.json 中 dsh.client.inject 已声明）。
升级：改源码或 package.json、cordis.patch.yml、locale 后需重启 DSH 应用（仅刷新页面不够）。卸载：
plugin_manager action=remove_bundle target=dsh-task-clarifier
然后重启 DSH。
典型用法¶
下面按 README 中的流程操作即可复现。
- 在起始页用一句话描述任务。
Enter开始澄清，Shift+Enter换行；可点示例填入，或「跳过提问，直接整理」只生成任务书。 - 查看顶部「已自动识别」chip，逐题回答；选项可用
1–9或点击，文本题用⌘/Ctrl+Enter提交；不确定可「跳过，你决定」。 - 确认卡「确认一下，我理解得对吗？」核对理解，点「对，生成任务书」；右侧随答实时更新预览，可随时切标准 / 极简。
- 「复制任务书」或「开始执行」；发送仍由你在对话里按 Enter 确认。
问答页可随时「直接生成任务书」（至少答过一题）；完成卡可「继续回答」或「继续补充」备注。
适用场景与注意¶
适合：习惯先写一句模糊需求、希望在进对话前把交付物、范围、验收和执行约定写清楚的人；希望减少「澄清轮次」token、又愿意花几分钟点选问答的人。
注意：
- 澄清只做结构化整理，不做语义理解（见项目 README「已知限制」）；省的是澄清这一段的 token，执行任务的那次对话仍正常消耗 token。
- 指标行的 token、完整度、「预计少问轮数」为启发式估算，不是计费数据。
localStorage禁用或写满时写入可能静默失败；换浏览器或清站点数据后历史不跟随。
开发自测（在插件目录下，路径按本机调整）：
cd /Users/sunchujun/Desktop/deepseek/dsh-task-clarifier
node --test tests/engine.test.mjs tests/review.test.mjs
预期：tests 66 / pass 66 / fail 0。
结尾¶
dsh-task-clarifier 在客户端用固定问题库和规则，把一句话收成可执行的 Markdown 任务书，澄清阶段 0 次模型调用；与 DSH「一切皆插件」的做法一致，作为侧栏工作台接入，不替代对话本身。
- 目录页：https://www.skillhub.cn/plugins/Sun-0306/dsh-task-clarifier
- GitHub：https://github.com/Sun-0306/dsh-task-clarifier
