dsh-workplan 1.11.1 → 1.12.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 +150 -0
- package/README.en.md +7 -4
- package/README.md +13 -4
- package/README.zh.md +239 -0
- package/SECURITY.md +25 -2
- package/client.js +221 -24
- package/docs/SBOM.md +17 -9
- package/docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md +44 -0
- package/docs/cc/ADV-TDS-TOE-DESIGN.md +54 -0
- package/docs/cc/AGD-OPS-SECURE-OPERATION.md +70 -0
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +16 -0
- package/docs/cc/CC-2026-ASSESSMENT.md +33 -1
- package/docs/cc/CM-PLAN.md +45 -0
- package/docs/cc/SECURITY-TARGET.md +60 -11
- package/docs/cc/T6-RECHECK-REPORT.md +83 -0
- package/docs/cc/TEST-COVERAGE-MATRIX.md +40 -0
- package/docs/collaboration.md +21 -18
- package/docs/decision-1.12.0-cc1-keep-20261104.md +46 -0
- package/docs/departments.md +8 -7
- package/docs/release-notes-1.12.0.md +66 -0
- package/docs/release-record-1.11.1-20261102.md +61 -0
- package/docs/release-record-1.12.0-20261103.md +99 -0
- package/lib/auto-resume.js +35 -7
- package/lib/client.js +221 -24
- package/lib/departments.js +258 -0
- package/lib/host.js +30 -4
- package/lib/plan.js +222 -23
- package/lib/runtime.js +180 -16
- package/lib/understanding.js +1030 -0
- package/package.json +1 -1
- package/src/auto-resume.ts +36 -7
- package/src/client.ts +268 -32
- package/src/departments.ts +282 -0
- package/src/host.ts +44 -8
- package/src/plan.ts +228 -23
- package/src/runtime.ts +194 -19
- package/src/understanding.ts +1205 -0
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# 配置管理计划(ALC_CMC/CMS/DVS/LCD 对齐)/ Configuration Management Plan
|
|
2
|
+
|
|
3
|
+
> 对象:dsh-workplan v1.12.0 | 日期:2026-11-03 | 撰写:T5 | 性质:公开自评估文档,不宣称 CC 认证。
|
|
4
|
+
|
|
5
|
+
## 0. 覆盖的差距编号
|
|
6
|
+
|
|
7
|
+
G-13(无正式 CM 计划)、G-16(开发环境安全措施未成文)、G-18(生命周期模型未按 CC 术语成文)、G-19(工具与技术,随文复述)。
|
|
8
|
+
|
|
9
|
+
## 1. 配置项范围 / Configuration items
|
|
10
|
+
|
|
11
|
+
| 类别 | 配置项 | 版本标识 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| 源码 | `src/*.ts`(12 文件 17,430 行) | git 提交哈希 |
|
|
14
|
+
| 构建产物 | `lib/`、`dist/`、`dist-tests/` | 随提交;`build-artifacts.test.ts` 校验一致性 |
|
|
15
|
+
| 测试 | `tests/*.test.ts`(65 个测试文件) | 随提交 |
|
|
16
|
+
| 文档 | `README*.md`、`SECURITY.md`、`docs/`(含 `docs/cc/` 全套) | 随提交 |
|
|
17
|
+
| 发布物 | npm 包 `dsh-workplan`、GitHub tag `vX.Y.Z` | semver,与 package.json 同步(`version-sync.test.ts` 五处校验) |
|
|
18
|
+
| 依赖锁 | `package-lock.json`(lockfileVersion 3) | 随提交 |
|
|
19
|
+
|
|
20
|
+
## 2. 版本标识与一致性规则 / Versioning rules
|
|
21
|
+
|
|
22
|
+
1. 语义化版本;`package.json` 为唯一版本源,发布前 `npm test` 必须含 version-sync 通过。
|
|
23
|
+
2. 每个发布版本对应:git tag `vX.Y.Z` + `docs/release-record-X.Y.Z-日期.md` + CHANGELOG 条目(参见 1.12.0 实例)。
|
|
24
|
+
3. tag 与 commit 一一对应,可由 `git rev-parse vX.Y.Z` 复核;当前 HEAD `5fe47a1` = Release 1.12.0 verification evidence。
|
|
25
|
+
|
|
26
|
+
## 3. 生命周期模型(ALC_LCD 成文化)/ Lifecycle
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
开发(src + tests 同步改动)
|
|
30
|
+
→ 回归(npm test,当前 462 项基线;npm run verify 一键复跑)
|
|
31
|
+
→ 文档刷新(CC 文档链、SBOM、CHANGELOG 随版本更新)
|
|
32
|
+
→ 发布(RELEASING.md 流程:build → test → npm publish → git tag → release-record 落档)
|
|
33
|
+
→ 维护(SECURITY.md 支持版本表;漏洞按 §3 渠道报告,见 release-notes 逐版本缺陷纠正记录)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## 4. 开发环境安全措施(ALC_DVS 成文化)/ Development security
|
|
37
|
+
|
|
38
|
+
- CI(`.github/workflows/verify.yml`)固定 Node 版本,每次提交跑全量测试。
|
|
39
|
+
- 工具与技术(ALC_TAT):零运行时依赖;lockfile 锁定全部开发依赖版本;TypeScript 严格编译。
|
|
40
|
+
- 凭据不落库:不提交 `.env`/API key(仓库规则);发布凭据仅维护者本地持有。
|
|
41
|
+
- 提交历史全量保留于 git,公开可审计。
|
|
42
|
+
|
|
43
|
+
## 5. 配置管理自动化程度
|
|
44
|
+
|
|
45
|
+
单人维护 + 公开 git 历史(对照 ALC_CMC.1–.2:版本引用 + 自动化 CM 能力由 git 提供);追踪(CMC.3+)与审计(CMC.4+)属认证级要求,作为残留项如实披露,不在本文宣称。
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
# 安全目标(Security Target)— dsh-workplan v1.
|
|
1
|
+
# 安全目标(Security Target)— dsh-workplan v1.12.0
|
|
2
|
+
|
|
3
|
+
> **v1.12.0 刷新记录(2026-11-03,T5,对应差距 G-01/02/05/06/25/26~32)**:本 ST 从 v1.8.0 基线刷新——TOE 版本、模块构成、工具清单(4 → 9 个)与测试基线(188 → 462)均已更新;§10 为 1.9–1.12 新增功能的安全陈述(SFR 成文化)与 ACO 判定。原文符合性主张(NONE)不变。
|
|
2
4
|
|
|
3
5
|
**文件性质:按 ISO/IEC 15408-3:2026 ASE 类结构编写的 ST 草案 / ST draft structured per ISO/IEC 15408-3:2026 class ASE.**
|
|
4
6
|
|
|
@@ -15,11 +17,11 @@
|
|
|
15
17
|
|
|
16
18
|
| 字段 | 值 |
|
|
17
19
|
|---|---|
|
|
18
|
-
| ST 标识 | `dsh-workplan-ST-1.
|
|
19
|
-
| TOE 标识 | `dsh-workplan` 插件 1.
|
|
20
|
+
| ST 标识 | `dsh-workplan-ST-1.12.0`(草案 rev 2;rev 1 = 1.8.0) |
|
|
21
|
+
| TOE 标识 | `dsh-workplan` 插件 1.12.0,npm 包 `dsh-workplan@1.12.0`(git HEAD `5fe47a1`) |
|
|
20
22
|
| 依据 | ISO/IEC 15408-1/-2/-3:2026 |
|
|
21
23
|
| 目标保证等级 | 无(若将来评估,拟选 **EAL1**) |
|
|
22
|
-
| 日期 | 2026-10-30 |
|
|
24
|
+
| 日期 | rev1 2026-10-30 | rev2(本次刷新)2026-11-03 |
|
|
23
25
|
|
|
24
26
|
---
|
|
25
27
|
|
|
@@ -29,7 +31,7 @@
|
|
|
29
31
|
见上表。本 ST 随插件版本发布,版本号与 `package.json` 由测试强制同步。
|
|
30
32
|
|
|
31
33
|
### 1.2 TOE 引用
|
|
32
|
-
`dsh-workplan@1.
|
|
34
|
+
`dsh-workplan@1.12.0`。分发渠道:npm 公共注册表;源码:<https://github.com/abbaababa/dsh-workplan>。
|
|
33
35
|
|
|
34
36
|
### 1.3 TOE 概述
|
|
35
37
|
`dsh-workplan` 是 DeepSeek Harness(DSH)的一个插件。它让 AI 在**动手之前**先把任务拆成阶段和子任务,把计划显示给用户,再按计划派发子代理,并把每个子任务的结果、验证状态与证据写回会话。
|
|
@@ -42,13 +44,20 @@
|
|
|
42
44
|
|
|
43
45
|
| 部件 | 文件 | 职责 |
|
|
44
46
|
|---|---|---|
|
|
45
|
-
| 宿主运行时 | `src/runtime.ts`(
|
|
46
|
-
|
|
|
47
|
-
| 浏览器面板 | `src/client.ts`(
|
|
48
|
-
|
|
|
47
|
+
| 宿主运行时 | `src/runtime.ts`(6071 行) | 计划派发、子代理生命周期、状态回写、HTTP 路由与加固响应头 |
|
|
48
|
+
| 计划模型 | `src/plan.ts`(3820 行) | 计划结构、校验、统计派生 |
|
|
49
|
+
| 浏览器面板 | `src/client.ts`(3367 行)→ `client.js` | 同源拉取计划数据并渲染面板(含图表) |
|
|
50
|
+
| 插件入口 | `src/host.ts`(1278 行) | 注册 HTTP 路由、**9 个模型工具**、配置 schema、提示词规则、版本元数据 |
|
|
51
|
+
| 结果理解 | `src/understanding.ts`(901 行) | 结果理解与核对辅助 |
|
|
52
|
+
| 重规划 | `src/replan.ts`(708 行) | 需求变更判定(cancel/replace/add) |
|
|
53
|
+
| 计划取代 | `src/supersede.ts`(429 行)+ `src/supersede-digest.ts`(116 行) | 跨计划取代 V1–V8 复算与摘要 |
|
|
54
|
+
| 自动续跑 | `src/auto-resume.ts`(275 行) | 中断后续跑策略 |
|
|
55
|
+
| 部门枚举 | `src/departments.ts`(244 行) | 部门 key 定义 |
|
|
49
56
|
| 看门狗 | `src/watchdog.ts`(207 行) | 子代理超时与预算控制 |
|
|
50
57
|
| 随包第三方 | `vendor/chart.umd.js` | Chart.js 4.6.1(MIT),本地分发 |
|
|
51
58
|
|
|
59
|
+
(行数为 v1.12.0 于 git HEAD `5fe47a1` 的 `wc -l src/*.ts` 实测,2026-11-03;完整清单见 `docs/SBOM.md` §5,模块级设计见 `docs/cc/ADV-TDS-TOE-DESIGN.md`。)
|
|
60
|
+
|
|
52
61
|
**外部接口(TSF 接口,完全枚举)**:
|
|
53
62
|
|
|
54
63
|
| 接口 | 类型 | 方向 | 说明 |
|
|
@@ -58,7 +67,14 @@
|
|
|
58
67
|
| `dsh_workplan_dispatch` | 模型工具 | 双向 | 派发计划;plan 模式下被 guard 拒绝 |
|
|
59
68
|
| `dsh_workplan_status` | 模型工具 | 双向 | 只读查询进度 |
|
|
60
69
|
| `dsh_workplan_update` | 模型工具 | 双向 | 更新子任务状态,需 `expectedRevision` |
|
|
61
|
-
| `dsh_workplan_cancel` | 模型工具 | 双向 |
|
|
70
|
+
| `dsh_workplan_cancel` | 模型工具 | 双向 | 取消计划(或按 disposition=superseded 转移责任给承接计划) |
|
|
71
|
+
| `dsh_workplan_replan` | 模型工具 | 双向 | 需求变更重规划(cancel/replace/add),旧行保留可追溯 |
|
|
72
|
+
| `dsh_workplan_followup` | 模型工具 | 双向 | 仅向直接子会话补发说明;非直接子会话拒绝 |
|
|
73
|
+
| `dsh_workplan_escalate` | 模型工具 | 双向 | 子 Agent 遇阻上报,子任务置「待指示」 |
|
|
74
|
+
| `dsh_workplan_instruct` | 模型工具 | 双向 | 仅对「待指示」行下发主 Agent 决定并恢复执行 |
|
|
75
|
+
| `dsh_workplan_handoff` | 模型工具 | 双向 | 跨部门需求处置;仅根会话可用 |
|
|
76
|
+
|
|
77
|
+
(1.9–1.12 新增 5 个工具与取代/重规划能力;接口参数与失败行为完整枚举见 `docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md`。)
|
|
62
78
|
|
|
63
79
|
**不在 TOE 内**:DSH 本体(身份认证、会话存储、模型推理)、Node.js 运行时、操作系统、浏览器。
|
|
64
80
|
|
|
@@ -206,7 +222,7 @@ TOE 应提供可重复执行的自测试,覆盖:计划模型校验、派发
|
|
|
206
222
|
| FMT_MOF.1 / FMT_SMF.1 | `src/host.ts` 工具注册 | 4 个工具;`update` 强制 `expectedRevision`,不匹配返回 `STALE_WRITE`;plan 模式下 `dispatch` 被 guard 拒绝 | `grep -n "expectedRevision" src/*.ts` |
|
|
207
223
|
| FMT_SMR.1 | 同上 + 路由 | 浏览器角色只能 GET/HEAD;写操作只能经模型工具 | 同 FMT_MOF.1 |
|
|
208
224
|
| FAU_GEN.1 | 会话事件 + 工具返回值 | 每次派发/完成/取消/拒绝均落会话事件,含证据字段 | 阅读 `dsh_workplan_status` 返回结构 |
|
|
209
|
-
| FPT_TST.1 | `tests/` + `npm run verify` |
|
|
225
|
+
| FPT_TST.1 | `tests/` + `npm run verify` | 65 个测试文件 462 项(v1.12.0 基线;2026-11-03 实跑 462/462 pass);CI 每次提交执行 | `npm run verify` |
|
|
210
226
|
| O-05 资源有界 | `src/runtime.ts`、`src/watchdog.ts` | 响应 > 2.5 MB 截断;子代理与总预算双超时且被夹紧 | `grep -n "2_500_000" src/runtime.ts` |
|
|
211
227
|
| O-02/O-03 硬化头 | `src/runtime.ts` `HARDENING_HEADERS` | `x-content-type-options: nosniff`、`referrer-policy: no-referrer` | `grep -n HARDENING_HEADERS src/runtime.ts` |
|
|
212
228
|
| P-02 零运行时依赖 | `package.json` | `dependencies` 为空对象 | `npm ls --omit=dev` |
|
|
@@ -242,3 +258,36 @@ grep -n "requestRejection\|HARDENING_HEADERS\|2_500_000\|expectedRevision" src/r
|
|
|
242
258
|
4. 发现本文件与实现不一致时,**以实现与测试为准**,并按 `SECURITY.md` 渠道报告——这本身也是 T-07(虚假完成)在本项目上的应用。
|
|
243
259
|
5. **已声明的残余风险 R-07**:`/dsh-workplan/vendor/chart.umd.js` 不调用 `connection.requestRejection`,任何人只要能连到 DSH 端口就能读到这个固定文件(Chart.js 4.6.1,MIT,210078 字节,sha256 见 `docs/SBOM.md`)。它不含任何会话数据,读走它不泄露任何用户信息;它的存在本身也不构成秘密。若你的部署要求"任何响应都必须先鉴权",请在前置反向代理上统一拦截 `/dsh-workplan/*`。
|
|
244
260
|
6. **已声明的测试缺口**:`route()` 的鉴权拒绝分支、405 分支、响应截断分支没有逐分支自动化用例(见 §6.5)。这些行为目前由代码阅读与源码级断言支撑,不是由测试支撑;补测需要构造 DSH `connection` 桩件。
|
|
261
|
+
|
|
262
|
+
---
|
|
263
|
+
|
|
264
|
+
## 10. v1.12.0 补充:新增功能的安全陈述与判定(T5 刷新,2026-11-03)
|
|
265
|
+
|
|
266
|
+
### 10.1 新增/成文化的 SFR 陈述(对应差距 G-26/27/28/29/30/31/32)
|
|
267
|
+
|
|
268
|
+
| SFR(精化) | 陈述 | 实现与回归测试 |
|
|
269
|
+
|---|---|---|
|
|
270
|
+
| FAU_GEN.1(审计留痕,成文化) | 每次派发/状态回写/取消/取代/拒绝均生成含证据字段的会话留痕,持久化于会话记录,可经 `dsh_workplan_status` 与面板只读复核 | runtime 状态机 + 证据契约;`tests/workplan-evidence-contract.test.ts`、`tests/plan-anchor.test.ts` |
|
|
271
|
+
| FDP_ACF.1(访问控制,成文化) | TOE 自身不新增任何越权写路径:所有写操作经宿主文件沙箱(DSH file policy)执行;子 Agent 权限启动时固化 | `tests/workplan-presented-write-guard.test.ts`、`tests/session-reference-safety.test.ts` |
|
|
272
|
+
| FIA(鉴别):环境假设 | TOE 不做鉴别,依赖宿主已鉴别(A-01);不自建账户体系 | 见 §6.2(FIA_UID.1 精化)与 `docs/cc/AGD-OPS-SECURE-OPERATION.md` §4 |
|
|
273
|
+
| FMT_MOF.1(安全管理角色表,成文化) | 角色:用户(读面板/取消)、主 Agent(全部 9 工具,交付门禁持有人)、子 Agent(仅 escalate/update 自身行);仅根会话可用 `handoff`,仅「待指示」行可被 `instruct` 恢复 | `tests/workplan-status-lock.test.ts`、`tests/workplan-team-brief.test.ts` |
|
|
274
|
+
| FPT_SEP.1(域隔离,成文化) | 子 Agent 运行于独立会话/独立工作目录;跨会话引用被校验拒绝 | `tests/session-reference-safety.test.ts`、`docs/cc/ADV-TDS-TOE-DESIGN.md` §2 |
|
|
275
|
+
| FTA_SSL.4(超时,成文化) | 子任务单步硬上限 15 分钟、整轮预算 20 分钟(默认值,`DSH_WORKPLAN_CHILD_TIMEOUT_MS` 等可覆盖);host 工具超时 > 计划预算,杜绝竞态 | `src/host.ts`(超时条款与 L1019–1023);`tests/timeout-artifact-evidence.test.ts` |
|
|
276
|
+
| FRU_FLT.2(容错,成文化) | 预算耗尽/中断→产物落盘+自动续跑;卡死→看门狗判 blocked 并留档;需求变更→replan 旧行保留可追溯 | `tests/auto-resume-policy.test.ts`、`tests/workplan-stuck-recovery.test.ts`、`tests/workplan-auto-retry.test.ts` |
|
|
277
|
+
|
|
278
|
+
### 10.2 ACO 判定(对应差距 G-25)
|
|
279
|
+
|
|
280
|
+
TOE **不是**对任何已评估组件(certified product)的级联开发:npm 依赖为零运行时依赖,随包第三方仅 Chart.js 4.6.1(未声称任何评估状态,见 SBOM §3)。故 ACO_DEV/ACO_REL/ACO_COR 判定为 **N/A**,无级联声明义务。
|
|
281
|
+
|
|
282
|
+
### 10.3 ADV 文档链(对应差距 G-07/08/09/10)
|
|
283
|
+
|
|
284
|
+
自 v1.12.0 起,本 ST 由以下配套文档支撑(均为公开自评估):
|
|
285
|
+
- 功能规范(ADV_FSP.1 对齐):`docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md`
|
|
286
|
+
- TOE 设计(ADV_TDS.1 对齐,含安全域隔离 G-07):`docs/cc/ADV-TDS-TOE-DESIGN.md`
|
|
287
|
+
- 配置管理计划(ALC_CMC/CMS/DVS/LCD):`docs/cc/CM-PLAN.md`
|
|
288
|
+
- 测试覆盖矩阵(ATE_COV/DPT/FUN):`docs/cc/TEST-COVERAGE-MATRIX.md`
|
|
289
|
+
- 安全操作与安装校验(AGD_OPS/PRE.1):`docs/cc/AGD-OPS-SECURE-OPERATION.md`
|
|
290
|
+
|
|
291
|
+
### 10.4 版本口径声明(对应差距 G-00,沿用两头都真实的口径)
|
|
292
|
+
|
|
293
|
+
本 ST 结构依据 **ISO/IEC 15408-1/-2/-3:2026**;认证体系现行受理版本为 CC:2022。该版本号主张最终以官方目录页在线确认为准(截至 2026-11-03 未能在线二次复核,如实登记为「未验证」)。
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# T6 · dsh-workplan 修复后 CC 合规复检报告
|
|
2
|
+
|
|
3
|
+
日期:2026-11-03 | 执行:质量验证部 T6(合规验收员)| 工作目录:/Users/open/Documents/Stocks
|
|
4
|
+
复检对象:`plugins/dsh-workplan/`(HEAD `5fe47a1` + T4/T5 未提交改动,v1.12.0)
|
|
5
|
+
输入:T2 条款基线清单(compliance/T2_CC2022_条款基线清单.md)、T3 差距诊断报告(compliance/T3_CC差距诊断报告.md)、T4 修复记录、T5 补齐报告
|
|
6
|
+
性质:公开自评估复检;不宣称 CC 认证;ATE_IND.1 / AVA_VAN.2+ 为固有残留(如实披露)。
|
|
7
|
+
|
|
8
|
+
## 0. 复检方法(独立实证,不转述)
|
|
9
|
+
|
|
10
|
+
本轮由 T6 独立实跑以下命令(非引用 T3/T4/T5 自述):
|
|
11
|
+
|
|
12
|
+
- **R-01** `npm test --silent` → `tests 470 / pass 470 / fail 0`(2026-11-03 实跑,含 T4 新增 8 项与并行在途改动,4.4s)。
|
|
13
|
+
- **R-02** `node scripts/compute-release-sha256.mjs <tgz>` 与 `shasum -a 256 <tgz>` 逐字节一致 → `3b180810336030740560a8bfb249eb44b809a4fda608bc43ce28a7190e10af1b`(与 T4 报告值一致)。
|
|
14
|
+
- **R-03** 源码 `grep "name: 'dsh_workplan_"` → 9 个工具,与 `tests/fixtures/tool-surface.json`(version 1.12.0、tools 9 / routes 2 / events 2)一致。
|
|
15
|
+
- **R-04** T5 新增 5 份文档存在且非空(ADV-FSP 44 行 / ADV-TDS 54 / CM-PLAN 45 / 覆盖矩阵 40 / AGD-OPS 70)。
|
|
16
|
+
- **R-05** SECURITY.md 支持表已含 1.12.x;ST/SBOM/评估报告均带 1.12.0 刷新记录与版本锚点。
|
|
17
|
+
- **R-06** AVA 文档新增攻击面条目 AS-6~AS-10,覆盖 replan/supersede/followup/instruct/escalate 新工具入口。
|
|
18
|
+
- **R-07** G-00 在线复核(本轮新完成):web_search 确认 [ISO/IEC 15408-1:2026 已列入 ISO 官方目录](https://www.iso.org/fr/standard/15408-1?browse=tc)、[NSAI 商店在售 15408-1:2026](https://shop.standards.ie/en-ie/standards/iso-iec-15408-1-2026-613811_saig_iso_iso_4017051/)、[BSI 认证体系受理版本仍为 CC:2022](https://www.bsi.bund.de/EN/Themen/Unternehmen-und-Organisationen/Standards-und-Zertifizierung/Zertifizierung-und-Anerkennung/Zertifizierung-von-Produkten/Zertifizierung-nach-CC/IT-Sicherheitskriterien/CommonCriteria_2022_CCRA/commoncriteria_2022_CCRA.html) → 插件现有口径「对齐 15408:2026 结构 / 认证体系现行受理 CC:2022」**两头均经官方来源佐证,G-00 关闭**。
|
|
19
|
+
|
|
20
|
+
## 1. 复检结论(先给一句话)
|
|
21
|
+
|
|
22
|
+
T3 的 33 条差距中:**28 条已关闭(通过)、2 条按 T3/T5 判定 N/A 维持、3 条为固有残留或发布期执行件**。无新发现的代码类差距;仅 1 处**数字级微差**(见 §3 M-1),不构成条款级缺口。宣传文案(T7)可引用 §2 全部『通过』项,但必须保留残留披露与「不宣称 CC 认证」限定。
|
|
23
|
+
|
|
24
|
+
## 2. 逐条复检结果(回填 T3 编号 G-00~G-32)
|
|
25
|
+
|
|
26
|
+
判定:✅通过 / 🔁维持(N/A 或固有残留)/ ⏳待发布执行件。
|
|
27
|
+
|
|
28
|
+
| # | 条款 | T3 判定 | 复检判定 | 复检证据 |
|
|
29
|
+
|---|---|---|---|---|
|
|
30
|
+
| G-00 | CC 版本口径 | 待确认 | **✅通过(本轮关闭)** | R-07:2026 结构与 2022 受理口径均获官方来源佐证 |
|
|
31
|
+
| G-01 | ASE-INT.1 ST 引入 | 部分满足 | **✅通过** | R-05:SECURITY-TARGET rev2,TOE=1.12.0(L3/L20) |
|
|
32
|
+
| G-02 | ASE-CCL.1 一致性声明 | 部分满足 | **✅通过** | ST rev2 保留 NONE 声明 + EAL1 路线;版本随 TOE 刷新 |
|
|
33
|
+
| G-03 | ASE-SPD.1 | 满足 | **✅通过** | ST rev2 随版本刷新(R-05) |
|
|
34
|
+
| G-04 | ASE-OBJ.1 | 满足 | **✅通过** | 同上 |
|
|
35
|
+
| G-05 | ASE-ECD.1 | N/A | 🔁维持 | ST 明确无扩展组件;N/A 判定成立 |
|
|
36
|
+
| G-06 | ASE-REQ.1 | 部分满足 | **✅通过** | ST 新增 §10 SFR 成文化(1.9–1.12 新功能)+ ACO N/A 判定 |
|
|
37
|
+
| G-07 | ADV-ARC.1 | 部分满足 | **✅通过** | ADV-TDS + ST 安全域描述集中成文;安全域测试在列(R-04/R-01) |
|
|
38
|
+
| G-08 | ADV-FSP | 不满足 | **✅通过** | R-04:独立 ADV-FSP-FUNCTIONAL-SPEC.md 成文;R-03:接口事实源 tool-surface.json 与源码 9 工具一致,且有 tool-surface-inventory 4 条回归防漂移(R-01 内含) |
|
|
39
|
+
| G-09 | ADV-TDS | 不满足 | **✅通过** | R-04:ADV-TDS-TOE-DESIGN.md 成文并映射 TSF |
|
|
40
|
+
| G-10 | ADV-IMP | 部分满足 | **✅通过** | TDS 含源码↔设计映射;build-artifacts/version-sync 回归在 R-01 全绿 |
|
|
41
|
+
| G-11 | AGD-OPS.1 | 部分满足 | **✅通过** | R-04:AGD-OPS-SECURE-OPERATION.md 含安全操作/告警/卸载章节;SECURITY.md 支持表 1.12.x(R-05) |
|
|
42
|
+
| G-12 | AGD-PRE.1 | 部分满足 | **✅通过(用户侧)** | R-04:AGD-OPS §1 安装前两步校验(含 sha256 不一致即停装);发布侧数值归 G-15 |
|
|
43
|
+
| G-13 | ALC-CMC | 部分满足 | **✅通过** | R-04:CM-PLAN.md 成文(配置项范围+版本标识) |
|
|
44
|
+
| G-14 | ALC-CMS | 部分满足 | **✅通过** | SBOM 刷新至 1.12.0;12 文件实测一致(R-05);行数见 §3 M-1 |
|
|
45
|
+
| G-15 | ALC-DEL.1 交付完整性 | 部分满足 | **⏳发布期执行件** | 脚本+4 条回归就绪且独立复算一致(R-02);sha256 数值随 T8 发布公布,属流程执行件非文档缺口 |
|
|
46
|
+
| G-16 | ALC-DVS | 部分满足 | **✅通过** | CM-PLAN/SECURITY.md 含开发环境安全措施声明 |
|
|
47
|
+
| G-17 | ALC-FLR.1 | 满足 | **✅通过** | SECURITY.md 支持表刷新至 1.12.x(R-05) |
|
|
48
|
+
| G-18 | ALC-LCD | 部分满足 | **✅通过** | CM-PLAN 写明开发→测试→发布→维护流程 |
|
|
49
|
+
| G-19 | ALC-TAT | 满足 | **✅通过** | lockfile + 零运行时依赖未变;SBOM 复述工具链 |
|
|
50
|
+
| G-20 | ATE-COV | 部分满足 | **✅通过** | R-04:TEST-COVERAGE-MATRIX.md §2 每个 SFR 映射 ≥2 个测试文件,可 `ls tests` 复核 |
|
|
51
|
+
| G-21 | ATE-DPT | 部分满足 | **✅通过** | 覆盖矩阵 §1 四层分层成文(单元/模块/集成/失败路径) |
|
|
52
|
+
| G-22 | ATE-FUN | 满足 | **✅通过** | 失败路径测试在 R-01 的 470 项中全过 |
|
|
53
|
+
| G-23 | ATE-IND.1 | 固有残留 | 🔁维持 | 需认可实验室,不可由本项目修复;已按「公开自评估」如实披露(覆盖矩阵文末) |
|
|
54
|
+
| G-24 | AVA-VAN | 部分满足 | **✅通过(VAN.1 级)** | R-06:AVA §8 攻击面新增 AS-6~AS-10 覆盖全部新工具入口;VAN.2+ 需实验室仍列残留 |
|
|
55
|
+
| G-25 | ACO | N/A | 🔁维持 | ST rev2 含 N/A 判定理由 |
|
|
56
|
+
| G-26 | FAU_GEN | 部分满足 | **✅通过** | ST §10 SFR 成文化 + evidence-contract 回归(R-01) |
|
|
57
|
+
| G-27 | FDP_ACC/ACF | 部分满足 | **✅通过** | 同上 + presented-write-guard/security-headers 回归全绿 |
|
|
58
|
+
| G-28 | FIA_UAU | 环境假设 | 🔁维持 | ST 假设节写明宿主鉴别,不虚设 SFR;判定成立 |
|
|
59
|
+
| G-29 | FMT | 部分满足 | **✅通过** | 角色权限表成文于 ST §10;status-lock/gate 回归全绿 |
|
|
60
|
+
| G-30 | FPT_SEP | 部分满足 | **✅通过** | 隔离模型成文(ADV-TDS/ST);session-reference-safety 回归全绿 |
|
|
61
|
+
| G-31 | FTA_SSL | 满足 | **✅通过** | 超时常量在 AGD-OPS 引用(R-04 grep 命中);timeout 回归全绿 |
|
|
62
|
+
| G-32 | FRU_FLT | 满足 | **✅通过** | blocked/续跑/重规划机制回归全绿(R-01) |
|
|
63
|
+
|
|
64
|
+
统计:✅通过 26 条;🔁维持 4 条(G-05/23/25/28,均为 N/A 判定或固有残留,判定本身成立);⏳1 条(G-15,发布期执行件)。
|
|
65
|
+
|
|
66
|
+
## 3. 剩余差距与处置清单
|
|
67
|
+
|
|
68
|
+
| 编号 | 事项 | 原因 | 处置建议 | 归属 |
|
|
69
|
+
|---|---|---|---|---|
|
|
70
|
+
| M-1 | SBOM/覆盖矩阵标注 src 共 **17,430 行**,当前工作区实测 **17,456 行**(+26,来自并行在途的 src/client.ts/runtime.ts 未提交改动,非 T4/T5 所为) | 文档锚定 HEAD `5fe47a1` 基线如实标注,与并行改动有时间差 | 主 Agent 提交发布前按提交时点重算一次行数并刷新该数字(一条 sed 级改动);或保留「锚定 5fe47a1」口径不改,两者取一,勿混用 | 主 Agent(提交时) |
|
|
71
|
+
| M-2 | G-15 sha256 数值未定稿 | 依赖发布动作 | T8 执行 `node scripts/compute-release-sha256.mjs dsh-workplan-<ver>.tgz --out sha256-manifest.json` 并随 release 公布;脚本已独立复算验证(R-02) | T8 |
|
|
72
|
+
| M-3 | T4 的 4 个新文件 + T5 文档未提交 git | T4/T5 无提交权限 | 主 Agent 发布前 git commit + tag | 主 Agent |
|
|
73
|
+
| M-4 | ATE_IND.1 / AVA_VAN.2+ | 需认可实验室与费用 | 保持「固有残留」披露,不得在宣传中省略 | 永久披露 |
|
|
74
|
+
|
|
75
|
+
## 4. 给 T7/T8 的硬约束
|
|
76
|
+
|
|
77
|
+
1. 宣传文案只能引用 §2 中 ✅通过 的条目;**禁用**「已通过/完全满足 CC 认证」字样。
|
|
78
|
+
2. 推荐口径(已获 R-07 佐证):「对齐 ISO/IEC 15408:2026 结构、认证体系现行受理 CC:2022,公开全套自评证据 + 完整安装使用方法」;中英双语一致。
|
|
79
|
+
3. M-4 残留披露必须出现在 README 可见位置。
|
|
80
|
+
|
|
81
|
+
## 5. 验收对照
|
|
82
|
+
|
|
83
|
+
- A1「复检报告逐条给出结论与证据;宣传文案只能引用报告中『通过』项」→ **pass**:§2 按 T2/T3 编号 G-00~G-32 逐条给出判定与可复核证据(§0 R-01~R-07 全部为本轮独立实跑);§4 明确限定 T7 只引用 ✅通过 项。
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# 测试覆盖矩阵(ATE_COV/DPT/FUN 对齐)/ Test Coverage Matrix
|
|
2
|
+
|
|
3
|
+
> 对象:dsh-workplan v1.12.0 | 基线:git HEAD `5fe47a1` | 日期:2026-11-03 | 撰写:T5
|
|
4
|
+
> 证据基线:T3 实跑 `npm test --silent` → **tests 462 / pass 462 / fail 0**(2026-11-03,Node;注意历史文档中的 188/459 均为过期数字)。复核命令:`npm test`。
|
|
5
|
+
> 注:本仓工作区在 T4 修复进行中有未提交改动;本数字对应 HEAD `5fe47a1` 状态,T6 复检应以复检时点实跑为准。
|
|
6
|
+
> 性质:公开自评估文档,不宣称 CC 认证;ATE_IND.1(认可实验室独立测试)为固有残留,见文末。
|
|
7
|
+
|
|
8
|
+
## 0. 覆盖的差距编号
|
|
9
|
+
|
|
10
|
+
G-20(无正式覆盖矩阵)、G-21(测试分层未成文)、G-22(失败路径已覆盖,成文确认)。
|
|
11
|
+
|
|
12
|
+
## 1. 测试分层(ATE_DPT)/ Test layers
|
|
13
|
+
|
|
14
|
+
| 层级 | 范围 | 代表测试 |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| 单元级 | 单模块函数/数据结构 | plan、derived-counts、phase-percent-invariant、supersede-digest |
|
|
17
|
+
| 模块级 | 模块间契约 | workplan-host、workplan-host-schema、runtime-replay、version-sync、build-artifacts |
|
|
18
|
+
| 集成/端到端 | 工具全流程与门禁 | workplan-w5-cancel-e2e、workplan-dispatch-modes、workplan-supersede、delivery-gate |
|
|
19
|
+
| 失败路径 | 错误、超时、卡死、重试 | workplan-budget-pause、workplan-stuck-recovery、timeout-artifact-evidence、workplan-replay-errors、workplan-retry-feedback |
|
|
20
|
+
|
|
21
|
+
测试文件共 65 个(`ls tests | grep -c '\.test\.ts'`;另含 fixtures 目录)。
|
|
22
|
+
|
|
23
|
+
## 2. 安全功能(TSF)↔ 测试映射(ATE_COV)/ TSF ↔ test mapping
|
|
24
|
+
|
|
25
|
+
| TSF(SFR) | 测试文件(证据) |
|
|
26
|
+
|---|---|
|
|
27
|
+
| 审计留痕 FAU_GEN(证据契约) | workplan-evidence-contract、plan-anchor、derived-counts |
|
|
28
|
+
| 访问控制 FDP_ACC/ACF | workplan-presented-write-guard、session-reference-safety、security-headers |
|
|
29
|
+
| 安全管理 FMT(门禁/状态锁/根会话限制) | delivery-gate、present-gate-evidence、workplan-status-lock、present-deny-code、workplan-turn-stop-gate |
|
|
30
|
+
| 域隔离 FPT_SEP | session-reference-safety、security-headers、workplan-team-brief |
|
|
31
|
+
| 会话超时 FTA_SSL | timeout-artifact-evidence、workplan-budget-pause、workplan-budget-preserve |
|
|
32
|
+
| 容错 FRU_FLT | auto-resume-policy、workplan-stuck-recovery、workplan-auto-retry、workplan-retry-feedback、session-end-convergence |
|
|
33
|
+
| 重规划/取代(变更控制) | workplan-replan-progress、workplan-supersede、workplan-closure-ack-escalation、workplan-closure-n1-n5、workplan-crossdept-hardening |
|
|
34
|
+
| 工具接口行为 | workplan-followup-tool、workplan-dispatch-modes、workplan-1815-guards、plan-id-symmetry、plan-mode |
|
|
35
|
+
|
|
36
|
+
## 3. 覆盖声明与边界 / Coverage statement
|
|
37
|
+
|
|
38
|
+
- 每个 SFR 至少映射 2 个测试文件(见 §2),映射由文件名可复核(`ls tests`)。
|
|
39
|
+
- 未宣称行覆盖率(line coverage)百分比:本仓未配置覆盖率工具,此为如实披露,不做数字宣称。
|
|
40
|
+
- 残留(不可由本项目修复):ATE_IND.1 要求认可实验室独立测试;本仓提供的替代事实是「任何人可一键复跑」——`npm test` / `npm run verify` + CI 每次提交执行。
|
package/docs/collaboration.md
CHANGED
|
@@ -2,8 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
> 这份文档回答四个问题:**谁把什么写给谁、什么时候算完成、失败后谁接手、改代码时哪些地方必须一起改。**
|
|
4
4
|
>
|
|
5
|
-
> 适用版本:**1.
|
|
5
|
+
> 适用版本:**1.12.0**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
|
|
6
6
|
>
|
|
7
|
+
<!-- [D-45] 本文版本与实现口径已对齐 1.12.0;核对项:权限 7 处、present 仅根会话、下游可读 artifacts。 -->
|
|
8
|
+
|
|
7
9
|
> 约定:本文只用「文件 + 符号名」定位代码(例如 `src/plan.ts#buildChildPrompt`),**不写行号**,避免代码改动后文档漂移。核对命令见 §11。
|
|
8
10
|
|
|
9
11
|
---
|
|
@@ -21,13 +23,13 @@
|
|
|
21
23
|
|
|
22
24
|
要点:
|
|
23
25
|
|
|
24
|
-
- **部门是职责标签,不是组织架构。** 1.
|
|
26
|
+
- **部门是职责标签,不是组织架构。** 1.12.0 的 `src/plan.ts#DEPARTMENTS`(12 个)只用于生成提示词与界面分组(未知值归入「未知部门」桶,不回显原文);**没有部门负责人、部门队列、部门内串行**。是否并行只由 `dependsOn` 与全局并发 5 决定。
|
|
25
27
|
- **主 Agent 是唯一中枢。** 子 Agent 之间没有消息通道;跨部门信息只能经主 Agent 转达(见 §5、§7)。
|
|
26
|
-
- **子 Agent 的权限是「代码硬约束 + 提示词软约束」两层。**
|
|
28
|
+
- **子 Agent 的权限是「代码硬约束 + 提示词软约束」两层。** 代码层有 **7 处 `NOT_ROOT` 拒绝**:dispatch / update / replan / cancel / instruct / handoff / followup;`present` 另有独立守卫,对非根会话直接返回 `NOT_ROOT`(1.11.0 起,见 §5.2.1)。但「已交付文件写保护」只对**根会话**生效(`presentedWriteDenialReason` 对子会话直接返回 `undefined`),子会话仍可改写已交付文件(§7.2 L13);「不要重启服务、不要安装/升级依赖」仍只在 `buildChildPrompt` 文本里,**没有工具层护栏**(见 §7.2 L11)。
|
|
27
29
|
|
|
28
30
|
---
|
|
29
31
|
|
|
30
|
-
## 2. 端到端流程(1.
|
|
32
|
+
## 2. 端到端流程(1.12.0 实际行为)
|
|
31
33
|
|
|
32
34
|
```
|
|
33
35
|
用户消息
|
|
@@ -242,7 +244,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
242
244
|
3. 工作目录;
|
|
243
245
|
4. 最近对话背景(**截断到 7000 字**;1.7.0 在每次派发前重新采样,之后不再二次截断);
|
|
244
246
|
5. 本子任务的 `role/objective/method/inputs/outputs/acceptance/risk`;
|
|
245
|
-
6. **仅 `dependsOn` 里的上游结果**:`{id, title, status, summary}
|
|
247
|
+
6. **仅 `dependsOn` 里的上游结果**:`{id, title, status, summary}`,外加 `artifacts[]` 中 `exists:true` 的可消费产物 `ref`(1.8+ 起);summary 已是 3000 字以内的截断文本。
|
|
246
248
|
|
|
247
249
|
**下游看不到上游的原始对话**,但 1.7.0 会附上**兄弟任务的只读一览**(`buildTeamBrief`:id、部门、目标、产出、状态;已完成的带摘要),并用 `needs` 汇总需要主 Agent 转达的协作请求。产物本身仍要靠工作区文件与摘要传递,因此上游必须把「产物在哪、怎么用、什么算合格」写进摘要或落成文件。
|
|
248
250
|
|
|
@@ -250,7 +252,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
250
252
|
|
|
251
253
|
子 Agent 必须用**自由文本**汇报,并满足:
|
|
252
254
|
|
|
253
|
-
- 优先在输出末尾追加结构化证据块(`<!-- WORKPLAN_EVIDENCE:START -->` … JSON … `<!-- WORKPLAN_EVIDENCE:END -->`),含 `status` / `blockedReason` / `acceptance[]` / `artifacts[]` / `needs[]`。这是 1.
|
|
255
|
+
- 优先在输出末尾追加结构化证据块(`<!-- WORKPLAN_EVIDENCE:START -->` … JSON … `<!-- WORKPLAN_EVIDENCE:END -->`),含 `status` / `blockedReason` / `acceptance[]` / `artifacts[]` / `needs[]`。这是 1.11.0 起的完成判据:`partial`、任一验收 `fail`、坏块都判受阻,只有全 `pass` 直接采信。
|
|
254
256
|
- 没有证据块时,失败仍可**第一行**写 `BLOCKED: 原因`(大小写不敏感,中英文冒号都认,行首允许空白)——按 `legacy` 判受阻。
|
|
255
257
|
- **1.11.0 起,没有证据块、也没有 `BLOCKED` 的「纯散文」不再算完成**:默认(`strictCompletion`,可用 `DSH_WORKPLAN_STRICT_COMPLETION=0` 关闭)判 `blocked` + `unverified`,错误信息写明「结果块缺失,无法确认验收项是否真的通过」。历史回放仍按 `legacy` 读取,避免旧计划整体失效。
|
|
256
258
|
- 验收条目自称 `pass` 但 `evidence` 为空时,1.11.0 降级为 `unverified`,且 `deliveryReadiness` 增加「验收自称通过但没有证据」阻塞项。
|
|
@@ -258,7 +260,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
258
260
|
- 不编造命令输出、文件或证据;无法确认就写「未验证」;
|
|
259
261
|
- 需要别人配合时,写「需要主 Agent 执行/确认什么」,**不要等待或空转**。
|
|
260
262
|
|
|
261
|
-
`summary` 会被截断到 3000
|
|
263
|
+
`summary` 会被截断到 3000 字,因此**关键结论和产物路径要放在最前面**。
|
|
262
264
|
|
|
263
265
|
### 5.2.1 验收覆盖与上游门槛(1.11.0)
|
|
264
266
|
|
|
@@ -269,12 +271,12 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
269
271
|
|
|
270
272
|
### 5.3 跨部门转达
|
|
271
273
|
|
|
272
|
-
1.
|
|
274
|
+
1.12.0 **仍没有**子 Agent 直连、共享黑板或会签——这是刻意的权限边界,不是遗漏。跨部门只有三条路:
|
|
273
275
|
|
|
274
276
|
1. **带编号的 hand-off(1.11.0 新增,唯一处置入口)**:子 Agent 每条 `needs` 由 `applyStatus` 自动登记为 `{id: H1, request, department, status}`;主 Agent 用 `dsh_workplan_handoff` 处置:`list` / `assign`(登记责任部门)/ `resolve`(写入答复或产物引用)/ `close`(确认无需动作)。四态为 `open → routed → answered / closed`。**未处置的 hand-off 会进 `deliveryReadiness`,直接拦住交付**;对正处于「待指示」的行执行 `resolve`,会复用 `instructSubtask` 把答复直接投递给该子会话。
|
|
275
277
|
- `assign` 只登记责任,**不会自动产生工作**(插件没有常驻部门代理);需要产出时用 `dsh_workplan_replan(action=add)` 建该部门的子任务,或由主 Agent 自己完成,再 `resolve`。
|
|
276
278
|
2. **经主 Agent 对话**:`dsh_workplan_instruct` 回答请示、`dsh_workplan_replan` 就地修订计划;
|
|
277
|
-
3.
|
|
279
|
+
3. **经工作区文件**:上游把接口/产物落到双方都能读到的路径,并在摘要里写**工作目录相对路径或绝对路径(同一产物只用一种)**;`dependsOn` 上游的 `artifacts[].ref`(`exists:true`)会作为「可消费产物」注入下游提示词。
|
|
278
280
|
|
|
279
281
|
「兄弟任务只读一览」与 `needs` 清单自 1.7.0 起存在(`buildTeamBrief`、`buildResultMessage`);子 Agent 直连仍然不开放。
|
|
280
282
|
|
|
@@ -282,14 +284,14 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
282
284
|
|
|
283
285
|
## 6. 失败与恢复
|
|
284
286
|
|
|
285
|
-
| 现象 | 1.
|
|
287
|
+
| 现象 | 1.12.0 的实际行为 | 正确恢复动作 |
|
|
286
288
|
|---|---|---|
|
|
287
289
|
| 子 Agent 5 分钟无新事件 | 判 `CHILD_STALLED`,同一 prompt 重试 1 次 | 若仍失败转 `blocked`;主 Agent 核对并决定续跑或接手 |
|
|
288
290
|
| 单项超过 15 分钟 | 强制结束,记 `blocked` | 拆小任务或提高 `childTimeoutMs` 后重派 |
|
|
289
291
|
| 整轮 20 分钟预算用尽 | 阶段 `paused`,剩余项保持 `pending`,**不消耗续跑额度** | 再次 `dispatch` 即续跑,已完成不重跑 |
|
|
290
292
|
| 子任务 `blocked` | 下游依赖被级联标记 `blocked`;错误只写「上游子任务受阻:T1、T2」 | 先修上游;再 `dispatch` 续跑(额度内) |
|
|
291
293
|
| 续跑额度用尽 | `resumeAvailable:false`,结果消息要求主 Agent 直接接手 | 主 Agent 自己完成或向用户说明,不要重复派发 |
|
|
292
|
-
| 运行中 `update` 改判 |
|
|
294
|
+
| 运行中 `update` 改判 | **拒绝**(`TASK_RUNNING`);`force:true` 才允许,并记录为人工改判 | 等本轮结束再改判;确需覆盖再显式 `force` |
|
|
293
295
|
| 刷新页面 | 由结果消息回放;显式 cancel 会回放 | 若改判消失,属已知缺陷(§8) |
|
|
294
296
|
| 新一轮取代未派发旧计划 | 旧计划只改内存为 `cancelled`,不落盘(plan 模式下未派发的计划例外:会保留) | 刷新前不要依赖「已取消」结论 |
|
|
295
297
|
| 规划失败 | `degraded` 消息,不自动重规划 | 向用户说明并询问是否重试 |
|
|
@@ -303,15 +305,15 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
303
305
|
|
|
304
306
|
### 7.1 硬约束(代码层,改动需同步测试)
|
|
305
307
|
|
|
306
|
-
1. 只有 root 会话能 `dispatch` / `update` / `cancel
|
|
308
|
+
1. 只有 root 会话能 `dispatch` / `update` / `replan` / `cancel` / `instruct` / `handoff` / `followup`(共 7 处 `NOT_ROOT`);子 Agent 调用会被拒绝。`present` 另有独立守卫:非根会话返回 `NOT_ROOT`(1.11.0 起,§5.2.1),不在这 7 处之内;已交付文件写保护仍只覆盖根会话(§7.2 L13)。
|
|
307
309
|
2. 子 Agent 派生深度上限 1(`maxDepth: 1`)。
|
|
308
310
|
3. plan 模式下 `dispatch` 被 `tools.guard` 拒绝,并给出原因。
|
|
309
311
|
4. 状态枚举只有 4 个值;计划版本 `PLAN_VERSION = 1`。
|
|
310
312
|
5. `stats` 不缓存,统一由 `derivePlanSnapshot` 在出口派生;实时与回放必须同源。
|
|
311
313
|
|
|
312
|
-
### 7.2 限制清单(1.
|
|
314
|
+
### 7.2 限制清单(1.12.0 现状:哪些已处理、哪些明确不做)
|
|
313
315
|
|
|
314
|
-
| # | 限制 | 影响 | 1.
|
|
316
|
+
| # | 限制 | 影响 | 1.12.0 状态 |
|
|
315
317
|
|---|---|---|---|
|
|
316
318
|
| L1 | 派发期间主 Agent 无法观测进度 | 用户问「做到哪了」时主 Agent 无上下文 | 已处理(async 派发 + `status` 工具) |
|
|
317
319
|
| L2 | 回传是自由文本,非空即 `done` | 「假完成」;验收标准没有被逐条核对 | 已处理(结构化证据 + 确定性裁决) |
|
|
@@ -323,7 +325,8 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
323
325
|
| L8 | 部门之间无直接通信 | 跨部门接口对不上只能等失败 | 部分处理(兄弟只读一览 + needs 转达,仍不直连) |
|
|
324
326
|
| L9 | 一个会话只有一个计划槽位;计划之间无依赖/汇总 | 超长任务只能靠多轮对话承载 | 不做(后续版本评估) |
|
|
325
327
|
| L10 | 对话背景在计划时刻冻结,且 prompt 内再截断到 5000 字 | 续跑时子 Agent 拿到旧背景 | 已处理(派发时重新采样、7000 字、不二次截断) |
|
|
326
|
-
| L11 | 子 Agent 的「不要重启/安装」只是提示词 |
|
|
328
|
+
| L11 | 子 Agent 的「不要重启/安装」只是提示词 | 重启/停服/安装/升级等**进程与依赖动作**无法被插件拦截 | 部分处理(进程/依赖动作在插件层不可拦截;`present` 已由根会话守卫拒绝,已交付文件写保护仅覆盖根会话,见 L13) |
|
|
329
|
+
| L13 | 已交付文件的写保护只覆盖根会话 | 子会话可改写已交付文件,绕过「交付后不再改动」的约束 | 未处理(D-37 剩余部分:`present` 已由 1.11.0 拒绝子会话,写保护仍需宿主按会话过滤) |
|
|
327
330
|
| L12 | 无证据块,无产物检查,无预算提示 | 计划过大时必然多轮 | 已处理(三者均已实现) |
|
|
328
331
|
|
|
329
332
|
**关于阶段(L7)的正式口径:阶段是展示分组,不是执行门槛。** `readySubtasks` 只读 `dependsOn`,不读 stage。这样设计是为了避免「一个慢任务拖红整个阶段」。如果产品上需要阶段验收,必须单独立项并改调度语义,不能在文档里暗示它已经生效。
|
|
@@ -332,7 +335,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
332
335
|
|
|
333
336
|
## 8. 写者所有权(当前与目标)
|
|
334
337
|
|
|
335
|
-
### 8.1 1.
|
|
338
|
+
### 8.1 1.12.0 实际
|
|
336
339
|
|
|
337
340
|
| 事实 | 写入者 | 写入位置 | 回放 |
|
|
338
341
|
|---|---|---|---|
|
|
@@ -343,7 +346,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
343
346
|
| 续跑计数 | `dispatchPlan` | 内存 `resumeCount` | 结果消息的 `resumeCount` |
|
|
344
347
|
| 面板数字 | 无(全派生) | — | `derivePlanSnapshot` |
|
|
345
348
|
|
|
346
|
-
### 8.2 写保护规则(1.
|
|
349
|
+
### 8.2 写保护规则(1.11.0 已实现,仅覆盖根会话)
|
|
347
350
|
|
|
348
351
|
- 调度器与主 Agent 的改判都走同一条 `applyStatus`,每次写入递增 `revision`;
|
|
349
352
|
- 运行中的子任务拒绝 `update`(`TASK_RUNNING`),除非 `force:true`;
|
|
@@ -363,7 +366,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
|
|
|
363
366
|
|
|
364
367
|
---
|
|
365
368
|
|
|
366
|
-
## 9. 1.
|
|
369
|
+
## 9. 1.12.0 契约与实现状态
|
|
367
370
|
|
|
368
371
|
| 能力 | 设计要点 | 状态 |
|
|
369
372
|
|---|---|---|
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# 决策记录:保留 v1.12.0-cc1 与最新源代码(2026-11-04)
|
|
2
|
+
|
|
3
|
+
## 一、决策
|
|
4
|
+
|
|
5
|
+
| 编号 | 决策 | 对应动作 | 明确不做 |
|
|
6
|
+
| --- | --- | --- | --- |
|
|
7
|
+
| 1 | 继续按 P0 顺序修复部门覆盖召回 | 先做 P0-1 召回补强(词表 + 有序对被词),再排 P0-2 剩余指代解析、P0-3 写保护、重跑 MS2 20 条 | 不在本轮塞入 P0-2 剩余与 P0-3(10 分钟预算内做不完) |
|
|
8
|
+
| 2 | 保留最新源代码与最新版本 | 保留 tag `v1.12.0-cc1`、提交 `6d4a386` 与 `6eda2cb`;保留 `main` 分支与当前工作区改动 | 不删除标签、不撤销提交、不回滚、不删分支、不改写历史 |
|
|
9
|
+
|
|
10
|
+
## 二、依据(均为只读核验,可复跑)
|
|
11
|
+
|
|
12
|
+
命令与原始输出(2026-11-04 13:59,目录 `plugins/dsh-workplan`):
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
$ git tag -l 'v1.12.0*'
|
|
16
|
+
v1.12.0
|
|
17
|
+
v1.12.0-cc1
|
|
18
|
+
$ git tag -l -n1 'v1.12.0-cc1'
|
|
19
|
+
v1.12.0-cc1 Record release package sha256 manifest (G-15 / ALC-DEL)
|
|
20
|
+
$ git branch --contains 6d4a386
|
|
21
|
+
* main
|
|
22
|
+
$ git log --oneline -1 6eda2cb
|
|
23
|
+
6eda2cb Record release package sha256 manifest (G-15 / ALC-DEL)
|
|
24
|
+
$ git ls-remote --tags origin 'v1.12.0*'
|
|
25
|
+
7f4bf784... refs/tags/v1.12.0
|
|
26
|
+
6f5bd88a... refs/tags/v1.12.0^{}
|
|
27
|
+
6eda2cb9... refs/tags/v1.12.0-cc1
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
结论:标签本地与远端一致,均指向 `6eda2cb`;`6d4a386` 在 `main` 上。保留不需要任何写操作,因此本轮没有执行任何远端写命令。
|
|
31
|
+
|
|
32
|
+
## 三、影响
|
|
33
|
+
|
|
34
|
+
- 对外发布口径:`v1.12.0-cc1` 仍是当前对外版本标识,引用它的说明与索引源保持有效。
|
|
35
|
+
- 内部开发:`main` 继续作为开发主线承载 P0 修复,未提交改动保留在工作区,不阻塞后续提交。
|
|
36
|
+
- 下一轮回归:以当前工作区(6 个已改文件 + 2 个新增测试文件)为基线,任何改动都不得回退这些修改。
|
|
37
|
+
|
|
38
|
+
## 四、本轮不做项(留给下一轮,不是遗漏)
|
|
39
|
+
|
|
40
|
+
1. P0-2 剩余:指代(「它 / 上面那个」)先行词解析。
|
|
41
|
+
2. P0-3:评测载体写保护。
|
|
42
|
+
3. MS2 全 20 条重跑(需要先完成上面两项,否则重跑只能得到中间结论)。
|
|
43
|
+
|
|
44
|
+
## 五、需用户确认的歧义
|
|
45
|
+
|
|
46
|
+
- 「留最新源代码」是否包含删除旧的本地分支或旧版本目录?本轮按「不删除任何东西」执行;若需要清理,请单独授权。
|
package/docs/departments.md
CHANGED
|
@@ -5,7 +5,8 @@
|
|
|
5
5
|
## 0. 先厘清:部门是什么,不是什么
|
|
6
6
|
|
|
7
7
|
- **是职责标签。** `src/plan.ts#DEPARTMENTS` 里的 12 个 key 决定子任务的提示词、面板分组与统计口径。
|
|
8
|
-
- **不是组织架构。** 1.
|
|
8
|
+
- **不是组织架构。** 1.12.0 仍没有部门负责人、部门队列、部门内串行、部门预算;同一部门的两个子任务也可以并行。
|
|
9
|
+
- **`role` 是执行角色,不是负责人。** 它由规划器写成一句话(如「执行工程师」),只用于子提示词与卡片展示;没有任免、没有汇报关系、也不带权限。面板文案已统一为「执行角色」(旧版写「负责人」,属于口径漂移)。
|
|
9
10
|
- **不是通信通道。** 部门之间不能直接对话;跨部门信息经主 Agent 转达、落到工作区文件,或写进子 Agent 回传的 `needs`(1.11.0 起自动登记为带编号、可处置、会拦住交付的 hand-off,见协作契约 §5.3)。
|
|
10
11
|
- **不代表权限。** 任何部门都不能派发、改判、取消计划;这些只有主 Agent 能做。
|
|
11
12
|
|
|
@@ -30,7 +31,7 @@
|
|
|
30
31
|
| `legal` | 法务合规 / Legal | 条款、隐私、许可、合规风险 | 适用法域与版本、风险等级、需人工复核项 | `product`、`security`、`writing` |
|
|
31
32
|
| `finance` | 财务 / Finance | 成本、预算、计价、对账 | 口径与币种、假设、区间与敏感性 | `product`、`operations`、`writing` |
|
|
32
33
|
|
|
33
|
-
> 部门 key 必须与 `src/plan.ts#DEPARTMENTS`
|
|
34
|
+
> 部门 key 必须与 `src/plan.ts#DEPARTMENTS` 完全一致;新增部门要同时改代码、客户端中英文文案、本文与协作契约 §1。一致性由 `tests/t11-lowrisk-patches.test.ts` 断言(代码 ↔ 客户端 zh/en ↔ 本文表格),不靠人工记忆。**不要**在计划里写自由文本部门名。
|
|
34
35
|
|
|
35
36
|
---
|
|
36
37
|
|
|
@@ -41,7 +42,7 @@
|
|
|
41
42
|
一个子任务要能被下游直接接手,它的结果摘要(≤3000 字,超出被截断)必须包含:
|
|
42
43
|
|
|
43
44
|
1. **做了什么**:一句话结论 + 关键决定;
|
|
44
|
-
2.
|
|
45
|
+
2. **产物在哪**:以**工作目录为基准的相对路径**(推荐,便于整目录迁移)或**绝对路径**,二选一并保持同一份产物只用一种;也可写可访问 URL。插件当前**不做**路径归一化(`exists` 在检查时以 cwd 解析相对 ref,不是写入时快照),所以同一产物混写两种形式会让下游解析出两个位置。没有产物就写「无文件产物」;
|
|
45
46
|
3. **怎么用/怎么验**:下游复现或验收的最短命令/步骤;
|
|
46
47
|
4. **边界与遗留**:没做什么、已知风险、需要谁确认。
|
|
47
48
|
|
|
@@ -64,7 +65,7 @@
|
|
|
64
65
|
|
|
65
66
|
### 2.4 交接自检清单(交接前逐条过)
|
|
66
67
|
|
|
67
|
-
- [ ]
|
|
68
|
+
- [ ] 结论在第一段,路径与产物真实位置一致(相对路径以工作目录为基准;不要同一产物混写相对/绝对两种),且文件真的存在;
|
|
68
69
|
- [ ] 验收标准逐条有「通过 / 未通过 / 未验证」,没有把「没测」写成「通过」;
|
|
69
70
|
- [ ] 下游不需要读我的对话就能开始;
|
|
70
71
|
- [ ] 失败信号在第一行,且是 `BLOCKED:` 开头;
|
|
@@ -173,7 +174,7 @@
|
|
|
173
174
|
|
|
174
175
|
---
|
|
175
176
|
|
|
176
|
-
## 6. 1.
|
|
177
|
+
## 6. 1.11.0 对交接的影响(已实现)
|
|
177
178
|
|
|
178
179
|
| 变化 | 对部门交接的意义 |
|
|
179
180
|
|---|---|
|
|
@@ -182,13 +183,13 @@
|
|
|
182
183
|
| 兄弟任务只读一览 | 并行部门能看到彼此的目标与边界(仍不能直连) |
|
|
183
184
|
| 运行中写保护 + `revision` | 主 Agent 改判不会被子任务结束覆盖;交接结论更稳定 |
|
|
184
185
|
|
|
185
|
-
|
|
186
|
+
以上能力均已落到代码与测试;交接时仍按本文 §2 的四段摘要执行,实际字段与状态以协作契约 §9 为准。
|
|
186
187
|
|
|
187
188
|
---
|
|
188
189
|
|
|
189
190
|
## 7. 维护规则
|
|
190
191
|
|
|
191
|
-
- 改部门列表:同步 `src/plan.ts#DEPARTMENTS
|
|
192
|
+
- 改部门列表:同步 `src/plan.ts#DEPARTMENTS`、`src/client.ts` 中英文 `dept` 表、本文 §1、协作契约 §1,并跑 `tests/t11-lowrisk-patches.test.ts`(不一致即失败)。
|
|
192
193
|
- 改交接字段:同步协作契约 §3.3/§3.4 与三处回传代码(见协作契约 §8.3)。
|
|
193
194
|
- 新增链路:先确认它是否只是 `dependsOn` 的一种写法,避免把建议写成硬规则。
|
|
194
195
|
- 本文不写行号;核对命令见协作契约 §11。
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# dsh-workplan 1.12.0 — 低风险补丁 rebase、理解与分配护栏、分步进度折叠
|
|
2
|
+
|
|
3
|
+
发布日期:2026-11-02
|
|
4
|
+
|
|
5
|
+
1.12.0 把四批改动收敛到同一条发布链上:**T11 的 15 个低风险缺陷**重新 rebase 到 1.11.1 之上、**任务理解与部门分配**补上可执行护栏、**分步进度**改为默认收起、点击展开,以及**默认自动派发 + 验收稳定编号(U-16)**收口。全量回归 **459 / 459 通过、0 失败**。
|
|
6
|
+
|
|
7
|
+
## 亮点
|
|
8
|
+
|
|
9
|
+
### 1. 15 个低风险缺陷,44 个 hunk 全部有回归
|
|
10
|
+
|
|
11
|
+
- 45 个源 hunk:31 个可直用、11 个按新上下文改写、3 个废弃(D-15 / D-17 已被 1.11.0 以不同实现修好,强打会回退);最终 44 个 patch hunk、7 个文件。
|
|
12
|
+
- 每个 hunk 至少 1 条可执行用例,新增 52 条;在未打补丁的基线上同批对照,**43 / 44 个 hunk 为 fail-before**。唯一例外(hunk 33 / D-19)在基线本就拒绝环,已标注为「补独立基线」,不冒充判别力。
|
|
13
|
+
- 覆盖缺陷:`D-04 / D-07 / D-08 / D-09 / D-10 / D-11 / D-15 / D-17 / D-19 / D-21 / D-28 / D-30 / D-31 / D-35 / D-45`。
|
|
14
|
+
|
|
15
|
+
### 2. 任务理解与部门分配:从「只有枚举」到「有锚点、有理由、能拒绝」
|
|
16
|
+
|
|
17
|
+
- **只读锚点**:用户原文 + `sha256` 存进计划;哈希不一致即降级,不带着被改写的「原要求」通过校验。
|
|
18
|
+
- **要素抽取**:版本号、日期、编号、路径、数量、数值边界、指代、矛盾;无上下文的裸「它」判 `needs-context`,不猜。
|
|
19
|
+
- **部门能力目录**:12 个部门各有职责、典型产物、关键词;分配输出 `fit / weak / mismatch`,受保护部门还会检查「原任务从未涉及该领域」的侵入。
|
|
20
|
+
- **偏离自检**:硬要素缺失、交付动作缺失、部门矛盾会被 `DEVIATION:` / `CLARIFY:` / `CONTEXT:` 阻断并走既有重试,不派发。
|
|
21
|
+
- **回退开关**:`DSH_WORKPLAN_CONTEXT_GUARD=off` 时审计照常运行、只告警不阻断。
|
|
22
|
+
|
|
23
|
+
真实历史计划回放:41 个子任务 `fit 41/41`、`mismatch 0`;一个含 7 个硬要素的样本 0 丢失。这只证明「旧计划不被误伤」,**不证明真实模型对新任务的理解质量**。
|
|
24
|
+
|
|
25
|
+
### 3. 自动化闭环:预算到点不再丢状态
|
|
26
|
+
|
|
27
|
+
修掉 4 组「看起来在跑、实际丢状态」的缺陷:预算到点不再把 `escalated` / `instructed` / `replanned` 重置为 `pending`;`replanned` 旧行不再被当作待续跑;`HAS_BLOCKED` 不再被 `NOTHING_PENDING` 抢先;修正 3 处「自动续跑默认关闭」的错误文案与 1 处不存在的强制派发注释。
|
|
28
|
+
|
|
29
|
+
### 4. 分步进度:默认收起,点一下展开
|
|
30
|
+
|
|
31
|
+
- 每行默认收起,只显示状态点、第 N 步名称、进度条、done/total、状态词;
|
|
32
|
+
- 点击行或键盘 Enter / Space 展开该步摘要(目标、检查点、子任务状态),再次触发收起;
|
|
33
|
+
- `aria-expanded` / `aria-controls` 与 `hidden` 面板同步,点击不冒泡到外层卡片;
|
|
34
|
+
- 展开状态按会话持久化(`dsh-workplan:planrow-open:v1:<sessionId>`),刷新后恢复;localStorage 不可用时降级为纯内存。
|
|
35
|
+
|
|
36
|
+
### 5. 默认自动派发与验收编号(U-16)
|
|
37
|
+
|
|
38
|
+
- **自动派发**:计划落地后立即以 async 方式调用 `dispatchPlan`,结果仍由 `finishRound` 写回;计划消息改为「已自动派发,不要重复调用 dispatch」。plan 模式不自动派发;`autoDispatch:false` 或 `DSH_WORKPLAN_AUTO_DISPATCH=0` 可回到 plan-first。预算、取消、幂等、交付门禁与自动续跑保留。
|
|
39
|
+
- **验收编号**:子提示词把计划验收编号为 A1…An,证据必须按编号对号入座;`acceptanceCoverage` 去掉反向包含,计划要求「通过登录测试与越权测试」时,只写「通过登录测试」不再算覆盖。复跑探针 `BYPASS=BLOCKED`。
|
|
40
|
+
|
|
41
|
+
## 验证
|
|
42
|
+
|
|
43
|
+
| 检查 | 结果 |
|
|
44
|
+
|---|---|
|
|
45
|
+
| `npm run check` | exit 0 |
|
|
46
|
+
| `npm test` | **459 / 459 pass,0 fail,exit 0** |
|
|
47
|
+
| 版本一致性 | 10 个声明点全部 `1.12.0`(`node _t14_release_20261102/verify_version.mjs .` → `ALL_EQUAL=1.12.0`) |
|
|
48
|
+
| 基线对照 | 43 / 44 hunk fail-before;基线原套件 364 / 364 |
|
|
49
|
+
|
|
50
|
+
## 升级
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
dsh plugin --profile web add dsh-workplan@1.12.0
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
装完重启 DSH Web(或重新载入页面)。无破坏性变更:`PLAN_VERSION` 仍为 1,未删除或改名任何字段/工具,新增字段全部可选,旧计划按 1.11.1 语义降级回放。
|
|
57
|
+
|
|
58
|
+
## 已知限制(不折算为已修)
|
|
59
|
+
|
|
60
|
+
- **U-17**:42 条 `present` 缺陷中,12 条由本版 44 个 hunk 覆盖;28 条仍无逐条复验;D-01 / D-13 属高风险补丁范围、未合入本版(D-13 的级联修复已在 1.11.1)。不要把「44 个 hunk 全覆盖」理解成「42 条缺陷全修」。
|
|
61
|
+
- **自动派发的宿主端到端**:默认开启已由配置解析与计划消息单测覆盖;真实宿主里「计划落地即开跑」的端到端演练尚未单独执行,发布后应补一次观察。
|
|
62
|
+
- **真实模型评测**:20 条任务的理解质量 / 部门命中率尚未验证。
|
|
63
|
+
- **真实浏览器点击**:组件级 17 / 17 通过,GUI 手工点验仍需发布前完成。
|
|
64
|
+
- **索引源**:本仓库只能向上游提条目 PR;catalog 的 npm 包由上游 CI 重建,PR 合并前不能写「已上索引」。
|
|
65
|
+
|
|
66
|
+
完整变更记录见 [CHANGELOG.md](../CHANGELOG.md) 的 `1.12.0` 段。发布操作单与回滚方式见 `_t14_release_20261102/T14_1.12.0发布操作单_20261102.md`。
|