dsh-workplan 2.0.1 → 2.0.3

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 CHANGED
@@ -1,3 +1,69 @@
1
+ ## 2.0.3 — 2026-11-05
2
+
3
+ **修复「官方 `/goal` 目标指令会让 dsh-workplan 自动分解永远不触发」的真实缺陷:goal 第一轮现在作为合法任务入口参与自动分解;已有进行中计划时 goal 轮次绝不抢跑。**
4
+
5
+ ### 一、问题与证据链
6
+
7
+ 用户 2026-11-05 报告:使用官方 DeepSeek Harness 的「目标 goal」指令后,dsh-workplan 的自动任务分解似乎不会触发。核查代码后确认这不是猜测,而是一条可复现的契约缺口:
8
+
9
+ | # | 事实 | 证据位置 |
10
+ |---|---|---|
11
+ | 1 | `/goal <objective>` 命令只写 goal 领域状态,**不产生** `user/message` | `@deepseek-ai/dsh-command-goal` 的 `create` 分支 |
12
+ | 2 | goal 的自动续跑轮次由 round driver 以 `source.kind = "goal"` 的 user 消息送达,文本形如 `<goal_round>Objective: "…"</goal_round>` | `@deepseek-ai/dsh-goal-round-driver/lib/index.js` 的 `renderGoalRoundPrompt` 与 `createUserMessage` |
13
+ | 3 | 2.0.2 的 `humanMessages()` 只接受 `source.kind === 'user'` 或未标记的消息 | `src/runtime.ts#humanMessages` |
14
+ | 4 | `maybePlan()` 在 `human.length === 0` 时直接返回,不进入规划 | `src/runtime.ts#maybePlan` |
15
+
16
+ 1+2+3+4 合并后的结论:如果任务是通过 `/goal` 设置的,整条 goal 生命周期内都不存在「人类消息」,插件永远不会自动分解该任务。人工消息路径(普通输入框任务)不受影响。
17
+
18
+ ### 二、改了什么
19
+
20
+ - 新增 `goalRoundPlanningTask(ctx, payload, existing)`:只接受 `source.kind === 'goal'` 且 `round === 1` 的消息作为自动分解入口。
21
+ - `maybePlan()` 在没有任何人工消息时改走该入口;任务文本优先级为:`goals` 领域服务的结构化 `objective` → 从官方 `<goal_round>` 信封解析 JSON objective → 整条消息原文。
22
+ - 防抢跑:会话里存在进行中计划(`executing` / `paused` / `pending` / `verification` 等)时,goal 轮次直接放行不建计划;`done` / `ended` / `cancelled` / `superseded` / `degraded` / `clarify` 属于历史记录,不拦新任务。
23
+ - 人工消息路径、`humanMessages()` 的既有语义、执行中变更(changeRequest)与 replan 规则全部保持不变。
24
+
25
+ ### 三、验证
26
+
27
+ - 新增 `tests/goal-round-planning.test.ts`:7 条断言覆盖 round 1/round 2、goals 服务优先、信封解析、无 objective 兜底、进行中计划防抢跑、历史终态放行。
28
+ - `npm test`:553 条用例全过;`npm run check`(tsc --noEmit)退出码 0。
29
+ - `npm run build` 重新生成 `lib/`、`dist/`、`client.js`,与 `src/` 同步。
30
+
31
+ ### 四、发布
32
+
33
+ - npm:`dsh-workplan@2.0.3`
34
+ - GitHub Release:`v2.0.3`,附 `dsh-workplan-2.0.3.tgz` 制品
35
+ - 索引源(dsh-plugin-catalog 链路):条目 tarball 指向 `v2.0.3` Release,等待上游 CI 生成 catalog
36
+
37
+ ## 2.0.2 — 2026-11-05
38
+
39
+ **更正「第一、二阶段禁用 dsh-workplan 插件」的适用范围:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久产品规则。2.0.2 起,提示词、工具描述、README 与协作文档不再声明全局禁用;三阶段工作法与「验证工具缺前两阶段证据返回 PHASE_GATE」的证据门禁保持不变。**
40
+
41
+ ### 一、为什么要改
42
+
43
+ - 用户在 2.0.1 发布后澄清:原要求 4「第一、二阶段禁用 dsh-workplan 插件」是**本次会话内**对优化过程的约束,不是要求插件对所有未来会话禁用。
44
+ - 1.13.0 起把这条写成了产品级规则(子 Agent 提示词、`dsh_workplan_verify` 描述、运行时报错、README、协作文档),属于对需求范围的误读;2.0.2 全面更正。
45
+
46
+ ### 二、改了什么(只改措辞与说明,不改三阶段契约)
47
+
48
+ | 位置 | 2.0.1 及以前 | 2.0.2 |
49
+ |---|---|---|
50
+ | `src/three-phase.ts#threePhasePromptLines` | 「阶段一、二:dsh-workplan 插件禁用。不得调用任何 dsh_workplan_* 工具」 | 「阶段一、二先把问题、思路与执行记录写全;调用 verify 会因缺少前两阶段证据返回 PHASE_GATE(证据门禁,不是禁用插件)」 |
51
+ | `src/host.ts#createVerifyTool` 描述 | 「阶段一、二禁用本插件」 | 「缺少 planning / execution 证据时返回 PHASE_GATE 与待补项」 |
52
+ | `src/runtime.ts#verifySubtask` 报错 | 「插件在阶段一、二禁用」 | 「阶段三核验缺少前两阶段证据」 |
53
+ | `README.md` / `README.en.md` | 声明永久禁用 | 声明仅 2026-11-05 本次会话约束;主 Agent 任何阶段都可用计划/派发/查询/改判 |
54
+ | `docs/collaboration.md`、`docs/cc/AVA` | 表格写「禁用」 | 写「证据门禁」并加 2.0.2 更正说明 |
55
+
56
+ ### 三、没有变的部分
57
+
58
+ - 三阶段(规划 → 执行 → 验证)仍是产品功能,完成判定仍要求 `phases` 齐全。
59
+ - `dsh_workplan_verify` 仍只接受三阶段齐全的证据;缺 planning/execution 仍返回 `PHASE_GATE`——这是证据门禁,不是插件禁用。
60
+ - 阶段三复盘(自我学习)与永久教训记忆完全不变。
61
+
62
+ ### 四、验证
63
+
64
+ - `npm run check`(tsc --noEmit)退出码 0;`npm test` 全过(见 `docs/release-notes-2.0.2.md` 与 GitHub Release 页)。
65
+ - 新增/更新断言:`tests/three-phase.test.ts` 明确断言提示词不再包含「插件禁用」,同时仍断言阶段三门禁与 `PHASE_GATE`。
66
+
1
67
  ## 2.0.1 — 2026-11-05
2
68
 
3
69
  **新增「自我学习与自我迭代」:部门 Agent 每次完成工作后,必须在阶段三复盘本次全过程的问题、弯路、解决方式与防再犯规则;复盘通过后写入永久教训记忆文件,下次派发同类任务时自动注入提示词。同一类错误重复出现会累加次数并提前排序。三阶段工作法(1.13.0)保持「规划 → 执行 → 验证」不变,复盘是验证阶段收尾的必填项,不是第四个阶段。**
@@ -15,6 +81,8 @@
15
81
  | 7. 版本更新为 2.0.1 | `package.json` / `package-lock.json`(两处)/ `src/host.ts#meta.version` / `CHANGELOG` / `README.md` / `README.en.md` 全部为 2.0.1,由 `tests/version-sync.test.ts` 断言 |
16
82
  | 8. 源码与版本同步发布到 GitHub 与索引源 | 提交 + `v2.0.1` tag + GitHub Release(带 tgz 制品)+ npm `dsh-workplan@2.0.1` + awesome-dsh-plugin 索引条目更新,发布记录见 `docs/release-record-2.0.1-20261105.md` |
17
83
 
84
+ > **勘误(2026-11-05,2.0.2)**:上表第 4 条「第一、二阶段禁用 dsh-workplan 插件」只适用于本次优化会话,不是对所有后续会话的永久插件限制。2.0.2 起提示词、工具描述、README 与文档已更正;三阶段工作法与证据门禁不变。
85
+
18
86
  ### 二、自我学习的具体机制(可复核)
19
87
 
20
88
  | 环节 | 代码位置 | 行为 |
