dsh-workplan 1.7.0 → 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 +68 -0
  2. package/README.en.md +41 -2
  3. package/README.md +40 -2
  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 +5 -16
  40. package/lib/runtime.js +37 -1
  41. package/package.json +4 -2
  42. package/src/host.ts +6 -15
  43. package/src/runtime.ts +39 -1
@@ -0,0 +1,254 @@
1
+ # dsh-workplan 对 ISO/IEC 15408:2026 的符合性自评估报告
2
+
3
+ **Self-Assessment Report against ISO/IEC 15408:2026**
4
+
5
+ | 项目 | 内容 |
6
+ |---|---|
7
+ | 评估对象(TOE) | dsh-workplan 插件 v1.8.0 |
8
+ | 评估性质 | **公开自评估(self-assessment),不是 CC 认证** |
9
+ | 依据标准 | ISO/IEC 15408-1/-2/-3/-4/-5:2026;ISO/IEC 18045:2026(CEM) |
10
+ | 报告日期 | 2026-10-30 |
11
+ | 报告者 | 项目维护者(abbaababa) |
12
+ | 结论摘要 | **不宣称通过 CC;按 15408-3 结构完成逐类自评,识别 8 项差距,本轮修复 4 项,剩余 4 项已列明原因** |
13
+
14
+ ---
15
+
16
+ ## 0. 一页读懂(给非技术读者)
17
+
18
+ **CC(Common Criteria,通用准则)是什么?**
19
+ 它是一份国际标准(编号 ISO/IEC 15408),用来回答一个问题:*"一个软件在安全上到底能做到什么,凭什么让人相信?"* 它不测功能多不多,只查一件事——**你说的安全承诺,有没有证据撑得住**。
20
+
21
+ **最重要的一句话:软件不能自己宣布"我通过 CC 了"。**
22
+ CC 的规矩是三方分工:写代码的人交材料(Security Target,安全目标)→ 独立实验室按 ISO/IEC 18045 去测 → 国家认证机构发证书。**没有证书就没有"通过"**,谁说"完全满足",谁就在说假话。本插件没有证书,所以本文从头到尾不会写"通过"或"完全满足"。
23
+
24
+ **那我们做了什么?**
25
+ 把 CC 要求的那套材料**按标准结构做出来、公开出来、能被任何人复核**:
26
+
27
+ | 我们做的 | 对应 CC 里的东西 | 文件 |
28
+ |---|---|---|
29
+ | 写清楚这个插件保护什么、防谁、边界在哪 | 安全目标 ST | [SECURITY-TARGET.md](SECURITY-TARGET.md) |
30
+ | 把攻击面、威胁、已有对策列成表 | 脆弱性评定 AVA | [AVA-VULNERABILITY-ANALYSIS.md](AVA-VULNERABILITY-ANALYSIS.md) |
31
+ | 列出所有第三方组件及许可证 | 生命周期 ALC | [../SBOM.md](../SBOM.md) |
32
+ | 补上缺失的安全响应头 | 实现修复 | `src/runtime.ts` |
33
+ | 公开漏洞报告渠道与时限 | 生命周期 / 响应 | [../../SECURITY.md](../../SECURITY.md) |
34
+ | 187 项自动化测试,可一键复跑 | 测试 ATE | `npm run verify` |
35
+
36
+ **结论(三句话)**:
37
+ 1. 插件的**工程实践**已经接近 CC 最低等级 EAL1 的材料要求;
38
+ 2. 但**认证这件事本身**需要外部实验室和费用,不是改代码能解决的;
39
+ 3. 所以我们把"能自证的"全部公开自证,把"不能自证的"逐条写清楚——**这才是对"国际标准"最诚实的用法**。
40
+
41
+ ---
42
+
43
+ ## 1. 审查依据与版本核验
44
+
45
+ ### 1.1 版本核验结果
46
+
47
+ | 标准 | 版本 | 说明 |
48
+ |---|---|---|
49
+ | ISO/IEC 15408-1 | **2026** | 简介与一般模型(术语、评估对象、保证等级) |
50
+ | ISO/IEC 15408-2 | **2026** | 安全功能组件(SFR) |
51
+ | ISO/IEC 15408-3 | **2026** | 安全保证组件(SAR) |
52
+ | ISO/IEC 15408-4 | **2026** | 评估方法与活动框架 |
53
+ | ISO/IEC 15408-5 | **2026** | 预定义保护轮廓(PP) |
54
+ | ISO/IEC 18045 | **2026** | 评估方法(CEM),实验室照此执行 |
55
+
56
+ **为什么不是 2022 版?** 2026 年 5–6 月,ISO/IEC 已发布 15408 全系列 2026 版,替代 2022 版(CC:2022 Release 1)。多个国家成员体目录页明确标注 "Replaced standards ISO/IEC 15408-2:2022"。
57
+
58
+ **版本与结构核对来源**(公开可查):
59
+ - ISO/IEC 15408-3:2026 目录(DIN 发布,含章节结构):<https://www.din.de/de/mitwirken/normenausschuesse/nia/veroeffentlichungen/wdc-beuth:din21:402972060/toc-3703455/download>
60
+ - 该目录确认了 2026 版 ASE 类的族结构:`ASE_INT`(9.2)、`ASE_CCL`(9.3)、`ASE_SPD`(9.4)、`ASE_OBJ`(9.5)、`ASE_ECD`(9.6)、`ASE_REQ`(9.7)、`ASE_COMP`(9.9.4);`ADV_FSP` 位于 10.3,组合类 `ACO_REL` 位于 15.4。
61
+ - CC:2022 Part 5(EAL 与组件表,IPA 镜像):<https://www.ipa.go.jp/security/jisec/about/cdk3vs000000240h-att/CC2022PART5R1.pdf>
62
+
63
+ ### 1.2 审查的已知限制(必须写明)
64
+
65
+ 1. `www.commoncriteriaportal.org` 在本机返回 **HTTP 403**,无法直接读取门户正文;本文的族/组件编号以官方发布目录(上列)为准,若 2026 正式文本有微调,以正式文本为准。
66
+ 2. 本文**不是**评估者报告(ETR),不含实验室结论、不含渗透测试、不含证书编号。
67
+ 3. 审查范围为**公开可见的全部材料**:源码、测试、CI、文档、发布记录。
68
+
69
+ ---
70
+
71
+ ## 2. 评估对象(TOE)界定
72
+
73
+ **TOE = dsh-workplan 插件在 DSH Web 进程内运行的那部分**,具体包含:
74
+
75
+ | 组成 | 文件 | 作用 |
76
+ |---|---|---|
77
+ | 宿主运行时 | `src/runtime.ts`(2384 行) | 计划生成、派发、watchdog、HTTP 路由、鉴权 |
78
+ | Host 插件入口 | `src/host.ts` | 注册 2 条 HTTP 路由、4 个模型工具、配置 schema |
79
+ | 浏览器面板 | `src/client.ts`(2881 行)→ `client.js` | 渲染计划面板(同源拉取 `/dsh-workplan/plans`) |
80
+ | 计划模型 | `src/plan.ts`(2158 行) | 计划结构、校验、派生统计 |
81
+ | 看门狗 | `src/watchdog.ts`(207 行) | 子代理超时与预算监控 |
82
+ | 类型声明 | `src/globals.d.ts` | 宿主 API 的类型补充 |
83
+ | 随包第三方文件 | `vendor/chart.umd.js` | Chart.js 4.6.1(MIT),本地分发,不走 CDN |
84
+
85
+ **不在 TOE 内**(属于运行环境,即 CC 语境里的 "environment"):
86
+ - DSH 本体与模型服务(身份认证、会话存储、模型推理);
87
+ - Node.js 运行时与操作系统;
88
+ - 用户的浏览器。
89
+
90
+ **TOE 安全边界**:进程内的插件代码 + 它对外暴露的 2 条 HTTP 路由和 4 个模型工具。
91
+ - `GET/HEAD /dsh-workplan/plans`
92
+ - `GET/HEAD /dsh-workplan/vendor/chart.umd.js`
93
+ - `dsh_workplan_dispatch` / `dsh_workplan_status` / `dsh_workplan_update` / `dsh_workplan_cancel`
94
+
95
+ ---
96
+
97
+ ## 3. 核心结论:为什么"完全满足"不可宣称
98
+
99
+ CC 符合性有三个**缺一不可**的硬前提:
100
+
101
+ | # | 前提 | 本插件状态 | 能否靠改代码解决 |
102
+ |---|---|---|---|
103
+ | 1 | 一份符合 ASE 结构的 **Security Target**,且声明了符合性 | **有草案**(本仓 `docs/cc/SECURITY-TARGET.md`),但明确声明 "no conformance claim" | 部分可以(文档),但声明本身需要评估者背书 |
104
+ | 2 | 由**认可实验室**按 ISO/IEC 18045 完成评估并出具 ETR | **无** | ❌ 不能 |
105
+ | 3 | 由**国家/地区认证体系**签发证书(如 CCRA 成员体系) | **无** | ❌ 不能 |
106
+
107
+ 因此,任何"本插件完全满足 ISO/IEC 15408"的表述都属于**不实陈述**。本项目拒绝这样写。
108
+ 本报告能承担的是第 1 项的材料准备,以及把第 2、3 项的差距**量化、公开、可复核**。
109
+
110
+ > 一句话:**合规不是形容词,是证据链。我们把链子的每一节都摆出来,缺哪节就说缺哪节。**
111
+
112
+ ---
113
+
114
+ ## 4. 按 ISO/IEC 15408-3:2026 保证类的逐类判定
115
+
116
+ 判定口径:✅ 材料齐备可复核 | 🟡 部分具备、有明确缺口 | ❌ 缺失 | ➖ 不适用
117
+
118
+ | 保证类 | 该类要证明什么 | 本插件现状 | 判定 | 证据 / 缺口 |
119
+ |---|---|---|---|---|
120
+ | **ASE** 安全目标评估 | ST 是否自洽、可测、无矛盾 | 已按 INT/CCL/SPD/OBJ/ECD/REQ/TSS 结构写出 ST 草案,并显式声明"不作符合性主张" | 🟡 | `docs/cc/SECURITY-TARGET.md`;缺口:未经独立评估者评审,未覆盖 ASE_COMP(非组合产品) |
121
+ | **ADV** 开发 | 设计是否被完整、正确地描述到实现 | 全部源码公开(5 个 TS 模块 + 1 个类型声明,共 8044 行);TSF 接口仅 2 路由 + 4 工具,可枚举 | 🟡 | 缺口:无独立的"功能规范(ADV_FSP)"文档与"实现表示(ADV_TDS)"文档;本报告第 2、5 节为最小替代 |
122
+ | **AGD** 指导性文档 | 用户/管理员能否正确安全地部署使用 | README(中英)、SECURITY.md 部署建议、FAQ | ✅ | `README.md`、`README.en.md`、`SECURITY.md`;含"我们不做/不宣称"清单 |
123
+ | **ALC** 生命周期支持 | 开发与交付过程是否受控、可追溯 | git 全历史(13 次提交)、CI(`npm ci` → `npm run verify` → 构建产物一致性检查)、版本五处同步测试 | 🟡 | 缺口:无正式《配置管理计划》文档、无可重现构建(reproducible build)证明 |
124
+ | **ATE** 测试 | 功能是否被独立验证过 | 30 个测试文件 / **187 项测试**全部通过,`npm run verify` 一键复跑,CI 每次提交执行 | 🟡 | 已有自动化测试与失败路径覆盖;缺口:无实验室独立测试(ATE_IND.1),无正式测试覆盖矩阵 |
125
+ | **AVA** 脆弱性评定 | 是否存在可被利用的脆弱性 | 威胁模型 7 条、攻击面枚举、源码特征扫描(危险 API 0 命中)、零运行时依赖 | 🟡 | `docs/cc/AVA-VULNERABILITY-ANALYSIS.md`;缺口:无第三方渗透测试 |
126
+ | **ACO** 组合 | 组合产品间的依赖与信任传递 | 插件不是组合产品(无底层 TOE 依赖) | ➖ | 不适用 |
127
+ | **AMA** 保证维护 | 发布后如何维持保证 | 有 CHANGELOG、语义化版本、npm `latest`、漏洞响应时限 | 🟡 | 缺口:无正式 AMA 计划文档(CC 的 AMA 类通常仅在保证维护场景要求) |
128
+
129
+ **逐类小结**:✅ 1 类 | 🟡 6 类 | ➖ 1 类 | ❌ 0 类。
130
+ 没有任何一类处于"完全缺失"状态,也没有任何一类可以被称为"已通过"。
131
+
132
+ ---
133
+
134
+ ## 5. EAL1 就绪度矩阵(最低保证等级)
135
+
136
+ EAL1 = "功能测试"级,是 CC 中最低、也是唯一对小工具现实可达的等级。
137
+ 下表按 EAL1 通常包含的 14 个保证组件逐项自评。
138
+
139
+ | 组件 | 含义(大白话) | 状态 | 证据 | 还缺什么 |
140
+ |---|---|---|---|---|
141
+ | ASE_INT.1 | 说清这产品是什么 | ✅ | 本报告第 2 节、ST 草案 §1 | — |
142
+ | ASE_CCL.1 | 说清"符合什么标准" | ✅ | ST 草案 §2 显式写 "no conformance claim" | 正式评估时需改为实际符合性主张 |
143
+ | ASE_SPD.1 | 说清防谁、防什么 | ✅ | ST 草案 §3(7 威胁 / 3 假设 / 3 组织策略) | — |
144
+ | ASE_OBJ.1 | 说清安全目标 | ✅ | ST 草案 §4 | — |
145
+ | ASE_ECD.1 | 若有自定义要求,定义之 | ✅ | ST 草案 §5(声明不使用扩展组件) | — |
146
+ | ASE_REQ.1 | 说清选用了哪些安全要求 | ✅ | ST 草案 §6(5 个功能要求族 / 8 个组件 + 理由) | — |
147
+ | ASE_TSS.1 | 说清"实现上怎么做到的" | ✅ | ST 草案 §7(逐条映射到文件与行为) | — |
148
+ | ADV_FSP.1 | 有基本的功能规范 | 🟡 | 路由/工具接口已完整枚举(本报告 §2、§5) | 缺一份独立的接口规范文档 |
149
+ | AGD_OPE.1 | 有用户操作指南 | ✅ | README 中英双语、面板使用说明 | — |
150
+ | AGD_PRE.1 | 有安装/准备指南 | ✅ | README 安装章节、SECURITY.md 部署建议 | — |
151
+ | ALC_CMC.1 | 有版本标识与唯一标识 | ✅ | `package.json` 版本五处同步测试、npm 发布记录、git tag | — |
152
+ | ALC_CMS.1 | 有配置项清单 | ✅ | `docs/SBOM.md` + `package-lock.json` + 文件清单 | 正式评估建议补 CM 计划 |
153
+ | ATE_IND.1 | 独立测试 | ❌ | 本仓有 187 项自动化测试,但**不是独立实验室测试** | 必须外部实验室 |
154
+ | AVA_VAN.1 | 基础脆弱性分析 | 🟡 | AVA 文档 + 威胁模型 | 建议第三方渗透测试 |
155
+
156
+ **就绪度合计**:✅ 11 项 | 🟡 2 项(ADV_FSP.1、AVA_VAN.1 的第三方评定部分)| ❌ 1 项(ATE_IND.1 独立测试)。
157
+
158
+ > 注意:**"就绪"≠"通过"**。上表说明的是"材料齐不齐",不是"实验室测没测"。
159
+
160
+ ---
161
+
162
+ ## 6. 本轮(v1.8.0)修复的差距
163
+
164
+ | 编号 | 差距 | 严重度 | 修复 | 验证 |
165
+ |---|---|---|---|---|
166
+ | D-01 | 响应缺少 `x-content-type-options: nosniff` 与 `referrer-policy: no-referrer`,存在浏览器把响应当别的类型解析的理论风险 | 中 | `src/runtime.ts` 新增冻结常量 `HARDENING_HEADERS` 与 `applyHardeningHeaders()`;`route()` 与 chart 路由均调用 | `tests/security-headers.test.ts`(4 项)+ 全量 187 项通过 |
167
+ | D-02 | 没有公开、可核验的漏洞报告渠道与响应时限 | 中 | 新增根目录 `SECURITY.md`:私密报告入口、时限承诺、攻击面、7 条威胁模型、部署建议、"不做/不宣称"清单 | 文件存在 + README 链接 |
168
+ | D-03 | 没有符合 ASE 结构的安全目标,无法回答"你到底保护什么" | 高 | 新增 `docs/cc/SECURITY-TARGET.md`(按 2026 版 7 个 ASE 族组织) | 与本报告 §4/§5 交叉引用一致 |
169
+ | D-04 | 没有依赖与供应链清单 | 中 | 新增 `docs/SBOM.md`(运行时 0 依赖 + 3 个开发依赖 + 1 个 vendored 文件,含 sha256) | 与 `package.json`、`package-lock.json` 一致 |
170
+
171
+ 修复后回归:`npm run verify` → **187 tests / 187 pass / 0 fail**(2026-10-30,Node 见 CI 配置)。
172
+
173
+ ---
174
+
175
+ ## 7. 未修复的差距及原因(诚实清单)
176
+
177
+ | 编号 | 差距 | 为什么不修 | 影响 |
178
+ |---|---|---|---|
179
+ | N-01 | 无 CC 证书 | 需认可实验室评测 + 认证机构发证 + 费用与周期,非代码可解 | 不能对外宣称"通过/完全满足" |
180
+ | N-02 | 无独立实验室测试(ATE_IND.1) | 同上 | 测试结论仅为自测 |
181
+ | N-03 | 无第三方渗透测试(AVA_VAN.1 深度部分) | 需外部安全团队,本项目无预算 | 脆弱性分析为自评 |
182
+ | N-04 | 无形式化/半形式化功能规范(ADV_FSP 完整版) | 对 8 千行插件属过度投入;已用接口枚举 + 源码公开替代 | 材料强度低于正式 EAL1 要求 |
183
+ | N-05 | 无多租户隔离、无独立审计日志服务 | **设计边界**:插件运行在 DSH 会话内,认证与审计由 DSH 承担 | 多人共用场景必须依赖 DSH 侧配置 |
184
+
185
+ **这五条不会因为版本升级而消失**。它们被写在这里,是为了让每一个读到"国际标准"四个字的人,都能立刻看到边界在哪里。
186
+
187
+ ---
188
+
189
+ ## 8. 如果要真正拿证:EAL1 路线图(供参考)
190
+
191
+ | 阶段 | 做什么 | 谁做 | 常见周期(业界区间,非报价) |
192
+ |---|---|---|---|
193
+ | 0 | 完成 ST(把本文草案的 "no conformance claim" 改为实际主张) | 开发者 | 2–4 周 |
194
+ | 1 | 补 ADV_FSP/ADV_TDS 文档、CM 计划 | 开发者 | 2–6 周 |
195
+ | 2 | 选实验室,签合同,提交 TOE 与证据包 | 开发者 + 实验室 | 2–4 周 |
196
+ | 3 | 实验室执行 ATE_IND.1 与 AVA_VAN.1 | 实验室 | 4–12 周 |
197
+ | 4 | 认证机构评审发证 | 认证机构 | 4–12 周 |
198
+ | 5 | 证书维持(AMA) | 开发者 | 持续 |
199
+
200
+ 周期与费用因国家体系(CCRA / EUCC / JISEC 等)差异很大,本文不给具体数字,避免误导。
201
+
202
+ ---
203
+
204
+ ## 9. 证据索引
205
+
206
+ | 证据 | 位置 | 复核方式 |
207
+ |---|---|---|
208
+ | 安全目标(ST 草案) | `docs/cc/SECURITY-TARGET.md` | 阅读,对照 §4 |
209
+ | 脆弱性分析 | `docs/cc/AVA-VULNERABILITY-ANALYSIS.md` | 阅读 + 运行 §10 命令 |
210
+ | 依赖清单 | `docs/SBOM.md` | 与 `package.json` 对比 |
211
+ | 安全策略与披露渠道 | `SECURITY.md` | 阅读 |
212
+ | 硬化响应头实现 | `src/runtime.ts`(`HARDENING_HEADERS`) | `grep -n HARDENING_HEADERS src/runtime.ts` |
213
+ | 硬化响应头测试 | `tests/security-headers.test.ts` | `npm run verify` |
214
+ | 全量测试结果 | 终端输出 | `npm run verify` |
215
+ | CI 流水线 | `.github/workflows/verify.yml` | 阅读 + GitHub Actions 运行记录 |
216
+ | 版本一致性 | `tests/version-sync.test.ts` | `npm run verify` |
217
+ | 发布记录 | npm `dsh-workplan`、GitHub Releases | `npm view dsh-workplan version` |
218
+
219
+ ---
220
+
221
+ ## 10. 复现方法(任何人可跑)
222
+
223
+ ```bash
224
+ # 1) 取代码
225
+ git clone https://github.com/abbaababa/dsh-workplan.git
226
+ cd dsh-workplan
227
+
228
+ # 2) 装依赖(仅开发依赖)
229
+ npm ci
230
+
231
+ # 3) 一键复跑:类型检查 + 构建 + 全部测试
232
+ npm run verify
233
+ # 期望最后看到:tests 187 / pass 187 / fail 0
234
+
235
+ # 4) 复核"无危险 API"这一条
236
+ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileSync|mkdirSync|https?\.request" src || echo "0 命中(预期)"
237
+
238
+ # 5) 复核硬化响应头
239
+ grep -n "x-content-type-options" src/runtime.ts
240
+ ```
241
+
242
+ ---
243
+
244
+ ## 11. 声明与限制
245
+
246
+ 1. 本报告是**开发者的自评估**,不是评估者报告(ETR),不构成任何认证结论。
247
+ 2. 文中"✅/🟡/❌"仅表示**材料齐备度**,不表示安全性已获第三方验证。
248
+ 3. 标准版本以 2026 年版为准;若官方文本有修订,以官方为准,本报告将随版本更新。
249
+ 4. 本报告不构成对任何具体攻击的免疫承诺;漏洞请按 `SECURITY.md` 的渠道报告。
250
+ 5. **本项目不会、也不应把"通过 ISO/IEC 15408"用作营销词**——除非将来真的拿到证书,届时证书编号会写在这一行。
251
+
252
+ ---
253
+
254
+ *报告结束。任何一项结论都可在第 10 节用 5 条命令复核。*
@@ -0,0 +1,239 @@
1
+ # 安全目标(Security Target)— dsh-workplan v1.8.0
2
+
3
+ **文件性质:按 ISO/IEC 15408-3:2026 ASE 类结构编写的 ST 草案 / ST draft structured per ISO/IEC 15408-3:2026 class ASE.**
4
+
5
+ > ## ⚠ 符合性主张:无 / Conformance claim: NONE
6
+ >
7
+ > 本文件**不主张**符合 ISO/IEC 15408(CC)。它是一个**自评估草案**,用于:
8
+ > 1. 把"这个插件到底保护什么"写成可被检查的文字;
9
+ > 2. 为将来可能的正式评估提供可直接修改的底稿。
10
+ >
11
+ > 本插件**没有**经过任何认可实验室(ISO/IEC 18045 / CEM)评测,**没有**任何认证体系签发的证书。
12
+ > 文中"满足"一律指"本实现符合本文自述的要求",**不是**"经第三方验证"。
13
+ >
14
+ > This document makes **no** CC conformance claim. It is a self-assessment draft. The TOE has **not** been evaluated by an accredited laboratory under ISO/IEC 18045 and holds **no** certificate. "Meets" below means "the implementation matches what this document states", not "independently verified".
15
+
16
+ | 字段 | 值 |
17
+ |---|---|
18
+ | ST 标识 | `dsh-workplan-ST-1.8.0`(草案 rev 1) |
19
+ | TOE 标识 | `dsh-workplan` 插件 1.8.0,npm 包 `dsh-workplan@1.8.0` |
20
+ | 依据 | ISO/IEC 15408-1/-2/-3:2026 |
21
+ | 目标保证等级 | 无(若将来评估,拟选 **EAL1**) |
22
+ | 日期 | 2026-10-30 |
23
+
24
+ ---
25
+
26
+ ## 1. ASE_INT — ST 引言
27
+
28
+ ### 1.1 ST 引用
29
+ 见上表。本 ST 随插件版本发布,版本号与 `package.json` 由测试强制同步。
30
+
31
+ ### 1.2 TOE 引用
32
+ `dsh-workplan@1.8.0`。分发渠道:npm 公共注册表;源码:<https://github.com/abbaababa/dsh-workplan>。
33
+
34
+ ### 1.3 TOE 概述
35
+ `dsh-workplan` 是 DeepSeek Harness(DSH)的一个插件。它让 AI 在**动手之前**先把任务拆成阶段和子任务,把计划显示给用户,再按计划派发子代理,并把每个子任务的结果、验证状态与证据写回会话。
36
+
37
+ 用大白话说:**它是给 AI 装的一个"先写施工图、再动工、干完对账"的流程锁。**
38
+
39
+ ### 1.4 TOE 描述
40
+
41
+ **物理/逻辑构成**(TOE 边界内):
42
+
43
+ | 部件 | 文件 | 职责 |
44
+ |---|---|---|
45
+ | 宿主运行时 | `src/runtime.ts`(2384 行) | 计划生成与派发、子代理看门狗、HTTP 路由与鉴权、状态写入 |
46
+ | 插件入口 | `src/host.ts` | 注册 2 条 HTTP 路由、4 个模型工具、配置 schema、版本元数据 |
47
+ | 浏览器面板 | `src/client.ts`(2881 行)→ `client.js` | 同源拉取计划数据并渲染面板(含图表) |
48
+ | 计划模型 | `src/plan.ts`(2158 行) | 计划结构、校验、统计派生 |
49
+ | 看门狗 | `src/watchdog.ts`(207 行) | 子代理超时与预算控制 |
50
+ | 随包第三方 | `vendor/chart.umd.js` | Chart.js 4.6.1(MIT),本地分发 |
51
+
52
+ **外部接口(TSF 接口,完全枚举)**:
53
+
54
+ | 接口 | 类型 | 方向 | 说明 |
55
+ |---|---|---|---|
56
+ | `/dsh-workplan/plans` | HTTP GET/HEAD | 入 | 返回当前会话计划 JSON;非 GET/HEAD 返回 405 |
57
+ | `/dsh-workplan/vendor/chart.umd.js` | HTTP GET/HEAD | 入 | 返回图表库静态文件 |
58
+ | `dsh_workplan_dispatch` | 模型工具 | 双向 | 派发计划;plan 模式下被 guard 拒绝 |
59
+ | `dsh_workplan_status` | 模型工具 | 双向 | 只读查询进度 |
60
+ | `dsh_workplan_update` | 模型工具 | 双向 | 更新子任务状态,需 `expectedRevision` |
61
+ | `dsh_workplan_cancel` | 模型工具 | 双向 | 取消未派发/等待中的计划 |
62
+
63
+ **不在 TOE 内**:DSH 本体(身份认证、会话存储、模型推理)、Node.js 运行时、操作系统、浏览器。
64
+
65
+ **TOE 运行所需但自身不提供的能力**:身份认证与访问控制(由 DSH 的 `connection.requestRejection` 提供)。
66
+
67
+ ---
68
+
69
+ ## 2. ASE_CCL — 符合性主张
70
+
71
+ | 项目 | 内容 |
72
+ |---|---|
73
+ | CC 符合性 | **不主张 / no claim** |
74
+ | 保护轮廓(PP)符合性 | **不主张**符合任何 PP(含 ISO/IEC 15408-5:2026 预定义 PP) |
75
+ | 包(Package)符合性 | **不主张**符合任何 EAL 包;EAL1 仅为将来评估的拟选目标 |
76
+ | 方法符合性 | 本文结构与术语参照 ISO/IEC 15408-3:2026,但未经 CEM 评估 |
77
+
78
+ **为什么这么写**:CC 的符合性主张必须由评估者验证后才成立。开发者先行"主张"而不经评估,等同于虚假陈述。因此本 ST 保留结构、放弃主张。
79
+
80
+ ---
81
+
82
+ ## 3. ASE_SPD — 安全问题的定义
83
+
84
+ ### 3.1 威胁(Threats)
85
+
86
+ | 编号 | 威胁 | 攻击者能力假设 |
87
+ |---|---|---|
88
+ | **T-01 未授权读取** | 未通过 DSH 鉴权的请求读到会话计划内容 | 能向本机端口发 HTTP 请求 |
89
+ | **T-02 数据外泄** | 插件把计划内容/会话信息发往第三方 | 能诱导插件发起出站请求 |
90
+ | **T-03 注入与路径穿越** | 构造请求使插件执行代码或返回边界外文件 | 能构造任意请求路径与方法 |
91
+ | **T-04 状态篡改** | 非主代理方修改子任务状态,使"已完成"失真 | 能调用模型工具或并发写入 |
92
+ | **T-05 资源耗尽** | 超长计划或永不返回的子代理拖死会话 | 能构造超大计划或让子代理挂起 |
93
+ | **T-06 供应链投毒** | 第三方依赖被植入恶意代码 | 能控制某个上游包或其发布渠道 |
94
+ | **T-07 虚假完成报告** | 子任务未完成却报告完成,误导运维者决策 | AI 自身产生幻觉或过度乐观的自述 |
95
+
96
+ > T-07 是本 TOE 区别于一般工具的关键威胁:这里的"攻击者"是**模型自己**。
97
+
98
+ ### 3.2 假设(Assumptions)
99
+
100
+ | 编号 | 假设 | 若不成立 |
101
+ |---|---|---|
102
+ | **A-01** | 运行环境(DSH)对每次 HTTP 请求执行身份认证与访问控制,并通过 `connection.requestRejection` 返回拒绝决定 | T-01 无法缓解,必须由部署方补齐反向代理鉴权 |
103
+ | **A-02** | TOE 部署在受信主机、面向受信运维者;不假设多租户隔离 | 多人共用场景需 DSH 侧额外隔离 |
104
+ | **A-03** | 运行于受支持的 Node.js(≥22)与受支持的浏览器 | 行为可能异常 |
105
+
106
+ ### 3.3 组织安全策略(OSPs)
107
+
108
+ | 编号 | 策略 | 理由 |
109
+ |---|---|---|
110
+ | **P-01** | TOE **不得**主动向外部网络发送任何数据 | 计划内容含任务与代码上下文,属敏感信息 |
111
+ | **P-02** | TOE **应**保持零运行时第三方依赖 | 减小 T-06 攻击面,便于审计 |
112
+ | **P-03** | TOE 的每次状态变更**应**可在会话记录中追溯 | 支撑 T-04、T-07 的发现与追责 |
113
+
114
+ ---
115
+
116
+ ## 4. ASE_OBJ — 安全目标
117
+
118
+ ### 4.1 TOE 的安全目标
119
+
120
+ | 编号 | 目标 | 对应威胁/策略 |
121
+ |---|---|---|
122
+ | **O-01 访问受控** | 只有通过环境鉴权的请求才能获得计划数据 | T-01, A-01 |
123
+ | **O-02 无出站数据流** | TOE 代码不发起任何对外网络请求;浏览器仅同源请求 | T-02, P-01 |
124
+ | **O-03 输入与方法受约束** | 路由为精确匹配;非 GET/HEAD 一律 405;静态文件路径写死 | T-03 |
125
+ | **O-04 写入受控** | 状态写入需携带匹配的 `expectedRevision`,不匹配即失败 | T-04, P-03 |
126
+ | **O-05 资源有界** | 子代理超时、总预算上限、响应体超过 2.5 MB 截断 | T-05 |
127
+ | **O-06 供应链最小化** | 运行时零依赖;唯一第三方文件随包固定并记录哈希 | T-06, P-02 |
128
+ | **O-07 进度可验证** | 完成声明必须附证据与验收分级;`structured` 之外不得直接采信 | T-07, P-03 |
129
+
130
+ ### 4.2 环境的安全目标
131
+
132
+ | 编号 | 目标 | 责任方 |
133
+ |---|---|---|
134
+ | **OE-01 认证与授权** | 对每个 HTTP 请求做身份判定并拒绝未授权请求 | DSH |
135
+ | **OE-02 会话完整存储** | 保证会话记录不被外部静默改写 | DSH |
136
+ | **OE-03 传输保护** | 若跨主机访问,由部署方提供 TLS | 部署方 |
137
+
138
+ ---
139
+
140
+ ## 5. ASE_ECD — 扩展组件定义
141
+
142
+ **本 ST 不使用任何扩展组件(extended components)。**
143
+
144
+ 全部安全功能要求均取自 ISO/IEC 15408-2:2026 已定义组件;仅使用标准允许的操作(赋值 assignment、精化 refinement、选择 selection)做适配,并在 §6 中逐条标注。
145
+
146
+ ---
147
+
148
+ ## 6. ASE_REQ — 安全功能要求
149
+
150
+ 共 **5 个功能要求族 / 8 个组件**。每条给出:标准组件 → 本 TOE 的赋值/精化 → 理由。
151
+
152
+ ### 6.1 信息流控制(FDP_IFC / FDP_IFF)
153
+
154
+ **FDP_IFC.1 子集信息流控制**
155
+ TOE 应强制执行以下信息流控制策略:*受保护的计划数据只能流向同源的、经环境鉴权的 HTTP 响应与浏览器面板。*
156
+ - 赋值:受控主体 = {宿主运行时, 浏览器面板};受控信息 = {计划数据、子任务结果、证据};受控操作 = {HTTP 响应, 模型工具返回}。
157
+ - 理由:直接支撑 O-02,对抗 T-02。
158
+
159
+ **FDP_IFF.1 简单安全属性**
160
+ TOE 应基于以下属性允许信息流:请求同源、方法 ∈ {GET, HEAD}、环境鉴权通过。
161
+ - 理由:把"谁能看"变成可判定的布尔条件,而非策略口号。
162
+
163
+ ### 6.2 识别(FIA_UID)
164
+
165
+ **FIA_UID.1 识别时机**
166
+ TOE 应在执行任何数据返回操作**之前**,依赖环境完成识别并取得允许/拒绝决定。
167
+ - 精化:TOE 不自行实现用户库,而是调用 `connectionCtx.connection.requestRejection(req)`,并在其返回拒绝时终止处理。
168
+ - 理由:O-01 + A-01;避免重复造认证轮子。
169
+
170
+ ### 6.3 功能管理(FMT_MOF / FMT_SMF / FMT_SMR)
171
+
172
+ **FMT_MOF.1 安全功能行为的管理**
173
+ TOE 应仅允许主代理(Lead)通过 `dsh_workplan_dispatch / update / cancel` 改变计划状态;只读查询不得改变状态。
174
+ **FMT_SMF.1 安全管理功能规范**
175
+ TOE 应提供:查看计划、派发计划、更新子任务状态与证据、取消计划,共 4 项管理功能。
176
+ **FMT_SMR.1 安全角色**
177
+ TOE 应区分两个角色:主代理(可写)与浏览器观察者(只读,仅能 GET/HEAD)。
178
+ - 理由:O-04 + P-03,对抗 T-04。
179
+
180
+ ### 6.4 审计(FAU_GEN)
181
+
182
+ **FAU_GEN.1 审计数据生成**
183
+ TOE 应在以下事件发生时生成可追溯记录:计划创建、派发开始、子任务完成(含 verification 与 acceptance)、派发取消、状态写入被 `STALE_WRITE` 拒绝。
184
+ - 赋值:记录载体 = DSH 会话事件与工具返回值(TOE 不另建日志文件)。
185
+ - 理由:P-03,支撑 T-04/T-07 的事后追责。
186
+
187
+ ### 6.5 TSF 自测试(FPT_TST)
188
+
189
+ **FPT_TST.1 TSF 自测试**
190
+ TOE 应提供可重复执行的自测试,覆盖:计划模型校验、鉴权分支、方法限制、响应截断、看门狗超时、版本一致性、安全响应头。
191
+ - 赋值:测试套件 = `npm run verify`(30 个文件 / 187 项测试)。
192
+ - 理由:O-05、O-07 的可复现证据来源;对应 ATE 类的自测部分。
193
+
194
+ ---
195
+
196
+ ## 7. ASE_TSS — TOE 安全功能规格(实现如何做到)
197
+
198
+ | 要求 | 实现位置 | 具体做法 | 复核命令 |
199
+ |---|---|---|---|
200
+ | FDP_IFC.1 / FDP_IFF.1 | `src/runtime.ts` `route()` | 仅注册 2 条 `exact` 路由;非 GET/HEAD → 405;响应带 `cache-control: no-store` | `grep -n "no-store" src/runtime.ts` |
201
+ | FDP_IFC.1(无出站) | 全仓 | 除浏览器同源 `fetch('/dsh-workplan/plans')` 外无任何网络调用 | 见 §8 扫描命令 |
202
+ | FIA_UID.1 | `src/runtime.ts` `route()` 开头 | 先 `await connectionCtx.connection.requestRejection(req)`,拒绝则直接返回 | `grep -n requestRejection src/runtime.ts` |
203
+ | FMT_MOF.1 / FMT_SMF.1 | `src/host.ts` 工具注册 | 4 个工具;`update` 强制 `expectedRevision`,不匹配返回 `STALE_WRITE`;plan 模式下 `dispatch` 被 guard 拒绝 | `grep -n "expectedRevision" src/*.ts` |
204
+ | FMT_SMR.1 | 同上 + 路由 | 浏览器角色只能 GET/HEAD;写操作只能经模型工具 | 同 FMT_MOF.1 |
205
+ | FAU_GEN.1 | 会话事件 + 工具返回值 | 每次派发/完成/取消/拒绝均落会话事件,含证据字段 | 阅读 `dsh_workplan_status` 返回结构 |
206
+ | FPT_TST.1 | `tests/` + `npm run verify` | 30 文件 187 项;CI 每次提交执行 | `npm run verify` |
207
+ | O-05 资源有界 | `src/runtime.ts`、`src/watchdog.ts` | 响应 > 2.5 MB 截断;子代理与总预算双超时且被夹紧 | `grep -n "2_500_000" src/runtime.ts` |
208
+ | 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` |
209
+ | P-02 零运行时依赖 | `package.json` | `dependencies` 为空对象 | `npm ls --omit=dev` |
210
+
211
+ **为什么这些证据够"基本"**:EAL1 只要求"功能规范可理解 + 独立测试通过",不要求形式化证明。上表把每个安全要求落到**一行可执行的 grep/命令**,使读者无需信任本文即可自行核对。
212
+
213
+ ---
214
+
215
+ ## 8. 复核方法(任何人可执行)
216
+
217
+ ```bash
218
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
219
+ npm ci
220
+ npm run verify # 期望:tests 187 / pass 187 / fail 0
221
+
222
+ # 无危险 API
223
+ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileSync|mkdirSync|https?\.request" src || echo "0 命中(预期)"
224
+
225
+ # 无出站请求(唯一命中应为浏览器同源 fetch)
226
+ grep -RIn "fetch(" src
227
+
228
+ # 鉴权、硬化头、截断、乐观锁
229
+ grep -n "requestRejection\|HARDENING_HEADERS\|2_500_000\|expectedRevision" src/runtime.ts src/host.ts
230
+ ```
231
+
232
+ ---
233
+
234
+ ## 9. 声明的边界
235
+
236
+ 1. 本 ST 是**草案**,未经评估者评审,不构成任何符合性结论。
237
+ 2. §6 的 SFR 为**自选**,用于把实现约束写成可检查的条款;不是对任何 PP 的符合性声明。
238
+ 3. §7 的"实现如何做到"仅覆盖本文列出的要求,不覆盖 DSH 本体、Node.js、OS 的安全属性。
239
+ 4. 发现本文件与实现不一致时,**以实现与测试为准**,并按 `SECURITY.md` 渠道报告——这本身也是 T-07(虚假完成)在本项目上的应用。