dsh-workplan 1.12.0 → 1.12.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 +51 -0
- package/README.en.md +7 -5
- package/README.md +13 -5
- package/README.zh.md +239 -0
- package/SECURITY.md +25 -2
- 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/decision-1.12.0-cc1-keep-20261104.md +46 -0
- package/docs/release-record-1.12.0-20261103.md +99 -0
- package/lib/departments.js +41 -1
- package/lib/host.js +46 -3
- package/lib/plan.js +1 -0
- package/lib/runtime.js +81 -6
- package/lib/understanding.js +304 -23
- package/package.json +1 -1
- package/src/departments.ts +39 -1
- package/src/host.ts +46 -4
- package/src/plan.ts +1 -0
- package/src/runtime.ts +78 -6
- package/src/understanding.ts +330 -26
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,54 @@
|
|
|
1
|
+
## 1.12.2 — 2026-11-04
|
|
2
|
+
|
|
3
|
+
**修好 G1/G2/G3 三个写保护漏洞(1.12.1 只记录了缺口)。这是一次有意的行为变更:已交付文件的写保护现在真正无死角,且不再区分「谁在写」。**
|
|
4
|
+
|
|
5
|
+
### 一、修了什么(三个漏洞,逐条)
|
|
6
|
+
|
|
7
|
+
| 编号 | 1.12.1 的状态 | 1.12.2 的修法 | 代码位置 |
|
|
8
|
+
|---|---|---|---|
|
|
9
|
+
| **G1** 子 Agent 不受保护 | 非根会话直接放行:「门卫只认户主,保姆拿钥匙能进」 | 去掉角色判断。已交付文件在计划未就绪期间不得被原地改写,**与谁在写无关**。 | `src/runtime.ts` `presentedWriteDenialReason` |
|
|
10
|
+
| **G2** 只认三个工具名 | 只接管 write / edit / str_replace_editor,第四个写工具(如 `apply_patch`)根本不进闸门 | 改为**按参数形状识别**写操作:带 `file_path`/`path`,或 patch 文本含 `*** Update/Add/Delete File:`。一次调用含多个文件时,只要有任一命中就整单拒绝。读类工具显式白名单排除。 | `src/host.ts` `fileWriteGuardReason` / `isWriteShapedCall`;`src/runtime.ts` `writeTargets` |
|
|
11
|
+
| **G3** 符号链接绕过 | 只做 `path.resolve`,`/link/report.md` 与 `/real/report.md` 被当成两个文件 | 两侧都归一到**真实文件身份**(`realpath.native`)。交付链接、写真实路径(或反之)都能认出来。文件尚不存在时解析最近的存在祖先;完全解析不了时退回旧行为。 | `src/runtime.ts` `realPathIdentity` / `identityPath` |
|
|
12
|
+
|
|
13
|
+
### 二、行为影响(会影响现有使用的部分,务必读完)
|
|
14
|
+
|
|
15
|
+
1. **子 Agent 写已交付文件会被拒绝**(G1)。以前后台子 Agent 能改掉用户手上那份报告,现在与主 Agent 同等对待。**present 仍只有主会话可用**,所以「交付能力」没有扩大,只是「改写已交付文件」的口子被堵上。
|
|
16
|
+
2. **更多工具名进入写保护**(G2)。过去改一个名字(如 `apply_patch`、`write_file`)就能绕过的写法,现在同样被拦;一次 patch 改动多个文件时,只要有一个是已交付文件就整单拒绝。
|
|
17
|
+
3. **符号链接不再是第二种写法**(G3)。通过软链接路径改写已交付文件会被拦下,报错文案与直接路径完全一致。
|
|
18
|
+
4. **照旧保留的出路**:计划交付就绪后放行;计划被 `dsh_workplan_cancel` 显式取消后放行;present 之后才新建的计划不受限制;plan 模式下写保护不生效。
|
|
19
|
+
5. **没有削弱的权限**:其余 8 处 `NOT_ROOT` 校验(子 Agent 不能 update / replan / cancel / dispatch 主计划、不能下发指示、不能处置跨部门需求、不能补发 follow-up、不能 present)**一处未动**。那是「子 Agent 不能改计划」的权限,与「不能改文件」是两件事。
|
|
20
|
+
|
|
21
|
+
### 三、验证(双向红绿,不是只跑一次绿)
|
|
22
|
+
|
|
23
|
+
- **修复前**(换回 1.12.1 的 `src/runtime.ts` + `src/host.ts`):`tests 498 / pass 491 / fail 7`,失败项正是 6 条 G1/G2/G3 新用例 + 1 条既有契约用例。
|
|
24
|
+
- **修复后**:`tests 498 / pass 498 / fail 0`,退出码 0;`npm run check`(tsc --noEmit)退出码 0。
|
|
25
|
+
- 用例数构成:基线 495 + G1 一条 + G2 一条 + G3 反向一条 = 498。
|
|
26
|
+
- 三条原本「钉住缺口」的用例已翻转成「钉住修复」:`p03-m1-write-guard-gaps.test.ts` 的 G3 条、`p03-m1-guard-gating-gaps.test.ts` 的 G1/G2 条、以及既有契约 `workplan-presented-write-guard.test.ts` 中「非根会话放行」的断言。
|
|
27
|
+
|
|
28
|
+
### 四、事实边界(不得外推)
|
|
29
|
+
|
|
30
|
+
- 真实模型在 20 条任务上的通过率**未被本版刷新**,仍为 2026-11-03 的 `pass 4/20`。原因:模型密钥 4 个环境变量全空 + 工作区外写配置权限缺失,20 条真实模型验证无法在本轮重跑。
|
|
31
|
+
- 1.12.2 是**代码级修复 + 回归验证**的结论,不代表 20 条真实模型任务的表现有任何变化。
|
|
32
|
+
|
|
33
|
+
## 1.12.1 — 2026-11-04
|
|
34
|
+
|
|
35
|
+
**补强任务理解的三处漏判:部门覆盖硬校验、指代先行词核实、写保护缺口固化测试。**
|
|
36
|
+
|
|
37
|
+
### 一、改动内容
|
|
38
|
+
|
|
39
|
+
1. **部门覆盖硬门禁(P0-1)**:任务原文命中某部门职责词 ≥2 个时,计划必须安排该部门,或在 `taskUnderstanding.assumptions` 写明「不安排<部门>:理由」,否则校验直接拒绝。新增 `REQUIRED_DEPARTMENT_MIN_HITS = 2` 与 `auditDepartmentCoverage`。同时补齐安全/运维/法务词表,并支持「打…标签」这类有序对匹配(跨度上限 12)。
|
|
40
|
+
2. **指代先行词核实(P0-2)**:旧逻辑只要最近对话非空,就把所有「它 / 上面那个 / A / B」判为已解析;现在必须真正从对话里抽到先行词(新字段 `antecedent`),抽不到就判 `needs-context` 并要求澄清。选项字母只有在对话里真的列出过该选项时才认。另外收窄了字母识别:只有「选/选项/方案/可选/建议/采用/按」紧邻 A–D 才算未解析引用,排除「A/B 测试」和列表编号。
|
|
41
|
+
3. **写保护缺口用例(P0-3 / M1)**:只新增测试、不改任何源码行为,固化已实测确认的三个缺口——G1 只保护根会话、G2 只识别 write/edit/str_replace_editor 三种工具、G3 符号链接写法绕过路径归一。用例断言写成「与基准路径行为一致」,缺口修好时会自动转绿。
|
|
42
|
+
|
|
43
|
+
### 二、事实边界
|
|
44
|
+
|
|
45
|
+
- 本版**没有**修复 G1/G2/G3,只把缺口固化成测试;G1/G2/G3 的修复涉及现有契约(`tests/workplan-presented-write-guard.test.ts` 的「非根会话放行」用例),属产品取舍,需单独评审。
|
|
46
|
+
- 真实模型在 20 条任务上的通过率**未被本版刷新**,仍为 2026-11-03 的 `pass 4/20`。
|
|
47
|
+
|
|
48
|
+
### 三、验证
|
|
49
|
+
|
|
50
|
+
`npm test` 495 条全过、0 失败、退出码 0(基线 490 + 新增 5);`npm run check`(tsc --noEmit)退出码 0;构建后 `lib/` 与 `src/` 同步。
|
|
51
|
+
|
|
1
52
|
## 1.12.0 — 2026-11-02
|
|
2
53
|
|
|
3
54
|
**把三类异质改动收敛为一次发布:T11 低风险缺陷补丁 rebase(15 个缺陷 / 44 个 hunk)、任务理解与部门分配机制修正、分步进度折叠 UI;并逐条给出 U-15…U-21 的结论或明确决策请求。**
|
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.12.2)
|
|
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
|
|
|
@@ -28,15 +28,17 @@ We do the half that can be done by us: **build the materials the 2026 edition (n
|
|
|
28
28
|
| Class-by-class mapping, EAL1 readiness, what is missing | Self-assessment | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
|
|
29
29
|
| Third-party components, licences, hashes | Life cycle (ALC) | [docs/SBOM.md](docs/SBOM.md) |
|
|
30
30
|
| How to report a vulnerability, response times | Security policy | [SECURITY.md](SECURITY.md) |
|
|
31
|
-
|
|
|
31
|
+
| 470 automated tests (independent recheck on 2026-11-03: 470/470 green), one command to re-run | Testing (ATE) | `npm run verify` |
|
|
32
32
|
|
|
33
|
-
Status
|
|
33
|
+
Status (from the independent recheck of 2026-11-03, all 33 gap items reviewed one by one): **26 items closed (pass); 4 items confirmed as "not applicable or inherent residual" with the judgement itself standing; 1 item (the release-package sha256 value) is a release-time execution step — the script is ready and the value ships with the release**. No new code-level gaps were found. **Inherent residuals that must stay disclosed**: `ATE_IND.1` (test execution witnessed by an accredited lab) and `AVA_VAN.2+` (independent penetration evaluation) — under CC rules only an accredited lab can perform these, so this project labels itself honestly as a **published self-assessment**, and no marketing copy may omit this line.
|
|
34
|
+
|
|
35
|
+
Version framing (both ends backed by official sources): the evidence pack follows the structure of **ISO/IEC 15408:2026** (listed in the official ISO catalogue); national certification schemes currently accept **CC:2022** (e.g. Germany's BSI). So we say: "**aligned with the 2026 structure, certification schemes currently accept CC:2022; full self-assessment evidence published, plus a complete install-and-use guide**" — and we never say "CC certified".
|
|
34
36
|
|
|
35
37
|
Check it yourself — 3 lines, copy-paste:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
40
|
git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
|
|
39
|
-
npm ci && npm run verify # expect: tests
|
|
41
|
+
npm ci && npm run verify # expect: tests 470 / pass 470 / fail 0
|
|
40
42
|
grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 hits (expected)"
|
|
41
43
|
```
|
|
42
44
|
|
|
@@ -78,7 +80,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
|
|
|
78
80
|
## Install
|
|
79
81
|
|
|
80
82
|
```bash
|
|
81
|
-
dsh plugin --profile web add dsh-workplan@1.12.
|
|
83
|
+
dsh plugin --profile web add dsh-workplan@1.12.2
|
|
82
84
|
```
|
|
83
85
|
|
|
84
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/v1.12.2)
|
|
7
7
|
|
|
8
8
|
给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
|
|
9
9
|
|
|
@@ -28,15 +28,17 @@
|
|
|
28
28
|
| 逐类对照 + EAL1 就绪度 + 还缺什么 | 自评估 | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
|
|
29
29
|
| 第三方组件、许可证、哈希 | 生命周期(ALC) | [docs/SBOM.md](docs/SBOM.md) |
|
|
30
30
|
| 漏洞怎么报、多久回、部署怎么配 | 安全策略 | [SECURITY.md](SECURITY.md) |
|
|
31
|
-
|
|
|
31
|
+
| 470 项自动化测试(2026-11-03 独立复检实测 470/470 全绿),一条命令复跑 | 测试(ATE) | `npm run verify` |
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
现状(2026-11-03 独立复检报告结论,33 条差距逐条复核):**26 条已关闭(通过);4 条经判定为「不适用或固有残留」且判定本身成立;1 条(发布包 sha256 数值)属发布期执行件,脚本已就绪、随发布公布**。无新发现的代码类缺口。**必须如实披露的固有残留**:`ATE_IND.1`(测试执行需认可实验室见证)与 `AVA_VAN.2+`(独立渗透评测)——按 CC 规则只能由认可实验室完成,本项目以「公开自评估」口径如实标注,任何宣传材料都不省略这条。
|
|
34
|
+
|
|
35
|
+
版本口径(两个头都有官方来源佐证):证据包按 **ISO/IEC 15408:2026**(已列入 ISO 官方目录)的结构编写;现行国家认证体系(如德国 BSI)受理的版本仍为 **CC:2022**。所以我们说「**对齐 2026 结构、认证体系现行受理 CC:2022,公开全套自评证据 + 完整安装使用方法**」,不说「已通过 CC 认证」。
|
|
34
36
|
|
|
35
37
|
自己验,3 行,复制即用:
|
|
36
38
|
|
|
37
39
|
```bash
|
|
38
40
|
git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
|
|
39
|
-
npm ci && npm run verify # 期望:tests
|
|
41
|
+
npm ci && npm run verify # 期望:tests 470 / pass 470 / fail 0
|
|
40
42
|
grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中(预期)"
|
|
41
43
|
```
|
|
42
44
|
|
|
@@ -67,7 +69,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
|
|
|
67
69
|
## 一键安装
|
|
68
70
|
|
|
69
71
|
```bash
|
|
70
|
-
dsh plugin --profile web add dsh-workplan@1.12.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@1.12.2
|
|
71
73
|
```
|
|
72
74
|
|
|
73
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -235,3 +237,9 @@ MIT,见 [LICENSE](LICENSE)。Chart.js 亦为 MIT。
|
|
|
235
237
|
---
|
|
236
238
|
|
|
237
239
|
**English (US) — plain-language guide:** [README.en.md](README.en.md)
|
|
240
|
+
|
|
241
|
+
## 🔒 安全性
|
|
242
|
+
|
|
243
|
+
我们对插件全部源码逐行做了安全审计。结论:**未发现任何窃取文件或数据的行为。**
|
|
244
|
+
它不读取您的文档、照片、通讯录、剪贴板等个人文件;不向任何外部服务器发送数据,仅在您本机内显示任务面板,且相关请求需登录授权。
|
|
245
|
+
以上为源码审计结论;发布包一致性、运行时实际行为两项仍在进一步验证中,详见 [SECURITY.md](SECURITY.md) 第 8 节。
|
package/README.zh.md
ADDED
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
# dsh-workplan
|
|
2
|
+
|
|
3
|
+
> **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
|
|
4
|
+
|
|
5
|
+
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
+
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v1.12.2)
|
|
7
|
+
|
|
8
|
+
给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
|
|
9
|
+
|
|
10
|
+
- 对话里先出【任务分解】:阶段、子任务、部门、验收标准,一样不缺
|
|
11
|
+
- 最多 5 个真实子 Agent 并行执行,结果写回会话
|
|
12
|
+
- 左侧栏「任务进度」:谁在做、做到哪、哪件卡住了
|
|
13
|
+
|
|
14
|
+
**English (US) — plain-language guide:** [README.en.md](README.en.md)
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 为什么敢拿 ISO/IEC 15408 当卖点,又不算吹牛
|
|
19
|
+
|
|
20
|
+
**CC(Common Criteria,ISO/IEC 15408)的规矩是三方分工:开发者交材料 → 独立实验室评测 → 国家机构发证。软件不能给自己发证。** 所以「本插件已通过 CC 认证」这句话,没有证书编号就是假的——这种话我们不说。
|
|
21
|
+
|
|
22
|
+
我们做的是能自己做的那一半:**按 2026 版(不是 2022 版)标准的结构,把材料真做出来、公开出来,任何人都能自己核对。**
|
|
23
|
+
|
|
24
|
+
| 我们公开的 | 对应标准 | 在哪儿 |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| 保护什么、防谁、边界在哪 | 安全目标(ST) | [docs/cc/SECURITY-TARGET.md](docs/cc/SECURITY-TARGET.md) |
|
|
27
|
+
| 攻击面、7 条威胁、对策、残留风险 | 脆弱性评定(AVA) | [docs/cc/AVA-VULNERABILITY-ANALYSIS.md](docs/cc/AVA-VULNERABILITY-ANALYSIS.md) |
|
|
28
|
+
| 逐类对照 + EAL1 就绪度 + 还缺什么 | 自评估 | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
|
|
29
|
+
| 第三方组件、许可证、哈希 | 生命周期(ALC) | [docs/SBOM.md](docs/SBOM.md) |
|
|
30
|
+
| 漏洞怎么报、多久回、部署怎么配 | 安全策略 | [SECURITY.md](SECURITY.md) |
|
|
31
|
+
| 470 项自动化测试(2026-11-03 独立复检实测 470/470 全绿),一条命令复跑 | 测试(ATE) | `npm run verify` |
|
|
32
|
+
|
|
33
|
+
现状(2026-11-03 独立复检报告结论,33 条差距逐条复核):**26 条已关闭(通过);4 条经判定为「不适用或固有残留」且判定本身成立;1 条(发布包 sha256 数值)属发布期执行件,脚本已就绪、随发布公布**。无新发现的代码类缺口。**必须如实披露的固有残留**:`ATE_IND.1`(测试执行需认可实验室见证)与 `AVA_VAN.2+`(独立渗透评测)——按 CC 规则只能由认可实验室完成,本项目以「公开自评估」口径如实标注,任何宣传材料都不省略这条。
|
|
34
|
+
|
|
35
|
+
版本口径(两个头都有官方来源佐证):证据包按 **ISO/IEC 15408:2026**(已列入 ISO 官方目录)的结构编写;现行国家认证体系(如德国 BSI)受理的版本仍为 **CC:2022**。所以我们说「**对齐 2026 结构、认证体系现行受理 CC:2022,公开全套自评证据 + 完整安装使用方法**」,不说「已通过 CC 认证」。
|
|
36
|
+
|
|
37
|
+
自己验,3 行,复制即用:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
|
|
41
|
+
npm ci && npm run verify # 期望:tests 470 / pass 470 / fail 0
|
|
42
|
+
grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中(预期)"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
> 一句话记住:**有证书是第三方给的,有证据是自己挣的。**
|
|
46
|
+
>
|
|
47
|
+
> **自我更正记录**:v1.8.1 公开更正了 v1.8.0 里三处「文档写得比代码多」的地方(图表路由其实不鉴权、自测并未覆盖鉴权与截断分支、EAL1 矩阵把一个自相矛盾的组件判成就绪),详情见 [CHANGELOG](CHANGELOG.md) 与 [自评估 §6.1](docs/cc/CC-2026-ASSESSMENT.md)。
|
|
48
|
+
|
|
49
|
+
## 它到底做了什么(用大白话讲)
|
|
50
|
+
|
|
51
|
+
平时你给 AI 一个复杂任务,它经常「一边想一边做」,做到一半你才发现方向不对。
|
|
52
|
+
|
|
53
|
+
这个插件把节奏改成三拍:
|
|
54
|
+
|
|
55
|
+
1. **先排计划**:你发出任务后、AI 真正动手前,它先写一份计划——分几个阶段、每个阶段几件具体工作、每件工作交给哪个部门、怎么做、什么算做完、可能卡在哪。
|
|
56
|
+
2. **计划先给你看**:这份计划以「任务分解」的形式出现在对话里,包含每一步的依据与验收标准,而不是一句话糊过去。
|
|
57
|
+
3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(最多 5 个同时跑),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
|
|
58
|
+
|
|
59
|
+
计划不是装饰品:主 Agent 必须先派发、等到部门结果回来,才能继续往下答。
|
|
60
|
+
|
|
61
|
+
## 装之前你需要什么
|
|
62
|
+
|
|
63
|
+
| 要求 | 说明 |
|
|
64
|
+
|---|---|
|
|
65
|
+
| DeepSeek Harness | 官方 Web 版(`dsh web` / `--profile web` 跑的这套) |
|
|
66
|
+
| Node.js | **22 或更高**(`node -v` 自查) |
|
|
67
|
+
| 网络 | 安装时需要能访问 npm registry |
|
|
68
|
+
|
|
69
|
+
## 一键安装
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@1.12.2
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
76
|
+
|
|
77
|
+
没有 `dsh` 命令的话,先确认它在 PATH 里;用 `npx` 起的 DSH 可以直接用完整路径调用同一个 `dsh`。
|
|
78
|
+
|
|
79
|
+
### 从源码安装(可选,想改代码时用)
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
git clone https://github.com/abbaababa/dsh-workplan.git
|
|
83
|
+
cd dsh-workplan
|
|
84
|
+
npm ci && npm run build
|
|
85
|
+
dsh plugin --profile web add "$(pwd)"
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## 装好以后怎么用(小白版)
|
|
89
|
+
|
|
90
|
+
1. 打开 DSH Web,随便发一个**有实际目标**的任务,例如「帮我把这个目录的测试补到 80% 覆盖」。
|
|
91
|
+
2. 等一两秒,对话里会出现一块【任务分解】:阶段、子任务、部门、验收标准齐全。
|
|
92
|
+
3. 你只需要正常对话;主 Agent 会按规则派发计划,遇到要拍板的地方会问你。
|
|
93
|
+
4. 点左侧栏的**「任务进度」**,就能看到:
|
|
94
|
+
|
|
95
|
+
- 顶部五个数字:**几个任务 / 分配了多少件工作 / 做好了 / 正在做 / 卡住了**;
|
|
96
|
+
- 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」= 这一轮已经停了(没有东西在跑)但计划还没做完,卡片会写清停在哪儿(预算用完 / 卡住了 / 还没开始),说一句「继续」即可接着推进;
|
|
97
|
+
- 展开任意计划:每个阶段的进度、每件具体工作由哪个部门负责、当前状态。
|
|
98
|
+
|
|
99
|
+
5. 进度数字背后的每一行,都来自同一份任务状态——**不会再出现「显示 0 个正在做、但下面明明写着正在做」这种自相矛盾**(1.4.3 专门修的就是这个,见下文)。
|
|
100
|
+
|
|
101
|
+
纯打招呼、道谢、问「做到哪了」不会触发拆解,不会平白多出一堆子 Agent。
|
|
102
|
+
|
|
103
|
+
## 九个模型工具(你不用直接调用)
|
|
104
|
+
|
|
105
|
+
| 工具 | 作用 |
|
|
106
|
+
|---|---|
|
|
107
|
+
| `dsh_workplan_dispatch` | 派发当前计划,把结果写回会话。默认 `mode:"wait"` 等结束;`mode:"async"` 立刻返回、后台继续。重复调用是幂等的。 |
|
|
108
|
+
| `dsh_workplan_status` | 只读:问到哪了。重启或刷新后也能从会话记录重建。 |
|
|
109
|
+
| `dsh_workplan_update` | 主 Agent 核对结果、修正某个子任务状态与证据。带 `expectedRevision` 防覆盖,运行中默认拒绝(`force:true` 才覆盖)。子 Agent 不能调用。 |
|
|
110
|
+
| `dsh_workplan_cancel` | 取消还没派发的计划,不会伪造任何「已完成」。 |
|
|
111
|
+
| `dsh_workplan_replan` | 需求变更时就地修订:`cancel` / `replace` / `add`,旧行标为「已取代」保留可追溯,计划版本号递增。主 Agent 专用。 |
|
|
112
|
+
| `dsh_workplan_escalate` | 子 Agent 执行中遇阻上报:问题、选项、建议进状态机,等主 Agent 指示;不再是「只能憋到结尾写 BLOCKED」。 |
|
|
113
|
+
| `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。带 60s/180s 回执检查。 |
|
|
114
|
+
| `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
|
|
115
|
+
| `dsh_workplan_followup` | 给预算/超时中止、但产物已落盘的直接子会话补一条收尾说明。 |
|
|
116
|
+
|
|
117
|
+
在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
|
|
118
|
+
|
|
119
|
+
## 部门怎么协作(1.11.0 的真实能力)
|
|
120
|
+
|
|
121
|
+
计划里的每件工作都带一个部门标签(工程研发、研究分析、设计、产品、数据、质量验证、安全、运维、文档写作、运营、法务合规、财务)。**标签决定提示词与统计口径,不是组织架构**:
|
|
122
|
+
|
|
123
|
+
- 部门之间**不能直接对话**(这是刻意的权限边界);跨部门信息由主 Agent 转达,或落到双方都能读的工作区文件。但每个子 Agent 的提示词里会带上**兄弟部门的只读一览**(谁、做什么、产出什么、已完成摘要),需要协作就写进 `needs`;每条 needs 会自动登记成带编号的跨部门需求(`open → routed → answered/closed`),结果消息与 `status` 都能看到,**未处置就拦住交付**。主 Agent 用 `dsh_workplan_handoff` 逐条处置;提出需求的行若正在等指示,`resolve` 会把答复直接投递给该子会话。
|
|
124
|
+
- 下游只看到 `dependsOn` 里上游的**摘要**与完整体检结果,看不到上游的完整对话。所以上游必须把「产物绝对路径 + 怎么验收」写进摘要;声明为 `file` 的产物会被逐个核实,**缺失就不给下游解锁**。
|
|
125
|
+
- 子 Agent 在输出末尾回传结构化证据块(`status` / `acceptance` / `artifacts` / `needs`)。**非空输出不再等于完成**:`partial`、任一条验收失败、坏块都判受阻,只有全 `pass` 才可直接采信,其余在结果消息里标「未验证」等主 Agent 核对。
|
|
126
|
+
- 阶段(stage)只是展示分组,**不是执行门槛**;真正决定先后的是 `dependsOn`。
|
|
127
|
+
|
|
128
|
+
完整的角色、数据契约、状态机、失败恢复与「改代码时必须同步的三处」,见 **[协作契约](https://github.com/abbaababa/dsh-workplan/blob/main/docs/collaboration.md)**;12 个部门的职责与交接清单见 **[部门职责与交接约定](https://github.com/abbaababa/dsh-workplan/blob/main/docs/departments.md)**。
|
|
129
|
+
|
|
130
|
+
## 预算、超时与续跑(知道这些就不会误以为卡死)
|
|
131
|
+
|
|
132
|
+
| 项 | 默认值 | 怎么改 |
|
|
133
|
+
|---|---|---|
|
|
134
|
+
| 单轮派发预算 | 20 分钟 | `DSH_WORKPLAN_TOTAL_TIMEOUT_MS` |
|
|
135
|
+
| 单个子 Agent 上限 | 15 分钟 | `DSH_WORKPLAN_CHILD_TIMEOUT_MS` |
|
|
136
|
+
| 子 Agent 无进展判定 | 5 分钟 | `DSH_WORKPLAN_IDLE_TIMEOUT_MS` |
|
|
137
|
+
| 自动续跑次数 | 4 次 | `DSH_WORKPLAN_MAX_RESUMES` |
|
|
138
|
+
| 并发子 Agent | 5 个(固定) | — |
|
|
139
|
+
|
|
140
|
+
预算用尽不是失败:计划会变成「**本轮预算用尽,可续跑**」,已完成的不重跑,剩下的下次接着做。被判定卡住的子任务只卡它自己,不会拖垮整个计划;重试只会发生一次,第二次的提示词会带上一次的失败原因,不会原样重撞。
|
|
141
|
+
|
|
142
|
+
环境变量写在启动 DSH 的那个 shell 里,或者写进插件配置:
|
|
143
|
+
|
|
144
|
+
```jsonc
|
|
145
|
+
// cordis.patch.yml 里的 config 字段
|
|
146
|
+
{ "totalTimeoutMs": 1800000 } // 30 分钟
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## 安全与隐私(可以自己复核)
|
|
150
|
+
|
|
151
|
+
- **没有第三方运行时依赖**:`dependencies` 是空的;装出来的只有这个插件自己的 JS、配置、图标和说明。
|
|
152
|
+
- **不写你的磁盘**:源码里没有任何 `writeFileSync` / `appendFileSync` / `mkdirSync`(可 `grep` 验证);结果只写进 DSH 会话记录。
|
|
153
|
+
- **不向外发数据**:源码里没有 `child_process`、没有对外 `fetch`/`http.request`;唯一的一次 `fetch` 是浏览器端请求**同源**的 `/dsh-workplan/plans`。
|
|
154
|
+
- **面板数据要登录**:该路由走 DSH 自己的鉴权,未登录直接返回 401。
|
|
155
|
+
- **图表库是本地自带**:`vendor/chart.umd.js`(Chart.js 4.6.1,MIT)随包分发,不加载任何 CDN 脚本。
|
|
156
|
+
|
|
157
|
+
自己复核:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
npm view dsh-workplan@latest dependencies # 应为空
|
|
161
|
+
grep -RInE "writeFileSync|child_process|eval\(" src # 应无命中
|
|
162
|
+
npm audit --omit=dev
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
<details>
|
|
166
|
+
<summary><b>1.5.0 改了什么(进度一眼可见)</b>(点开看)</summary>
|
|
167
|
+
|
|
168
|
+
1.5.0 只改展示层:把计划卡折叠态那行「本计划 0/8 做好了 + 一根 54×5px 的小条」换成图表组合。
|
|
169
|
+
|
|
170
|
+
| 位置 | 改前 | 改后 |
|
|
171
|
+
|---|---|---|
|
|
172
|
+
| 折叠中的计划卡 | 12px 灰字 + 迷你条 + 「0 卡住了」;百分比只在鼠标悬停的 `title` 里 | 44px 环形图 + 24px 百分比 + `本计划 X/Y 做好了` + 一行「现在在做什么」(卡住优先,带任务名)+ 8px 四段构成条 + 状态图例 + 阶段步进条 |
|
|
173
|
+
| 展开后的面板 | 一根计划级进度条 | 「分步进度」:每个阶段一行(名称、`完成/总数`、细条、状态),外加加权总体进度 |
|
|
174
|
+
| 0% 的计划 | 迷你条填充宽度为 0,轨道又与卡片底色用同一个 token,等于没有图 | 四层信号:加粗的环轨、24px「0%」、整条灰色的「还没开始」构成条、虚线阶段槽 + 当前阶段描边 |
|
|
175
|
+
| 0 个工作项的组头 | `未完成 0 / 已完成 0(完成率暂无数据)` | 整句删除,只留环上的 `—`;组内空态仍在(展开可见) |
|
|
176
|
+
|
|
177
|
+
「卡住了」这类数字一个都没少,只是换了呈现:图例始终是 `做好了 / 正在做 / 卡住了 / 还没开始` 四项带数字。
|
|
178
|
+
|
|
179
|
+
**怎么看到效果**:插件的前端在 `client.js` 里,DSH Web 进程启动时加载它,所以先重启 DSH Web,再刷新 <http://127.0.0.1:3080>。不想改环境也能离线看对比:打开 [docs/preview/progress-visual-1.5.0.html](docs/preview/progress-visual-1.5.0.html)(`npm run preview` 可重新生成,它用同一份 CSS 渲染 1.4.3 与 1.5.0 的卡头)。
|
|
180
|
+
|
|
181
|
+
没有新增依赖,`plan.ts` / `runtime.ts` 无改动;回滚方式见 [CHANGELOG.md](CHANGELOG.md)。
|
|
182
|
+
|
|
183
|
+
</details>
|
|
184
|
+
|
|
185
|
+
<details>
|
|
186
|
+
<summary><b>1.4.3 修了什么(为什么值得升级)</b>(点开看)</summary>
|
|
187
|
+
|
|
188
|
+
1.4.3 是一次**计数一致性**修复:插件曾同时维护「实时任务状态」和「缓存的统计快照」两份真相,导致面板数字和实际状态对不上(截图里「0 个正在做」但下面有任务正在做,就是它)。
|
|
189
|
+
|
|
190
|
+
| 缺陷 | 表现 | 根因 |
|
|
191
|
+
|---|---|---|
|
|
192
|
+
| D1 | 面板数字长时间不更新 | 统计只在整批子 Agent 跑完后才重算,运行期间冻结 |
|
|
193
|
+
| D2 | 同一份数据里两个数字互相矛盾 | 计数来自缓存,部门聚合来自实时状态 |
|
|
194
|
+
| D3 | 「还没开始」的任务却显示 100%、带着上一次的执行者 | 预算重置绕过了状态机,旧字段没清 |
|
|
195
|
+
| D4 | 同一类失败,进度有时 100 有时 0 | 两处代码对「卡住」的进度语义不一致 |
|
|
196
|
+
|
|
197
|
+
修法是**删掉缓存快照,只保留一份状态源**:所有数字在序列化时由同一函数现场派生,并配了 7 条不变量 + 变异测试防止回退。完整报告:[docs/fix-report-derived-counts-1.4.3.md](docs/fix-report-derived-counts-1.4.3.md)。
|
|
198
|
+
|
|
199
|
+
</details>
|
|
200
|
+
|
|
201
|
+
## 常见问题
|
|
202
|
+
|
|
203
|
+
**装完没反应?**
|
|
204
|
+
先重启 DSH Web;再确认 `~/.dsh/profiles/web/package.json` 的依赖里有 `dsh-workplan`。
|
|
205
|
+
|
|
206
|
+
**面板一直是空的?**
|
|
207
|
+
面板只显示**当前会话**的计划。换一个会话、或这个会话还没产生计划时是空的,这是正常的。
|
|
208
|
+
|
|
209
|
+
**数字和以前不一样了?**
|
|
210
|
+
1.4.3 之后数字来自真实状态而不是缓存,所以会比旧版本「更小、但更准」(旧版本的完成率经常虚高)。
|
|
211
|
+
|
|
212
|
+
**子 Agent 卡住不动?**
|
|
213
|
+
5 分钟没有任何新事件会被判定卡住并单独标红;对主 Agent 说「续跑这个计划」即可从受阻处继续。
|
|
214
|
+
|
|
215
|
+
## 卸载
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
dsh plugin --profile web remove dsh-workplan
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
## 开发与验证
|
|
222
|
+
|
|
223
|
+
```bash
|
|
224
|
+
npm ci
|
|
225
|
+
npm run check # tsc --noEmit
|
|
226
|
+
npm test # 全部测试(数量随版本变化,以命令输出与 CI 为准),含计数不变量与进度图表用例
|
|
227
|
+
npm run build # 编译 src/*.ts → lib/*.js、client.js
|
|
228
|
+
npm run preview # 重新生成 docs/preview 里的 1.4.3 / 1.5.0 卡头对比页
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
`lib/` 与 `client.js` 是**提交进仓库的构建产物**,CI 会重建并校验二者无差异。
|
|
232
|
+
|
|
233
|
+
## 许可证
|
|
234
|
+
|
|
235
|
+
MIT,见 [LICENSE](LICENSE)。Chart.js 亦为 MIT。
|
|
236
|
+
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
**English (US) — plain-language guide:** [README.en.md](README.en.md)
|
package/SECURITY.md
CHANGED
|
@@ -19,8 +19,11 @@
|
|
|
19
19
|
|
|
20
20
|
| 版本 | 安全修复 | 说明 |
|
|
21
21
|
|---|---|---|
|
|
22
|
-
| 1.
|
|
23
|
-
|
|
|
22
|
+
| 1.12.x | ✅ 接收 | 当前发布线(latest:1.12.0) |
|
|
23
|
+
| 1.9 – 1.11.x | ⚠️ 仅重大问题 | 建议升级到 1.12.x |
|
|
24
|
+
| ≤ 1.8.x | ❌ 不再单独修复 | 建议升级到 1.12.x |
|
|
25
|
+
|
|
26
|
+
(2026-11-03 刷新:支持表已从 1.8.x 更新到 1.12.x,对应 T3 差距 G-17。)
|
|
24
27
|
|
|
25
28
|
只维护 npm `latest` 指向的版本线;升级命令见 [README.md](README.md)。
|
|
26
29
|
|
|
@@ -118,3 +121,23 @@ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileS
|
|
|
118
121
|
5. ✅ 本插件**提供**按 ISO/IEC 15408:2026 结构组织的公开自评估、ST 草案、攻击面分析与可复现测试。
|
|
119
122
|
|
|
120
123
|
> 一句话:**我们把"能做到的"做到了并公开证据;把"做不到的"写清楚,而不是把它包装成卖点。**
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## 8. 数据窃取专项审计结论(2026-11-03,逐行源码审计)
|
|
128
|
+
|
|
129
|
+
> **安全说明**
|
|
130
|
+
>
|
|
131
|
+
> 我们对插件全部源码逐行做了安全审计。结论:**未发现任何窃取文件或数据的行为。**
|
|
132
|
+
> 它不读取您的文档、照片、通讯录、剪贴板等个人文件;不向任何外部服务器发送数据,仅在您本机内显示任务面板,且相关请求需登录授权。
|
|
133
|
+
> 说明:以上为源码审计结论。发布包一致性、运行时实际行为两项仍在进一步验证中,结果会在此更新。
|
|
134
|
+
|
|
135
|
+
<details>
|
|
136
|
+
<summary>技术证据索引(点击展开)</summary>
|
|
137
|
+
|
|
138
|
+
- 文件访问仅 4 处、全部只读、路径为常量:`src/host.ts:2,49,1238`、`src/runtime.ts:16`;`writeFile/mkdir/rm/unlink/child_process` 全源码 0 命中。
|
|
139
|
+
- 敏感数据(clipboard/contact/keychain/token/camera 等)全源码 0 命中;环境变量仅读自身 `DSH_WORKPLAN_*` 开关;浏览器侧仅 localStorage 存面板展开状态(`src/client.ts:2134-2161`)。
|
|
140
|
+
- 全源码仅 1 处网络请求:`src/client.ts:1494` 同源相对路径 `/dsh-workplan/plans`,且经宿主鉴权(`src/runtime.ts:5495-5505`,未授权返回 401);无外部域名、无 WebSocket/第三方 HTTP 库、无混淆与动态加载、零运行时依赖。
|
|
141
|
+
- 完整审计报告:`_t1_plugin_security_locate_20261103/T1…T3`(本地工作区留存)。
|
|
142
|
+
|
|
143
|
+
</details>
|
package/docs/SBOM.md
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
# 软件物料清单(SBOM)— dsh-workplan v1.
|
|
1
|
+
# 软件物料清单(SBOM)— dsh-workplan v1.12.0
|
|
2
|
+
|
|
3
|
+
> **v1.12.0 刷新记录(2026-11-03,T5)**:本文件已从 v1.8.0 基线刷新——自有代码重算为 **12 个文件(11 个 TS 模块 + 1 个类型声明)/ 17,430 行**,测试刷新为 **65 个测试文件 / 462 项测试**(T3 于 git HEAD `5fe47a1` 实跑 `npm test`:tests 462 / pass 462 / fail 0)。§5 表为 v1.12.0 实测;供应链事实(依赖表)未变化并复核仍成立。
|
|
2
4
|
|
|
3
5
|
**用途**:回答"这个插件里到底有哪些别人的代码"。供应链安全的起点,也是 ISO/IEC 15408 生命周期(ALC)类的基础材料。
|
|
4
6
|
|
|
@@ -14,7 +16,7 @@
|
|
|
14
16
|
| 运行时第三方依赖 | **0** |
|
|
15
17
|
| 随包分发的第三方文件 | **1**(Chart.js,MIT) |
|
|
16
18
|
| 构建期开发依赖(含传递) | **6** |
|
|
17
|
-
| 本仓自有代码 |
|
|
19
|
+
| 本仓自有代码 | 12 个文件(11 个 TS 模块 + 1 个类型声明)/ 17,430 行 |
|
|
18
20
|
| 许可证 | 本项目 MIT;第三方全部为 MIT 或 Apache-2.0,均允许再分发 |
|
|
19
21
|
|
|
20
22
|
**零运行时依赖**是本项目最重要的安全属性之一:安装插件不会引入任何可被投毒的运行时依赖树。
|
|
@@ -69,16 +71,22 @@ shasum -a 256 vendor/chart.umd.js
|
|
|
69
71
|
|
|
70
72
|
| 文件 | 行数 | 作用 |
|
|
71
73
|
|---|---|---|
|
|
72
|
-
| `src/
|
|
73
|
-
| `src/
|
|
74
|
-
| `src/
|
|
75
|
-
| `src/host.ts` |
|
|
74
|
+
| `src/runtime.ts` | 6071 | 执行编排:计划派发、子会话生命周期、状态回写、HTTP 路由与加固响应头 |
|
|
75
|
+
| `src/plan.ts` | 3820 | 计划数据模型、校验、统计派生 |
|
|
76
|
+
| `src/client.ts` | 3367 | 浏览器面板渲染 |
|
|
77
|
+
| `src/host.ts` | 1278 | 插件入口:注册路由、9 个工具、配置与提示词规则 |
|
|
78
|
+
| `src/understanding.ts` | 901 | 结果理解与核对辅助 |
|
|
79
|
+
| `src/replan.ts` | 708 | 需求变更重规划(cancel/replace/add) |
|
|
80
|
+
| `src/supersede.ts` | 429 | 跨计划取代(V1–V8 复算) |
|
|
81
|
+
| `src/auto-resume.ts` | 275 | 自动续跑策略 |
|
|
82
|
+
| `src/departments.ts` | 244 | 部门枚举 |
|
|
76
83
|
| `src/watchdog.ts` | 207 | 子代理超时与预算监控 |
|
|
84
|
+
| `src/supersede-digest.ts` | 116 | 取代摘要 |
|
|
77
85
|
| `src/globals.d.ts` | 14 | 宿主 API 类型声明 |
|
|
78
|
-
| **合计** | **
|
|
79
|
-
| `tests/*.test.ts` | **
|
|
86
|
+
| **合计** | **17,430** | |
|
|
87
|
+
| `tests/*.test.ts` | **65 个文件 / 462 项测试** | 自动化验证 |
|
|
80
88
|
|
|
81
|
-
(行数取自 `wc -l src/*.ts`,v1.
|
|
89
|
+
(行数取自 `wc -l src/*.ts`,v1.12.0 于 git HEAD `5fe47a1` 实测,2026-11-03;测试数为同基线 `npm test` 实跑结果。)
|
|
82
90
|
|
|
83
91
|
---
|
|
84
92
|
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# 功能规范(ADV_FSP.1 对齐)/ Functional Specification
|
|
2
|
+
|
|
3
|
+
> 对象(TOE):dsh-workplan 插件 v1.12.0 | 基线:git HEAD `5fe47a1` | 日期:2026-11-03 | 撰写:T5(文档与合规证据)
|
|
4
|
+
> 性质:**公开自评估文档**,非认证机构出具的评估证据。本插件未通过 CC 认证,本文不宣称任何证书。
|
|
5
|
+
>
|
|
6
|
+
> TOE:dsh-workplan plugin v1.12.0 | Baseline: git HEAD `5fe47a1` | 2026-11-03 | Nature: **public self-assessment**, not accredited-lab evidence. No CC certificate is claimed.
|
|
7
|
+
|
|
8
|
+
## 0. 覆盖的差距编号 / Covered gaps
|
|
9
|
+
|
|
10
|
+
G-08(ADV-FSP.1 独立接口规范缺失)。核对方法:工具名逐一来自 `src/host.ts` 的 `name:` 字段(L201/338/472/567/633/713/787/873/936),路由来自 `src/runtime.ts` L5516。任何人可用 `grep -n "name: 'dsh_workplan_" src/host.ts` 复核。
|
|
11
|
+
|
|
12
|
+
## 1. 对外接口总表 / External interface inventory
|
|
13
|
+
|
|
14
|
+
TOE 对外暴露 **2 类接口**:9 个 Agent 工具(宿主注入给模型调用)+ 1 个本地 HTTP 路由(面板数据源)。
|
|
15
|
+
|
|
16
|
+
### 1.1 Agent 工具(9 个)/ Agent tools
|
|
17
|
+
|
|
18
|
+
| # | 工具 | 调用者 | 用途(一句话) | 关键参数 | 失败/拒绝行为 |
|
|
19
|
+
|---|---|---|---|---|---|
|
|
20
|
+
| 1 | `dsh_workplan_dispatch` | 主 Agent | 派发计划执行 | `planId?`, `mode: wait/async` | 无计划/重复派发幂等返回;`complete:false` 表示未完成,必须续跑 |
|
|
21
|
+
| 2 | `dsh_workplan_status` | 主 Agent(只读) | 查看各子任务实时状态 | `planId?` | 只读,无副作用 |
|
|
22
|
+
| 3 | `dsh_workplan_update` | 主 Agent | 回写子任务状态/证据/验收 | `subtaskId`, `status`, `verification`, `acceptance[]` | done 需 structured+pass,否则 `deliveryReady=false`;执行中改判需 `force` |
|
|
23
|
+
| 4 | `dsh_workplan_replan` | 主 Agent | 需求变更时重规划 | `reason`, `changes[]` | 执行中调用返回 `REPLAN_PLAN_RUNNING`,变更不丢 |
|
|
24
|
+
| 5 | `dsh_workplan_cancel` | 主 Agent | 取消计划(或转移责任) | `planId?`, `reason`, `disposition`, `supersededBy?` | supersede 需 V1–V8 复算,任一不满足返回 `SUPERSEDE_*` |
|
|
25
|
+
| 6 | `dsh_workplan_followup` | 主 Agent | 向直接子会话补发说明 | `sessionId`, `message` | 非直接子会话一律拒绝 |
|
|
26
|
+
| 7 | `dsh_workplan_instruct` | 主 Agent | 向「待指示」子任务下发决定 | `subtaskId`, `instruction` | 仅接受 `closure=escalated` 的行 |
|
|
27
|
+
| 8 | `dsh_workplan_escalate` | 子 Agent | 子任务遇阻上报请示 | `question`, `options?`, `needs?` | 调用后子任务置「待指示」 |
|
|
28
|
+
| 9 | `dsh_workplan_handoff` | 主 Agent(仅根会话) | 处置跨部门需求 | `action: list/assign/resolve/close` | 非根会话拒绝 |
|
|
29
|
+
|
|
30
|
+
### 1.2 HTTP 路由(1 个)/ HTTP route
|
|
31
|
+
|
|
32
|
+
| 路由 | 方法 | 用途 | 安全头 | 说明 |
|
|
33
|
+
|---|---|---|---|---|
|
|
34
|
+
| `/dsh-workplan/plans` | GET | 返回面板所需的计划状态数据 | `x-content-type-options: nosniff`、`referrer-policy: no-referrer`(`HARDENING_HEADERS`,见 `tests/security-headers.test.ts`) | 非该路径一律拒绝(`src/runtime.ts` L5516);只读,无写入接口 |
|
|
35
|
+
|
|
36
|
+
### 1.3 不存在的接口(负面声明)/ Interfaces that do NOT exist
|
|
37
|
+
|
|
38
|
+
- 无网络出站调用、无遥测上报(零运行时依赖,`package.json` `dependencies` 为空)。
|
|
39
|
+
- 无鉴权/账户体系(见 ST 假设 A-1:宿主环境已鉴别,TOE 不自做鉴别)。
|
|
40
|
+
- HTTP 层无任何写入/删除路由。
|
|
41
|
+
|
|
42
|
+
## 2. SFR 对应 / SFR trace
|
|
43
|
+
|
|
44
|
+
接口行为与 ST(`docs/cc/SECURITY-TARGET.md`)SFR 的对应:审计留痕→FAU_GEN(状态变更全留档);访问控制→FDP_ACC/ACF(文件沙箱 + presented-write-guard);域隔离→FPT_SEP(子会话隔离);会话超时→FTA_SSL(15 分钟/步、20 分钟预算,可用 `DSH_WORKPLAN_CHILD_TIMEOUT_MS`/`IDLE_TIMEOUT_MS`/`TOTAL_TIMEOUT_MS` 覆盖默认值)。
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# TOE 设计(ADV_TDS.1 对齐)/ TOE Design
|
|
2
|
+
|
|
3
|
+
> 对象:dsh-workplan v1.12.0 | 基线:git HEAD `5fe47a1` | 日期:2026-11-03 | 撰写:T5
|
|
4
|
+
> 性质:公开自评估文档,非认证证据;不宣称 CC 证书。
|
|
5
|
+
|
|
6
|
+
## 0. 覆盖的差距编号
|
|
7
|
+
|
|
8
|
+
G-09(无独立 TOE 设计文档)、G-10(源码↔设计映射)。核对方法:`wc -l src/*.ts`(合计 17,430 行,2026-11-03 实测)。
|
|
9
|
+
|
|
10
|
+
## 1. 模块结构 / Module structure
|
|
11
|
+
|
|
12
|
+
TS 源码共 **12 个文件(11 个模块 + globals.d.ts)**,合计 17,430 行:
|
|
13
|
+
|
|
14
|
+
| 模块 | 行数 | 职责 | 是否含 TSF(安全功能) |
|
|
15
|
+
|---|---|---|---|
|
|
16
|
+
| `src/plan.ts` | 3820 | 计划数据模型与状态机 | 是(状态与完成判据) |
|
|
17
|
+
| `src/runtime.ts` | 6071 | 执行编排:调度、子会话生命周期、状态回写、HTTP 服务与加固头 | 是 |
|
|
18
|
+
| `src/host.ts` | 1278 | 9 个工具的宿主侧定义与提示词规则(15 分钟/步、20 分钟预算条款) | 是 |
|
|
19
|
+
| `src/client.ts` | 3367 | 面板前端渲染 | 否 |
|
|
20
|
+
| `src/replan.ts` | 708 | 需求变更重规划(cancel/replace/add) | 是 |
|
|
21
|
+
| `src/understanding.ts` | 901 | 结果理解与核对辅助 | 否 |
|
|
22
|
+
| `src/supersede.ts` | 429 | 跨计划取代(V1–V8 复算) | 是 |
|
|
23
|
+
| `src/supersede-digest.ts` | 116 | 取代摘要 | 否 |
|
|
24
|
+
| `src/auto-resume.ts` | 275 | 自动续跑策略 | 是(容错) |
|
|
25
|
+
| `src/watchdog.ts` | 207 | 看门狗/卡死检测 | 是(容错) |
|
|
26
|
+
| `src/departments.ts` | 244 | 部门枚举 | 否 |
|
|
27
|
+
| `src/globals.d.ts` | 14 | 类型声明 | 否 |
|
|
28
|
+
|
|
29
|
+
## 2. 安全域隔离(FPT_SEP 成文化,兼答 G-07/G-30)/ Security domains
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
┌─ 宿主环境(已鉴别,TOE 假设 A-1)
|
|
33
|
+
│ ┌─ TOE:主 Agent 会话 ── 9 个工具 + 提示词规则 + 交付门禁
|
|
34
|
+
│ │ └─ 子 Agent 会话 × N(独立上下文、独立工作目录,凭 dsh_workplan_escalate 上报)
|
|
35
|
+
│ └─ 面板:GET /dsh-workplan/plans(只读,加固响应头)
|
|
36
|
+
└─ 文件沙箱:DSH file policy 限定可写范围(workspace-write 等)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
边界规则:子 Agent 不能派发、不能安装服务、权限在启动时固化;`tests/session-reference-safety.test.ts` 与 `tests/workplan-presented-write-guard.test.ts` 回归守护该边界。host 工具超时 > 计划预算(`src/host.ts` L1019–1023),保证不会出现“工具还在跑、预算已判死”的竞态。
|
|
40
|
+
|
|
41
|
+
## 3. TSF 与模块映射(兼答 G-26/27/29/30/31/32 成文化)
|
|
42
|
+
|
|
43
|
+
| TSF(SFR) | 实现位置 | 回归测试 |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| FAU_GEN 审计留痕 | runtime 状态回写 + 证据契约(WORKPLAN_EVIDENCE 块) | workplan-evidence-contract |
|
|
46
|
+
| FDP_ACC/ACF 访问控制 | DSH file policy + presented-write-guard | workplan-presented-write-guard、session-reference-safety |
|
|
47
|
+
| FMT_MOF/MSA 安全管理 | deliveryReady 门禁 + status-lock + 仅根会话可 handoff | workplan-status-lock、delivery-gate、present-gate-evidence |
|
|
48
|
+
| FPT_SEP 域隔离 | 子会话隔离模型(§2) | session-reference-safety、security-headers |
|
|
49
|
+
| FTA_SSL 会话超时 | host.ts 硬上限/预算常量,env 可覆盖 | timeout-artifact-evidence |
|
|
50
|
+
| FRU_FLT 容错 | auto-resume、watchdog、blocked/重规划留档 | auto-resume-policy、workplan-stuck-recovery、workplan-auto-retry |
|
|
51
|
+
|
|
52
|
+
## 4. 构建与实现表示(ADV_IMP 补充)
|
|
53
|
+
|
|
54
|
+
源码即发布物:`npm run build` 产出 `lib/`、`dist/`;`tests/build-artifacts.test.ts` 校验构建产物一致性,`tests/version-sync.test.ts` 校验版本号五处同步(package.json / CHANGELOG / 文档等)。无打包混淆、无外部代码注入点。
|