dsh-workplan 3.0.6 → 3.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -0
- package/README.en.md +2 -2
- package/README.md +16 -14
- package/README.zh.md +2 -2
- package/docs/release-notes-3.0.9.md +7 -0
- package/lib/comm-format.js +5 -5
- package/lib/{three-phase.js → five-step.js} +204 -132
- package/lib/host.js +120 -75
- package/lib/lessons.js +4 -4
- package/lib/llm-rules.js +22 -80
- package/lib/plan.js +155 -65
- package/lib/runtime.js +307 -133
- package/lib/v3-contract.js +3 -3
- package/package.json +2 -3
- package/src/comm-format.ts +5 -5
- package/src/{three-phase.ts → five-step.ts} +230 -167
- package/src/host.ts +120 -75
- package/src/lessons.ts +4 -4
- package/src/llm-rules.ts +27 -99
- package/src/plan.ts +152 -63
- package/src/runtime.ts +318 -133
- package/src/v3-contract.ts +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,25 @@
|
|
|
1
|
+
## 3.0.9 — 2026-11-19
|
|
2
|
+
|
|
3
|
+
- 3.0.9:五步工作法全量审计修复——结果块模板补 approachBasis 字段、全部结算阈值渲染进提示词(消除「40/40/20」简写遮蔽 resources/tools/prepared/evidence 四项下限)、五步证据不完整接入有界回喂(EVIDENCE_INCOMPLETE 闸)、负责人汇总 F11 校验接线生效、缺块/退回改结构化标志(不再依赖错误文案正则);专家汇报回调强制结构化 JSON 结算(非法 JSON 绝不计 done);取消 engines.dsh 版本门槛,各版本 DSH 均可安装使用
|
|
4
|
+
|
|
5
|
+
## 3.0.8 — 2026-11-18(废除两轮深度思考,五步工作法单框架)
|
|
6
|
+
|
|
7
|
+
- **废除「两轮深度思考」开工门禁**:2.5.1/2.5.2 引入的 deepThink 两轮产物(主 Agent dispatch / 负责人 review+direct / 专家 self_effort 三处硬门禁)与五步工作法(2026-11-17 引入)长期双轨并存——两轮内容本就是五步第 1、2 步的子集,同一内容双份提交、无一致性比对,且模块名/错误信息仍停留在三阶段口径。本版按用户裁决彻底废除 deepThink 双轨,五步工作法成为唯一框架。
|
|
8
|
+
- **开工闸升级**:三处开工门禁统一改查五步第 1/2/3 步证据 `startPhases`(第一步任务梳理 ≥40 字、第二步资源 ≥20 字/工具 ≥10 字/方法 ≥40 字/依据 ≥20 字、第三步准备与就绪证据各 ≥20 字);错误码 `DEEP_THINK_*` / `MAIN_DEEP_THINK_*` → `START_EVIDENCE_MISSING` / `START_EVIDENCE_INCOMPLETE`(direct 动作为 `DELEGATE_DIRECT_START_*`)。
|
|
9
|
+
- **开工-结算一致性比对(新)**:结算时若行级已登记 startPhases,`phases.planning` 各清单条数与合计字符数必须 ≥ 开工登记值——收尾证据不得稀释开工时登记的第 1/2/3 步证据,违反即判 blocked(错误文案「开工-结算证据不一致」)。
|
|
10
|
+
- **consolidation 瘦身**:分工表不再内嵌开工证据,`ConsolidationInput` 只剩 `taskReasoningEffort(+Declared)` + `assignments`;`planDelegations` 删除三道两轮字数闸,开工证据一律经 `startPhases` 提交登记。
|
|
11
|
+
- **三阶段→五步全量改名**:`three-phase.ts` 删除,新模块 `five-step.ts`(契约版本 4);状态字段 `mainDeepThink→mainStartPhases`、`delegateDeepThinks→delegateStartPhases`、`delegates[].deepThink→delegates[].startPhases`(durable 键同步,历史存档零迁移:读不到即回 phase-0 补交);verify 工具与全部提示词口径统一为「第四步核验/五步证据」。
|
|
12
|
+
- **回归**:开工闸(START_EVIDENCE_* 缺交/太薄/边界 40-40-20-20-10-20)、开工-结算一致性比对、consolidation 瘦身、改名回放全链测试全量改写对齐;版本断言随定版升级 3.0.8。
|
|
13
|
+
|
|
14
|
+
## 3.0.7 — 2026-11-18(用户确认回复:自动放行并派发对应任务)
|
|
15
|
+
|
|
16
|
+
- **事故背景**:用户对计划回复「按你的建议执行」,旧的三类分类器(社交消息 / 空泛追问 / 进度提问)都不认确认回复,它就被当成全新任务——先把原任务在途的后台分解取代中止,再对这句确认本身启动新一轮分解;下一条消息又取代这一轮,任务永远开不了跑(无限取代循环)。本会话 2026-11-18 实测复现。
|
|
17
|
+
- **用户想法(原话)**:「收到用户确认回复后,你应该结合所有上下文全面、深入分析、思考、研究后,开始依据得出的所有结果分配任务」。
|
|
18
|
+
- **新增 `isUserConfirmation`(plan.ts)**:与三个既有分类器同层的纯函数判定。保守、可证三条件——文本 ≤24 字符;含至少一个认可信号词;不含任何否定词,且剥掉全部信号词与填充词后必须一个不剩。任何实质内容都会落选:如「可以,但范围改成X」回落到常规新任务路径——以该消息为最新输入、结合全部上下文**重新分解**(=深入分析)后按新计划分配任务,正是用户裁决的语义,而不是误当纯确认直接开跑旧计划。
|
|
19
|
+
- **用户补充裁决(2026-11-18,同版本吸收)**:「用户确认后,无论任务是否已经生成,都必须结合所有上下文和用户的回复,全面、深入开展分析、思考、研究,然后依据得出的所有结果开始分配任务」——**分析在先、派发现在**。据此,maybePlan 确认分支(runtime.ts)按当时实际状态分三种情形:① 已有计划未派发(含被认可闸门按住的)→ 解除按住(`gateHistory` 落档 `by:'user'`)、刷新 `conversationContext` 为含确认消息的全量上下文,并向主 Agent 下达**分析-派发指令**(必须 deepThink 登记完整分析后 `workplan_dispatch`;分析发现计划需调整则先 `replan` 再派发);本回合标记 activeTurns,主 Agent 若未在回合内派发,收尾闸门拦停 steer 兜底,不留「确认后无人派发」的尾巴。插件不在钩子层不经分析机械开跑。② 后台分解在途 → 标记 `planningEntry.userConfirmed`,原分解不被取代中止;后台分解本身就是结合全量上下文的深入分析,计划一生成即跳过认可闸门、刷新上下文后自动派发(=依据分析结果分配任务)。③ 其余(执行中/无计划/社交场景)→ 原样放行,绝不把确认当成新任务重新分解。plan 模式(先审后执行)下确认只记录不派发,保护不变。
|
|
20
|
+
- **双保险**:`onInboxInserted` 的取代守卫同步排除确认回复,确认消息不会先把原规划中止掉;重复确认只通知一次。
|
|
21
|
+
- **回归**:新增 `tests/workplan-user-confirmation.test.ts` 7 例(事故原句、中英正例全集、含实质内容反例、长度/类型/标点边界);版本断言(package.json / tool-surface fixture / host meta)随定版升级 3.0.7。
|
|
22
|
+
|
|
1
23
|
## 3.0.6 — 2026-11-18(审计后第 1–4 批:数据安全、并发排队、看板开销、收尾闸门与复审修复)
|
|
2
24
|
|
|
3
25
|
- **永久记忆不再可能被整体清空**:`recordLesson` 读文件失败(EACCES/EMFILE/EIO/路径被目录占用)时直接抛 `LESSONS_READ_FAILED` 并拒绝写入,不再把“读失败”当成“空文件”后覆盖;重写时把无法解析的坏行原样带回文件末尾;覆盖前留一代 `<file>.bak`。
|
package/README.en.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **Two selling points, one line: a full ISO/IEC 15408:2026 evidence pack you can verify with 5 commands, and a one-command install with zero runtime dependencies.**
|
|
4
4
|
|
|
5
5
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
|
|
7
7
|
|
|
8
8
|
Adds "plan first → dispatch real department subagents → watch progress in the sidebar" to **DeepSeek Harness (DSH)**. No app, no DSH source patch, no page replacement.
|
|
9
9
|
|
|
@@ -80,7 +80,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
|
|
|
80
80
|
## Install
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
dsh plugin --profile web add dsh-workplan@3.0.
|
|
83
|
+
dsh plugin --profile web add dsh-workplan@3.0.9
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
Restart the DSH Web process (or reload the page) so the bundle is picked up.
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
|
|
4
4
|
|
|
5
5
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
|
|
7
7
|
|
|
8
8
|
给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
|
|
9
9
|
|
|
@@ -62,14 +62,14 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
|
|
|
62
62
|
|
|
63
63
|
| 要求 | 说明 |
|
|
64
64
|
|---|---|
|
|
65
|
-
| DeepSeek Harness |
|
|
65
|
+
| DeepSeek Harness | 官方 Web 版(`dsh web` / `--profile web` 跑的这套;自 3.0.9 起对 DSH 版本不作要求,均可安装使用) |
|
|
66
66
|
| Node.js | **22 或更高**(`node -v` 自查) |
|
|
67
67
|
| 网络 | 安装时需要能访问 npm registry |
|
|
68
68
|
|
|
69
69
|
## 一键安装
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
dsh plugin --profile web add dsh-workplan@3.0.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@3.0.9
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -113,28 +113,30 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
113
113
|
| `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。60 秒无回执只提示,不按时间判失败或中止。 |
|
|
114
114
|
| `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
|
|
115
115
|
| `dsh_workplan_followup` | 给已中止或暂停、但产物已落盘的直接子会话补一条收尾说明。 |
|
|
116
|
-
| `dsh_workplan_verify` | 子 Agent
|
|
116
|
+
| `dsh_workplan_verify` | 子 Agent 在**第四步(验证阶段)**提交五步证据做核验;前三步证据不齐调用会返回 `PHASE_GATE`。核验通过≠完成,最终仍由完成判定复核。 |
|
|
117
117
|
| `dsh_workplan_lessons` | 只读查看**永久教训记忆**:`list` / `search` / `stats`。仅限根会话调用(子 Agent 不能跨项目读取);它只读文件,不改计划状态;用来核对「到底记住了什么、哪些错误在重复发生」。 |
|
|
118
118
|
|
|
119
119
|
在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
|
|
120
120
|
|
|
121
|
-
##
|
|
121
|
+
## 五步工作法与自我学习(3.0.8 的单框架)
|
|
122
122
|
|
|
123
|
-
###
|
|
123
|
+
### 五步:任务梳理 → 资源/工具/方案研究 → 准备就绪 → 执行与验证 → 收尾复盘
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
3.0.8 起,原「两轮深度思考」开工门禁并入五步工作法(两轮内容本就是第 1、2 步的子集,不再双份提交):每个部门 Agent 收到工作后,顺序不可颠倒,开工前必须完成前三步并登记开工证据 `startPhases`:
|
|
126
126
|
|
|
127
|
-
|
|
|
127
|
+
| 步骤 | 必须完成的事 | 证据 |
|
|
128
128
|
|---|---|---|
|
|
129
|
-
| 一
|
|
130
|
-
| 二
|
|
131
|
-
| 三
|
|
129
|
+
| 一 任务梳理 | 全面、深入梳理自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界) | `startPhases.planning.problemAnalysis` + 结算 `phases.planning` |
|
|
130
|
+
| 二 资源/工具/方案 | 基于第一步全部结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据) | `startPhases.planning.resources/tools/approach/approachBasis` |
|
|
131
|
+
| 三 准备就绪 | 把资源与工具真正备齐并给出可复核的就绪证据 | `startPhases.preparation.prepared/evidence` |
|
|
132
|
+
| 四 执行与验证 | 严格按第二步的方法、流程、步骤执行并逐条验证;需要改道必须记录原因 | `phases.execution.steps/deviations` + `phases.verification` |
|
|
133
|
+
| 五 收尾复盘 | 逐条验证验收标准与用户原要求,并做**自我学习复盘** | `phases.verification` + `retrospective` |
|
|
132
134
|
|
|
133
|
-
|
|
135
|
+
**关于「前三步禁用插件」的更正(2.0.2)**:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则(2.0.1 曾把它写成产品级规则,2.0.2 已更正)。五步工作法约束的是部门子 Agent 的交付证据顺序;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。验证工具在缺前三步证据时返回 `PHASE_GATE` 并列出待补项——这是防止跳过前三步直接「验证通过」的门禁,不是禁用插件。遇阻上报 `dsh_workplan_escalate` 始终可用。
|
|
134
136
|
|
|
135
137
|
### 自我学习与自我迭代:把弯路变成永久记忆
|
|
136
138
|
|
|
137
|
-
|
|
139
|
+
每次完成工作,第五步收尾必须提交四项复盘(缺一项就判未完成):
|
|
138
140
|
|
|
139
141
|
1. **problems**:本次全过程遇到的所有问题(现象 + 根因);
|
|
140
142
|
2. **detours**:走过的弯路、返工与无效尝试(确实没有就写空数组,不编造);
|
|
@@ -257,7 +259,7 @@ npm audit --omit=dev
|
|
|
257
259
|
|
|
258
260
|
DSH 本身自带「子智能体」能力(内置 subagent 工具)。本插件**不替换、也不关闭**它,两者同时存在,请知道这三件事:
|
|
259
261
|
|
|
260
|
-
1. **插件的部门负责人/专家**由插件统一派发和管理,走 `dsh_workplan_delegate` 等 11
|
|
262
|
+
1. **插件的部门负责人/专家**由插件统一派发和管理,走 `dsh_workplan_delegate` 等 11 个工具的全部闸门(事前预估、分工表、五步开工证据、结算核验、汇报核验)。
|
|
261
263
|
2. **内置 subagent 工具在这些子会话里仍然可见**。如果模型绕过插件、直接调用内置 `subagent` / `subagent_fork`,那个人会话**不经过插件的任何闸门**(无台账、无核验、无执行管理),产物也不会自动进计划看板。发现看板外多出来路不明的子会话时,对它说「以后派活一律走 dsh_workplan」即可。
|
|
262
264
|
3. **设置页两个子代理选项对本插件的影响不同**(已核实宿主源码,两条通道互不相干):
|
|
263
265
|
- 「子代理最大深度」(`subagent.maxDepth`)**只管内置 subagent/subagent_fork 工具**——本插件的三层体系(你 → 部门负责人 → 专家)按派发契约固定申请第 2 层深度,宿主对插件契约单独放行,**该滑块在任何位置都不会影响、也不会拦阻**负责人派发给专家。首次检测到该设置 <2 时插件会一次性说明这一点(无需任何操作;想完全一致可把滑块调到 2,重启后恢复默认);
|
package/README.zh.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
|
|
4
4
|
|
|
5
5
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
|
|
7
7
|
|
|
8
8
|
给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
|
|
9
9
|
|
|
@@ -69,7 +69,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
|
|
|
69
69
|
## 一键安装
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
dsh plugin --profile web add dsh-workplan@3.0.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@3.0.9
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# v3.0.9
|
|
2
|
+
|
|
3
|
+
3.0.9:五步工作法全量审计修复——结果块模板补 approachBasis 字段、全部结算阈值渲染进提示词(消除「40/40/20」简写遮蔽 resources/tools/prepared/evidence 四项下限)、五步证据不完整接入有界回喂(EVIDENCE_INCOMPLETE 闸)、负责人汇总 F11 校验接线生效、缺块/退回改结构化标志(不再依赖错误文案正则);专家汇报回调强制结构化 JSON 结算(非法 JSON 绝不计 done);取消 engines.dsh 版本门槛,各版本 DSH 均可安装使用
|
|
4
|
+
|
|
5
|
+
- tag: v3.0.9
|
|
6
|
+
- date: 2026-11-19
|
|
7
|
+
- npm: https://www.npmjs.com/package/dsh-workplan/v/3.0.9
|
package/lib/comm-format.js
CHANGED
|
@@ -12,9 +12,9 @@
|
|
|
12
12
|
*
|
|
13
13
|
* 设计约束:
|
|
14
14
|
* - 本模块只做「格式/结构」核验,不做语义真伪判断(F9 为提示词级诚信约束,
|
|
15
|
-
*
|
|
15
|
+
* 由五步证据门禁与人工复核兜底,这里不自动判);
|
|
16
16
|
* - 规范是纯数据,可序列化进提示词,也可独立校验,版本号随内容变更递增;
|
|
17
|
-
* -
|
|
17
|
+
* - 与既有门禁正交:解析失败、验收缺口、五步证据缺失仍由原门禁先拦,
|
|
18
18
|
* 本门禁只负责把「其它门禁都过了、但格式仍不合规」的 done 退回。
|
|
19
19
|
*/
|
|
20
20
|
import { checkDepartmentSummary, checkExpertReport, renderDepartmentSummarySpec, renderExpertReportSpec, } from './v3-contract.js';
|
|
@@ -67,7 +67,7 @@ export const COMM_FORMAT_SPEC = Object.freeze({
|
|
|
67
67
|
* 冻结条目,本次只增不改;两条新条目按接收者层级启用(见 check 的 tier)。
|
|
68
68
|
*/
|
|
69
69
|
Object.freeze({ id: 'F10', category: 'report',
|
|
70
|
-
description: '专家(第三层执行者)结果必须包含 report 对象,只允许 keyResults/keyInfo/importantInfo/leadRequirements
|
|
70
|
+
description: '专家(第三层执行者)结果必须包含 report 对象,只允许 keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组字段:keyResults / leadRequirements 各至少 1 条非空内容,keyInfo / importantInfo 可为空数组但字段必须存在,每数组最多 6 条、每条最多 200 字符,内部与跨字段不得出现重复表述',
|
|
71
71
|
rationale: '用户要求 7:专家成果必须非常精简地汇报给部门负责人,只要关键信息、关键成果、重要信息和负责人要求的东西,并以 JSON mode 结构化输出' }),
|
|
72
72
|
Object.freeze({ id: 'F11', category: 'report',
|
|
73
73
|
description: '部门负责人结果必须包含 departmentSummary 对象,只允许 keyResults/keyInfo/importantInfo/sources 四个字符串数组字段,keyResults 至少 1 条非空,keyResults/keyInfo/importantInfo 每项最多 6 条、每条最多 200 字符;sources 最多 16 条且必须逐人覆盖本部门全部已派发专家,内部与跨字段不得出现重复表述',
|
|
@@ -123,7 +123,7 @@ export function checkCommFormatCompliance(parsed, rawOutput, expectedAcceptanceC
|
|
|
123
123
|
violations.push({ ruleId: 'F2', category: 'structure',
|
|
124
124
|
message: `status 字段缺失或取值非法("${String(parsed.status ?? '')}"),只能是 done / blocked / partial` });
|
|
125
125
|
}
|
|
126
|
-
// F3:
|
|
126
|
+
// F3: 五步证据齐全(planning / preparation / execution / verification)
|
|
127
127
|
const phases = parsed.phases;
|
|
128
128
|
if (!phases || typeof phases !== 'object') {
|
|
129
129
|
violations.push({ ruleId: 'F3', category: 'phases',
|
|
@@ -195,7 +195,7 @@ export function checkCommFormatCompliance(parsed, rawOutput, expectedAcceptanceC
|
|
|
195
195
|
}
|
|
196
196
|
/*
|
|
197
197
|
* F10/F11(用户 2026-11-14 第 7、10、11 条):按接收者层级启用。
|
|
198
|
-
* 只拦 done 路径——受阻结果已有更针对性的诊断(F8
|
|
198
|
+
* 只拦 done 路径——受阻结果已有更针对性的诊断(F8/五步证据),
|
|
199
199
|
* 不再叠加精简性条目,避免一条 blocked 被反复退回在格式上。
|
|
200
200
|
*/
|
|
201
201
|
if (options.tier === 'expert' && parsed.status === 'done') {
|