dsh-grill-first

dsh-grill-first

> DSH（DeepSeek Harness）插件：先把模糊任务聊清楚，再确认需求并开工。

[English](./README.en.md) · [配置项](#配置项) · [两层记忆](#两层记忆)

本文描述 V1（1.0.x）。该版本已发布到 [npm](https://www.npmjs.com/package/dsh-grill-first) 并推送到 GitHub 仓库。验证情况：173 项自动化回归通过；设置页新增偏好、批量删除均已由用户在真实宿主页面实测成功。宿主登录页面无法用自动化浏览器进入，因此这些页面操作没有截图存档，只有用户实测反馈。

使用流程

1. 模型把任务原文交给 grill_start，判断目标、范围、约束和验收标准是否足够明确。

2. 对模糊任务只追问影响方案的歧义。默认每轮最多 3 问、最多 3 轮，不必凑满；每轮用 mode: continue 记录答案摘要和实际问过的维度。

3. 信息齐全或达到轮次上限后，停止追问，把需求与尚未验证的假设整理成四段清单，交给 grill_confirm。达到上限仍需确认，不会自动放行。

4. 用户选择「确认，按此开工」后放行本次任务；选择「要改」则修订清单并再次确认。

5. 明确的小任务、命中跳过词的新任务可直接放行。正在澄清时的咨询或追问不会替代需求确认。

例如「把那个页面优化一下」需要先确定页面、优化范围和完成标准。确认清单可以是：

目标：整理登录页视觉
范围：只改样式，不动结构和文案
约束：沿用现有设计规范
验收标准：主要页面在移动端不错位
[确认，按此开工] [要改]

三个工具

| 工具 | 作用 |

|---|---|

| grill_start | 判断是否需要澄清，返回追问方向、轮次、历史答案和 memory_context |

| grill_confirm | 展示需求清单；明确确认后放行，并按记忆设置保存历史和偏好 |

| grill_research | 需求明确后，用公开技术关键词查询开源候选和来源证据；不安装、不执行候选代码 |

grill_confirm 优先使用宿主结构化提问。通道不可用或抛错时返回 needs_user_confirmation: true，模型应改用内置提问工具展示完整清单，得到用户明确同意后再传 confirmed: true。只有同一会话、相同清单此前实际进入兜底通道才接受该声明；正常服务可用时直接传 true 不会跳过确认卡片。正文超过 6000 字会被拒绝，需要先整理保留全部约束的摘要再确认。

门禁模式

| gateMode | 需求未确认时 |

|---|---|

| off | 不拦截工具；不等于关闭整个插件 |

| warn（默认） | 记录日志，允许工具执行 |

| ask | 每次变更类调用都请求宿主审批；审批该次操作不会放行整项任务 |

| strict | 拒绝变更类调用，直到需求确认或明确跳过 |

门禁仅作用于根 agent。只读工具允许通过；写文件、命令和委派类工具属于受控操作。ask 返回审批请求不代表用户已批准；后续变更仍需审批，直到 grill_confirm 等合法流程打开任务门禁。

关闭 enabled 可停用澄清、门禁与调研。默认跳过词包括「直接做」「跳过提问」「不用问」「skip」；英文按词边界匹配，中文按子串匹配；紧邻关键词的否定表达（如「不要直接做」「don't skip」）不算跳过指令。判定器是中英文关键词启发式，并非完整的语义理解，复杂否定或引用仍可能误判。

安装

可通过 DSH 插件管理安装选定版本，或使用命令行：

dsh plugin --profile <你的-profile> add dsh-grill-first
# 开发构建：使用实际生成的本地包路径
dsh plugin --profile <你的-profile> add /绝对路径/dsh-grill-first-1.0.0.tgz

以上为安装方式示例，registry 的默认版本不保证是本文的 V1。以安装结果中的应用状态为准；仓库源码修改不等于运行中的安装副本已更新。

配置项

V1 提供独立的 DSH 设置 → 需求澄清 页面，共 10 项配置，保存到当前插件实例。页面依赖宿主的设置、连接和工作区服务；实际部署后仍需检查页面是否加载与保存成功。

| 配置 | 类型 | 默认 | 说明 |

|---|---|---|---|

| enabled | 布尔 | true | 总开关 |

| gateMode | off / warn / ask / strict | warn | 门禁模式，见上表 |

| maxQuestionsPerRound | 1–6 | 3 | 每轮问题数上限 |

| maxRounds | 1–10 | 3 | 追问轮数上限；达到上限仍需确认清单 |

| intensity | gentle / standard / grill | standard | 两维 / 三维 / 还要求验收标准的明确度判定 |

| bypassKeywords | 字符串数组 | ["直接做","跳过提问","不用问","skip"] | 命中时跳过澄清 |

| memoryEnabled | 布尔 | true | 控制澄清流程读取与确认流程写入记忆 |

| memoryScope | project / global | project | 项目记忆存工作区或全局目录 |

| researchMode | off / auto / always | auto | 调研关闭 / 适用时查询 / 每次调用均尝试查询 |

| researchDepth | quick / deep | quick | 调研请求预算与摘录深度 |

页面可编辑全部配置，跳过词每行一个。也可在 profile 的 cordis.patch.yml 中按插件条目配置；只提供需要覆盖的项：

- id: dsh-grill-first
  name: dsh-grill-first