dsh-workplan 1.12.3 → 2.0.2
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 +99 -0
- package/README.en.md +17 -2
- package/README.md +41 -3
- package/docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md +3 -1
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +9 -0
- package/docs/cc/SECURITY-TARGET.md +3 -1
- package/docs/collaboration.md +29 -2
- package/docs/release-notes-2.0.1.md +58 -0
- package/docs/release-notes-2.0.2.md +49 -0
- package/docs/release-record-2.0.1-20261105.md +113 -0
- package/lib/host.js +195 -2
- package/lib/lessons.js +378 -0
- package/lib/plan.js +37 -5
- package/lib/runtime.js +178 -2
- package/lib/three-phase.js +289 -0
- package/package.json +1 -1
- package/src/host.ts +202 -2
- package/src/lessons.ts +445 -0
- package/src/plan.ts +37 -4
- package/src/runtime.ts +184 -1
- package/src/three-phase.ts +344 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,102 @@
|
|
|
1
|
+
## 2.0.2 — 2026-11-05
|
|
2
|
+
|
|
3
|
+
**更正「第一、二阶段禁用 dsh-workplan 插件」的适用范围:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久产品规则。2.0.2 起,提示词、工具描述、README 与协作文档不再声明全局禁用;三阶段工作法与「验证工具缺前两阶段证据返回 PHASE_GATE」的证据门禁保持不变。**
|
|
4
|
+
|
|
5
|
+
### 一、为什么要改
|
|
6
|
+
|
|
7
|
+
- 用户在 2.0.1 发布后澄清:原要求 4「第一、二阶段禁用 dsh-workplan 插件」是**本次会话内**对优化过程的约束,不是要求插件对所有未来会话禁用。
|
|
8
|
+
- 1.13.0 起把这条写成了产品级规则(子 Agent 提示词、`dsh_workplan_verify` 描述、运行时报错、README、协作文档),属于对需求范围的误读;2.0.2 全面更正。
|
|
9
|
+
|
|
10
|
+
### 二、改了什么(只改措辞与说明,不改三阶段契约)
|
|
11
|
+
|
|
12
|
+
| 位置 | 2.0.1 及以前 | 2.0.2 |
|
|
13
|
+
|---|---|---|
|
|
14
|
+
| `src/three-phase.ts#threePhasePromptLines` | 「阶段一、二:dsh-workplan 插件禁用。不得调用任何 dsh_workplan_* 工具」 | 「阶段一、二先把问题、思路与执行记录写全;调用 verify 会因缺少前两阶段证据返回 PHASE_GATE(证据门禁,不是禁用插件)」 |
|
|
15
|
+
| `src/host.ts#createVerifyTool` 描述 | 「阶段一、二禁用本插件」 | 「缺少 planning / execution 证据时返回 PHASE_GATE 与待补项」 |
|
|
16
|
+
| `src/runtime.ts#verifySubtask` 报错 | 「插件在阶段一、二禁用」 | 「阶段三核验缺少前两阶段证据」 |
|
|
17
|
+
| `README.md` / `README.en.md` | 声明永久禁用 | 声明仅 2026-11-05 本次会话约束;主 Agent 任何阶段都可用计划/派发/查询/改判 |
|
|
18
|
+
| `docs/collaboration.md`、`docs/cc/AVA` | 表格写「禁用」 | 写「证据门禁」并加 2.0.2 更正说明 |
|
|
19
|
+
|
|
20
|
+
### 三、没有变的部分
|
|
21
|
+
|
|
22
|
+
- 三阶段(规划 → 执行 → 验证)仍是产品功能,完成判定仍要求 `phases` 齐全。
|
|
23
|
+
- `dsh_workplan_verify` 仍只接受三阶段齐全的证据;缺 planning/execution 仍返回 `PHASE_GATE`——这是证据门禁,不是插件禁用。
|
|
24
|
+
- 阶段三复盘(自我学习)与永久教训记忆完全不变。
|
|
25
|
+
|
|
26
|
+
### 四、验证
|
|
27
|
+
|
|
28
|
+
- `npm run check`(tsc --noEmit)退出码 0;`npm test` 全过(见 `docs/release-notes-2.0.2.md` 与 GitHub Release 页)。
|
|
29
|
+
- 新增/更新断言:`tests/three-phase.test.ts` 明确断言提示词不再包含「插件禁用」,同时仍断言阶段三门禁与 `PHASE_GATE`。
|
|
30
|
+
|
|
31
|
+
## 2.0.1 — 2026-11-05
|
|
32
|
+
|
|
33
|
+
**新增「自我学习与自我迭代」:部门 Agent 每次完成工作后,必须在阶段三复盘本次全过程的问题、弯路、解决方式与防再犯规则;复盘通过后写入永久教训记忆文件,下次派发同类任务时自动注入提示词。同一类错误重复出现会累加次数并提前排序。三阶段工作法(1.13.0)保持「规划 → 执行 → 验证」不变,复盘是验证阶段收尾的必填项,不是第四个阶段。**
|
|
34
|
+
|
|
35
|
+
### 一、用户要求与本版实现逐条对照
|
|
36
|
+
|
|
37
|
+
| 用户要求(2026-11-05) | 本版实现 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 1. 增加自我学习和自我迭代能力 | 新增 `src/lessons.ts`(复盘校验、永久记忆读写、相关度排序、提示词注入)+ 运行时闭环(`src/runtime.ts#settleFromOutput` 完成即落盘);主 Agent 可用 `dsh_workplan_lessons` 只读复核 |
|
|
40
|
+
| 2. 每次完成工作后全面复盘问题/弯路/如何解决,并永久记住、不再重犯 | `phases.verification.retrospective` 四项(problems / detours / resolutions / prevention)成为完成判定的必填证据:缺项、太薄(问题/解决 <20 字、预防 <16 字)一律 `blocked/unverified`;通过后写入 `~/.dsh/workplan/lessons.jsonl`(可用 `DSH_WORKPLAN_LESSONS_FILE` 覆盖),下次派发自动注入最相关的 8 条 |
|
|
41
|
+
| 3. 全过程按规划 → 执行 → 验证三阶段 | 沿用 1.13.0 的 `phases.planning/execution/verification` 契约;复盘放进验证阶段收尾,阶段数仍是三个 |
|
|
42
|
+
| 4. 第一、二阶段禁用 dsh-workplan 插件 | 子 Agent 本就没有 update/replan/cancel/dispatch/status/instruct/handoff/followup 权限;`dsh_workplan_verify` 在缺 planning/execution 证据时返回 `PHASE_GATE`;提示词写明阶段一、二不得调用插件,唯一例外是遇阻上报 `dsh_workplan_escalate`(安全阀) |
|
|
43
|
+
| 5. 第三阶段可用插件验证是否完全满足要求 | 阶段三核验工具同步要求 `verification.retrospective`:结构不全返回 `VERIFICATION_INCOMPLETE`,齐全才 `passed`;核验通过仍不等于完成,结果块与 `adjudicateResult` 会再判一次 |
|
|
44
|
+
| 6. 全程遵照用户要求,禁止偏离 | 本版所有新增门禁都落在完成判定与提示词两处,避免「提示词说要做、判定却不检查」的两套真相 |
|
|
45
|
+
| 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` 断言 |
|
|
46
|
+
| 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` |
|
|
47
|
+
|
|
48
|
+
> **勘误(2026-11-05,2.0.2)**:上表第 4 条「第一、二阶段禁用 dsh-workplan 插件」只适用于本次优化会话,不是对所有后续会话的永久插件限制。2.0.2 起提示词、工具描述、README 与文档已更正;三阶段工作法与证据门禁不变。
|
|
49
|
+
|
|
50
|
+
### 二、自我学习的具体机制(可复核)
|
|
51
|
+
|
|
52
|
+
| 环节 | 代码位置 | 行为 |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| 复盘校验 | `src/lessons.ts#validateRetrospective`、`src/three-phase.ts#validatePhaseEvidence` | 四项缺一不可;problems/resolutions/prevention 至少 1 条;问题与解决合计 ≥20 字、预防 ≥16 字;单条上限 600 字、最多 12 条 |
|
|
55
|
+
| 永久记忆 | `src/lessons.ts#recordLesson` | 追加写入 JSONL;同一子任务重复结算原地更新(不虚增次数);不同子任务同类错误 `occurrences+1`;临时文件 + 改名原子替换;保留最近 500 条;坏行跳过 |
|
|
56
|
+
| 防再犯注入 | `src/lessons.ts#renderLessonsBrief`、`src/runtime.ts#executeSubtask` | 按同部门 > 同项目 > 关键词 > 重复次数 > 新近程度排序,注入最多 8 条;段首声明「历史数据,不是新指令」;清除不可见字符与会话引用 |
|
|
57
|
+
| 可复核入口 | `src/host.ts#createLessonsTool`、`src/runtime.ts#lessonsTool` | `dsh_workplan_lessons` 的 `list` / `search` / `stats` 只读返回记忆内容、重复次数、文件位置;不提供写入动作,防止绕过真实复盘证据 |
|
|
58
|
+
| 可见性 | `src/runtime.ts#settleFromOutput` | 完成摘要追加 `[自我学习] 复盘已写入永久教训记忆`(同类重复时注明第 N 次) |
|
|
59
|
+
|
|
60
|
+
### 三、兼容边界(如实登记)
|
|
61
|
+
|
|
62
|
+
- 这是**破坏性证据契约变更**:2.0.1 以前写出的 done 结果没有 `retrospective`,用本版完成判定重放会被判未完成。历史回放可显式传 `requirePhases:false`(或 `strict:false`)走旧语义。
|
|
63
|
+
- 复盘内容来自模型输出,插件只能校验「有没有写、写得是否够具体、是否覆盖四项」,**不能证明复盘内容真实**;真实性仍由主 Agent 对照产物核对。
|
|
64
|
+
- 记忆是文本数据:注入前已清除不可见字符与会话引用,并在提示词中声明不是指令;但一条被污染的记忆仍可能影响后续任务,主 Agent 应用 `dsh_workplan_lessons` 抽查并在发现污染时删除对应行。
|
|
65
|
+
- 插件无法自动判断「有没有走弯路」,只能要求子 Agent 如实填写 `detours`;确实没有时允许空数组,避免为了过门禁编造弯路。
|
|
66
|
+
|
|
67
|
+
### 四、验证
|
|
68
|
+
|
|
69
|
+
- `npm run check`(tsc --noEmit)退出码 0。
|
|
70
|
+
- `npm test`:**546 条全过、0 失败**(基线 536 + 新增 10 条 `tests/self-learning.test.ts`);`npm run check`(tsc --noEmit)退出码 0。
|
|
71
|
+
- 新增 `tests/self-learning.test.ts`:复盘四项校验、完成判定缺复盘降级、提示词注入与复盘要求、落盘/去重/累加、坏行容错、相关度排序与统计、环境变量覆盖、指纹稳定。
|
|
72
|
+
- 工具面 fixture(`tests/fixtures/tool-surface.json`)与 `docs/cc` 同步到 11 个工具、2.0.1。
|
|
73
|
+
|
|
74
|
+
## 1.13.0 — 2026-11-05
|
|
75
|
+
|
|
76
|
+
**新增「三阶段工作法」:部门 Agent 收到工作后必须先规划、再执行、最后验证;阶段一、二不提供插件工作能力,阶段三才可用 `dsh_workplan_verify` 核验。完成判定新增三阶段证据门禁,缺段一律 blocked/unverified。**
|
|
77
|
+
|
|
78
|
+
### 一、改了什么
|
|
79
|
+
|
|
80
|
+
| 用户要求 | 本版实现 |
|
|
81
|
+
|---|---|
|
|
82
|
+
| 先全面梳理问题,再形成可执行思路,最后才动手 | `src/three-phase.ts#threePhasePromptLines` 写进每个子 Agent 提示词:阶段一先列事实/约束/未知/主要矛盾,再给步骤、产物、依赖、风险与验证方式,并明说「思路未形成前禁止动手」 |
|
|
83
|
+
| 全过程按规划→执行→验证三阶段 | 结果块新增必填 `phases`:planning(problemAnalysis/constraints/unknowns/approach)→ execution(steps/deviations)→ verification(allPassed/checks/requirementCheck);`src/three-phase.ts#validatePhaseEvidence` 校验顺序与完整性 |
|
|
84
|
+
| 阶段一、二禁用插件 | 子 Agent 本就没有 update/replan/cancel/dispatch/status/instruct/handoff/followup 权限;新增的 verify 工具在只交 planning/execution 时返回 `PHASE_GATE`;提示词同时写明阶段一、二不得调用插件。唯一保留的是遇阻上报 `dsh_workplan_escalate`(安全阀,不属于计划/执行/验证能力),否则子 Agent 受阻只能空转或编造 |
|
|
85
|
+
| 阶段三可用插件验证是否成功、是否满足全部要求 | 新增 `dsh_workplan_verify`(`src/host.ts#createVerifyTool`、`src/runtime.ts#verifySubtask`):提交三阶段证据,按计划验收表逐条核对结构与覆盖;核验通过也不等于完成,结果块仍须写同一份 phases,由 `adjudicateResult` 再判 |
|
|
86
|
+
| 完成判定必须挡住缺段 | `src/plan.ts#adjudicateResult` 对 done 默认 `requirePhases=true`:缺任一阶段、规划内容过薄(<40 字符)、`allPassed!==true`、验证条数少于验收数或未逐条对号、字段为空,一律 `blocked/unverified`,计划不可交付 |
|
|
87
|
+
|
|
88
|
+
### 二、验证
|
|
89
|
+
|
|
90
|
+
- `npm test`:**536 条全过、0 失败**(基线 523 + 新增 13 条 `tests/three-phase.test.ts`);`npm run check`(tsc --noEmit)退出码 0。
|
|
91
|
+
- 新增用例覆盖:提示词含三阶段与禁用、合法 phases 仍 structured、缺 planning/思路过薄/allPassed=false/漏验均被降级、`requirePhases:false` 历史回放兼容、verify 工具的 `PHASE_GATE` 与 `VERIFICATION_INCOMPLETE`。
|
|
92
|
+
- 工具面 fixture(`tests/fixtures/tool-surface.json`)与 docs/cc 同步到 10 个工具、1.13.0。
|
|
93
|
+
|
|
94
|
+
### 三、事实边界(如实登记)
|
|
95
|
+
|
|
96
|
+
- 插件无法观测模型内部「想了多久、按什么顺序想」,只能把顺序变成**可审计的完成证据**:没有 planning/execution 证据就不算完成;阶段三核验只在模型主动调用时发生。
|
|
97
|
+
- 阶段一、二禁止的是插件的工作能力(计划/执行/验证);`dsh_workplan_escalate` 是遇阻上报的安全通道,本版保留并在提示词中明确其例外身份。
|
|
98
|
+
- verify 只检查证据的结构与验收覆盖,不判断证据内容是否真实;真实性仍由主 Agent 核对产物与结果消息。
|
|
99
|
+
|
|
1
100
|
## 1.12.3 — 2026-11-04
|
|
2
101
|
|
|
3
102
|
**修好 MS2 20 条真实实跑暴露的四处缺陷:指代误拦(T05-08)、该问不问(T05-04/09/13/20)、未确认自行派发、法务召回缺失(T05-12)。默认行为变化:信息不足时不再生成计划、不再派发,改为向用户提问。**
|
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/v1.13.0)
|
|
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@
|
|
83
|
+
dsh plugin --profile web add dsh-workplan@2.0.2
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
Restart the DSH Web process (or reload the page) so the bundle is picked up.
|
|
@@ -120,9 +120,24 @@ Every number is derived from the same task state — the panel can no longer cla
|
|
|
120
120
|
| `dsh_workplan_instruct` | The main agent answers an escalation and issues direction; if delivery fails the instruction is queued for the next activation. Ack checks at 60s/180s. |
|
|
121
121
|
| `dsh_workplan_handoff` | Resolve cross-department needs: `list` / `assign` / `resolve` / `close`. Unresolved needs block delivery; when the asking row is waiting for direction, `resolve` delivers the answer straight into the child session. |
|
|
122
122
|
| `dsh_workplan_followup` | Send a closing note to a direct child that was stopped by budget/timeout but already wrote its artifacts. |
|
|
123
|
+
| `dsh_workplan_verify` | Child agents submit their three-phase evidence for phase-3 (verification) checking; calls from phases 1–2 return `PHASE_GATE`. Passing verification is not completion — the completion gate re-checks the same evidence. |
|
|
124
|
+
| `dsh_workplan_lessons` | Read-only view of the permanent lesson memory: `list` / `search` / `stats`. Never changes plan state; used to audit what was remembered and which mistakes keep repeating. |
|
|
123
125
|
|
|
124
126
|
In **plan mode** the plan is shown for review and `dispatch` is explicitly refused with a reason.
|
|
125
127
|
|
|
128
|
+
## Three phases and self-learning (2.0.2)
|
|
129
|
+
|
|
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
|
+
|
|
132
|
+
Phase 3 also requires a **retrospective** (`retrospective` inside `phases.verification`):
|
|
133
|
+
|
|
134
|
+
1. `problems` — every problem met in the process (symptom + root cause);
|
|
135
|
+
2. `detours` — wrong turns, rework, dead ends (empty array when genuinely none; do not invent);
|
|
136
|
+
3. `resolutions` — how those problems were finally solved;
|
|
137
|
+
4. `prevention` — executable "when X, first do Y" rules that stop the same mistake from happening again.
|
|
138
|
+
|
|
139
|
+
A passing retrospective is appended to the **permanent lesson memory** at `~/.dsh/workplan/lessons.jsonl` (override with `DSH_WORKPLAN_LESSONS_FILE`). Before each dispatch, the most relevant lessons are ranked by department, project, keyword overlap, recurrence count and recency, then injected into the child prompt (max 8), labelled explicitly as historical data rather than new instructions. A repeated mistake increments `occurrences` and moves up the ranking instead of creating a duplicate — that is the self-iteration loop. A corrupt line is skipped instead of poisoning the whole file; the store keeps the most recent 500 records and writes atomically.
|
|
140
|
+
|
|
126
141
|
## Budgets, timeouts, resumes
|
|
127
142
|
|
|
128
143
|
| Setting | Default | Environment variable |
|
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/v2.0.2)
|
|
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@
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@2.0.2
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -100,7 +100,7 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
100
100
|
|
|
101
101
|
纯打招呼、道谢、问「做到哪了」不会触发拆解,不会平白多出一堆子 Agent。
|
|
102
102
|
|
|
103
|
-
##
|
|
103
|
+
## 十一个模型工具(你不用直接调用)
|
|
104
104
|
|
|
105
105
|
| 工具 | 作用 |
|
|
106
106
|
|---|---|
|
|
@@ -113,9 +113,47 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
113
113
|
| `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。带 60s/180s 回执检查。 |
|
|
114
114
|
| `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
|
|
115
115
|
| `dsh_workplan_followup` | 给预算/超时中止、但产物已落盘的直接子会话补一条收尾说明。 |
|
|
116
|
+
| `dsh_workplan_verify` | 子 Agent 在**阶段三(验证阶段)**提交三阶段证据做核验;阶段一、二调用会返回 `PHASE_GATE`。核验通过≠完成,最终仍由完成判定复核。 |
|
|
117
|
+
| `dsh_workplan_lessons` | 只读查看**永久教训记忆**:`list` / `search` / `stats`。它只读文件,不改计划状态;用来核对「到底记住了什么、哪些错误在重复发生」。 |
|
|
116
118
|
|
|
117
119
|
在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
|
|
118
120
|
|
|
121
|
+
## 三阶段工作法与自我学习(2.0.2 的核心)
|
|
122
|
+
|
|
123
|
+
### 三阶段:规划 → 执行 → 验证
|
|
124
|
+
|
|
125
|
+
每个部门 Agent 收到工作后,顺序不可颠倒:
|
|
126
|
+
|
|
127
|
+
| 阶段 | 必须完成的事 | 完成证据 |
|
|
128
|
+
|---|---|---|
|
|
129
|
+
| 一 规划 | 先梳理问题(现状/约束/未知/主要矛盾),再形成完整可执行思路(做什么、产出什么、如何证明) | `phases.planning` |
|
|
130
|
+
| 二 执行 | 严格按阶段一的思路执行;需要改道必须记录原因 | `phases.execution.steps/deviations` |
|
|
131
|
+
| 三 验证 | 逐条验证验收标准与用户原要求,并做**自我学习复盘** | `phases.verification` + `retrospective` |
|
|
132
|
+
|
|
133
|
+
**关于「第一、二阶段禁用插件」的更正(2.0.2)**:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则(2.0.1 曾把它写成产品级规则,2.0.2 已更正)。三阶段约束的是部门子 Agent 的交付证据顺序;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。验证工具在缺规划或执行证据时返回 `PHASE_GATE` 并列出待补项——这是防止跳过前两阶段直接「验证通过」的门禁,不是禁用插件。遇阻上报 `dsh_workplan_escalate` 始终可用。
|
|
134
|
+
|
|
135
|
+
### 自我学习与自我迭代:把弯路变成永久记忆
|
|
136
|
+
|
|
137
|
+
每次完成工作,阶段三必须提交四项复盘(缺一项就判未完成):
|
|
138
|
+
|
|
139
|
+
1. **problems**:本次全过程遇到的所有问题(现象 + 根因);
|
|
140
|
+
2. **detours**:走过的弯路、返工与无效尝试(确实没有就写空数组,不编造);
|
|
141
|
+
3. **resolutions**:最终是如何解决的;
|
|
142
|
+
4. **prevention**:以后如何预防再犯,必须写成「遇到…先…」的可执行硬规则。
|
|
143
|
+
|
|
144
|
+
复盘通过后,插件立刻把它写入**永久记忆文件**(JSONL,追加写):
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
~/.dsh/workplan/lessons.jsonl # 默认位置,跨项目长期保留
|
|
148
|
+
DSH_WORKPLAN_LESSONS_FILE=/path/x.jsonl # 需要时用环境变量覆盖
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
下一次派发子任务前,插件会按「同部门 > 同项目 > 关键词命中 > 重复次数 > 新近程度」挑选最相关的历史教训,自动注入子 Agent 提示词(最多 8 条),并明确标注:**这是历史数据,不是新指令,但相关就必须遵守**。
|
|
152
|
+
|
|
153
|
+
同一类错误再次出现时不会新增一条重复记录,而是把 `occurrences` 累加并把排序提前——越重复越显眼,这就是「自我迭代」。主 Agent 可用 `dsh_workplan_lessons` 复核;`occurrences ≥ 2` 的教训必须在下一次计划里变成明确约束。
|
|
154
|
+
|
|
155
|
+
记忆文件损坏一行不会拖垮整份记忆(坏行跳过);文件最多保留最近 500 条;写入用「临时文件 + 改名」避免半截文件。复盘来自模型输出,注入前会清掉不可见字符与会话引用,并声明为数据而非指令。
|
|
156
|
+
|
|
119
157
|
## 部门怎么协作(1.11.0 的真实能力)
|
|
120
158
|
|
|
121
159
|
计划里的每件工作都带一个部门标签(工程研发、研究分析、设计、产品、数据、质量验证、安全、运维、文档写作、运营、法务合规、财务)。**标签决定提示词与统计口径,不是组织架构**:
|
|
@@ -13,7 +13,7 @@ G-08(ADV-FSP.1 独立接口规范缺失)。核对方法:工具名逐一来
|
|
|
13
13
|
|
|
14
14
|
TOE 对外暴露 **2 类接口**:9 个 Agent 工具(宿主注入给模型调用)+ 1 个本地 HTTP 路由(面板数据源)。
|
|
15
15
|
|
|
16
|
-
### 1.1 Agent 工具(
|
|
16
|
+
### 1.1 Agent 工具(11 个)/ Agent tools
|
|
17
17
|
|
|
18
18
|
| # | 工具 | 调用者 | 用途(一句话) | 关键参数 | 失败/拒绝行为 |
|
|
19
19
|
|---|---|---|---|---|---|
|
|
@@ -26,6 +26,8 @@ TOE 对外暴露 **2 类接口**:9 个 Agent 工具(宿主注入给模型调
|
|
|
26
26
|
| 7 | `dsh_workplan_instruct` | 主 Agent | 向「待指示」子任务下发决定 | `subtaskId`, `instruction` | 仅接受 `closure=escalated` 的行 |
|
|
27
27
|
| 8 | `dsh_workplan_escalate` | 子 Agent | 子任务遇阻上报请示 | `question`, `options?`, `needs?` | 调用后子任务置「待指示」 |
|
|
28
28
|
| 9 | `dsh_workplan_handoff` | 主 Agent(仅根会话) | 处置跨部门需求 | `action: list/assign/resolve/close` | 非根会话拒绝 |
|
|
29
|
+
| 10 | `dsh_workplan_verify` | 子 Agent(阶段三) | 核验三阶段证据与验收覆盖 | `phases`(planning/execution/verification) | 阶段一/二返回 `PHASE_GATE`;证据缺口返回 `VERIFICATION_INCOMPLETE`;核验通过不等于完成 |
|
|
30
|
+
| 11 | `dsh_workplan_lessons` | 根会话 / 子 Agent(只读) | 查看永久教训记忆(`list` / `search` / `stats`) | `action`、`department`、`query`、`limit` | 只读,不写计划状态、不提供写入动作;记忆只能由阶段三复盘通过后的完成判定写入 |
|
|
29
31
|
|
|
30
32
|
### 1.2 HTTP 路由(1 个)/ HTTP route
|
|
31
33
|
|
|
@@ -111,3 +111,12 @@ npm run verify
|
|
|
111
111
|
| AS-10 | `dsh_workplan_escalate` | question/options | 子 Agent 借请示把决策推给主会话、空转 | 调用后子任务置「待指示」并停止推进,由主 Agent 决定;`workplan-pending-diagnosis` 等回归 |
|
|
112
112
|
|
|
113
113
|
新增接口的完整参数/失败行为见 `docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md`。本节不改 §1 方法与「未做」声明:仍未做渗透测试、模糊测试与形式化分析;AVA_VAN.2+ 需外部实验室,为固有残留、如实披露。
|
|
114
|
+
|
|
115
|
+
## 9. v1.13.0 / v2.0.2 攻击面增量(三阶段核验与教训记忆)
|
|
116
|
+
|
|
117
|
+
1.13.0 新增 1 个工具入口 `dsh_workplan_verify`,只对子 Agent 开放,用于阶段三核验。攻击面评估:
|
|
118
|
+
|
|
119
|
+
| # | 新增入口 | 输入可控点 | 潜在滥用 | 对策(实测) |
|
|
120
|
+
|---|---|---|---|---|
|
|
121
|
+
| AS-11 | `dsh_workplan_verify` | `phases`(嵌套对象,受字段长度/条数/总长上限)、`acceptance` | 子 Agent 伪造「全部通过」的验证证据骗过核验;把核验通过当成完成许可;阶段一/二提前调用规避门禁 | 核验只做结构与验收覆盖检查,**不是完成判定**;完成仍由 `adjudicateResult` 对同一份证据再判;只交 planning/execution 时返回 `PHASE_GATE`;`MAX_PHASE_*` 限制输入规模;`tests/three-phase.test.ts` 覆盖 |
|
|
122
|
+
| AS-12 | `dsh_workplan_lessons` | `action`(枚举)、`department`、`query`(≤ 原文长度)、`limit`(1–50) | 读取教训记忆探测其他项目的内部信息;用被污染的教训做提示词注入;把只读工具当成写入通道 | 只读、无写入动作;注入前清除不可见字符与会话引用并在提示词中声明为历史数据;返回条数受 `limit` 限制;`tests/self-learning.test.ts` 覆盖 |
|
|
@@ -73,8 +73,10 @@
|
|
|
73
73
|
| `dsh_workplan_escalate` | 模型工具 | 双向 | 子 Agent 遇阻上报,子任务置「待指示」 |
|
|
74
74
|
| `dsh_workplan_instruct` | 模型工具 | 双向 | 仅对「待指示」行下发主 Agent 决定并恢复执行 |
|
|
75
75
|
| `dsh_workplan_handoff` | 模型工具 | 双向 | 跨部门需求处置;仅根会话可用 |
|
|
76
|
+
| `dsh_workplan_verify` | 模型工具 | 双向 | 子 Agent 在阶段三提交三阶段证据做核验;阶段一/二返回 `PHASE_GATE` |
|
|
77
|
+
| `dsh_workplan_lessons` | 模型工具 | 读出 | 只读查看永久教训记忆(list/search/stats);不写计划状态 |
|
|
76
78
|
|
|
77
|
-
(1.9–
|
|
79
|
+
(1.9–2.0 新增 7 个工具(含 1.13.0 的三阶段核验与 2.0.1 的教训记忆)与取代/重规划能力;接口参数与失败行为完整枚举见 `docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md`。)
|
|
78
80
|
|
|
79
81
|
**不在 TOE 内**:DSH 本体(身份认证、会话存储、模型推理)、Node.js 运行时、操作系统、浏览器。
|
|
80
82
|
|
package/docs/collaboration.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
> 这份文档回答四个问题:**谁把什么写给谁、什么时候算完成、失败后谁接手、改代码时哪些地方必须一起改。**
|
|
4
4
|
>
|
|
5
|
-
> 适用版本:**
|
|
5
|
+
> 适用版本:**2.0.2**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
|
|
6
6
|
>
|
|
7
|
-
<!-- [D-45] 本文版本与实现口径已对齐
|
|
7
|
+
<!-- [D-45] 本文版本与实现口径已对齐 2.0.2;核对项:权限 7 处、present 仅根会话、下游可读 artifacts、三阶段证据门禁、复盘永久记忆。 -->
|
|
8
8
|
|
|
9
9
|
> 约定:本文只用「文件 + 符号名」定位代码(例如 `src/plan.ts#buildChildPrompt`),**不写行号**,避免代码改动后文档漂移。核对命令见 §11。
|
|
10
10
|
|
|
@@ -253,6 +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` 预核验(缺 planning/execution 返回 `PHASE_GATE`,是证据门禁而非全局禁用插件),但核验通过不等于完成。
|
|
256
257
|
- 没有证据块时,失败仍可**第一行**写 `BLOCKED: 原因`(大小写不敏感,中英文冒号都认,行首允许空白)——按 `legacy` 判受阻。
|
|
257
258
|
- **1.11.0 起,没有证据块、也没有 `BLOCKED` 的「纯散文」不再算完成**:默认(`strictCompletion`,可用 `DSH_WORKPLAN_STRICT_COMPLETION=0` 关闭)判 `blocked` + `unverified`,错误信息写明「结果块缺失,无法确认验收项是否真的通过」。历史回放仍按 `legacy` 读取,避免旧计划整体失效。
|
|
258
259
|
- 验收条目自称 `pass` 但 `evidence` 为空时,1.11.0 降级为 `unverified`,且 `deliveryReadiness` 增加「验收自称通过但没有证据」阻塞项。
|
|
@@ -435,6 +436,8 @@ npm run verify
|
|
|
435
436
|
| 子 Agent 不能 dispatch/update/cancel | `src/runtime.ts#dispatchTool`、`#updateStatus`、`#cancelPlan` 的 `isRootSession` |
|
|
436
437
|
| 阶段只是分组 | `src/plan.ts#readySubtasks` 上方注释与实现 |
|
|
437
438
|
| 证据块决定完成/受阻,非空文本不再直接算完成 | `src/plan.ts#adjudicateResult`、`#parseEvidenceBlock` |
|
|
439
|
+
| 完成必须带规划→执行→验证三段证据,缺段降级 | `src/plan.ts#adjudicateResult`、`src/three-phase.ts#validatePhaseEvidence` |
|
|
440
|
+
| 阶段三才可核验,阶段一/二返回 PHASE_GATE | `src/runtime.ts#verifySubtask`、`src/host.ts#createVerifyTool` |
|
|
438
441
|
| 依赖同时看状态与产物 | `src/plan.ts#readySubtasks` 的 `dependencyOk`、`src/runtime.ts#checkArtifacts` |
|
|
439
442
|
| 派发支持 wait/async 且可汇合 | `src/runtime.ts#dispatchTool` 的 `mode` 与 `dispatchPromise` 分支 |
|
|
440
443
|
| 运行中 update 默认被拒 | `src/runtime.ts#updateStatus` 的 `TASK_RUNNING` 分支 |
|
|
@@ -452,3 +455,27 @@ npm run verify
|
|
|
452
455
|
- [1.6.0 会话终止收敛](../CHANGELOG.md)
|
|
453
456
|
- [安装与使用说明](../README.md) / [English](../README.en.md)
|
|
454
457
|
- T5 优化方案与验收标准:`deliverables/workplan/T5_优化方案与验收标准_20261030.md`
|
|
458
|
+
|
|
459
|
+
---
|
|
460
|
+
|
|
461
|
+
## 13. 三阶段工作法(1.13.0 起,2.0.1 增补复盘,2.0.2 更正「禁用插件」的适用范围)
|
|
462
|
+
|
|
463
|
+
部门 Agent 收到子任务后,必须按顺序完成三个阶段;阶段不可颠倒、不可跳过。
|
|
464
|
+
|
|
465
|
+
| 阶段 | 必须做什么 | 结果块证据(`phases`) | 插件核验工具 |
|
|
466
|
+
|---|---|---|---|
|
|
467
|
+
| 一 规划 | 先全面梳理问题:现状与事实、约束、未知、主要矛盾、边界;再形成完整可执行思路:步骤、产物、依赖、风险、验证方式 | `planning.problemAnalysis` / `planning.constraints` / `planning.unknowns` / `planning.approach` | 前两阶段证据尚未产生,调用会返回 `PHASE_GATE` |
|
|
468
|
+
| 二 执行 | 严格按阶段一的思路执行;任何偏离都必须记录原因与证据 | `execution.steps` / `execution.deviations` | 前两阶段证据尚未产生,调用会返回 `PHASE_GATE` |
|
|
469
|
+
| 三 验证 | 逐条验证验收标准与用户原要求,全部通过才可报 done | `verification.allPassed` / `verification.checks` / `verification.requirementCheck` | 可用 `dsh_workplan_verify` |
|
|
470
|
+
|
|
471
|
+
完成判定:`src/plan.ts#adjudicateResult` 对 `status:'done'` 强制校验 `phases`;缺任一阶段、规划内容过薄、`allPassed!==true`、验证记录少于验收标准数或未逐条对号、字段为空,一律判 `blocked/unverified`,计划不能交付。
|
|
472
|
+
|
|
473
|
+
唯一保留的插件通道:遇阻上报 `dsh_workplan_escalate`。它不是计划/执行/验证能力,而是安全阀;否则子 Agent 在阶段一/二受阻时只能空转或编造。
|
|
474
|
+
|
|
475
|
+
核验工具:`dsh_workplan_verify` 只接受阶段三调用;缺 planning/execution 时返回 `PHASE_GATE` 与待补项(证据门禁,不是禁用插件)。核验通过不等于完成——结果块仍须写同一份 `phases`,由完成判定再判一次。
|
|
476
|
+
|
|
477
|
+
> 2.0.2 更正:「第一、二阶段禁用 dsh-workplan 插件」只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。
|
|
478
|
+
|
|
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` 复核。
|
|
480
|
+
|
|
481
|
+
代码位置:提示词 `src/plan.ts#buildChildPrompt` 调用 `src/three-phase.ts#threePhasePromptLines`;校验 `src/three-phase.ts#validatePhaseEvidence` 与 `src/plan.ts#adjudicateResult`;核验工具 `src/host.ts#createVerifyTool` / `src/runtime.ts#verifySubtask`;回归 `tests/three-phase.test.ts`。
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# dsh-workplan 2.0.1 — 自我学习与自我迭代
|
|
2
|
+
|
|
3
|
+
发布日期:2026-11-05(Asia/Shanghai)
|
|
4
|
+
|
|
5
|
+
> **勘误(2.0.2)**:本版把「第一、二阶段禁用 dsh-workplan 插件」写成了产品级永久规则,这是对需求范围的误读——该条只适用于 2026-11-05 本次优化会话。2.0.2 已更正提示词、工具描述、README 与协作文档;三阶段契约与复盘机制不变。
|
|
6
|
+
|
|
7
|
+
## 一句话
|
|
8
|
+
|
|
9
|
+
部门 Agent 每次完成工作后必须复盘(问题 / 弯路 / 解决 / 防再犯),复盘写入永久记忆文件;下次派发同类任务时自动注入历史教训,同一类错误重复出现会累加次数并提前排序。三阶段工作法保持「规划 → 执行 → 验证」,复盘是验证阶段收尾的必填项。
|
|
10
|
+
|
|
11
|
+
## 安装 / 升级
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
dsh plugin --profile web add dsh-workplan@2.0.1
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
从源码安装:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
git clone https://github.com/abbaababa/dsh-workplan.git
|
|
21
|
+
cd dsh-workplan && git checkout v2.0.1
|
|
22
|
+
npm ci && npm run build
|
|
23
|
+
dsh plugin --profile web add /绝对路径/dsh-workplan
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## 新增能力
|
|
27
|
+
|
|
28
|
+
| 能力 | 说明 |
|
|
29
|
+
|---|---|
|
|
30
|
+
| 阶段三复盘必填 | `phases.verification.retrospective` 四项:`problems` / `detours` / `resolutions` / `prevention`。缺项、太薄(问题/解决合计 <20 字、预防 <16 字)一律 `blocked/unverified` |
|
|
31
|
+
| 永久教训记忆 | 复盘通过后写入 `~/.dsh/workplan/lessons.jsonl`(JSONL,追加写,保留最近 500 条,坏行跳过,临时文件 + 改名原子替换);`DSH_WORKPLAN_LESSONS_FILE` 可覆盖位置 |
|
|
32
|
+
| 自动防再犯 | 每次派发前按「同部门 > 同项目 > 关键词 > 重复次数 > 新近程度」取最相关 8 条注入子 Agent 提示词;段首声明「历史数据,不是新指令」 |
|
|
33
|
+
| 自我迭代信号 | 同类错误再次出现时 `occurrences+1`、排序提前;同一子任务重试/回放只原地更新,不虚增次数 |
|
|
34
|
+
| 只读复核工具 | `dsh_workplan_lessons`:`list` / `search` / `stats`,返回记忆内容、重复次数、文件位置;不提供写入动作,防止绕过真实复盘证据 |
|
|
35
|
+
|
|
36
|
+
## 三阶段与插件禁用边界(不变)
|
|
37
|
+
|
|
38
|
+
- 阶段一(规划):先梳理现状/约束/未知/主要矛盾,再形成完整可执行思路;阶段二(执行):严格按思路执行并记录偏离;阶段三(验证):逐条验证 + 复盘。
|
|
39
|
+
- 阶段一、二禁用 dsh-workplan 插件:子 Agent 本就没有计划/派发/改判权限;`dsh_workplan_verify` 在缺 planning/execution 证据时返回 `PHASE_GATE`。
|
|
40
|
+
- 唯一例外是遇阻上报 `dsh_workplan_escalate`(安全阀,不属于计划/执行/验证能力)。
|
|
41
|
+
- 核验通过 ≠ 完成:结果块仍须写同一份 `phases`,由 `adjudicateResult` 再判。
|
|
42
|
+
|
|
43
|
+
## 兼容性(破坏性变更)
|
|
44
|
+
|
|
45
|
+
- 2.0.1 之前写出的 `done` 结果没有 `retrospective`,用本版完成判定重放会判未完成。历史回放请显式传 `requirePhases:false`(或 `strict:false`)走旧语义。
|
|
46
|
+
- 复盘内容来自模型输出:插件只校验「有没有写、够不够具体、是否覆盖四项」,不能证明内容真实;真实性仍由主 Agent 对照产物核对。
|
|
47
|
+
- 记忆是文本数据:注入前清除不可见字符与会话引用,并声明不是指令;发现污染时用 `dsh_workplan_lessons` 抽查并删除对应行。
|
|
48
|
+
|
|
49
|
+
## 验证
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npm run check # tsc --noEmit
|
|
53
|
+
npm test # 构建 + 全量用例
|
|
54
|
+
npm run build
|
|
55
|
+
git diff --exit-code -- lib client.js # 构建产物可复现
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
发布记录(提交、tag、Release 资产哈希、npm 完整性、索引源 PR)见 `docs/release-record-2.0.1-20261105.md`。
|
|
@@ -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`。
|