结构化计划 LMQ00/dsh-method

dsh-method

给 DeepSeek Harness 一套通用做事方法：任何非平凡任务都先产出结构化执行计划，计划的结构由 schema 与校验器强制，不靠提示词请求。

产出的是最普遍的计划，不是最快的。换领域、换执行者仍然成立。

为什么

快的方法都靠省略：省掉目标澄清、省掉方案比较、省掉约束、省掉验证。这些省略在自己熟悉的领域看不出来，换到不熟悉的领域就变成返工。

这个插件把这几项变成必填且机器校验，所以模型省不掉。

装

本仓库未发布到 npm，只能从源码 clone 后以链接方式安装：

git clone https://github.com/LMQ00/dsh-method.git ~/Projects/dsh-method
dsh plugin --profile web add link:~/Projects/dsh-method

装完重启 dsh web。profile 的 node_modules 里应有 dsh-method 软链——link: 装完若缺这条软链，dsh web 会打印 cannot resolve profile bundle "dsh-method" 并跳过该 bundle，重装一次即可。

用

/method # 开启，直接说要做的事 /method off # 关闭

开启后模型必须调用 plan_submit 提交计划。计划通过校验会落盘到 <项目根>/.method/plan.md，并把渲染后的全文回给模型，之后按计划执行。

计划被强制包含什么

| 项 | 规则 | 违反时 |
| 目标 | 一句话说清完成后的状态 | 拒绝 |
| 非目标 | ≥1 条明确不做的 | 拒绝 |
| 约束 | ≥1 条，标 hard / soft | 拒绝 |
| 方案比较 | ≥2 个候选，各写优点与代价，选中项必须是其中之一 | 拒绝 |
| 任务 | ≥2 个，id 唯一，依赖不许成环 | 拒绝 |
| 每任务失败原因 | ≥1 条 | 拒绝 |
| 每任务完成判定 | 必须可观察：一条命令 / 一个文件路径 / 一个数值比较 | 拒绝 |
| 验证 | 每任务都被覆盖，或一条 task: "" 覆盖整体 | 拒绝 |
| 可逆性 / 置信度 | 布尔 + high\|medium\|low | 拒绝 |

「可观察」的判定标准是结构化的，覆盖技术与非技术两类：

| 类型 | 例子 |
| 命令 / 退出码 | pnpm test 退出码为 0 |
| 文件 / 产物 | docs/plan.md 存在、report/q3.docx 不少于 20 页 |
| 数值 / 阈值 | 测试覆盖率 ≥ 80%、输出 42 行 |
| 对比 / 状态值 | accepted 为 true、返回码为 0 |
| 他人确认 / 交付物 | 收到订票确认邮件、合同已签署、客户在验收单上签字 |
| 状态达成 | 页面能打开、样机通过跌落测试 |

确认一切正常、 好 、go、make it happen、随便看看、「完成」 这类只有形容词和程度副词、既不指向对象也不指向状态的空话会被拒绝。

两层强制

| 层 | 拒绝什么 | 在哪 |
| JSON Schema | 形状错：缺字段、类型错、枚举非法、多余字段 | provider 侧，execute 之前 |
| validate.js | 内容错：空串、条目不够、判定不可观察、依赖成环、验证没覆盖 | execute 内 |

Schema 用标准 JSON Schema（required 是字符串数组），不是 defineTool 的 DSL。用 DSL 写法（属性上 required: true）会被 provider 拒绝：Invalid schema for function 'plan_submit': true is not of type 'array'。

结构

| 文件 | 职责 |
| index.js | 插件入口：/method 命令、plan_submit 工具、method:policy 提示词段 |
| validate.js | 计划内容校验，纯函数 |
| state.js | 会话投影（从会话日志折叠状态）+ 计划路径解析 |
| methodology.js | 提示词文本 |
| selftest.mjs | 68 项自测，全部执行真实代码 |
| docs/插件说明.md | 做什么、怎么用、计划必含什么、拦什么不拦什么、限制 |
| docs/实现逻辑.md | 状态模型、两层校验、判定判据、路径解析、渲染格式、宿主接口面 |
| AGENTS.md | 文档索引 + 开发规范，改代码前必读 |

状态怎么存

sessionProjections 从会话日志折叠，不自造事件类型——DSH 的持久化读路径会拒绝未知事件类型（除非带 ignorable: true，而 Session.append() 设不了）。

| 事件 | 作用 |
| command/run（name: method） | 记录待生效的选择 |
| command/done（配对 id） | success 才提交选择 |
| tool/call（plan_submit） | 按 callId 记下 arguments |
| tool/result（配对 id） | 非错误则解析该次的 arguments 并提交计划 |

待提交项是 map 不是单值，所以并行工具调用时每个 plan_submit 与自己的结果配对，不会互相抢。后完成的成功提交覆盖计划并递增 revision。

自测

node selftest.mjs

68 项，覆盖：合法计划接受、结构缺陷拒绝、依赖图缺陷拒绝、验证覆盖缺陷拒绝、元信息缺陷拒绝、边界（超长/null/非对象）、判定可观察性的双向误报与漏报、投影折叠（含并发、乱序、状态必须是无损 JSON）、错误路径可诊断、渲染。

已知取舍

- 判定靠词表，识别不了的说法会被误拒：酒店订好了、机票已出票、行程已排好 这类中文口语完成态，既不命中产物名词，也不命中状态词，会被拒绝；而同义的 已完成酒店预订、订单已生成 会通过。同一个意思，措辞不同结果就不同，这是当前实现的缺陷。[待改] 方向是反过来只检测空话（黑名单），而不是枚举所有合法说法（白名单）。
- .method/ 落在项目根下：首次落盘时会在 .method/ 内自写一个内容为 的 .gitignore，让它整目录不进版本控制，不改你的根 .gitignore。
- 同一项目多会话共用一份计划：路径按工作目录定位，不含 session id，两个并行会话会写同一个 plan.md。
- 没有强制中断：plan_submit 只在 method mode 下可用，但插件不阻止模型不调它就直接干活。真要强制，得靠 tools.guard 拦截写操作——那是另一个量级的设计，当前版本刻意不做，避免变成「不开 method 就不能干活」。