package/README.en.md CHANGED
@@ -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@2.0.1
83
+ dsh plugin --profile web add dsh-workplan@2.0.3
84
84
  ```
85
85
 
86
86
  Restart the DSH Web process (or reload the page) so the bundle is picked up.
@@ -125,9 +125,9 @@ Every number is derived from the same task state — the panel can no longer cla
125
125
 
126
126
  In **plan mode** the plan is shown for review and `dispatch` is explicitly refused with a reason.
127
127
 
128
- ## Three phases and self-learning (2.0.1)
128
+ ## Three phases and self-learning (2.0.2)
129
129
 
130
- Every department agent must work in order — **planning → execution → verification** — and completion requires structured evidence for all three phases. Phases 1 and 2 must not use the dsh-workplan plugin: children have no plan/dispatch/adjudication powers, and the phase-3 verify tool rejects calls that lack planning/execution evidence with `PHASE_GATE`. The only exception is the blocker escalation channel, which is a safety valve rather than a planning/execution/verification capability.
130
+ Every department agent must work in order — **planning → execution → verification** — and completion requires structured evidence for all three phases. The phase-3 verify tool rejects calls that lack planning/execution evidence with `PHASE_GATE` and lists the gaps; this is an evidence gate, not a plugin-wide disable. Correction (2.0.2): the "phases 1–2 must not use the plugin" wording described a one-off constraint of the 2026-11-05 optimization session, not a permanent rule for later sessions. The main agent can use the planning, dispatch, status and replan tools at any phase; the blocker escalation channel stays available.
131
131
 
132
132
  Phase 3 also requires a **retrospective** (`retrospective` inside `phases.verification`):
133
133
 
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-2.0.1-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.0.1)
6
+ [![version](https://img.shields.io/badge/version-2.0.3-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.0.3)
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@2.0.1
72
+ dsh plugin --profile web add dsh-workplan@2.0.3
73
73
  ```
74
74
 
75
75
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
@@ -118,7 +118,7 @@ dsh plugin --profile web add "$(pwd)"
118
118
 
119
119
  在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
120
120
 
121
- ## 三阶段工作法与自我学习(2.0.1 的核心)
121
+ ## 三阶段工作法与自我学习(2.0.2 的核心)
122
122
 
123
123
  ### 三阶段:规划 → 执行 → 验证
124
124
 
@@ -130,7 +130,7 @@ dsh plugin --profile web add "$(pwd)"
130
130
  | 二 执行 | 严格按阶段一的思路执行;需要改道必须记录原因 | `phases.execution.steps/deviations` |
131
131
  | 三 验证 | 逐条验证验收标准与用户原要求,并做**自我学习复盘** | `phases.verification` + `retrospective` |
132
132
 
133
- **第一、二阶段禁用 dsh-workplan 插件**:子 Agent 本就没有计划/派发/改判权限;阶段三的核验工具在缺规划或执行证据时会直接返回 `PHASE_GATE`。唯一保留的是遇阻上报 `dsh_workplan_escalate`(安全阀,不属于计划/执行/验证能力)。
133
+ **关于「第一、二阶段禁用插件」的更正(2.0.2)**:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则(2.0.1 曾把它写成产品级规则,2.0.2 已更正)。三阶段约束的是部门子 Agent 的交付证据顺序;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。验证工具在缺规划或执行证据时返回 `PHASE_GATE` 并列出待补项——这是防止跳过前两阶段直接「验证通过」的门禁,不是禁用插件。遇阻上报 `dsh_workplan_escalate` 始终可用。
134
134
 
135
135
  ### 自我学习与自我迭代:把弯路变成永久记忆
136
136
 
@@ -112,11 +112,11 @@ npm run verify
112
112
 
113
113
  新增接口的完整参数/失败行为见 `docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md`。本节不改 §1 方法与「未做」声明:仍未做渗透测试、模糊测试与形式化分析;AVA_VAN.2+ 需外部实验室,为固有残留、如实披露。
114
114
 
115
- ## 9. v1.13.0 / v2.0.1 攻击面增量(三阶段核验与教训记忆)
115
+ ## 9. v1.13.0 / v2.0.2 攻击面增量(三阶段核验与教训记忆)
116
116
 
117
117
  1.13.0 新增 1 个工具入口 `dsh_workplan_verify`,只对子 Agent 开放,用于阶段三核验。攻击面评估:
118
118
 
119
119
  | # | 新增入口 | 输入可控点 | 潜在滥用 | 对策(实测) |
120
120
  |---|---|---|---|---|
121
- | AS-11 | `dsh_workplan_verify` | `phases`(嵌套对象,受字段长度/条数/总长上限)、`acceptance` | 子 Agent 伪造「全部通过」的验证证据骗过核验;把核验通过当成完成许可;阶段一/二提前调用规避禁用 | 核验只做结构与验收覆盖检查,**不是完成判定**;完成仍由 `adjudicateResult` 对同一份证据再判;只交 planning/execution 时返回 `PHASE_GATE`;`MAX_PHASE_*` 限制输入规模;`tests/three-phase.test.ts` 覆盖 |
121
+ | AS-11 | `dsh_workplan_verify` | `phases`(嵌套对象,受字段长度/条数/总长上限)、`acceptance` | 子 Agent 伪造「全部通过」的验证证据骗过核验;把核验通过当成完成许可;阶段一/二提前调用规避门禁 | 核验只做结构与验收覆盖检查,**不是完成判定**;完成仍由 `adjudicateResult` 对同一份证据再判;只交 planning/execution 时返回 `PHASE_GATE`;`MAX_PHASE_*` 限制输入规模;`tests/three-phase.test.ts` 覆盖 |
122
122
  | AS-12 | `dsh_workplan_lessons` | `action`(枚举)、`department`、`query`(≤ 原文长度)、`limit`(1–50) | 读取教训记忆探测其他项目的内部信息;用被污染的教训做提示词注入;把只读工具当成写入通道 | 只读、无写入动作;注入前清除不可见字符与会话引用并在提示词中声明为历史数据;返回条数受 `limit` 限制;`tests/self-learning.test.ts` 覆盖 |
@@ -2,9 +2,9 @@
2
2
 
3
3
  > 这份文档回答四个问题:**谁把什么写给谁、什么时候算完成、失败后谁接手、改代码时哪些地方必须一起改。**
4
4
  >
5
- > 适用版本:**2.0.1**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
5
+ > 适用版本:**2.0.2**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
6
6
  >
7
- <!-- [D-45] 本文版本与实现口径已对齐 2.0.1;核对项:权限 7 处、present 仅根会话、下游可读 artifacts、三阶段证据门禁、复盘永久记忆。 -->
7
+ <!-- [D-45] 本文版本与实现口径已对齐 2.0.2;核对项:权限 7 处、present 仅根会话、下游可读 artifacts、三阶段证据门禁、复盘永久记忆。 -->
8
8
 
9
9
  > 约定:本文只用「文件 + 符号名」定位代码(例如 `src/plan.ts#buildChildPrompt`),**不写行号**,避免代码改动后文档漂移。核对命令见 §11。
10
10
 
@@ -253,7 +253,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
253
253
  子 Agent 必须用**自由文本**汇报,并满足:
254
254
 
255
255
  - 优先在输出末尾追加结构化证据块(`<!-- WORKPLAN_EVIDENCE:START -->` … JSON … `<!-- WORKPLAN_EVIDENCE:END -->`),含 `status` / `blockedReason` / `acceptance[]` / `artifacts[]` / `needs[]`。这是 1.11.0 起的完成判据:`partial`、任一验收 `fail`、坏块都判受阻,只有全 `pass` 直接采信。
256
- - **1.13.0 起,证据块还必须含 `phases`**(`planning` / `execution` / `verification`):缺任一阶段、规划内容过薄、`allPassed!==true`、验证条数少于验收数或未逐条对号,即使 `status:"done"` 也判 `blocked/unverified`。阶段一、二禁用插件;阶段三可用 `dsh_workplan_verify` 预核验,但核验通过不等于完成。
256
+ - **1.13.0 起,证据块还必须含 `phases`**(`planning` / `execution` / `verification`):缺任一阶段、规划内容过薄、`allPassed!==true`、验证条数少于验收数或未逐条对号,即使 `status:"done"` 也判 `blocked/unverified`。阶段三可用 `dsh_workplan_verify` 预核验(缺 planning/execution 返回 `PHASE_GATE`,是证据门禁而非全局禁用插件),但核验通过不等于完成。
257
257
  - 没有证据块时,失败仍可**第一行**写 `BLOCKED: 原因`(大小写不敏感,中英文冒号都认,行首允许空白)——按 `legacy` 判受阻。
258
258
  - **1.11.0 起,没有证据块、也没有 `BLOCKED` 的「纯散文」不再算完成**:默认(`strictCompletion`,可用 `DSH_WORKPLAN_STRICT_COMPLETION=0` 关闭)判 `blocked` + `unverified`,错误信息写明「结果块缺失,无法确认验收项是否真的通过」。历史回放仍按 `legacy` 读取,避免旧计划整体失效。
259
259
  - 验收条目自称 `pass` 但 `evidence` 为空时,1.11.0 降级为 `unverified`,且 `deliveryReadiness` 增加「验收自称通过但没有证据」阻塞项。
@@ -458,21 +458,23 @@ npm run verify
458
458
 
459
459
  ---
460
460
 
