dsh-workplan 1.7.1 → 1.8.0

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.
Files changed (43) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.en.md +40 -1
  3. package/README.md +39 -1
  4. package/SECURITY.md +109 -0
  5. package/docs/SBOM.md +113 -0
  6. package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +97 -0
  7. package/docs/cc/CC-2026-ASSESSMENT.md +254 -0
  8. package/docs/cc/SECURITY-TARGET.md +239 -0
  9. package/docs/collaboration.md +440 -0
  10. package/docs/collapse-interaction-spec.md +272 -0
  11. package/docs/defect-report-count-inconsistency.md +370 -0
  12. package/docs/departments.md +194 -0
  13. package/docs/design-proposals/state-machine.reference.ts +836 -0
  14. package/docs/design-proposals/state-machine.test.reference.ts +655 -0
  15. package/docs/fix-report-derived-counts-1.4.3.md +199 -0
  16. package/docs/fix-report-phase-percent-1.5.2.md +284 -0
  17. package/docs/preview/progress-visual-1.5.0.html +683 -0
  18. package/docs/progress-visualization-clarify-20261028.md +211 -0
  19. package/docs/progress-visualization-design-20261028.md +607 -0
  20. package/docs/progress-visualization-locate-20261028.md +159 -0
  21. package/docs/progress-visualization-report-1.5.0.md +140 -0
  22. package/docs/release-notes-1.7.0.md +46 -0
  23. package/docs/release-notes-1.7.1.md +36 -0
  24. package/docs/release-record-1.5.1-20261028.md +258 -0
  25. package/docs/release-record-1.5.2-20261029.md +101 -0
  26. package/docs/release-record-1.7.0-20261030.md +58 -0
  27. package/docs/release-record-1.7.1-20261030.md +56 -0
  28. package/docs/repro-count-inconsistency.md +310 -0
  29. package/docs/review-collaboration-20261030.md +246 -0
  30. package/docs/root-cause-phase-percent.md +866 -0
  31. package/docs/state-progress-matrix.md +517 -0
  32. package/docs/status-grouping-ia.md +789 -0
  33. package/docs/stuck-review-1.3.0.md +646 -0
  34. package/docs/t4-contrast-measurement.json +496 -0
  35. package/docs/t4-contrast-measurement.md +177 -0
  36. package/docs/t8-fix-prioritization.md +105 -0
  37. package/docs/version-upgrade-rollback-1.5.0-20261028.md +654 -0
  38. package/docs/visual-refinement-spec.md +164 -0
  39. package/lib/host.js +3 -2
  40. package/lib/runtime.js +21 -0
  41. package/package.json +4 -2
  42. package/src/host.ts +3 -1
  43. package/src/runtime.ts +22 -0
package/CHANGELOG.md CHANGED
@@ -1,3 +1,42 @@
1
+ ## 1.8.0 — 2026-10-30
2
+
3
+ **本次发布只做一件事:把"安全"从形容词变成可核对的证据链 —— 按 ISO/IEC 15408:2026(CC)的结构公开自评估材料,并补上两处实现缺口。**
4
+
5
+ > 明确声明:**本插件没有 CC 证书,也没有通过任何实验室评测。** 我们不宣称"完全满足 ISO/IEC 15408"。
6
+ > 我们公开的是按标准结构组织的材料、可复跑的测试、以及逐条写明的边界。详见 `docs/cc/CC-2026-ASSESSMENT.md`。
7
+
8
+ ### 新增(标准材料)
9
+
10
+ - `docs/cc/CC-2026-ASSESSMENT.md`:按 ISO/IEC 15408-3:2026 保证类(ASE/ADV/AGD/ALC/ATE/AVA/ACO/AMA)逐类判定,
11
+ 并给出 **EAL1 就绪度矩阵**(14 项组件:11 项就绪、2 项部分具备、1 项完全依赖外部实验室)与未修复差距清单。
12
+ - `docs/cc/SECURITY-TARGET.md`:按 ASE 族结构(INT/CCL/SPD/OBJ/ECD/REQ/TSS)编写的安全目标草案,
13
+ 含 7 条威胁、3 条假设、3 条组织策略、5 个功能要求族共 8 个组件,以及逐条到实现的映射。
14
+ 首行显式声明 **"Conformance claim: NONE"**。
15
+ - `docs/cc/AVA-VULNERABILITY-ANALYSIS.md`:攻击面穷举(2 条只读路由 + 4 个模型工具 + 1 个随包文件)、
16
+ 威胁→对策→残留风险表、8 项已识别缺陷(5 项本版修复、3 项写明接受理由)。
17
+ - `docs/SBOM.md`:软件物料清单。运行时 **0** 依赖、6 个开发依赖(含传递)、1 个随包第三方文件
18
+ (Chart.js 4.6.1,MIT,sha256 `338399fb…f67fbf`)。
19
+ - `SECURITY.md`:漏洞私密报告渠道、响应时限、攻击面摘要、部署建议、以及
20
+ **5 条"我们不做/不宣称的声明"**(无 CC 证书、非多租户、不替代 DSH 鉴权等)。
21
+
22
+ ### 变更(实现)
23
+
24
+ - `src/runtime.ts`:新增冻结常量 `HARDENING_HEADERS`(`x-content-type-options: nosniff`、
25
+ `referrer-policy: no-referrer`)与 `applyHardeningHeaders(res)`,在 `route()` 入口统一应用。
26
+ - `src/host.ts`:chart 静态文件路由同样调用 `applyHardeningHeaders`,避免两条路由的策略不一致。
27
+ - `package.json`:`files` 增加 `SECURITY.md` 与 `docs`,使 npm 包内即可查阅合规材料。
28
+
29
+ ### 测试
30
+
31
+ - 新增 `tests/security-headers.test.ts`(4 项):断言响应头常量值、写入行为、
32
+ 对无 `setHeader` 的对象保持静默、以及两条路由确实都调用了加固助手。
33
+ - `npm run verify`:**187 tests / 187 pass / 0 fail**(1.7.1 基线为 183)。
34
+
35
+ ### 升级须知
36
+
37
+ - 无破坏性变更,无新增运行时依赖;`dsh plugin --profile web add dsh-workplan@1.8.0` 即可。
38
+ - 若你在反向代理后部署,请仍按 `SECURITY.md` §6 自行加 TLS 与认证——本插件不自带。
39
+
1
40
  ## 1.7.1 — 2026-10-30
