dsh-workplan 2.0.4 → 2.1.1
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 +98 -0
- package/README.en.md +2 -2
- package/README.md +2 -2
- package/README.zh.md +2 -2
- package/docs/cc/AGD-OPS-SECURE-OPERATION.md +3 -1
- package/docs/release-record-2.1.0-20261106.md +95 -0
- package/lib/comm-format.js +184 -0
- package/lib/host.js +1 -1
- package/lib/plan.js +268 -12
- package/lib/runtime.js +70 -3
- package/package.json +1 -1
- package/src/comm-format.ts +215 -0
- package/src/host.ts +1 -1
- package/src/plan.ts +269 -12
- package/src/runtime.ts +69 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,101 @@
|
|
|
1
|
+
## 2.1.1 — 2026-11-06
|
|
2
|
+
|
|
3
|
+
**修复 2.1.0 的三处「说到了但没做到」:格式退回通知在续跑时送不到部门人员、中文 README 的安装命令仍指旧版本、安全文档里有一句「当前 1.12.0」的错误陈述。**
|
|
4
|
+
|
|
5
|
+
### 一、退回通知为什么没送到(根因)
|
|
6
|
+
|
|
7
|
+
用户要求是「结果不符合格式立刻退回,通知其重新检查格式」。2.1.0 把退回原因写进了状态行(`blockedKind:'comm-format'` + `error`),但续跑路径的顺序错了:
|
|
8
|
+
|
|
9
|
+
1. 计划被判 `blocked` 后再次派发,`dispatchPlan` 先调用 `resetBlockedStatuses`,把受阻行连同 `blockedKind` / `error` 一起清成待跑;
|
|
10
|
+
2. `executeSubtask` 随后才去读「这一行上次是不是格式退回」,此时信息已经被清掉;
|
|
11
|
+
3. 结果:退回只留下一个状态记号,子 Agent 重跑时看到的提示词与第一次完全一样(实测两次提示词长度都是 4374 字符),只能把同样的格式错误再交一遍。
|
|
12
|
+
|
|
13
|
+
修复(`src/runtime.ts`):
|
|
14
|
+
|
|
15
|
+
- `dispatchPlan` 在 `resetBlockedStatuses` **之前**扫出 `blockedKind === 'comm-format'` 的行,把退回原因抄进 `record.commFormatRejections`;
|
|
16
|
+
- `executeSubtask` 在行内 `blockedKind` 已被清掉时改读这份记录,作为 `COMM_FORMAT_REJECTED` 的上次失败原因带给子提示词;
|
|
17
|
+
- 消费一次即删,同一条退回通知不会被后续无关重试重复带上。
|
|
18
|
+
|
|
19
|
+
修复后实测:第 2 次激活的提示词多出「上一次尝试失败」段,包含失败类型 `COMM_FORMAT_REJECTED` 与逐条不合规项(4374 → 4584 字符)。
|
|
20
|
+
|
|
21
|
+
### 二、另外两处修正
|
|
22
|
+
|
|
23
|
+
- `README.zh.md:72` 的安装命令仍是 `dsh-workplan@1.12.3`,而同文件徽章已是新版本——用户会照着装错版本。已改为 `dsh-workplan@2.1.1`。(`tests/version-sync.test.ts` 只校验 `README.md` 与 `README.en.md`,所以这个缺口一直没被测出来。)
|
|
24
|
+
- `docs/cc/AGD-OPS-SECURE-OPERATION.md` 的安装校验步骤写着「当前 1.12.0」,是唯一一处面向用户的过期「当前版本」陈述。已改为版本中立表述,并在文首补一条带日期的版本说明:正文其余 1.12.0 都是那次评估的历史快照,不改写历史。
|
|
25
|
+
|
|
26
|
+
### 三、新增验证
|
|
27
|
+
|
|
28
|
+
- 新增 `tests/workplan-comm-format-e2e.test.ts`(2 条):用真实运行时 + 假子会话跑完整链路——不合规结果判 `blocked/comm-format` 且不计完成;修正后同一子任务可判 `done`;**并断言第 2 次激活的提示词确实带「上一次尝试失败」段、失败类型与逐条不合规项**(把「通知」环节钉成回归用例)。
|
|
29
|
+
- `npm run check`(tsc --noEmit)退出码 0。
|
|
30
|
+
- `npm test`:580 条用例,pass 580 / fail 0。
|
|
31
|
+
|
|
32
|
+
### 四、边界
|
|
33
|
+
|
|
34
|
+
- 修复只影响「因格式不合规被退回」的行;超时、no-ack、escalated 等其它受阻原因的通知路径不变。
|
|
35
|
+
- `commFormatRejections` 是单轮内的传递载体,不写进会话事件;跨轮重跑依赖状态行上的 `blockedKind/error`,二者仍在结果消息里原样保留。
|
|
36
|
+
|
|
37
|
+
## 2.1.0 — 2026-11-06
|
|
38
|
+
|
|
39
|
+
**建立主 Agent 与部门人员之间的统一沟通交流格式契约(下发—自检—核验—退回闭环),并保留 2.0.5 草案的规划器 JSON 结构修复。**
|
|
40
|
+
|
|
41
|
+
### 一、问题与证据链
|
|
42
|
+
|
|
43
|
+
用户 2026-11-05 在同一会话里连续两次遇到自动分解失败:
|
|
44
|
+
|
|
45
|
+
| # | 事实 | 证据 |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| 1 | 第一次:`Expected ',' or '}' after property value in JSON at position 12475` | 会话降级消息原文 |
|
|
48
|
+
| 2 | 第二次:规划器 JSON 被 max tokens 截断,旧实现先 `lastIndexOf('}')` 找不到结尾括号,直接判 `NO_JSON` | `src/plan.ts#extractJson` 旧实现 |
|
|
49
|
+
| 3 | 两次都不是「没规划」,而是「规划结果有一个字符的结构瑕疵」 | 降级消息均带 `degraded:true` 与原 JSON 错误 |
|
|
50
|
+
|
|
51
|
+
2.0.4 修的是**子 Agent 回执**的解析(`repairEvidenceJson`),规划器入口的 `extractJson` 仍是裸 `JSON.parse`,是同一个病根的另一个出口。
|
|
52
|
+
|
|
53
|
+
### 二、改了什么
|
|
54
|
+
|
|
55
|
+
- **结构修复**:新增 `repairJsonStructure()`——配平未闭合的 `{` `[` `"`、去掉尾逗号、把字符串内的裸换行/制表符/控制符转义。**只修结构,不新增或猜测任何字段值**。
|
|
56
|
+
- **截断修复**:新增 `truncatedCandidates()`——输出被 max tokens 截断时,从尾部逐个丢弃不完整成员(每次都是「本来就残缺、不可用」的内容),最多 24 轮,每轮尝试解析。
|
|
57
|
+
- **不再误判 NO_JSON**:旧实现要求文本里存在结尾 `}`,截断输出因此被判「没有 JSON 对象」;现在只要以 `{` 起头就进入修复流程。
|
|
58
|
+
- **失败仍然如实报错**:修不好照旧抛 `INVALID_JSON`,不静默返回空计划;成功修复时打印一条 warn 日志说明「只补括号/逗号,未改内容」。
|
|
59
|
+
|
|
60
|
+
### 三、验证
|
|
61
|
+
|
|
62
|
+
- 新增离线自检 10 条,全部通过:合法 JSON、少一个 `}`、少两个 `}]`、尾逗号、字符串内裸换行、截断 70%、截断 55%、代码块包裹、无 JSON(应抛 `NO_JSON`)、纯空白(应抛 `EMPTY_OUTPUT`)。
|
|
63
|
+
- `npm run check`(tsc --noEmit)退出码 0;`npm run build` 重新生成 `lib/`、`dist/`、`client.js`。
|
|
64
|
+
- `npm test` 全套回归见本版本 CI 输出。
|
|
65
|
+
|
|
66
|
+
### 四、边界(不夸大)
|
|
67
|
+
|
|
68
|
+
- 结构修复无法把「内容本身就错」的 JSON 变成正确内容;它只解决括号/逗号/截断这类机械损伤。
|
|
69
|
+
- 丢弃尾部残缺成员意味着该成员的信息丢失,调用方的 schema 校验仍会拦下缺字段的计划,不会因此产出半成品计划。
|
|
70
|
+
|
|
71
|
+
### 五、沟通交流格式契约(本次核心)
|
|
72
|
+
|
|
73
|
+
用户 2026-11-06 的强制要求:派发工作的同时附带一份统一的沟通交流格式要求;部门人员提交结果前依此自查;主 Agent 收到后依同一份格式核验,不合规立刻退回,通知其重新检查格式后全盘重交。
|
|
74
|
+
|
|
75
|
+
| 环节 | 落地位置 | 行为 |
|
|
76
|
+
|---|---|---|
|
|
77
|
+
| 下发 | `src/comm-format.ts#renderCommFormatSpec` → `src/plan.ts#buildChildPrompt` 末尾 | 每个子任务提示都附带 F1–F9 九条格式规范与「提交前自查(强制)」指令 |
|
|
78
|
+
| 自检 | 同上(提示词内强制指令) | 部门人员提交前逐条对照 F1–F9 |
|
|
79
|
+
| 核验 | `src/comm-format.ts#checkCommFormatCompliance` → `src/plan.ts#adjudicateResult` done 路径前 | 主 Agent 用同一份规范逐条核验 F1–F8(F9 为诚信约束,由三阶段门禁与人工复核兜底) |
|
|
80
|
+
| 退回 | `adjudicateResult` 返回 `blockedKind:'comm-format'` + `renderCommFormatRejection` | 不合规即判 blocked,退回通知写明逐条不合规项与修正要求 |
|
|
81
|
+
| 重交 | `src/runtime.ts#executeSubtask` 的 `lastFailure` 注入 | 复位重派时把退回通知作为上次失败原因(`COMM_FORMAT_REJECTED`)随提示词发回,子 Agent 看到具体不合规条目,只补缺口不重做 |
|
|
82
|
+
|
|
83
|
+
九条规范:F1 证据块标记成对、F2 status 合法、F3 三阶段齐全、F4 pass 必须带证据、F5 验收条数不少于计划、F6 产物条目合法(kind ∈ file/url/note 且 ref 非空)、F7 复盘四项、F8 blocked 必须带 question、F9 不得编造。
|
|
84
|
+
|
|
85
|
+
设计边界(不夸大):
|
|
86
|
+
|
|
87
|
+
- 只拦 `done` 路径。解析失败、验收缺口、三阶段缺失已被更早的门禁拦下,保留原有更具针对性的诊断,不用格式条目覆盖。
|
|
88
|
+
- `requirePhases:false`(历史回放 / 明确关闭新契约)不追溯否决旧日志里按当时规则合法的 done。
|
|
89
|
+
- F6 只校验「产物声明的合法性」,是否必须交付文件由计划验收标准决定——避免把无文件产物的写作类子任务误判为不合规。
|
|
90
|
+
- F9 不做自动判定:编造检测需要语义理解而非结构校验,把它写成提示词级诚信约束,由三阶段门禁与人工复核承担。
|
|
91
|
+
|
|
92
|
+
### 六、验证
|
|
93
|
+
|
|
94
|
+
- `npm run check`(tsc --noEmit)退出码 0。
|
|
95
|
+
- `npm test`:578 条用例,pass 578 / fail 0。
|
|
96
|
+
- 新增 `tests/workplan-comm-format.test.ts`:覆盖 F1–F8 逐条拒收、合规放行、退回通知文案、`requirePhases:false` 兼容边界。
|
|
97
|
+
- 既有用例按新契约修订 1 条:`workplan-evidence-contract.test.ts` 的 C-19 由「空证据 pass 降级 unverified 仍算 done」改为「按 F4 退回 blocked/comm-format」——这是用户要求的行为前移,不是放宽。
|
|
98
|
+
|
|
1
99
|
## 2.0.4 — 2026-11-05
|
|
2
100
|
|
|
3
101
|
**修复「子 Agent 干完活却交不了差」的四条判定缺陷,并给交互式会话收尾加上「放行但留痕」。**
|
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/v2.1.1)
|
|
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@2.
|
|
83
|
+
dsh plugin --profile web add dsh-workplan@2.1.1
|
|
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/v2.1.1)
|
|
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.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@2.1.1
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
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/v2.1.1)
|
|
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@1.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@2.1.1
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# 安全操作与准备程序(AGD_OPS.1 / AGD_PRE.1 对齐)/ Secure Operation & Preparation
|
|
2
2
|
|
|
3
3
|
> 对象:dsh-workplan v1.12.0 | 日期:2026-11-03 | 撰写:T5 | 性质:公开自评估文档,不宣称 CC 认证。
|
|
4
|
+
>
|
|
5
|
+
> **版本说明(2026-11-06 补记)**:本文是 v1.12.0 时点的评估快照,正文里的版本号与实测数字都属于那次评估,不改写历史;当前发布版本、下载校验值与变更记录以 README 徽章、CHANGELOG 和 GitHub Release 页为准。
|
|
4
6
|
|
|
5
7
|
## 0. 覆盖的差距编号
|
|
6
8
|
|
|
@@ -13,7 +15,7 @@ G-11(安全相关操作不成文)、G-12(安装缺完整性校验步骤)
|
|
|
13
15
|
```bash
|
|
14
16
|
# 1) 确认包来源是官方 npm 注册表与最新版本号
|
|
15
17
|
npm view dsh-workplan version dist.tarball
|
|
16
|
-
#
|
|
18
|
+
# 期望:输出与 README 徽章一致的最新版本号,tarball 域名为 registry.npmjs.org
|
|
17
19
|
|
|
18
20
|
# 2) 下载后校验完整性(sha512 由 npm 提供;发布包 sha256 见 GitHub Release 页附件)
|
|
19
21
|
npm pack dsh-workplan --pack-destination /tmp && shasum -a 256 /tmp/dsh-workplan-*.tgz
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Release record — dsh-workplan 2.1.0 (2026-11-06)
|
|
2
|
+
|
|
3
|
+
## 1. 变更主题
|
|
4
|
+
|
|
5
|
+
建立主 Agent 与部门人员之间的**统一沟通交流格式契约**:派发任务时随任务附带同一份格式要求;部门人员提交前据此自查,完全符合后全盘提交;主 Agent 收到后用同一份格式逐条核验,不合规立刻退回并写明不合规条目,通知其重新检查格式后重交。同时保留 2.0.5 草案的规划器 JSON 结构修复。
|
|
6
|
+
|
|
7
|
+
用户原话要点(2026-11-06):
|
|
8
|
+
|
|
9
|
+
1. 与相关部门人员之间建立完善、健全的交流沟通机制。
|
|
10
|
+
2. 派发工作的同时附带一份统一的沟通交流格式要求;部门人员依据该格式自查,完全符合后再全盘交付;主 Agent 收到的结果不符合要求时,立刻退回,通知其重新检查格式。
|
|
11
|
+
3. 全部完美完成后,按以前规矩同步自动对外发布新源代码和新版本。
|
|
12
|
+
|
|
13
|
+
## 2. 机制落地位置
|
|
14
|
+
|
|
15
|
+
| 环节 | 代码位置 | 行为 |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| 下发 | `src/comm-format.ts#renderCommFormatSpec` → `src/plan.ts#buildChildPrompt` 末尾 | 每个子任务提示都附带 F1–F9 九条规范与「提交前自查(强制)」指令 |
|
|
18
|
+
| 自检 | 同上(提示词内强制指令) | 部门人员提交前逐条对照 F1–F9 |
|
|
19
|
+
| 核验 | `src/comm-format.ts#checkCommFormatCompliance` → `src/plan.ts#adjudicateResult` | 主 Agent 用同一份规范逐条核验 F1–F8(F9 为诚信约束) |
|
|
20
|
+
| 退回 | `adjudicateResult` 返回 `blockedKind: 'comm-format'` + `renderCommFormatRejection` | 不合规即判受阻,退回通知写明逐条不合规项与修正要求 |
|
|
21
|
+
| 重交 | `src/runtime.ts#executeSubtask` 的 `lastFailure` 注入(`COMM_FORMAT_REJECTED`) | 退回原因随下次激活回到子提示词,子 Agent 只补缺口不重做 |
|
|
22
|
+
|
|
23
|
+
九条规范:F1 证据块标记成对、F2 status 合法、F3 三阶段齐全、F4 pass 必须带证据、F5 验收条数不少于计划、F6 产物条目合法(kind ∈ file/url/note 且 ref 非空)、F7 复盘四项、F8 blocked 必须带 question、F9 不得编造。
|
|
24
|
+
|
|
25
|
+
`src/plan.ts` 中 `BLOCKED_KINDS` 同步加入 `'comm-format'`(第 145 行)。
|
|
26
|
+
|
|
27
|
+
## 3. 设计边界(不夸大)
|
|
28
|
+
|
|
29
|
+
- 只拦 `done` 路径:解析失败、验收缺口、三阶段缺失已被更早的门禁拦下,保留原有更具针对性的诊断。
|
|
30
|
+
- `requirePhases:false`(历史回放 / 明确关闭新契约)不追溯否决旧日志里按当时规则合法的 done。
|
|
31
|
+
- F6 只校验产物声明的合法性,是否必须交付文件由各子任务验收标准决定,避免把写作类任务误判为不合规。
|
|
32
|
+
- F9 不做自动判定:编造检测需要语义理解而非结构校验,写成提示词级诚信约束,由三阶段门禁与人工复核承担。
|
|
33
|
+
|
|
34
|
+
## 4. 版本与提交
|
|
35
|
+
|
|
36
|
+
| 项目 | 值 |
|
|
37
|
+
|---|---|
|
|
38
|
+
| package.json version | 2.1.0 |
|
|
39
|
+
| meta.version(src/host.ts) | 2.1.0 |
|
|
40
|
+
| git commit | c7e8f64 |
|
|
41
|
+
| git tag | v2.1.0 |
|
|
42
|
+
| 远程 | `git@github.com:abbaababa/dsh-workplan.git`(main) |
|
|
43
|
+
|
|
44
|
+
版本同步点(与 `tests/version-sync` 一致):`package.json`、`package-lock.json` 两处、`src/host.ts` 的 `meta.version`、`tests/fixtures/tool-surface.json`、README 三语的安装命令与徽章、CHANGELOG 的 `## 2.1.0 — 2026-11-06` 标题。
|
|
45
|
+
|
|
46
|
+
## 5. 验证
|
|
47
|
+
|
|
48
|
+
- `npm run check`(tsc -p tsconfig.json --noEmit):退出码 0。
|
|
49
|
+
- `npm test`:tests 578 / pass 578 / fail 0(含新增 `tests/workplan-comm-format.test.ts`)。
|
|
50
|
+
- 新增用例覆盖:规范下发一致性(提示词含 renderCommFormatSpec 全文与 F1–F9)、F1–F8 逐条拒收、F6 边界(纯 note 合法)、合规零违规、退回 blocked/comm-format 与通知文案、`requirePhases:false` 兼容、版本契约稳定性。
|
|
51
|
+
- 既有用例按新契约前移 1 条:`tests/workplan-evidence-contract.test.ts` 的 C-19 由「空证据 pass 降级 unverified 仍算 done」改为「按 F4 退回 blocked/comm-format」。
|
|
52
|
+
- `npm run build` 重新生成 `lib/`、`dist/`、`client.js`,`lib/comm-format.js` 新增,`lib/host.js` 内 version 为 2.1.0。
|
|
53
|
+
|
|
54
|
+
## 6. 发布渠道
|
|
55
|
+
|
|
56
|
+
| 渠道 | 状态 | 证据 |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| npm | 已发布 | registry 元数据 `dist-tags.latest` = 2.1.0,`versions["2.1.0"]` 存在(`https://registry.npmjs.org/dsh-workplan`,直接查询,非 CLI 缓存) |
|
|
59
|
+
| GitHub Release | 已发布 | https://github.com/abbaababa/dsh-workplan/releases/tag/v2.1.0 |
|
|
60
|
+
| Release 制品 | 已上传且校验一致 | `dsh-workplan-2.1.0.tgz`,sha256 `0f015202575999b4be428bd55f2349f676a88ad48c605727cbd6e8494c9ac261`;用 `gh release download` 重新下载后本地复算一致;GitHub 侧记录 `digest: sha256:0f015202…` 相同 |
|
|
61
|
+
| npm tarball sha1 | 与本地 pack 一致 | `afc59da063e210f03eb0424b00da6e594f8536eb`(npm publish 输出与本机 `npm pack` 输出相同) |
|
|
62
|
+
|
|
63
|
+
说明:`npm view` 使用的本地 CLI 缓存可能短时间仍返回 2.0.4,以 registry 原始响应为准(本记录的证据即取自此)。缓存刷新后 CLI 即一致。
|
|
64
|
+
|
|
65
|
+
## 7. 复验命令
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# 1) npm registry 上的最新版本(原始元数据,绕过 CLI 缓存)
|
|
69
|
+
curl -s https://registry.npmjs.org/dsh-workplan | node -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{const j=JSON.parse(d);console.log(j['dist-tags'].latest, !!j.versions['2.1.0'])})"
|
|
70
|
+
|
|
71
|
+
# 2) 远程 tag
|
|
72
|
+
git ls-remote --tags origin | grep v2.1.0
|
|
73
|
+
|
|
74
|
+
# 3) 制品可下载且校验一致
|
|
75
|
+
gh release download v2.1.0 -p 'dsh-workplan-2.1.0.tgz' -D /tmp/recheck --clobber
|
|
76
|
+
shasum -a 256 /tmp/recheck/dsh-workplan-2.1.0.tgz # 期望 0f015202…
|
|
77
|
+
|
|
78
|
+
# 4) 本地复现验证
|
|
79
|
+
cd /Users/open/Documents/Stocks/plugins/dsh-workplan
|
|
80
|
+
npm run check && npm test
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## 8. 回滚方案
|
|
84
|
+
|
|
85
|
+
- 代码:`git revert c7e8f64` 后推送 `main`;需要撤销 tag 时 `git tag -d v2.1.0 && git push origin :refs/tags/v2.1.0`。
|
|
86
|
+
- npm:72 小时内可 `npm unpublish dsh-workplan@2.1.0`(已发布版本超过 72 小时不可撤,改用 `npm deprecate dsh-workplan@2.1.0 "…"` 标注问题并发布修复版)。
|
|
87
|
+
- 用户侧:安装旧版 `npm i dsh-workplan@2.0.4`;GitHub Release 可删除 v2.1.0 资产。
|
|
88
|
+
|
|
89
|
+
风险提示:版本一旦被下游安装,撤回不能从已安装环境消失,回滚应以「发修复版」为主,`unpublish` 仅用于发布后立刻发现的严重错误。
|
|
90
|
+
|
|
91
|
+
## 9. 已知问题(如实记录)
|
|
92
|
+
|
|
93
|
+
本次会话中,dsh-workplan 的**自动任务分解**(它自己驱动的部门子 Agent)连续失败,计划 `wp-b7750256`(10 项)与 `wp-80e484d9`(9 项)全部子任务为 blocked,错误均为基础设施层:`cannot get required service "subagents" in inactive context` 与 `子 Agent 结束状态为 error`。子 Agent 未产生任何代码改动;2.1.0 的全部实现、测试与发布均由主 Agent 在本会话直接完成。
|
|
94
|
+
|
|
95
|
+
这不影响 2.1.0 的代码正确性(578 条用例含专门的门禁用例全部通过),但说明「子 Agent 调度链路」在本机当前环境不可用,需在后续版本或部署侧单独排查。
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [2.1.0] 统一沟通交流格式规范与合规检查(用户 2026-11-06 的强制要求)。
|
|
3
|
+
*
|
|
4
|
+
* 机制闭环:
|
|
5
|
+
* 1. 主 Agent 派发子任务时,在提示词里附带本模块渲染的《沟通交流格式规范》
|
|
6
|
+
* (renderCommFormatSpec),作为双方认可的唯一结果格式契约;
|
|
7
|
+
* 2. 部门人员提交结果前,必须逐条对照规范自查(提示词中有强制自查指令);
|
|
8
|
+
* 3. 主 Agent 收到结果后,由 adjudicateResult 用 checkCommFormatCompliance
|
|
9
|
+
* 按同一份规范逐条核验;不合规即判定 blocked/comm-format,把
|
|
10
|
+
* renderCommFormatRejection 生成的退回通知随下一次激活发回,
|
|
11
|
+
* 通知部门人员重新检查格式后重交。
|
|
12
|
+
*
|
|
13
|
+
* 设计约束:
|
|
14
|
+
* - 本模块只做「格式/结构」核验,不做语义真伪判断(F9 为提示词级诚信约束,
|
|
15
|
+
* 由三阶段门禁与人工复核兜底,这里不自动判);
|
|
16
|
+
* - 规范是纯数据,可序列化进提示词,也可独立校验,版本号随内容变更递增;
|
|
17
|
+
* - 与既有门禁正交:解析失败、验收缺口、三阶段缺失仍由原门禁先拦,
|
|
18
|
+
* 本门禁只负责把「其它门禁都过了、但格式仍不合规」的 done 退回。
|
|
19
|
+
*/
|
|
20
|
+
/** 格式规范版本,随规范内容变更递增。 */
|
|
21
|
+
export const COMM_FORMAT_VERSION = 1;
|
|
22
|
+
/**
|
|
23
|
+
* 统一沟通交流格式规范定义(F1-F9,冻结不可变)。
|
|
24
|
+
*/
|
|
25
|
+
export const COMM_FORMAT_SPEC = Object.freeze({
|
|
26
|
+
version: COMM_FORMAT_VERSION,
|
|
27
|
+
name: 'dsh-workplan 沟通交流格式规范',
|
|
28
|
+
requirements: Object.freeze([
|
|
29
|
+
Object.freeze({ id: 'F1', category: 'structure',
|
|
30
|
+
description: '结果必须包含结构化证据块:以 <!-- WORKPLAN_EVIDENCE:START --> 开头、<!-- WORKPLAN_EVIDENCE:END --> 结尾,且两块标记成对出现',
|
|
31
|
+
rationale: '没有标记块,主 Agent 无法定位与解析结果,交付门禁无从启动' }),
|
|
32
|
+
Object.freeze({ id: 'F2', category: 'structure',
|
|
33
|
+
description: '证据块必须是合法 JSON 对象,顶层必须含 status 字段,取值只能是 done / blocked / partial',
|
|
34
|
+
rationale: 'status 是交付门禁的入口条件,缺失或非法则无法判定完成与否' }),
|
|
35
|
+
Object.freeze({ id: 'F3', category: 'phases',
|
|
36
|
+
description: '必须包含三阶段证据:phases.planning(问题分析与可执行思路)、phases.execution(实际执行步骤)、phases.verification(逐项验证)',
|
|
37
|
+
rationale: '三阶段是质量闭环的基础,缺任一阶段等于跳过对应质控环节' }),
|
|
38
|
+
Object.freeze({ id: 'F4', category: 'acceptance',
|
|
39
|
+
description: '验收结果必须逐条回应计划的验收标准(A1、A2…),且每条 result=pass 必须附带具体证据(命令输出/文件路径/引用),禁止空证据 pass',
|
|
40
|
+
rationale: '空证据 pass 是自述而非验证,交付门禁只认可证据' }),
|
|
41
|
+
Object.freeze({ id: 'F5', category: 'acceptance',
|
|
42
|
+
description: '验收回应的条数不得少于计划定义的验收标准条数',
|
|
43
|
+
rationale: '少回应一条等于该条验收未做,交付门禁会判为未完成' }),
|
|
44
|
+
Object.freeze({ id: 'F6', category: 'artifacts',
|
|
45
|
+
description: 'artifacts 声明清单中每一项都必须是合法条目:kind 只能取 file / url / note,且 ref 非空;不允许空条目或占位条目',
|
|
46
|
+
rationale: '主 Agent 按 ref 核验交付物;非法条目让核验无从执行。是否必须交付文件由计划验收标准决定,不由本条决定' }),
|
|
47
|
+
Object.freeze({ id: 'F7', category: 'retrospective',
|
|
48
|
+
description: 'phases.verification.retrospective 复盘必须完整:problems、resolutions、prevention 均至少 1 条(detours 没有可写空数组)',
|
|
49
|
+
rationale: '复盘是自我学习闭环的入口,缺失则教训无法写入永久记忆' }),
|
|
50
|
+
Object.freeze({ id: 'F8', category: 'blocked',
|
|
51
|
+
description: '若 status 为 blocked,必须附非空 question 字段写清受阻原因(卡在哪一步、已尝试什么、需要谁决定什么)',
|
|
52
|
+
rationale: '受阻无原因等于主 Agent 不知道卡在哪里,无法给出指示或转派' }),
|
|
53
|
+
Object.freeze({ id: 'F9', category: 'integrity',
|
|
54
|
+
description: '不得编造、虚构或伪造任何证据、文件路径、命令输出或验收结果;无法确认的项目必须写 unverified',
|
|
55
|
+
rationale: '虚假证据一旦通过交付门禁,用户拿到的就是不可信的成品' }),
|
|
56
|
+
]),
|
|
57
|
+
});
|
|
58
|
+
/**
|
|
59
|
+
* 对子 Agent 的证据块执行沟通交流格式合规检查(F1-F8 自动核验;F9 为诚信约束不自动判)。
|
|
60
|
+
*
|
|
61
|
+
* @param parsed - 已解析的证据块 payload(parseEvidenceBlock 的 payload,可为 null)
|
|
62
|
+
* @param rawOutput - 子 Agent 原始输出全文
|
|
63
|
+
* @param expectedAcceptanceCount - 计划定义的验收标准条数
|
|
64
|
+
*/
|
|
65
|
+
export function checkCommFormatCompliance(parsed, rawOutput, expectedAcceptanceCount) {
|
|
66
|
+
const violations = [];
|
|
67
|
+
const text = typeof rawOutput === 'string' ? rawOutput : '';
|
|
68
|
+
// F1: 证据块标记必须成对出现(rescueEvidence 捞到的豁免——主 Agent 已能解析)
|
|
69
|
+
if (!text.includes('WORKPLAN_EVIDENCE:START') || !text.includes('WORKPLAN_EVIDENCE:END')) {
|
|
70
|
+
if (!parsed) {
|
|
71
|
+
violations.push({ ruleId: 'F1', category: 'structure',
|
|
72
|
+
message: '缺少 WORKPLAN_EVIDENCE:START/END 标记块,主 Agent 无法定位与解析结果' });
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
if (!parsed || typeof parsed !== 'object') {
|
|
76
|
+
if (violations.length === 0) {
|
|
77
|
+
violations.push({ ruleId: 'F2', category: 'structure', message: '证据块无法解析为 JSON 对象' });
|
|
78
|
+
}
|
|
79
|
+
return { compliant: false, violations, version: COMM_FORMAT_VERSION };
|
|
80
|
+
}
|
|
81
|
+
// F2: status 必填且取值合法
|
|
82
|
+
if (!['done', 'blocked', 'partial'].includes(String(parsed.status ?? ''))) {
|
|
83
|
+
violations.push({ ruleId: 'F2', category: 'structure',
|
|
84
|
+
message: `status 字段缺失或取值非法("${String(parsed.status ?? '')}"),只能是 done / blocked / partial` });
|
|
85
|
+
}
|
|
86
|
+
// F3: 三阶段证据齐全
|
|
87
|
+
const phases = parsed.phases;
|
|
88
|
+
if (!phases || typeof phases !== 'object') {
|
|
89
|
+
violations.push({ ruleId: 'F3', category: 'phases',
|
|
90
|
+
message: '缺少 phases 对象:planning / execution / verification 三阶段证据全部缺失' });
|
|
91
|
+
}
|
|
92
|
+
else {
|
|
93
|
+
const missing = [];
|
|
94
|
+
if (!phases.planning || typeof phases.planning !== 'object')
|
|
95
|
+
missing.push('planning(问题分析与思路)');
|
|
96
|
+
if (!phases.execution || typeof phases.execution !== 'object')
|
|
97
|
+
missing.push('execution(实际执行步骤)');
|
|
98
|
+
if (!phases.verification || typeof phases.verification !== 'object')
|
|
99
|
+
missing.push('verification(逐项验证与复盘)');
|
|
100
|
+
if (missing.length > 0) {
|
|
101
|
+
violations.push({ ruleId: 'F3', category: 'phases', message: `三阶段证据缺失:${missing.join('、')}` });
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
// F4: pass 必须带证据
|
|
105
|
+
const acceptance = Array.isArray(parsed.acceptance) ? parsed.acceptance : [];
|
|
106
|
+
const emptyPass = [];
|
|
107
|
+
for (const item of acceptance) {
|
|
108
|
+
if (item && item.result === 'pass' && !String(item.evidence ?? '').trim()) {
|
|
109
|
+
emptyPass.push(String(item.criterion ?? '(未命名验收项)'));
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
if (emptyPass.length > 0) {
|
|
113
|
+
violations.push({ ruleId: 'F4', category: 'acceptance',
|
|
114
|
+
message: `以下验收项 result=pass 但未附证据:${emptyPass.slice(0, 5).join('、')};pass 必须附命令输出/文件路径/引用` });
|
|
115
|
+
}
|
|
116
|
+
// F5: 验收条数不得少于计划定义
|
|
117
|
+
if (expectedAcceptanceCount > 0 && acceptance.length < expectedAcceptanceCount) {
|
|
118
|
+
violations.push({ ruleId: 'F5', category: 'acceptance',
|
|
119
|
+
message: `验收回应仅 ${acceptance.length} 条,少于计划定义的 ${expectedAcceptanceCount} 条;须逐条回应 A1、A2…` });
|
|
120
|
+
}
|
|
121
|
+
// F6: 产物声明必须逐条合法(kind 枚举 + ref 非空);是否必须交付文件由计划验收决定,不在此拦
|
|
122
|
+
const artifacts = Array.isArray(parsed.artifacts) ? parsed.artifacts : [];
|
|
123
|
+
const badArtifacts = artifacts.filter((item) => !item || typeof item !== 'object'
|
|
124
|
+
|| !['file', 'url', 'note'].includes(String(item.kind ?? ''))
|
|
125
|
+
|| String(item.ref ?? '').trim() === '');
|
|
126
|
+
if (badArtifacts.length > 0) {
|
|
127
|
+
violations.push({ ruleId: 'F6', category: 'artifacts',
|
|
128
|
+
message: `artifacts 有 ${badArtifacts.length} 条非法声明:每条必须 kind 取 file/url/note 且 ref 非空,不允许空条目` });
|
|
129
|
+
}
|
|
130
|
+
// F7: 复盘完整(problems/resolutions/prevention 均至少 1 条)
|
|
131
|
+
const retro = phases?.verification?.retrospective;
|
|
132
|
+
if (!retro || typeof retro !== 'object') {
|
|
133
|
+
violations.push({ ruleId: 'F7', category: 'retrospective',
|
|
134
|
+
message: '缺少 phases.verification.retrospective 复盘(problems / detours / resolutions / prevention)' });
|
|
135
|
+
}
|
|
136
|
+
else {
|
|
137
|
+
const missingRetro = [];
|
|
138
|
+
if (!Array.isArray(retro.problems) || retro.problems.length === 0)
|
|
139
|
+
missingRetro.push('problems(遇到的问题,现象+根因)');
|
|
140
|
+
if (!Array.isArray(retro.resolutions) || retro.resolutions.length === 0)
|
|
141
|
+
missingRetro.push('resolutions(最终如何解决)');
|
|
142
|
+
if (!Array.isArray(retro.prevention) || retro.prevention.length === 0)
|
|
143
|
+
missingRetro.push('prevention(防再犯规则)');
|
|
144
|
+
if (missingRetro.length > 0) {
|
|
145
|
+
violations.push({ ruleId: 'F7', category: 'retrospective',
|
|
146
|
+
message: `复盘不完整,缺少:${missingRetro.join('、')},均至少 1 条` });
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
// F8: blocked 必须附非空 question
|
|
150
|
+
if (parsed.status === 'blocked' && !String(parsed.question ?? '').trim()) {
|
|
151
|
+
violations.push({ ruleId: 'F8', category: 'blocked',
|
|
152
|
+
message: 'status 为 blocked 但 question 为空:须写清卡在哪一步、已尝试什么、需要谁做什么决定' });
|
|
153
|
+
}
|
|
154
|
+
return { compliant: violations.length === 0, violations, version: COMM_FORMAT_VERSION };
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* 把格式规范渲染为嵌入子 Agent 提示词的文本。
|
|
158
|
+
* 这是「派发工作时附带统一沟通交流格式要求」的具体实现。
|
|
159
|
+
*/
|
|
160
|
+
export function renderCommFormatSpec() {
|
|
161
|
+
const lines = [
|
|
162
|
+
'沟通交流格式规范(v' + String(COMM_FORMAT_VERSION) + ',主 Agent 与部门人员双方认可的结果格式契约):',
|
|
163
|
+
];
|
|
164
|
+
for (const req of COMM_FORMAT_SPEC.requirements) {
|
|
165
|
+
lines.push(`- 【${req.id}】${req.description}`);
|
|
166
|
+
}
|
|
167
|
+
lines.push('不合规的后果:主 Agent 收到结果后按本规范逐条核验;任一不合规,结果立刻退回,你将收到列明不合规条目的退回通知,须全部修正后重新提交完整结果。');
|
|
168
|
+
return lines.join('\n');
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 把合规检查结果渲染为退回通知文本(随下一次激活发回部门人员)。
|
|
172
|
+
*/
|
|
173
|
+
export function renderCommFormatRejection(result) {
|
|
174
|
+
if (result.compliant)
|
|
175
|
+
return '';
|
|
176
|
+
const lines = [
|
|
177
|
+
'结果退回:沟通交流格式不合规(规范 v' + String(result.version) + ')。',
|
|
178
|
+
'你的结果未通过以下条目,请逐条修正、重新自查全部 F1-F9 后再提交完整结果(不要只修一条就重交):',
|
|
179
|
+
];
|
|
180
|
+
for (const v of result.violations) {
|
|
181
|
+
lines.push(`- ${v.ruleId}:${v.message}`);
|
|
182
|
+
}
|
|
183
|
+
return lines.join('\n');
|
|
184
|
+
}
|
package/lib/host.js
CHANGED
|
@@ -1363,7 +1363,7 @@ export function apply(ctx, config = {}) {
|
|
|
1363
1363
|
}
|
|
1364
1364
|
export const meta = {
|
|
1365
1365
|
name,
|
|
1366
|
-
version: '2.
|
|
1366
|
+
version: '2.1.1',
|
|
1367
1367
|
promptOrder: PROMPT_ORDER,
|
|
1368
1368
|
routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
|
|
1369
1369
|
};
|