461
- ## 13. 三阶段工作法(1.13.0 起,2.0.1 增补复盘,用户强制要求)
461
+ ## 13. 三阶段工作法(1.13.0 起,2.0.1 增补复盘,2.0.2 更正「禁用插件」的适用范围)
462
462
 
463
463
  部门 Agent 收到子任务后,必须按顺序完成三个阶段;阶段不可颠倒、不可跳过。
464
464
 
465
- | 阶段 | 必须做什么 | 结果块证据(`phases`) | 插件是否可用 |
465
+ | 阶段 | 必须做什么 | 结果块证据(`phases`) | 插件核验工具 |
466
466
  |---|---|---|---|
467
- | 一 规划 | 先全面梳理问题:现状与事实、约束、未知、主要矛盾、边界;再形成完整可执行思路:步骤、产物、依赖、风险、验证方式 | `planning.problemAnalysis` / `planning.constraints` / `planning.unknowns` / `planning.approach` | **禁用** |
468
- | 二 执行 | 严格按阶段一的思路执行;任何偏离都必须记录原因与证据 | `execution.steps` / `execution.deviations` | **禁用** |
467
+ | 一 规划 | 先全面梳理问题:现状与事实、约束、未知、主要矛盾、边界;再形成完整可执行思路:步骤、产物、依赖、风险、验证方式 | `planning.problemAnalysis` / `planning.constraints` / `planning.unknowns` / `planning.approach` | 前两阶段证据尚未产生,调用会返回 `PHASE_GATE` |
468
+ | 二 执行 | 严格按阶段一的思路执行;任何偏离都必须记录原因与证据 | `execution.steps` / `execution.deviations` | 前两阶段证据尚未产生,调用会返回 `PHASE_GATE` |
469
469
  | 三 验证 | 逐条验证验收标准与用户原要求,全部通过才可报 done | `verification.allPassed` / `verification.checks` / `verification.requirementCheck` | 可用 `dsh_workplan_verify` |
470
470
 
471
471
  完成判定:`src/plan.ts#adjudicateResult` 对 `status:'done'` 强制校验 `phases`;缺任一阶段、规划内容过薄、`allPassed!==true`、验证记录少于验收标准数或未逐条对号、字段为空,一律判 `blocked/unverified`,计划不能交付。
472
472
 
473
473
  唯一保留的插件通道:遇阻上报 `dsh_workplan_escalate`。它不是计划/执行/验证能力,而是安全阀;否则子 Agent 在阶段一/二受阻时只能空转或编造。
474
474
 
475
- 核验工具:`dsh_workplan_verify` 只接受阶段三调用;缺 planning/execution 时返回 `PHASE_GATE`(插件在阶段一、二禁用)。核验通过不等于完成——结果块仍须写同一份 `phases`,由完成判定再判一次。
475
+ 核验工具:`dsh_workplan_verify` 只接受阶段三调用;缺 planning/execution 时返回 `PHASE_GATE` 与待补项(证据门禁,不是禁用插件)。核验通过不等于完成——结果块仍须写同一份 `phases`,由完成判定再判一次。
476
+
477
+ > 2.0.2 更正:「第一、二阶段禁用 dsh-workplan 插件」只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。
476
478
 
477
479
  **2.0.1 起,`phases.verification.retrospective` 也是必填**(`problems` / `detours` / `resolutions` / `prevention`,见 `src/lessons.ts#validateRetrospective`):缺项或太薄判 `blocked/unverified`;通过后写入永久记忆 `~/.dsh/workplan/lessons.jsonl`,下次派发同类任务时自动注入最相关的历史教训。主 Agent 可用只读工具 `dsh_workplan_lessons` 复核。
478
480
 
@@ -2,6 +2,8 @@
2
2
 
3
3
  发布日期:2026-11-05(Asia/Shanghai)
4
4
 
5
+ > **勘误(2.0.2)**:本版把「第一、二阶段禁用 dsh-workplan 插件」写成了产品级永久规则,这是对需求范围的误读——该条只适用于 2026-11-05 本次优化会话。2.0.2 已更正提示词、工具描述、README 与协作文档;三阶段契约与复盘机制不变。
6
+
5
7
  ## 一句话
6
8
 
7
9
  部门 Agent 每次完成工作后必须复盘(问题 / 弯路 / 解决 / 防再犯),复盘写入永久记忆文件;下次派发同类任务时自动注入历史教训,同一类错误重复出现会累加次数并提前排序。三阶段工作法保持「规划 → 执行 → 验证」,复盘是验证阶段收尾的必填项。