2
41
 
3
42
  **修复:1.7.0 在宿主上无法激活(整个插件被跳过)。**
package/README.en.md CHANGED
@@ -8,6 +8,45 @@
8
8
  >
9
9
  > **No app to install, no DSH source to patch, no page replacement.** You get three things: a plan in the conversation, real subagents doing the work, and a **Task progress** panel in the sidebar.
10
10
 
11
+ ---
12
+
13
+ ## 🌍 International security standard: the full evidence chain, and the honest boundary
14
+
15
+ **You have probably seen plugins claim "ISO/IEC 15408 / Common Criteria certified". For small open-source tools that claim is almost always false — CC's rules do not allow it.**
16
+
17
+ In plain words:
18
+
19
+ - **ISO/IEC 15408** (a.k.a. **CC**, Common Criteria) is an international standard that answers one question: *"what can this software actually secure, and why should anyone believe it?"* The current edition is **2026** (not 2022).
20
+ - CC splits the work three ways: **the developer supplies evidence → an accredited lab evaluates it → a national scheme issues the certificate**. The certificate comes from a third party; **software cannot certify itself**.
21
+ - So any claim of "fully satisfies ISO/IEC 15408" without a **certificate number** is a false statement. This plugin has no certificate, and we **will not** write that.
22
+
23
+ So what did we do? **We produced the materials CC asks for, in the standard's own structure, and published them so you can verify everything yourself — without trusting us.**
24
+
25
+ | What is published | What it is in the standard | Where |
26
+ |---|---|---|
27
+ | What this plugin protects, from whom, and where the boundary is | Security Target (ST) | [docs/cc/SECURITY-TARGET.md](docs/cc/SECURITY-TARGET.md) |
28
+ | Attack surface, 7 threats, countermeasures, residual risk | Vulnerability assessment (AVA) | [docs/cc/AVA-VULNERABILITY-ANALYSIS.md](docs/cc/AVA-VULNERABILITY-ANALYSIS.md) |
29
+ | Class-by-class mapping, EAL1 readiness, what is still missing | Self-assessment | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
30
+ | Every third-party component, licence and hash | Life cycle (ALC) | [docs/SBOM.md](docs/SBOM.md) |
31
+ | How to report a vulnerability, response times, deployment | Security policy | [SECURITY.md](SECURITY.md) |
32
+ | 187 automated tests, one command to re-run | Testing (ATE) | `npm run verify` |
33
+
34
+ **Three sentences of conclusion:**
35
+ 1. On engineering evidence, the material is close to **EAL1** — the lowest CC level (11 of 14 components ready, 2 partial, 1 that **only** an external lab can provide);
36
+ 2. Certification itself costs lab time and money and **cannot be achieved by editing code**, so we do not pretend otherwise;
37
+ 3. What we do claim is **checkable by anyone with 5 commands** — worth far more than the phrase "certified".
38
+
39
+ Verify it yourself (copy-paste):
40
+
41
+ ```bash
42
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
43
+ npm ci && npm run verify # expect: tests 187 / pass 187 / fail 0
44
+ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 hits (expected)"
45
+ ```
46
+
47
+ > Remember one line: **a certificate is given by a third party; evidence is earned by the project. We give you the evidence, and we do not fake the certificate.**
48
+
49
+
11
50
  ---
12
51
 
13
52
  ## What it actually does
@@ -44,7 +83,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
44
83
  ## Install
45
84
 
46
85
  ```bash
47
- dsh plugin --profile web add dsh-workplan@1.7.1
86
+ dsh plugin --profile web add dsh-workplan@1.8.0
48
87
  ```
49
88
 
50
89
  Restart the DSH Web process (or reload the page) so the bundle is picked up.
package/README.md CHANGED
@@ -10,6 +10,44 @@
10
10
 
11
11
  ---
12
12
 
13
+ ## 🌍 国际安全标准:我们公开了完整证据链,也公开了边界
14
+
15
+ **你可能在别的插件介绍里见过「通过 ISO/IEC 15408 / Common Criteria 认证」。这句话在开源小工具上基本都是假的,因为 CC 的规矩不允许。**
16
+
17
+ 先说人话版:
18
+
19
+ - **ISO/IEC 15408**(简称 **CC**,通用准则)是一份国际标准,专门回答一个问题:*"一个软件在安全上到底能做到什么,凭什么让人信?"* 最新版是 **2026 年版**(不是 2022 版)。
20
+ - CC 的规矩是三方分工:**写代码的人交材料 → 独立实验室去测 → 国家认证机构发证书**。证书由第三方签发,**软件自己不能给自己发**。
21
+ - 所以任何"我这个插件完全满足 ISO/IEC 15408"的说法,只要没给出**证书编号**,就是不实陈述。本插件没有证书,我们**不会**这么写。
22
+
23
+ 那我们做了什么?**把 CC 要求的那套材料,按标准结构真做出来、公开出来、让任何人不信任我们也能自己核对。**
24
+
25
+ | 我们公开的 | 对应标准里的东西 | 在哪儿看 |
26
+ |---|---|---|
27
+ | 这个插件保护什么、防谁、边界在哪 | 安全目标(ST) | [docs/cc/SECURITY-TARGET.md](docs/cc/SECURITY-TARGET.md) |
28
+ | 攻击面、7 条威胁、对策、残留风险 | 脆弱性评定(AVA) | [docs/cc/AVA-VULNERABILITY-ANALYSIS.md](docs/cc/AVA-VULNERABILITY-ANALYSIS.md) |
29
+ | 逐类对照 + EAL1 就绪度 + 还缺什么 | 符合性自评估 | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
30
+ | 用了哪些别人的代码、许可证、哈希 | 生命周期(ALC) | [docs/SBOM.md](docs/SBOM.md) |
31
+ | 漏洞怎么报、多久回、部署怎么配 | 安全策略 | [SECURITY.md](SECURITY.md) |
32
+ | 187 项自动化测试,一条命令复跑 | 测试(ATE) | `npm run verify` |
33
+
34
+ **结论就三句**:
35
+ 1. 工程实践上,材料已接近 CC 最低等级 **EAL1** 的要求(14 项组件里 11 项已就绪、2 项部分具备、1 项**完全**必须靠外部实验室);
36
+ 2. 认证本身要花外部实验室的钱和时间,**不是改代码能解决的**,所以我们不吹;
37
+ 3. 我们吹的是**能被任何人 5 条命令验证的事实**——这比一句"已通过认证"值钱得多。
38
+
39
+ 自己验证(复制即用):
40
+
41
+ ```bash
42
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
43
+ npm ci && npm run verify # 期望:tests 187 / pass 187 / fail 0
44
+ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中(预期)"
45
+ ```
46
+
47
+ > 一句话记住:**"有证书"是第三方给的,"有证据"是自己挣的。我们给你后者,并且不冒充前者。**
48
+
49
+ ---
50
+
13
51
  ## 它到底做了什么(用大白话讲)
14
52
 
15
53
  平时你给 AI 一个复杂任务,它经常「一边想一边做」,做到一半你才发现方向不对。
@@ -33,7 +71,7 @@
33
71
  ## 一键安装
34
72
 
35
73
  ```bash
36
- dsh plugin --profile web add dsh-workplan@1.7.1
74
+ dsh plugin --profile web add dsh-workplan@1.8.0
37
75
  ```
38
76
 