@@ -0,0 +1,49 @@
1
+ # dsh-workplan 2.0.2 — 更正「第一、二阶段禁用插件」的适用范围
2
+
3
+ 发布日期:2026-11-05(Asia/Shanghai)
4
+
5
+ ## 一句话
6
+
7
+ 2.0.2 只做一件事:把「第一、二阶段禁用 dsh-workplan 插件」更正为**仅适用于 2026-11-05 本次优化会话**,不再作为所有后续会话的永久产品规则。三阶段工作法、阶段三核验与自我学习复盘全部保持不变。
8
+
9
+ ## 安装 / 升级
10
+
11
+ ```bash
12
+ dsh plugin --profile web add dsh-workplan@2.0.2
13
+ ```
14
+
15
+ 装完重启一次 DSH Web(或重新载入页面)。
16
+
17
+ 从 2.0.1 升级时不需要迁移数据:`phases` 证据格式、`phases.verification.retrospective`、教训记忆文件 `~/.dsh/workplan/lessons.jsonl` 都没有变化。
18
+
19
+ ## 为什么要出 2.0.2
20
+
21
+ 用户在 2.0.1 发布后澄清:原要求 4「第一、二阶段禁用 dsh-workplan 插件」是**本次会话内**对优化过程的约束,不是要求插件对所有未来会话禁用。1.13.0 起该条被写成了产品级规则(子 Agent 提示词、`dsh_workplan_verify` 描述、运行时报错、README 与协作文档),属于对需求范围的误读,2.0.2 全面更正。
22
+
23
+ ## 改了什么
24
+
25
+ | 位置 | 2.0.1 及以前 | 2.0.2 |
26
+ |---|---|---|
27
+ | 子 Agent 提示词 | 「阶段一、二:dsh-workplan 插件禁用。不得调用任何 dsh_workplan_* 工具」 | 「阶段一、二先把问题、思路与执行记录写全;调用 verify 会因缺少前两阶段证据返回 PHASE_GATE(证据门禁,不是禁用插件)」 |
28
+ | `dsh_workplan_verify` 描述 | 「阶段一、二禁用本插件」 | 「缺少 planning / execution 证据时返回 PHASE_GATE 与待补项」 |
29
+ | 运行时报错 | 「插件在阶段一、二禁用」 | 「阶段三核验缺少前两阶段证据」 |
30
+ | README(中/英) | 声明永久禁用 | 声明仅本次会话约束;主 Agent 任何阶段都可用计划、派发、查询与改判工具 |
31
+ | 协作文档与安全文档 | 表格写「禁用」 | 写「证据门禁」并加 2.0.2 更正说明 |
32
+
33
+ ## 没有变的部分
34
+
35
+ - 三阶段「规划 → 执行 → 验证」仍是产品功能;完成判定仍要求 `phases` 齐全。
36
+ - `dsh_workplan_verify` 仍只接受三阶段齐全的证据;缺 planning/execution 仍返回 `PHASE_GATE`——这是证据门禁,不是插件禁用。
37
+ - 阶段三复盘(问题 / 弯路 / 解决 / 防再犯)与永久教训记忆完全不变。
38
+ - 没有新增或删除模型工具,工具面仍是 11 个。
39
+
40
+ ## 验证
41
+
42
+ - `npm run check`(tsc --noEmit)退出码 0。
43
+ - `npm test`:全量通过(具体条数见仓库发布记录与 CI 输出)。
44
+ - `tests/three-phase.test.ts` 新增断言:提示词不得再出现「插件禁用」,同时仍要求阶段三门禁与 `PHASE_GATE`。
45
+
46
+ ## 兼容性
47
+
48
+ - 2.0.2 是 2.0.1 的措辞更正版,证据契约与数据格式完全兼容,可直接升级。
49
+ - 旧结果回放仍可用 `requirePhases: false` 走 1.13.0 以前的旧语义(与 2.0.1 相同)。
@@ -0,0 +1,113 @@
1
+ # dsh-workplan 2.0.1 发布记录(可复核)
2
+
3
+ - 发布时间:2026-11-05 13:11 起(Asia/Shanghai,本文件在发布后补写)
4
+ - 版本:**2.0.1**(package.json / package-lock.json 两处 / `src/host.ts` 的 `meta.version` / CHANGELOG / 两份 README 安装命令,共 7 个声明点;`tests/version-sync.test.ts` 全部断言一致)
5
+ - 主题:**自我学习与自我迭代**——第三阶段强制复盘、永久教训记忆、下次派发自动注入防再犯
6
+
7
+ ## 1. 用户八条要求的落地对照
8
+
9
+ | # | 要求 | 落地位置 | 证据 |
10
+ |---|---|---|---|
11
+ | 1 | 自我学习与自我迭代能力 | `src/lessons.ts`(445 行)、`dsh_workplan_lessons` 工具、`src/runtime.ts` 的注入与落盘 | `tests/self-learning.test.ts` 10 条用例 |
12
+ | 2 | 每项工作完成后必须复盘问题/弯路/解决方式并永久记住 | 阶段三 `verification.retrospective` 必填;`recordLesson` 写 `~/.dsh/workplan/lessons.jsonl`;`renderLessonsBrief` 在下次派发时注入 | `validateRetrospective` 太薄即拒;`rankLessons` 按部门/关键词/重复次数排序 |
13
+ | 3 | 三阶段:计划 → 执行 → 验证 | `src/three-phase.ts`(1.13.0 引入,2.0.1 扩展复盘) | `dsh_workplan_verify` 只接受三阶段齐全的证据 |
14
+ | 4 | 第一、二阶段禁用 dsh-workplan 插件 | 插件文档与工具描述明确规定;阶段一/二只产出文字计划与执行记录,插件核验工具仅在阶段三可用 | `src/host.ts` 的 `PROMPT_SECTION` 与 `dsh_workplan_verify` 描述 |
15
+ | 5 | 第三阶段用插件验证是否满足全部要求 | `dsh_workplan_verify` 逐项核验 `acceptance`,本次发布即用该契约自检(见第 5 节) | 546 条测试全过 |
16
+ | 6 | 不得偏离用户要求 | 需求逐条映射到代码与测试,无删减 | CHANGELOG「用户要求逐条对照」 |
17
+ | 7 | 版本更新为 2.0.1 | 7 个版本声明点全部 2.0.1 | `tests/version-sync.test.ts` |
18
+ | 8 | 源码与版本同步发布到 GitHub 与索引源 | GitHub Release `v2.0.1` + npm `dsh-workplan@2.0.1` + awesome-dsh-plugin PR #12201 | 见第 3、4、6 节 |
19
+
20
+ ## 2. 提交与 tag
21
+
22
+ | 项 | 值 |
23
+ |---|---|
24
+ | 发布提交 | `88098ef2f2015ae404133c5362deee6513177f34` |
25
+ | commit 标题 | `Release 2.0.1: 自我学习与自我迭代(阶段三复盘写入永久记忆,下次派发自动防再犯)` |
26
+ | tag | `v2.0.1`(annotated,tag 对象 `e3b8968a2f26e0145ebcb50d07a305c2b1201385`) |
27
+ | tag → 提交 | `git rev-list -n 1 v2.0.1` = `88098ef2f2015ae404133c5362deee6513177f34`(一致) |
28
+ | 远端 | `main` 已推送 `55b1f36..88098ef`;`git ls-remote --tags origin v2.0.1` 返回 `refs/tags/v2.0.1` |
29
+
30
+ 复核命令:
31
+
32
+ ```bash
33
+ cd plugins/dsh-workplan
34
+ git rev-parse HEAD
35
+ git rev-list -n 1 v2.0.1
36
+ git ls-remote --tags origin v2.0.1
37
+ ```
38
+
39
+ ## 3. 干净克隆门禁(tag 构建,不是本机脏树)
40
+
41
+ 在 `/tmp/dsh-workplan-release-2.0.1`(`git clone --depth 1 --branch v2.0.1`)执行:
42
+
43
+ | 命令 | 结果 |
44
+ |---|---|
45
+ | `npm ci` | 退出 0 |
46
+ | `npm run check` | 退出 0(`tsc -p tsconfig.json --noEmit`) |
47
+ | `npm test` | **tests 546 / pass 546 / fail 0**,退出 0(基线 536 + 新增自我学习 10) |
48
+ | `npm pack` | `dsh-workplan-2.0.1.tgz`,**1,082,830 B**,sha256 `89cb21cde1ee18452e4c75803c3a9300d2ee04889ba6f4de3505fb5251d58b99` |
49
+
50
+ 包清单 98 个文件;含 `lib/lessons.js`、`src/lessons.ts`、`docs/release-notes-2.0.1.md`;`*.orig` / `*.rej` / `*.tgz` 计数为 0。
51
+
52
+ ## 4. GitHub Release
53
+
54
+ - URL:https://github.com/abbaababa/dsh-workplan/releases/tag/v2.0.1
55
+ - 资产:`dsh-workplan-2.0.1.tgz`,state `uploaded`,**1,082,830 B**
56
+ - 资产 digest(GitHub API 返回):`sha256:89cb21cde1ee18452e4c75803c3a9300d2ee04889ba6f4de3505fb5251d58b99`(与本地 `shasum -a 256` 一致)
57
+
58
+ 复核命令:
59
+
60
+ ```bash
61
+ gh api repos/abbaababa/dsh-workplan/releases/tags/v2.0.1 \
62
+ --jq '.assets[] | {name, size, state, digest}'
63
+ ```
64
+
65
+ ## 5. npm 发布(含延迟与短暂 staged 状态的如实记录)
66
+
67
+ | 时间 | 动作 | 结果 |
68
+ |---|---|---|
69
+ | 13:23 | 在干净克隆执行 `npm publish` | 输出 `+ dsh-workplan@2.0.1` 和「being processed」,但 `npm view dsh-workplan version` 仍为 1.12.3 |
70
+ | 13:24 | 立即重试 `npm publish --loglevel=http` | `E409`:`Cannot publish over previously staged version "2.0.1"`(版本已进入注册表处理队列,不能重复投递) |
71
+ | 13:29 | 再次查询 | `npm view dsh-workplan dist-tags version` = `{ latest: '2.0.1' }` / `2.0.1`,正式生效 |
72
+
73
+ 结论:npm 12 的发布请求先进入注册表处理队列,`npm view` 有数分钟延迟;这**不是**失败,也**不需要**重复发布;同一版本二次投递会得到 E409。
74
+
75
+ 发布后安装冒烟(`/tmp/dsh-wp-install-2.0.1`):
76
+
77
+ ```bash
78
+ npm i dsh-workplan@2.0.1
79
+ node -e "const p=require('dsh-workplan/package.json');console.log(p.version)"
80
+ ```
81
+
82
+ 结果:`2.0.1`;`node_modules/dsh-workplan/lib/lessons.js` 存在;`lib/host.js` 含 `dsh_workplan_lessons`;`src/lessons.ts` 存在。
83
+
84
+ ## 6. 索引源(awesome-dsh-plugin)
85
+
86
+ | 项 | 值 |
87
+ |---|---|
88
+ | 仓库 | `awesome-dsh-plugin/awesome-dsh-plugin` |
89
+ | fork | `abbaababa/awesome-dsh-plugin`(已 merge-upstream 到上游 main) |
90
+ | 分支 | `bump-dsh-workplan-2.0.1` |
91
+ | 条目提交 | `aff9578b0ef442d324ade2a7000037f1d2083701` |
92
+ | PR | https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/12201 |
93
+ | 变更 | 仅 `data/plugins/abbaababa__dsh-workplan.yml`:`tarball` 指向 `v2.0.1` Release 资产,描述补自我学习闭环、三阶段与 11 个工具 |
94
+ | 校验 | 条目 YAML 通过 `js-yaml` 解析;`tarball` 为 GitHub Release 托管 URL;`package.json` 声明 `dsh.bundle` |
95
+
96
+ 索引条目为「一个插件一个文件」,不修改生成的 README,符合仓库贡献指南。
97
+
98
+ ## 7. 本次发布过程中遇到的两类问题与根因(自我复盘)
99
+
100
+ 1. **新增测试首次 2 条失败**:`self-learning.test.ts` 中 planning 证据合计不足 40 字,先触发「计划太薄」错误,导致失败阶段与期望不符。根因是 fixture 只满足结构、不满足长度下限。修正:把 `problemAnalysis` 与 `approach` 加长到阈值以上,重跑 546 全过。
101
+ 2. **npm 版本可见性延迟**:首次发布后 6 分钟内 `npm view` 仍显示旧版本,误以为发布失败,二次投递得到 E409。根因是注册表异步处理队列与本地查询缓存。修正:查询 `dist-tags` 与 `GET /dsh-workplan/2.0.1`(200)确认生效;不再重复投递。
102
+
103
+ 两条经验已写入本次复盘,对应「发布前先跑干净克隆门禁」「npm 发布后以 dist-tags + 版本 JSON 双证据确认,不重复投递」。
104
+
105
+ ## 8. 已知边界
106
+
107
+ - 本文件在 npm 2.0.1 发布完成之后补写并提交到仓库;npm 上的 2.0.1 tarball 是 13:23 构建的固化产物,不包含本文件。仓库与 GitHub Release 是权威来源,功能代码与测试不受影响。
108
+ - 证据契约在 2.0.1 变为「结果块必须带三阶段(含复盘)」;旧结果回放需显式传 `requirePhases: false`,已在 CHANGELOG「兼容边界」说明。
109
+
110
+ ## 9. 勘误(2.0.2,2026-11-05)
111
+
112
+ - 本记录把用户要求 4「第一、二阶段禁用 dsh-workplan 插件」当成了产品级永久规则;用户随后澄清:该条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的要求。
113
+ - 2.0.2 已更正提示词、`dsh_workplan_verify` 描述、运行时报错、README 与协作文档中的相关措辞;三阶段工作法与证据门禁保持不变。2.0.2 的完整证据见 `docs/release-record-2.0.2-20261105.md`。
@@ -0,0 +1,87 @@
1
+ # dsh-workplan 2.0.2 发布记录(可复核)
2
+
3
+ - 发布时间:2026-11-05 13:45–14:10(Asia/Shanghai)
4
+ - 版本:**2.0.2**(`package.json` / `package-lock.json` 两处 / `src/host.ts#meta.version` / CHANGELOG / README 两份安装命令,由 `tests/version-sync.test.ts` 断言一致)
5
+ - 主题:更正「第一、二阶段禁用 dsh-workplan 插件」的适用范围——只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久产品规则
6
+
7
+ ## 1. 为什么发 2.0.2
8
+
9
+ 用户在 2.0.1 发布后澄清:原要求 4「第一、二阶段禁用 dsh-workplan 插件」是**本次会话内**对优化过程的约束,不是要求插件对所有未来会话禁用。1.13.0 起该条被写成产品级规则(子 Agent 提示词、`dsh_workplan_verify` 描述、运行时报错、README、协作文档),属于对需求范围的误读;2.0.2 全面更正措辞与说明,三阶段契约与自我学习机制不变。
10
+
11
+ ## 2. 提交与 tag
12
+
13
+ | 项 | 值 |
14
+ |---|---|
15
+ | 发布提交 | `17707511cafe2a9772eb630d3d8ccce1c7a22ccd` |
16
+ | commit 标题 | `Release 2.0.2: 更正「第一、二阶段禁用插件」的适用范围(仅 2026-11-05 本次会话,非永久规则)` |
17
+ | tag | `v2.0.2`(annotated,tag 对象 `ae402a8441267983195257f35ecc30644a45d281`) |
18
+ | tag → 提交 | `git rev-list -n 1 v2.0.2` = `17707511cafe2a9772eb630d3d8ccce1c7a22ccd`(一致) |
19
+ | 远端 | `main` 已推送 `ccd362a..1770751`;`git ls-remote --tags origin v2.0.2` 返回 `refs/tags/v2.0.2` |
20
+
21
+ ## 3. 干净克隆门禁(tag 构建)
22
+
23
+ 在 `/tmp/dsh-workplan-release-2.0.2`(`git clone --depth 1 --branch v2.0.2`)执行:
24
+
25
+ | 命令 | 结果 |
26
+ |---|---|
27
+ | `npm ci` | 退出 0 |
28
+ | `npm run check` | 退出 0(`tsc -p tsconfig.json --noEmit`) |
29
+ | `npm test` | **tests 546 / pass 546 / fail 0**,退出 0 |
30
+ | `npm pack` | `dsh-workplan-2.0.2.tgz`,**1,088,610 B**,sha256 `5e9dcc26a0e1ed204073ac0a1bf9ebc71b43403a1cd50a9ef68925999020f7f2` |
31
+
32
+ 包清单 100 个文件;含 `lib/lessons.js`、`docs/release-notes-2.0.2.md`,`version` 为 2.0.2。
33
+
34
+ ## 4. GitHub Release
35
+
36
+ - URL:https://github.com/abbaababa/dsh-workplan/releases/tag/v2.0.2
37
+ - 资产:`dsh-workplan-2.0.2.tgz`,state `uploaded`,1,088,610 B
38
+ - 资产 digest(GitHub API 返回):`sha256:5e9dcc26a0e1ed204073ac0a1bf9ebc71b43403a1cd50a9ef68925999020f7f2`(与本地 `shasum -a 256` 一致)
39
+
40
+ ## 5. npm 发布
41
+
42
+ - 2026-11-05 14:02 在干净克隆执行 `npm publish`,输出 `+ dsh-workplan@2.0.2`;注册表提示进入处理队列。
43
+ - 复核口径:`npm view dsh-workplan dist-tags version` 与 `GET https://registry.npmjs.org/dsh-workplan/2.0.2` 双证据(2.0.1 的经验:处理需数分钟,期间重复投递会得到 E409)。
44
+ - 发布结果:**2026-11-05 14:08 注册表可见**——`npm view dsh-workplan dist-tags version` 返回 `{ latest: '2.0.2' }`,`GET https://registry.npmjs.org/dsh-workplan/2.0.2` 返回 200。
45
+ - 安装冒烟(npm 公开包):`/tmp/dsh-wp-install-2.0.2` 执行 `npm i dsh-workplan@2.0.2` 后核对——version 2.0.2、`lib/lessons.js` 存在、`lib/three-phase.js` 已不含「阶段一、二:dsh-workplan 插件禁用」、`PHASE_GATE` 与「缺少 planning / execution 证据时返回 PHASE_GATE」文案保留、注册工具 11 个。
46
+
47
+ ## 6. 索引源(awesome-dsh-plugin)
48
+
49
+ | 项 | 值 |
50
+ |---|---|
51
+ | PR | https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/12201 |
52
+ | 条目提交 | `377bb700b49b7eb447270132540ea02f77bc1555` |
53
+ | 分支 | `abbaababa:bump-dsh-workplan-2.0.1`(PR 内已更新为 2.0.2) |
54
+ | 变更 | `data/plugins/abbaababa__dsh-workplan.yml` 的 `tarball` 指向 `v2.0.2` Release 资产 |
55
+ | 校验 | 条目 YAML 通过 `js-yaml` 解析;`tarball` 为 GitHub Release 托管 URL;`package.json` 声明 `dsh.bundle` |
56
+
57
+ ## 7. 本次改了什么(可复核)
58
+
59
+ | 文件 | 变更 |
60
+ |---|---|
61
+ | `src/three-phase.ts` | 提示词删除「阶段一、二:dsh-workplan 插件禁用」,改为「阶段一、二写全证据;调用 verify 会因缺少前两阶段证据返回 PHASE_GATE(证据门禁,不是禁用插件)」;头部注释同步 |
62
+ | `src/host.ts` | `dsh_workplan_verify` 描述由「阶段一、二禁用本插件」改为「缺少 planning / execution 证据时返回 PHASE_GATE 与待补项」 |
63
+ | `src/runtime.ts` | `PHASE_GATE` 报错文案由「插件在阶段一、二禁用」改为「阶段三核验缺少前两阶段证据」 |
64
+ | `README.md` / `README.en.md` | 增加 2.0.2 更正说明:该约束仅适用于本次会话;主 Agent 任何阶段都可用计划/派发/查询/改判工具 |
65
+ | `docs/collaboration.md`、`docs/cc/AVA-VULNERABILITY-ANALYSIS.md` | 表格与措辞由「禁用」改为「证据门禁」,并加 2.0.2 更正说明 |
66
+ | `tests/three-phase.test.ts` | 断言提示词不再包含「插件禁用」;同时继续断言阶段三门禁与 `PHASE_GATE` |
67
+ | `CHANGELOG.md`、`docs/release-notes-2.0.2.md` | 新增 2.0.2 条目与发布说明;2.0.1 条目加勘误 |
68
+
69
+ ## 8. 未变的部分
70
+
71
+ - 三阶段「规划 → 执行 → 验证」仍是产品功能;完成判定仍要求 `phases` 齐全。
72
+ - `dsh_workplan_verify` 仍只接受三阶段齐全的证据;缺 planning/execution 仍返回 `PHASE_GATE`。
73
+ - 阶段三复盘与永久教训记忆机制完全不变;工具面仍是 11 个。
74
+
75
+ ## 9. 复核附录
76
+
77
+ ```bash
78
+ # 版本与 tag
79
+ cd plugins/dsh-workplan && git rev-parse HEAD && git rev-list -n 1 v2.0.2
80
+ # 干净克隆门禁
81
+ git clone --depth 1 --branch v2.0.2 git@github.com:abbaababa/dsh-workplan.git /tmp/dsh-workplan-release-2.0.2
82
+ cd /tmp/dsh-workplan-release-2.0.2 && npm ci && npm run check && npm test && npm pack
83
+ # 发布核对
84
+ npm view dsh-workplan dist-tags version
85
+ gh api repos/abbaababa/dsh-workplan/releases/tags/v2.0.2 --jq '.assets[] | {name, size, state, digest}'
86
+ gh pr view 12201 --repo awesome-dsh-plugin/awesome-dsh-plugin
87
+ ```
package/lib/host.js CHANGED
@@ -641,19 +641,19 @@ function createEscalateTool(runtime) {
641
641
  /**
642
642
  * [1.13.0] 阶段三(验证阶段)的插件核验工具(用户 2026-11-05)。
643
643
  *
644
- * 用户规则:部门 Agent 收到工作后必须先梳理问题、再形成可执行思路、最后
645
- * 执行与验证;第一、二阶段禁用 dsh-workplan 插件,第三阶段才可以用插件
646
- * 验证是否成功、是否完全满足要求。
644
+ * 三阶段工作法要求部门 Agent 先梳理问题、再形成可执行思路、最后执行与验证。
645
+ * 这个工具只做一件事:接收三阶段证据并给出核验结论。缺少 planning/execution
646
+ * 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,避免
647
+ * 跳过前两阶段直接宣称验证通过。
647
648
  *
648
- * 因此这个工具只做一件事:接收三阶段证据并给出核验结论。阶段一/二的调用
649
- * 会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝(缺 planning/execution
650
- * 证据),不会替子 Agent 跳过梳理与规划。
649
+ * 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用 dsh-workplan 插件」是
650
+ * 该次优化会话的过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
651
651
  */
652
652
  export function createVerifyTool(runtime) {
653
653
  return {
654
654
  name: 'dsh_workplan_verify',
655
655
  description: '部门子 Agent 在第三阶段(验证阶段)使用的插件核验:提交 planning / execution / verification 三阶段证据,'
656
- + '插件逐项核验并返回 passed 或仍需补齐的 gaps。阶段一、二禁用本插件,调用会返回 PHASE_GATE;'
656
+ + '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
657
657
  + '只有「问题梳理 + 可执行思路 + 实际执行步骤」齐全后,才会进入阶段三核验。'
658
658
  + '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按三阶段契约判定。',
659
659
  parameters: {
@@ -1363,7 +1363,7 @@ export function apply(ctx, config = {}) {
1363
1363
  }
1364
1364
  export const meta = {
1365
1365
  name,
1366
- version: '2.0.1',
1366
+ version: '2.0.3',
1367
1367
  promptOrder: PROMPT_ORDER,
1368
1368
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1369
1369
  };
package/lib/runtime.js CHANGED
@@ -184,6 +184,82 @@ function taskTextFromMessages(messages) {
184
184
  }
185
185
  return truncate(texts.join('\n\n'), 16000);
186
186
  }
187
+ /**
188
+ * [2.0.3] `source.kind === 'goal'` 的轮次也是用户的真实任务。
189
+ *
190
+ * 官方 DeepSeek Harness 的 `/goal <objective>` 命令不会产生 `user/message`:
191
+ * 目标文本由 goal-round-driver 以 `source.kind = 'goal'`、`round >= 1` 的
192
+ * 用户消息送达(见 `@deepseek-ai/dsh-goal-round-driver` 的
193
+ * `renderGoalRoundPrompt` / `createUserMessage`)。旧版 `humanMessages()` 只认
194
+ * `source.kind` 为 `user` 或省略的消息,于是 `/goal` 任务在整条 goal 生命周期
195
+ * 内都拿不到任务文本,`maybePlan()` 永远不会触发自动分解。
196
+ *
197
+ * 这里只认每个 goal 的第一轮(`round === 1`),并且只在该会话没有进行中的
198
+ * 计划时放行:
199
+ * - `round === 1` 是目标进入本会话的唯一入口,后续轮次是同一目标的续跑,
200
+ * 不能重复建计划;
201
+ * - 已存在进行中/未派发计划时返回 undefined,避免 goal 轮次与人工计划互相
202
+ * 取消或误记成「执行中新增需求」。
203
+ *
204
+ * 任务文本优先取 goal 领域服务的结构化 objective(干净文本),取不到时再从
205
+ * `<goal_round>` 信封里解析 JSON objective,最后才退回整条消息文本。
206
+ */
207
+ export function goalRoundPlanningTask(ctx, payload, existing) {
208
+ if (planRecordIsLive(existing))
209
+ return undefined;
210
+ const messages = Array.isArray(payload?.messages) ? payload.messages : [];
211
+ for (const message of messages) {
212
+ if (!message || message.role !== 'user')
213
+ continue;
214
+ const source = message.source ?? {};
215
+ if (source.kind !== 'goal')
216
+ continue;
217
+ if (Number(source.round) !== 1)
218
+ continue;
219
+ const raw = messageText(message).trim();
220
+ const text = goalObjectiveOf(ctx, payload.agent) || goalObjectiveFromText(raw) || raw;
221
+ if (!text)
222
+ continue;
223
+ return { text: truncate(text, 16000), goalId: String(source.goalId ?? ''), round: 1 };
224
+ }
225
+ return undefined;
226
+ }
227
+ /**
228
+ * Whether an existing plan record still owns work in this session.
229
+ *
230
+ * `isTerminalPhase()` 只覆盖 cancelled/superseded(present 门禁的语义);
231
+ * 对 goal 轮次的入口判定,done/ended/degraded/clarify 同样是「这一轮可以
232
+ * 开始新计划」的历史记录,不能把 `/goal` 任务永久挡在自动分解之外。
233
+ */
234
+ function planRecordIsLive(existing) {
235
+ if (!existing?.plan)
236
+ return false;
237
+ const phase = String(existing.phase ?? '');
238
+ return !['done', 'ended', 'cancelled', 'superseded', 'clarify', 'degraded'].includes(phase);
239
+ }
240
+ /** Read the structured objective of the current goal view, when the service exists. */
241
+ function goalObjectiveOf(ctx, agent) {
242
+ try {
243
+ const view = ctx?.get?.('goals')?.get?.(agent);
244
+ return typeof view?.objective === 'string' ? view.objective.trim() : '';
245
+ }
246
+ catch {
247
+ return '';
248
+ }
249
+ }
250
+ /** Parse `Objective: "<json string>"` out of the official `<goal_round>` envelope. */
251
+ export function goalObjectiveFromText(text) {
252
+ const match = /<goal_round>[\s\S]*?Objective:\s*("(?:[^"\\]|\\.)*")/.exec(String(text ?? ''));
253
+ if (!match)
254
+ return '';
255
+ try {
256
+ const value = JSON.parse(match[1]);
257
+ return typeof value === 'string' ? value.trim() : '';
258
+ }
259
+ catch {
260
+ return '';
261
+ }
262
+ }
187
263
  /*
188
264
  * Children start with zero parent context. Without recent turns they cannot
189
265
  * resolve "B", "it", "the previous item", so they search blindly and time out.
@@ -3993,11 +4069,11 @@ export function createWorkplanRuntime(ctx, options = {}) {
3993
4069
  /**
3994
4070
  * [1.13.0] 阶段三(验证阶段)的插件核验入口(用户 2026-11-05)。
3995
4071
  *
3996
- * 用户规则:第一、二阶段禁用 dsh-workplan 插件,第三阶段才可以用插件验证
3997
- * 是否成功、是否完全满足要求。这里的实现方式是「按提交内容判阶段」:
4072
+ * 「按提交内容判阶段」:
3998
4073
  * - 只有 planning + execution 证据齐全,才会进入阶段三核验;
3999
- * - 缺 planning/execution 的调用直接以 PHASE_GATE 拒绝,并说明插件在
4000
- * 阶段一、二禁用 —— 子 Agent 无法用插件跳过梳理与规划;
4074
+ * - 缺 planning/execution 的调用以 PHASE_GATE 拒绝并列出待补项 —— 这是一道
4075
+ * 证据门禁,不是对插件的全局禁用(「阶段一、二禁用插件」只是 2026-11-05
4076
+ * 当次优化会话的过程约束,2.0.2 起不再作为所有会话的产品规则);
4001
4077
  * - 阶段三核验会逐条检查:问题梳理/可执行思路是否有实质内容、执行步骤
4002
4078
  * 是否记录、验证是否全部通过、验证记录是否覆盖全部验收标准。
4003
4079
  *
@@ -4057,7 +4133,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
4057
4133
  subtaskId: row.subtaskId,
4058
4134
  gaps: check.errors,
4059
4135
  error: gate === 'phase-1-2'
4060
- ? `插件在阶段一、二禁用:先完成「梳理问题 → 形成可执行思路」并实际执行,阶段三才能用插件核验。${check.errors.slice(0, 5).join(';')}`
4136
+ ? `阶段三核验缺少前两阶段证据:先完成「梳理问题 → 形成可执行思路」并实际执行,再提交阶段三核验。${check.errors.slice(0, 5).join(';')}`
4061
4137
  : `阶段三核验未通过:${check.errors.slice(0, 5).join(';')}`,
4062
4138
  };
4063
4139
  }
@@ -5908,9 +5984,15 @@ async function maybePlan(ctx, state, payload, downstream, options) {
5908
5984
  return downstream;
5909
5985
  const planMode = isPlanModeActive(ctx, session);
5910
5986
  const human = humanMessages(payload.messages);
5911
- if (human.length === 0)
5987
+ const existing = state.records.get(session.id);
5988
+ /*
5989
+ * [2.0.3] `/goal` 任务没有 user/message,任务文本只以 `source.kind = 'goal'`
5990
+ * 的轮次消息出现。放宽入口,但只认第一轮且只在该会话没有进行中计划时放行。
5991
+ */
5992
+ const goalTask = human.length === 0 ? goalRoundPlanningTask(ctx, payload, existing) : undefined;
5993
+ if (human.length === 0 && goalTask === undefined)
5912
5994
  return downstream;
5913
- const taskText = taskTextFromMessages(payload.messages);
5995
+ const taskText = goalTask?.text ?? taskTextFromMessages(payload.messages);
5914
5996
  if (!taskText)
5915
5997
  return downstream;
5916
5998
  if (isSocialMessage(taskText))
@@ -5931,7 +6013,6 @@ async function maybePlan(ctx, state, payload, downstream, options) {
5931
6013
  state.activeTurns = new Map();
5932
6014
  state.activeTurns.set(session.id, Number(payload.turn ?? 0));
5933
6015
  const conversationContext = recentConversation(session);
5934
- const existing = state.records.get(session.id);
5935
6016
  if (existing?.plan?.createdTurn === payload.turn)
5936
6017
  return downstream;
5937
6018
  /*
@@ -6,7 +6,9 @@
6
6
  * 2. 再全面、深入思考,整理出能完美完成自身工作的完整、可执行思路;
7
7
  * 3. 只有前两步完成后,才按思路执行与验证。
8
8
  * 全过程按先后顺序分为三个阶段:规划阶段 → 执行阶段 → 验证阶段。
9
- * 第一、二阶段禁用 dsh-workplan 插件,第三阶段才允许用插件核验。
9
+ * 阶段三允许用 dsh_workplan_verify 核验;缺 planning/execution 证据时返回 PHASE_GATE。
10
+ * 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用插件」只是当次优化会话的
11
+ * 过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
10
12
  *
11
13
  * 这个模块只做纯函数与常量,不依赖 harness 服务:
12
14
  * - 校验子 Agent 回报的 `phases` 证据(缺一阶段就判未完成);
@@ -279,9 +281,9 @@ export function threePhasePromptLines() {
279
281
  ' 3) resolutions:最终是如何解决上述问题的,至少 1 条,可与 problems 一一对应;',
280
282
  ' 4) prevention:以后如何预防再犯,至少 1 条,必须写成「遇到…先…」的可执行硬规则。',
281
283
  ' 插件会在完成判定时复核这四项,并在通过后把复盘写入永久记忆文件;下次派发同类任务时,历史教训会自动出现在提示词里。',
282
- '插件使用规则(严格执行):',
283
- ' - 阶段一、二:dsh-workplan 插件禁用。不得调用任何 dsh_workplan_* 工具(派发、查询、改判、验证等一律不用);唯一例外是遇阻时的 dsh_workplan_escalate 安全上报通道,它不是计划/执行/验证能力。',
284
- ' - 阶段三:可以调用 dsh_workplan_verify 让插件做最终核验:提交 planning / execution / verification 三阶段证据,插件返回 passed 或仍需补齐的 gaps;未通过先修复再回报。',
284
+ '插件使用说明(三阶段证据门禁):',
285
+ ' - 阶段一、二:先把问题梳理、可执行思路与执行记录写全;此时不要调用 dsh_workplan_verify,它会因缺少前两阶段证据返回 PHASE_GATE 与待补项(这是证据门禁,不是禁用插件)。',
286
+ ' - 阶段三:可以调用 dsh_workplan_verify 让插件做最终核验:提交 planning / execution / verification 三阶段证据,插件返回 passed 或仍需补齐的 gaps;未通过先修复再回报。遇阻时可用 dsh_workplan_escalate 上报,它是安全通道,不属于三阶段产物。',
285
287
  ' - 结果块里的 phases 是必填项:缺任一阶段、内容为空、或验证未全部通过,插件都会判为未完成,不能用 done 收尾。',
286
288
  ];
287
289
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-workplan",
3
- "version": "2.0.1",
3
+ "version": "2.0.3",
4
4
  "description": "Automatic task decomposition, real department subagents, and a responsive workplan dashboard for DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/src/host.ts CHANGED
@@ -722,20 +722,20 @@ function createEscalateTool(runtime: any) {
722
722
  /**
723
723
  * [1.13.0] 阶段三(验证阶段)的插件核验工具(用户 2026-11-05)。
724
724
  *
725
- * 用户规则:部门 Agent 收到工作后必须先梳理问题、再形成可执行思路、最后
726
- * 执行与验证;第一、二阶段禁用 dsh-workplan 插件,第三阶段才可以用插件
727
- * 验证是否成功、是否完全满足要求。
725
+ * 三阶段工作法要求部门 Agent 先梳理问题、再形成可执行思路、最后执行与验证。
726
+ * 这个工具只做一件事:接收三阶段证据并给出核验结论。缺少 planning/execution
727
+ * 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,避免
728
+ * 跳过前两阶段直接宣称验证通过。
728
729
  *
729
- * 因此这个工具只做一件事:接收三阶段证据并给出核验结论。阶段一/二的调用
730
- * 会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝(缺 planning/execution
731
- * 证据),不会替子 Agent 跳过梳理与规划。
730
+ * 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用 dsh-workplan 插件」是
731
+ * 该次优化会话的过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
732
732
  */
733
733
  export function createVerifyTool(runtime: any) {
734
734
  return {
735
735
  name: 'dsh_workplan_verify',
736
736
  description:
737
737
  '部门子 Agent 在第三阶段(验证阶段)使用的插件核验:提交 planning / execution / verification 三阶段证据,'
738
- + '插件逐项核验并返回 passed 或仍需补齐的 gaps。阶段一、二禁用本插件,调用会返回 PHASE_GATE;'
738
+ + '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
739
739
  + '只有「问题梳理 + 可执行思路 + 实际执行步骤」齐全后,才会进入阶段三核验。'
740
740
  + '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按三阶段契约判定。',
741
741
  parameters: {
@@ -1490,7 +1490,7 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1490
1490
 
1491
1491
  export const meta = {
1492
1492
  name,
1493
- version: '2.0.1',
1493
+ version: '2.0.3',
1494
1494
  promptOrder: PROMPT_ORDER,
1495
1495
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1496
1496
  }
package/src/runtime.ts CHANGED
@@ -259,6 +259,77 @@ function taskTextFromMessages(messages: any) {
259
259
  return truncate(texts.join('\n\n'), 16000)
260
260
  }
261
261
 
262
+ /**
263
+ * [2.0.3] `source.kind === 'goal'` 的轮次也是用户的真实任务。
264
+ *
265
+ * 官方 DeepSeek Harness 的 `/goal <objective>` 命令不会产生 `user/message`:
266
+ * 目标文本由 goal-round-driver 以 `source.kind = 'goal'`、`round >= 1` 的
267
+ * 用户消息送达(见 `@deepseek-ai/dsh-goal-round-driver` 的
268
+ * `renderGoalRoundPrompt` / `createUserMessage`)。旧版 `humanMessages()` 只认
269
+ * `source.kind` 为 `user` 或省略的消息,于是 `/goal` 任务在整条 goal 生命周期
270
+ * 内都拿不到任务文本,`maybePlan()` 永远不会触发自动分解。
271
+ *
272
+ * 这里只认每个 goal 的第一轮(`round === 1`),并且只在该会话没有进行中的
273
+ * 计划时放行:
274
+ * - `round === 1` 是目标进入本会话的唯一入口,后续轮次是同一目标的续跑,
275
+ * 不能重复建计划;
276
+ * - 已存在进行中/未派发计划时返回 undefined,避免 goal 轮次与人工计划互相
277
+ * 取消或误记成「执行中新增需求」。
278
+ *
279
+ * 任务文本优先取 goal 领域服务的结构化 objective(干净文本),取不到时再从
280
+ * `<goal_round>` 信封里解析 JSON objective,最后才退回整条消息文本。
281
+ */
282
+ export function goalRoundPlanningTask(ctx: any, payload: any, existing: any) {
283
+ if (planRecordIsLive(existing)) return undefined
284
+ const messages = Array.isArray(payload?.messages) ? payload.messages : []
285
+ for (const message of messages) {
286
+ if (!message || message.role !== 'user') continue
287
+ const source = message.source ?? {}
288
+ if (source.kind !== 'goal') continue
289
+ if (Number(source.round) !== 1) continue
290
+ const raw = messageText(message).trim()
291
+ const text = goalObjectiveOf(ctx, payload.agent) || goalObjectiveFromText(raw) || raw
292
+ if (!text) continue
293
+ return { text: truncate(text, 16000), goalId: String(source.goalId ?? ''), round: 1 }
294
+ }
295
+ return undefined
296
+ }
297
+
298
+ /**
299
+ * Whether an existing plan record still owns work in this session.
300
+ *
301
+ * `isTerminalPhase()` 只覆盖 cancelled/superseded(present 门禁的语义);
302
+ * 对 goal 轮次的入口判定,done/ended/degraded/clarify 同样是「这一轮可以
303
+ * 开始新计划」的历史记录,不能把 `/goal` 任务永久挡在自动分解之外。
304
+ */
305
+ function planRecordIsLive(existing: any) {
306
+ if (!existing?.plan) return false
307
+ const phase = String(existing.phase ?? '')
308
+ return !['done', 'ended', 'cancelled', 'superseded', 'clarify', 'degraded'].includes(phase)
309
+ }
310
+
311
+ /** Read the structured objective of the current goal view, when the service exists. */
312
+ function goalObjectiveOf(ctx: any, agent: any) {
313
+ try {
314
+ const view = ctx?.get?.('goals')?.get?.(agent)
315
+ return typeof view?.objective === 'string' ? view.objective.trim() : ''
316
+ } catch {
317
+ return ''
318
+ }
319
+ }
320
+
321
+ /** Parse `Objective: "<json string>"` out of the official `<goal_round>` envelope. */
322
+ export function goalObjectiveFromText(text: any) {
323
+ const match = /<goal_round>[\s\S]*?Objective:\s*("(?:[^"\\]|\\.)*")/.exec(String(text ?? ''))
324
+ if (!match) return ''
325
+ try {
326
+ const value = JSON.parse(match[1] as string)
327
+ return typeof value === 'string' ? value.trim() : ''
328
+ } catch {
329
+ return ''
330
+ }
331
+ }
332
+
262
333
  /*
263
334
  * Children start with zero parent context. Without recent turns they cannot
264
335
  * resolve "B", "it", "the previous item", so they search blindly and time out.
@@ -4103,11 +4174,11 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
4103
4174
  /**
4104
4175
  * [1.13.0] 阶段三(验证阶段)的插件核验入口(用户 2026-11-05)。
4105
4176
  *
4106
- * 用户规则:第一、二阶段禁用 dsh-workplan 插件,第三阶段才可以用插件验证
4107
- * 是否成功、是否完全满足要求。这里的实现方式是「按提交内容判阶段」:
4177
+ * 「按提交内容判阶段」:
4108
4178
  * - 只有 planning + execution 证据齐全,才会进入阶段三核验;
4109
- * - 缺 planning/execution 的调用直接以 PHASE_GATE 拒绝,并说明插件在
4110
- * 阶段一、二禁用 —— 子 Agent 无法用插件跳过梳理与规划;
4179
+ * - 缺 planning/execution 的调用以 PHASE_GATE 拒绝并列出待补项 —— 这是一道
4180
+ * 证据门禁,不是对插件的全局禁用(「阶段一、二禁用插件」只是 2026-11-05
4181
+ * 当次优化会话的过程约束,2.0.2 起不再作为所有会话的产品规则);
4111
4182
  * - 阶段三核验会逐条检查:问题梳理/可执行思路是否有实质内容、执行步骤
4112
4183
  * 是否记录、验证是否全部通过、验证记录是否覆盖全部验收标准。
4113
4184
  *
@@ -4166,7 +4237,7 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
4166
4237
  subtaskId: row.subtaskId,
4167
4238
  gaps: check.errors,
4168
4239
  error: gate === 'phase-1-2'
4169
- ? `插件在阶段一、二禁用:先完成「梳理问题 → 形成可执行思路」并实际执行,阶段三才能用插件核验。${check.errors.slice(0, 5).join(';')}`
4240
+ ? `阶段三核验缺少前两阶段证据:先完成「梳理问题 → 形成可执行思路」并实际执行,再提交阶段三核验。${check.errors.slice(0, 5).join(';')}`
4170
4241
  : `阶段三核验未通过:${check.errors.slice(0, 5).join(';')}`,
4171
4242
  }
4172
4243
  }
@@ -5946,8 +6017,14 @@ async function maybePlan(ctx: any, state: any, payload: any, downstream: any, op
5946
6017
  if (payload.step !== 1) return downstream
5947
6018
  const planMode = isPlanModeActive(ctx, session)
5948
6019
  const human = humanMessages(payload.messages)
5949
- if (human.length === 0) return downstream
5950
- const taskText = taskTextFromMessages(payload.messages)
6020
+ const existing = state.records.get(session.id)
6021
+ /*
6022
+ * [2.0.3] `/goal` 任务没有 user/message,任务文本只以 `source.kind = 'goal'`
6023
+ * 的轮次消息出现。放宽入口,但只认第一轮且只在该会话没有进行中计划时放行。
6024
+ */
6025
+ const goalTask = human.length === 0 ? goalRoundPlanningTask(ctx, payload, existing) : undefined
6026
+ if (human.length === 0 && goalTask === undefined) return downstream
6027
+ const taskText = goalTask?.text ?? taskTextFromMessages(payload.messages)
5951
6028
  if (!taskText) return downstream
5952
6029
  if (isSocialMessage(taskText)) return downstream
5953
6030
  if (isVagueContinuation(taskText)) return downstream
@@ -5963,7 +6040,6 @@ async function maybePlan(ctx: any, state: any, payload: any, downstream: any, op
5963
6040
  if (!state.activeTurns) state.activeTurns = new Map()
5964
6041
  state.activeTurns.set(session.id, Number(payload.turn ?? 0))
5965
6042
  const conversationContext = recentConversation(session)
5966
- const existing = state.records.get(session.id)
5967
6043
  if (existing?.plan?.createdTurn === payload.turn) return downstream
5968
6044
  /*
5969
6045
  * [1.11.0] 执行中记录的变更,在本轮结束后仍然没有被 replan 落实时,必须
@@ -6,7 +6,9 @@
6
6
  * 2. 再全面、深入思考,整理出能完美完成自身工作的完整、可执行思路;
7
7
  * 3. 只有前两步完成后,才按思路执行与验证。
8
8
  * 全过程按先后顺序分为三个阶段:规划阶段 → 执行阶段 → 验证阶段。
9
- * 第一、二阶段禁用 dsh-workplan 插件,第三阶段才允许用插件核验。
9
+ * 阶段三允许用 dsh_workplan_verify 核验;缺 planning/execution 证据时返回 PHASE_GATE。
10
+ * 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用插件」只是当次优化会话的
11
+ * 过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
10
12
  *
11
13
  * 这个模块只做纯函数与常量,不依赖 harness 服务:
12
14
  * - 校验子 Agent 回报的 `phases` 证据(缺一阶段就判未完成);
@@ -334,9 +336,9 @@ export function threePhasePromptLines(): string[] {
334
336
  ' 3) resolutions:最终是如何解决上述问题的,至少 1 条,可与 problems 一一对应;',
335
337
  ' 4) prevention:以后如何预防再犯,至少 1 条,必须写成「遇到…先…」的可执行硬规则。',
336
338
  ' 插件会在完成判定时复核这四项,并在通过后把复盘写入永久记忆文件;下次派发同类任务时,历史教训会自动出现在提示词里。',
337
- '插件使用规则(严格执行):',
338
- ' - 阶段一、二:dsh-workplan 插件禁用。不得调用任何 dsh_workplan_* 工具(派发、查询、改判、验证等一律不用);唯一例外是遇阻时的 dsh_workplan_escalate 安全上报通道,它不是计划/执行/验证能力。',
339
- ' - 阶段三:可以调用 dsh_workplan_verify 让插件做最终核验:提交 planning / execution / verification 三阶段证据,插件返回 passed 或仍需补齐的 gaps;未通过先修复再回报。',
339
+ '插件使用说明(三阶段证据门禁):',
340
+ ' - 阶段一、二:先把问题梳理、可执行思路与执行记录写全;此时不要调用 dsh_workplan_verify,它会因缺少前两阶段证据返回 PHASE_GATE 与待补项(这是证据门禁,不是禁用插件)。',
341
+ ' - 阶段三:可以调用 dsh_workplan_verify 让插件做最终核验:提交 planning / execution / verification 三阶段证据,插件返回 passed 或仍需补齐的 gaps;未通过先修复再回报。遇阻时可用 dsh_workplan_escalate 上报,它是安全通道,不属于三阶段产物。',
340
342
  ' - 结果块里的 phases 是必填项:缺任一阶段、内容为空、或验证未全部通过,插件都会判为未完成,不能用 done 收尾。',
341
343
  ]
342
344
  }