39
77
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
package/SECURITY.md ADDED
@@ -0,0 +1,109 @@
1
+ # 安全策略 / Security Policy
2
+
3
+ > 本文件是 `dsh-workplan` 的安全入口:**能做什么、边界在哪、出了问题怎么报、哪些话我们不说**。
4
+ > This file is the security entry point for `dsh-workplan`: what it can do, where the boundary is, how to report a problem, and **what we do not claim**.
5
+
6
+ ---
7
+
8
+ ## 1. 一句话说清底线 / The honest bottom line
9
+
10
+ **中文**:本插件按 ISO/IEC 15408(通用准则,Common Criteria,简称 CC)**2026 年版**的文档结构与证据要求做了公开自评估,并把能补的差距补齐了。但 **CC 符合性不是软件自己说了算的**:它必须由具备资质的实验室按 ISO/IEC 18045(CEM)评测、再由一个国家/地区认证体系签发证书。**本插件没有 CC 证书,因此我们不宣称"已通过/完全满足 ISO/IEC 15408"。** 我们宣称的是可被任何人复核的事实:文档结构、证据、测试与修复记录全部公开。
11
+
12
+ **English**: This plugin carries a public self-assessment aligned to the **2026 edition** of ISO/IEC 15408 (Common Criteria, CC) — its documentation structure and evidence expectations — and closes the gaps it could close. But **CC conformance is not something software declares about itself**: it requires evaluation by an accredited laboratory under ISO/IEC 18045 (CEM) and a certificate issued by a national scheme. **This plugin has no CC certificate, so we do not claim it "passes" or "fully satisfies ISO/IEC 15408".** What we claim is checkable: the structure, the evidence, the tests and the fix record are all public.
13
+
14
+ 完整评估见 [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md),安全目标(ST 草案)见 [docs/cc/SECURITY-TARGET.md](docs/cc/SECURITY-TARGET.md)。
15
+
16
+ ---
17
+
18
+ ## 2. 支持范围 / Supported versions
19
+
20
+ | 版本 | 安全修复 | 说明 |
21
+ |---|---|---|
22
+ | 1.8.x | ✅ 接收 | 当前发布线 |
23
+ | ≤ 1.7.x | ❌ 不再单独修复 | 建议升级到 1.8.x |
24
+
25
+ 只维护 npm `latest` 指向的版本线;升级命令见 [README.md](README.md)。
26
+
27
+ ---
28
+
29
+ ## 3. 报告漏洞 / Reporting a vulnerability
30
+
31
+ **请不要开公开 issue。** 公开 issue 等于把攻击方法贴在门口。
32
+
33
+ - 首选:GitHub 私密漏洞报告 <https://github.com/abbaababa/dsh-workplan/security/advisories/new>
34
+ - 备选:发邮件到仓库维护者邮箱(见 `git log -1 --format=%ae`)
35
+
36
+ 请在报告里给出:版本号、复现步骤、影响、以及你认为的严重程度。
37
+
38
+ **我们对时间的承诺(尽力而为,非法律承诺)**:
39
+
40
+ | 阶段 | 目标 |
41
+ |---|---|
42
+ | 确认收到 | 7 天内 |
43
+ | 初步判断(是否成立、严重度) | 14 天内 |
44
+ | 修复或缓解方案 | 30 天内(高危优先) |
45
+ | 公开致谢 | 修复发布后,除非你要求匿名 |
46
+
47
+ ---
48
+
49
+ ## 4. 攻击面:这个插件到底能被怎么碰 / Attack surface
50
+
51
+ 插件只在 DSH Web 进程中跑,暴露面只有两条路由和四个模型工具:
52
+
53
+ | 入口 | 方法 | 谁能到 | 鉴权 |
54
+ |---|---|---|---|
55
+ | `/dsh-workplan/plans` | GET / HEAD | 浏览器 | 走 DSH 的 `connection.requestRejection`,未通过返回 401/403 |
56
+ | `/dsh-workplan/vendor/chart.umd.js` | GET / HEAD | 浏览器 | 同上(同源静态资源) |
57
+ | `dsh_workplan_dispatch` 等 4 个工具 | 模型调用 | 仅主 Agent | plan 模式下 `dispatch` 被 guard 拒绝;写入带 `expectedRevision` 乐观锁 |
58
+
59
+ **没有的东西(可自行 grep 复核)**:
60
+
61
+ ```bash
62
+ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileSync|mkdirSync|https?\.request" src # 应无命中
63
+ ```
64
+
65
+ - 零第三方**运行时**依赖(`dependencies` 为空)。
66
+ - 不写用户磁盘:结果只进 DSH 会话记录。
67
+ - 不外发数据:唯一的 `fetch` 是浏览器请求**同源**的 `/dsh-workplan/plans`。
68
+ - 图表库 Chart.js 4.6.1(MIT)随包分发,不加载 CDN。
69
+
70
+ ---
71
+
72
+ ## 5. 威胁模型(简版)/ Threat model
73
+
74
+ | 威胁 | 场景 | 现有对策 | 证据 |
75
+ |---|---|---|---|
76
+ | 未授权读取 | 别人直接访问面板接口 | 依赖 DSH 会话鉴权,未通过即拒绝 | `src/runtime.ts` `route()` 的 `requestRejection` |
77
+ | 数据外泄 | 插件把计划内容发给第三方 | 源码无对外请求;同源 only | `grep` 证据见上 |
78
+ | 注入 / 路径穿越 | 构造请求读出别的文件 | 路由是 `exact` 精确匹配,静态文件路径写死 | `src/host.ts` `webServer.register({kind:'exact'})` |
79
+ | 状态被篡改 | 子 Agent 或别处改计划状态 | 写入需 `expectedRevision`,不匹配返回 `STALE_WRITE` | `dsh_workplan_update` 契约 |
80
+ | 资源耗尽 | 超长计划 / 永不返回的子 Agent | 子 Agent 与总预算双超时;响应超过 2.5 MB 截断 | `watchdog.ts`;`route()` 截断分支 |
81
+ | 供应链 | 依赖被投毒 | 零运行时依赖;唯一的第三方文件是 vendored Chart.js | `package.json`、`vendor/` |
82
+ | **虚假完成** | 报告说"做完了"其实没做 | `verification`/`acceptance` 分级,`structured` 才可直接采信 | 系统提示词契约 + `workplan-evidence-contract.test.ts` |
83
+
84
+ 第 7 条是这个插件最特别的一条:它防备的不是外部攻击者,而是**AI 自己编造进度**。
85
+
86
+ ---
87
+
88
+ ## 6. 部署建议 / Deployment guidance
89
+
90
+ | 场景 | 建议 |
91
+ |---|---|
92
+ | 本机单人用(默认) | 保持默认,DSH 默认只监听本机 |
93
+ | 局域网 / 多人共用 | 必须在 DSH 侧开启身份认证与访问控制;本插件**不自带**多租户隔离 |
94
+ | 反向代理暴露到公网 | 必须加 TLS + 认证;面板接口会返回计划正文,等同会话内容 |
95
+ | 生产环境 | 固定版本号安装,不要用浮动版本 |
96
+
97
+ ---
98
+
99
+ ## 7. 我们不做的声明 / Claims we do NOT make
100
+
101
+ 为避免误读,逐条写死:
102
+
103
+ 1. ❌ 本插件**没有** CC 证书,也**没有**通过任何实验室评测。
104
+ 2. ❌ 本插件**不是**"完全满足 ISO/IEC 15408"的产品。
105
+ 3. ❌ 本插件**不提供**多用户隔离、加密存储、独立审计日志服务。
106
+ 4. ❌ 本插件**不替代** DSH 自身的身份认证与权限体系。
107
+ 5. ✅ 本插件**提供**按 ISO/IEC 15408:2026 结构组织的公开自评估、ST 草案、攻击面分析与可复现测试。
108
+
109
+ > 一句话:**我们把"能做到的"做到了并公开证据;把"做不到的"写清楚,而不是把它包装成卖点。**
package/docs/SBOM.md ADDED
@@ -0,0 +1,113 @@
1
+ # 软件物料清单(SBOM)— dsh-workplan v1.8.0
2
+
3
+ **用途**:回答"这个插件里到底有哪些别人的代码"。供应链安全的起点,也是 ISO/IEC 15408 生命周期(ALC)类的基础材料。
4
+
5
+ 生成方式:`package.json` + `package-lock.json`(lockfileVersion 3)+ 仓库文件扫描。
6
+ 复核:`npm ls --all`、`shasum -a 256 vendor/chart.umd.js`。
7
+
8
+ ---
9
+
10
+ ## 1. 结论先行
11
+
12
+ | 项目 | 数量 |
13
+ |---|---|
14
+ | 运行时第三方依赖 | **0** |
15
+ | 随包分发的第三方文件 | **1**(Chart.js,MIT) |
16
+ | 构建期开发依赖(含传递) | **6** |
17
+ | 本仓自有代码 | 5 个 TS 模块 + 1 个类型声明 / 8044 行 |
18
+ | 许可证 | 本项目 MIT;第三方全部为 MIT 或 Apache-2.0,均允许再分发 |
19
+
20
+ **零运行时依赖**是本项目最重要的安全属性之一:安装插件不会引入任何可被投毒的运行时依赖树。
21
+
22
+ ---
23
+
24
+ ## 2. 运行时依赖
25
+
26
+ ```
27
+ (空)
28
+ ```
29
+
30
+ `package.json` 的 `dependencies` 字段不存在或为空对象。插件运行所需的全部能力来自 Node.js 标准库与 DSH 提供的宿主 API。
31
+
32
+ ---
33
+
34
+ ## 3. 随包分发的第三方文件
35
+
36
+ | 文件 | 组件 | 版本 | 许可证 | 大小 | SHA-256 |
37
+ |---|---|---|---|---|---|
38
+ | `vendor/chart.umd.js` | Chart.js | 4.6.1 | MIT | 210,078 字节 | `338399fb5bafe598d21cfc471b0590b61ceb321a985fade4f68499b151f67fbf` |
39
+
40
+ **为什么它随包而不是走 CDN**:走 CDN 意味着每次打开面板都要向第三方发起请求,泄露使用行为,且受对方可用性影响。随包固定 + 哈希可核对,是把这条风险关掉的最简单做法。
41
+
42
+ **复核**:
43
+ ```bash
44
+ shasum -a 256 vendor/chart.umd.js
45
+ # 期望:338399fb5bafe598d21cfc471b0590b61ceb321a985fade4f68499b151f67fbf
46
+ ```
47
+
48
+ ---
49
+
50
+ ## 4. 构建期开发依赖(不随包发布)
51
+
52
+ | 包 | 版本 | 许可证 | 用途 |
53
+ |---|---|---|---|
54
+ | `typescript` | 5.9.3 | Apache-2.0 | 编译 TS → JS、类型检查 |
55
+ | `@types/node` | 22.20.5 | MIT | Node.js API 类型定义 |
56
+ | `@types/react` | 18.3.31 | MIT | 面板代码的 React 类型定义 |
57
+ | `@types/prop-types` | 15.7.15 | MIT | 上者的传递依赖 |
58
+ | `csstype` | 3.2.3 | MIT | 上者的传递依赖 |
59
+ | `undici-types` | 6.21.0 | MIT | `@types/node` 的传递依赖 |
60
+
61
+ 声明范围(`package.json` `devDependencies`):`@types/node ^22.20.5`、`@types/react ^18.3.31`、`typescript ^5.9.3`。
62
+ 实际锁定版本以上表与 `package-lock.json` 为准。
63
+
64
+ **为什么开发依赖的风险可接受**:它们只在开发者机器与 CI 上执行,不进入 npm 包的运行路径。即便被投毒,影响面是"构建产物被污染",而 CI 的 `git diff --exit-code -- lib client.js` 会立即发现构建产物与源码不一致。
65
+
66
+ ---
67
+
68
+ ## 5. 本项目自有代码清单
69
+
70
+ | 文件 | 行数 | 作用 |
71
+ |---|---|---|
72
+ | `src/client.ts` | 2881 | 浏览器面板渲染 |
73
+ | `src/runtime.ts` | 2384 | 计划生成/派发/看门狗/HTTP 路由/鉴权 |
74
+ | `src/plan.ts` | 2158 | 计划结构、校验、统计派生 |
75
+ | `src/host.ts` | 400 | 插件入口:注册路由、工具、配置 |
76
+ | `src/watchdog.ts` | 207 | 子代理超时与预算监控 |
77
+ | `src/globals.d.ts` | 14 | 宿主 API 类型声明 |
78
+ | **合计** | **8044** | |
79
+ | `tests/*.test.ts` | **30 个文件 / 187 项测试** | 自动化验证 |
80
+
81
+ (行数取自 `wc -l src/*.ts`,v1.8.0 实测。)
82
+
83
+ ---
84
+
85
+ ## 6. 许可证合规
86
+
87
+ | 许可证 | 组件 | 是否允许商用/再分发 | 义务 |
88
+ |---|---|---|---|
89
+ | MIT | 本项目、Chart.js、@types/*、csstype、undici-types | ✅ | 保留版权与许可声明 |
90
+ | Apache-2.0 | typescript(**仅构建期**) | ✅ | 保留声明与 NOTICE(未再分发则不适用) |
91
+
92
+ **没有再分发的 Apache-2.0 代码**:TypeScript 只在构建时使用,产物是编译后的 JS,不包含 TypeScript 源码或声明文件。因此 npm 包内只含 MIT 代码。
93
+
94
+ ---
95
+
96
+ ## 7. 已知未覆盖项(诚实说明)
97
+
98
+ | 项 | 状态 |
99
+ |---|---|
100
+ | 未生成 SPDX/CycloneDX 标准格式文件 | 本文件为人工维护的 Markdown 版 SBOM;对零运行时依赖的项目足够,但不如机器可读格式便于自动化审计 |
101
+ | 未做依赖漏洞库比对(CVE 扫描) | 运行时零依赖使此项收益极低;开发依赖可用 `npm audit` 自行检查 |
102
+ | 未固定开发依赖的精确版本(用 `^` 范围) | `package-lock.json` 已锁定实际版本;`npm ci` 会严格按 lock 安装 |
103
+
104
+ ---
105
+
106
+ ## 8. 复核命令
107
+
108
+ ```bash
109
+ npm ls --all # 看完整依赖树
110
+ npm ls --omit=dev # 期望:空(零运行时依赖)
111
+ shasum -a 256 vendor/chart.umd.js
112
+ npm ci && npm run verify # 按 lock 安装并跑全量测试
113
+ ```
@@ -0,0 +1,97 @@
1
+ # 脆弱性分析(AVA)— dsh-workplan v1.8.0
2
+
3
+ **性质:开发者自评的脆弱性分析,不是实验室的 AVA_VAN 评定。**
4
+ 本文件回答三个问题:**能被怎么打 → 打了会怎样 → 现在挡不挡得住**。
5
+
6
+ ---
7
+
8
+ ## 1. 方法
9
+
10
+ | 步骤 | 做法 | 可复核性 |
11
+ |---|---|---|
12
+ | 1. 攻击面枚举 | 列出 TOE 的全部外部接口(2 条 HTTP 路由 + 4 个模型工具 + 1 个随包文件) | `src/host.ts` 的 `webServer.register` 与 `registerTool` |
13
+ | 2. 危险能力扫描 | 对危险 API 做源码特征扫描 | 本文 §5 命令 |
14
+ | 3. 威胁建模 | 7 条威胁,逐条给对策与残留风险 | 本文 §3、ST §3 |
15
+ | 4. 依赖审计 | 运行时零依赖;第三方文件记哈希 | [../SBOM.md](../SBOM.md) |
16
+ | 5. 已知缺陷清单 | 列出已知但未修复的问题 | 本文 §6 |
17
+
18
+ **未做**:第三方渗透测试、模糊测试(fuzzing)、形式化分析、侧信道分析。这三项是 N-01~N-03 差距的直接来源。
19
+
20
+ ---
21
+
22
+ ## 2. 攻击面清单(穷举)
23
+
24
+ | # | 入口 | 输入可控点 | 潜在滥用 |
25
+ |---|---|---|---|
26
+ | AS-1 | `GET/HEAD /dsh-workplan/plans` | 请求头、查询串(未使用)、方法 | 越权读取计划内容 |
27
+ | AS-2 | `GET/HEAD /dsh-workplan/vendor/chart.umd.js` | 同 AS-1 | 路径穿越读任意文件(理论) |
28
+ | AS-3 | `dsh_workplan_dispatch` | 模型生成的参数 | 未经确认的派发、重复派发 |
29
+ | AS-4 | `dsh_workplan_update` | `subtaskId`、`status`、`expectedRevision` | 并发覆盖、伪造完成 |
30
+ | AS-5 | `dsh_workplan_cancel` | `planId` | 取消他人计划 |
31
+ | AS-6 | `dsh_workplan_status` | `planId` | 只读,风险最低 |
32
+ | AS-7 | 随包 `vendor/chart.umd.js` | 文件本身(供应链) | 被替换为恶意版本 |
33
+
34
+ **没有的入口**:文件上传、WebSocket、子进程、SQL、模板渲染、反序列化、命令执行、环境变量写入。
35
+
36
+ ---
37
+
38
+ ## 3. 威胁 → 对策 → 残留风险
39
+
40
+ | 威胁 | 攻击路径 | 现有对策(实现层) | 残留风险 | 等级 |
41
+ |---|---|---|---|---|
42
+ | **T-01 未授权读取** | 直接请求 AS-1 | `route()` 先 `await connectionCtx.connection.requestRejection(req)`,拒绝即终止 | 若部署方能绕过 DSH 直连端口,或 DSH 未配置认证 → 可读 | **中**(取决于部署) |
43
+ | **T-02 数据外泄** | 诱导插件出站 | 源码无出站 API;唯一 `fetch` 为浏览器同源 | 模型可把计划内容写进自己的回复,属 DSH/模型层问题,非本 TOE 可控 | **低**(TOE 内) |
44
+ | **T-03 注入/穿越** | 构造 `../../etc/passwd` 之类路径 | 两条路由均为 `kind: 'exact'` 精确匹配;静态文件路径在代码中写死;响应带 `nosniff` | 未做模糊测试,未知边界行为 | **低** |
45
+ | **T-04 状态篡改** | 并发 `update` 覆盖 | `expectedRevision` 乐观锁,不匹配返回 `STALE_WRITE` | 主代理自身可合法改写(设计如此) | **低** |
46
+ | **T-05 资源耗尽** | 超长计划 / 子代理挂起 | 子代理超时 + 总预算双上限且夹紧;响应 > 2.5 MB 截断 | 极长计划仍占会话 token(受 DSH 限制) | **低** |
47
+ | **T-06 供应链** | 替换上游依赖 | 运行时零依赖;唯一第三方文件随包固定,记录 sha256 | 开发依赖(3 个 @types/TS)被投毒可影响构建,不影响运行时 | **低** |
48
+ | **T-07 虚假完成** | AI 自述"已完成" | 完成需附 `verification`(structured/unverified/failed/legacy)与 `acceptance`;`structured` 之外必须人工/主代理复核 | 主代理若不核对仍可能误信 | **中**(流程依赖) |
49
+
50
+ ---
51
+
52
+ ## 4. 已识别的具体缺陷与处置
53
+
54
+ | 编号 | 缺陷 | 影响 | 处置 | 状态 |
55
+ |---|---|---|---|---|
56
+ | V-01 | `respondJson` 与两处 `writeHead` 未设置 `x-content-type-options` | 某些浏览器可能对响应做 MIME 嗅探 | 新增 `HARDENING_HEADERS` + `applyHardeningHeaders()`,两条路由均调用 | **已修复 1.8.0** |
57
+ | V-02 | 缺少 `referrer-policy` | 面板被嵌入外站时可能泄露 URL | 同上(`no-referrer`) | **已修复 1.8.0** |
58
+ | V-03 | 缺少公开的漏洞报告渠道 | 研究者只能开公开 issue,扩大暴露 | 新增 `SECURITY.md`(私密 advisory + 时限) | **已修复 1.8.0** |
59
+ | V-04 | 无依赖清单 | 无法快速回答"用了什么第三方代码" | 新增 `docs/SBOM.md` | **已修复 1.8.0** |
60
+ | V-05 | 无 ST / AVA 文档 | 无法回答"保护什么、防谁" | 新增 `docs/cc/*` | **已修复 1.8.0** |
61
+ | V-06 | `x-frame-options`/CSP 未设置 | 若被第三方页面 iframe 嵌入,存在点击劫持理论风险 | **未修复**:面板由 DSH 主页面同源加载,未以可嵌入形态对外;加 CSP 需与 DSH 主站策略协调,单独加会破坏面板 | 接受(记录在案) |
62
+ | V-07 | 未做模糊测试 | 边界输入行为未知 | 未修复(需工具与时间预算) | 接受 |
63
+ | V-08 | 无多租户隔离 | 多用户共用同一 DSH 实例时,计划数据在同进程内 | 设计边界:由 DSH 承担隔离;已在 SECURITY.md 写明 | 接受(设计边界) |
64
+
65
+ ---
66
+
67
+ ## 5. 复核命令(任何人都能验证上面的说法)
68
+
69
+ ```bash
70
+ # 1) 危险 API 扫描:预期 0 命中
71
+ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileSync|mkdirSync|https?\.request" src || echo "0 命中(预期)"
72
+
73
+ # 2) 网络调用:预期只有浏览器同源 fetch
74
+ grep -RIn "fetch(" src
75
+
76
+ # 3) 鉴权与硬化响应头
77
+ grep -n "requestRejection" src/runtime.ts
78
+ grep -n "HARDENING_HEADERS\|x-content-type-options\|referrer-policy" src/runtime.ts
79
+
80
+ # 4) 路由为精确匹配(非前缀)
81
+ grep -n "kind: 'exact'" src/host.ts
82
+
83
+ # 5) 响应截断阈值
84
+ grep -n "2_500_000" src/runtime.ts
85
+
86
+ # 6) 全量测试
87
+ npm run verify
88
+ ```
89
+
90
+ ---
91
+
92
+ ## 6. 结论
93
+
94
+ - TOE 的攻击面**很小且可完全枚举**:2 条只读路由 + 4 个受控工具,无文件写入、无子进程、无出站请求。
95
+ - 本版本修掉了 5 项可修的缺陷(V-01~V-05),剩余 3 项(V-06~V-08)已写明理由,属**接受的风险**而非遗漏。
96
+ - 与 CC 的 AVA 类对照:材料层面满足自评要求,**不满足**第三方评定的要求(见 `CC-2026-ASSESSMENT.md` §7 N-02/N-03)。
97
+ - 最重要的残留风险不是技术性的:**T-07 虚假完成**依赖流程纪律,而不是代码。这一点必须在使用文档里反复讲清楚。