dsh-blue-team-mode 2.0.0-beta.32 → 2.0.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.
package/CHANGELOG.md CHANGED
@@ -1,6 +1,29 @@
1
1
  # Changelog
2
2
 
3
- ## 2.0.0-beta.32 — 2026-11-15(本地试用,未发布)
3
+ ## 2.0.0 — 2026-11-17
4
+
5
+ ### Added
6
+
7
+ - 2.0 稳定版:66 个 `blue_*` 工具、12 个控制台页签、17 张事实库表、6 个执行角色。
8
+ - 高风险任务强制 `pending_approval`,新增人工审批与审计;不再允许 `pending_approval` 直接派发。
9
+ - SQLite WAL、timeline 哈希链、Ed25519 证据签名、幂等迁移与 1.5.3 回滚演练。
10
+ - CL+TE / 重复长度 / 歧义 TE 直接拒绝;JWT none、路径、Cookie 规则。
11
+ - 诱饵 planned/active 校准,假 flag 不按真泄露处理。
12
+ - JSONL 增量遥测与 OTLP/HTTP JSON 接收器,Bearer token 保护。
13
+ - CVE 防御包、CVE 任务生成、资产—CVE—发现风险图。
14
+ - 中英文本地化与独立右侧栏控制台。
15
+
16
+ ### Tests
17
+
18
+ - 可恢复 24h soak 完成:1442 个采样,`integrity=ok`,`timeline=true`,`alerts=0`。
19
+ - `npm test` 8 组测试、`build`、`validate`、迁移/回滚演练、合规自测、`npm pack --dry-run` 全部通过。
20
+
21
+ ### Notes
22
+
23
+ - soak 按实际采样时间累计;本次墙钟跨度约 53h,中间有 3 段暂停,符合 `docs/stabilization.md` 的可暂停/恢复口径。
24
+ - 已知限制仍包括 CVE 未外部核验、审计锚定偏本地、无 RBAC/静态加密、OTLP 无持久队列。
25
+
26
+ ## 2.0.0-beta.32 — 2026-11-15(beta 通道)
4
27
 
5
28
  ### Added
6
29
 
package/README.md CHANGED
@@ -12,8 +12,8 @@
12
12
 
13
13
  **66 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 12 个控制台页签 · 17 张事实库表**
14
14
 
15
- > 🧪 当前源码是 `2.0.0-beta.32` 本地试用版,**没有发布到 npm / 市场**。
16
- > 正式安装仍用 `1.5.3`;2.0 用本地 tarball 装。
15
+ > ✅ 当前稳定版是 `2.0.0`,已发布到 npm。
16
+ > 从 `1.5.4` 升级前先备份 `$DSH_HOME/blue/blue.db`;回滚见 `docs/release-2.0.md`。
17
17
  > DSH 兼容:最低 `0.2.1-rc.1`,当前验证 `0.2.2-rc.3`;详见 `docs/compatibility.md`。
18
18
 
19
19
  ---
@@ -114,7 +114,7 @@ dsh plugin --profile desktop add .
114
114
  - **范围自动入库**:创建 engagement 时自动把 scope 中的具体主机登记为资产,避免“开了目标但图谱空白”;CIDR/通配符仍只作为范围,不冒充在线资产。
115
115
  - **请求走私防线**:内联网关直接拒绝 CL+TE、重复长度头、歧义 TE,并设置 headers/request/keep-alive 硬超时;测试策略见 `docs/request-smuggling.md`,不拿无重启能力的 live 目标做实验。
116
116
  - **OTLP/HTTP 日志接收器**:设置 `BLUE_OTLP_TOKEN` 后,`/blue/otlp/v1/logs` 接收 OTLP JSON,按 service/severity 落成告警;不支持 protobuf,详见 `docs/otel.md`。
117
- - **维护巡检**:`scripts/maintenance-check.mjs` 每周检查测试、构建、npm latest、catalog 和 soak;只报告/开 issue,不发布、不合并。见 `docs/maintenance-bot.md` 和 `MAINTENANCE.md`。
117
+ - **维护巡检**:`scripts/maintenance-check.mjs` 每天检查测试、构建、npm latest、catalog 和 soak;只报告/开 issue,不发布、不合并。见 `docs/maintenance-bot.md` 和 `MAINTENANCE.md`。
118
118
  - **攻击面图谱**:`blue_risk_graph` 把资产、CVE 匹配和未关闭发现关联成风险排序图;控制台「图谱」页签直接看对外资产、风险条和关联 CVE。
119
119
  - **2026 CVE 防御包**:`blue_cve_pack` 查看 Node.js/PHP/Laravel/Ivanti/NetScaler 等补丁动作,`blue_cve_scan` 做启发式日志匹配,`blue_cve_campaign` 按资产名/服务/tag 生成 hardening 核查任务;不包含利用代码,具体版本以厂商公告为准。
120
120
  - **证据包**:`blue_evidence_export` 导出事实库快照、审计链/锚点状态和 Ed25519 签名;`blue_evidence_verify` 校验 digest 与签名,敏感字段脱敏。
@@ -1,13 +1,13 @@
1
1
  # 已知问题与欠债
2
2
 
3
- > 最后更新:2026-11-15
3
+ > 最后更新:2026-11-17
4
4
  > 这些不是“以后再说”,是接盘者必须先知道的坑。
5
5
 
6
6
  ## 1. 市场 catalog 滞后
7
7
 
8
8
  ```text
9
- npm latest:1.5.4
10
- catalog:1.5.2
9
+ npm latest:2.0.0
10
+ catalog:可能仍显示 1.5.4
11
11
  ```
12
12
 
13
13
  原因:
@@ -30,23 +30,28 @@ catalog 由 awesome-dsh-plugin 的 probe 生成
30
30
  改 main 的 YAML 只改描述,不改 versions
31
31
  ```
32
32
 
33
- ## 2. 24h soak 未完成
33
+ ## 2. soak 是“实际采样时间”,不是连续墙钟
34
34
 
35
- 当前:
35
+ 2.0.0 的结果:
36
36
 
37
37
  ```text
38
- 约 9h / 24h
38
+ elapsed_sec:86400(24h 实际采样)
39
+ samples:1442
40
+ integrity:ok
41
+ timeline:true
42
+ alerts:0
39
43
  ```
40
44
 
41
45
  限制:
42
46
 
43
47
  ```text
44
- soak 只在本机运行
45
- 关机就暂停
48
+ 墙钟跨度约 53h
49
+ 中间有 3 段暂停(约 10h / 25h / 6.7h)
50
+ 关机、休眠、退出都不计入进度
46
51
  ```
47
52
 
48
- 不是失败,是还没跑完。
49
- 在 24h 完成前,2.0 不能叫正式稳定版。
53
+ 这是 `docs/stabilization.md` 的既定口径,不是失败;
54
+ 但不要把“24h soak”理解成连续 24 小时墙钟。
50
55
 
51
56
  ## 3. CVE 数据未核验
52
57
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## 它做什么
4
4
 
5
- 每周自动检查:
5
+ 每天自动检查:
6
6
 
7
7
  ```text
8
8
  npm test
@@ -25,7 +25,7 @@ maintenance-report.json
25
25
  如果配置了 `GITHUB_TOKEN`,会创建/更新固定 issue:
26
26
 
27
27
  ```text
28
- [maintenance] 每周巡检
28
+ [maintenance] 每日巡检
29
29
  ```
30
30
 
31
31
  ## 它不做什么
@@ -48,8 +48,8 @@ maintenance-report.json
48
48
  时间:
49
49
 
50
50
  ```text
51
- 每周一 01:00 UTC
52
- = 北京时间周一 09:00
51
+ 每天 01:00 UTC
52
+ = 北京时间 09:00
53
53
  ```
54
54
 
55
55
  也可以手动:
@@ -85,7 +85,7 @@ schtasks /Create /SC DAILY /ST 09:00 /TN "DSH Blue Maintenance" `
85
85
 
86
86
  ```text
87
87
  名称:DSH Blue Maintenance
88
- 时间:每周一 09:00
88
+ 时间:每天 09:00
89
89
  模式:Interactive only(登录后运行)
90
90
  ```
91
91
 
@@ -95,8 +95,8 @@ schtasks /Create /SC DAILY /ST 09:00 /TN "DSH Blue Maintenance" `
95
95
  下一个周一 09:00
96
96
  ```
97
97
 
98
- GitHub workflow 的 `schedule` **只会在默认分支上触发**。
99
- 当前 workflow 在 `2.0-dev` 工作分支时,需要手动 `workflow_dispatch`;合并到默认分支后才会每周自动跑。
98
+ GitHub workflow 的 `schedule` 只在默认分支上触发。
99
+ 当前 workflow 已在 `main`,每天自动跑;本地/其他分支用 `workflow_dispatch`。
100
100
 
101
101
  带 issue:
102
102
 
@@ -120,17 +120,17 @@ fail 测试/构建/打包失败
120
120
  ## 典型报告
121
121
 
122
122
  ```text
123
- npm latest=1.5.4 package=2.0.0-beta.32 warn
124
- catalog=1.5.2 package=2.0.0-beta.32 warn
125
- soak=2.53h/24h running warn
123
+ npm latest=2.0.0 package=2.0.0 ok
124
+ catalog=1.5.4 package=2.0.0 warn
125
+ soak=24h/24h completed ok
126
126
  ```
127
127
 
128
- 这不是故障,是提醒:
128
+ `warn` 不是故障,是提醒:
129
129
 
130
130
  ```text
131
- beta 和 stable 本来就不是同一个版本
132
131
  catalog 可能还没重建
133
- soak 还没跑完
132
+ catalog 的版本来自上游 probe,不是 npm 发布后立刻更新
133
+ soak 如果显示 running,说明本地 state 被重置或还没跑到 24h
134
134
  ```
135
135
 
136
136
  ## 权限
@@ -0,0 +1,174 @@
1
+ # 2.0 发布说明
2
+
3
+ > 状态:`2.0.0` 已发布为稳定版;`2.0.0-beta.32` 保留在 beta 通道。
4
+
5
+ ## 一句话
6
+
7
+ 2.0 把蓝队插件从“工具集合”推进到:
8
+
9
+ ```text
10
+ 风险闸
11
+ + 事实库
12
+ + 审计链
13
+ + 证据包
14
+ + 任务审批
15
+ + 诱饵/遥测/OTLP
16
+ + CVE 防御包
17
+ + 资产—风险图谱
18
+ ```
19
+
20
+ ## 规模
21
+
22
+ ```text
23
+ 66 个工具
24
+ 12 个页签
25
+ 17 张表
26
+ 6 个执行角色
27
+ ```
28
+
29
+ ## 主要变化
30
+
31
+ ### 风险与审批
32
+
33
+ ```text
34
+ high 风险任务强制 pending_approval
35
+ blue_task_approve 人工放行
36
+ 审批写 timeline
37
+ 不允许 pending_approval 直接 dispatched
38
+ ```
39
+
40
+ ### 事实库与审计
41
+
42
+ ```text
43
+ SQLite WAL
44
+ timeline 哈希链
45
+ Ed25519 证据签名
46
+ 幂等迁移
47
+ 回滚演练脚本
48
+ ```
49
+
50
+ ### 检测与防御
51
+
52
+ ```text
53
+ CL+TE / 重复长度 / 歧义 TE 直接拒绝
54
+ JWT none、路径、Cookie 规则
55
+ 诱饵 planned/active 校准
56
+ 假 flag 不按真泄露处理
57
+ ```
58
+
59
+ ### 遥测
60
+
61
+ ```text
62
+ JSONL 增量轮询
63
+ OTLP/HTTP JSON 接收器
64
+ Bearer token
65
+ 按 service/severity 落告警
66
+ ```
67
+
68
+ ### CVE 与资产
69
+
70
+ ```text
71
+ CVE 防御包
72
+ CVE 任务生成
73
+ 资产—CVE—发现风险图
74
+ scope 中具体 host/URL 自动登记资产
75
+ ```
76
+
77
+ ### 控制台
78
+
79
+ ```text
80
+ 12 个页签
81
+ 任务审批
82
+ 诱饵标记运行
83
+ 证据导出
84
+ 全面浏览
85
+ 中英文本地化
86
+ ```
87
+
88
+ ## 从 1.5.4 升级
89
+
90
+ ### 升级前
91
+
92
+ ```text
93
+ 备份 $DSH_HOME/blue/blue.db
94
+ 记录当前版本
95
+ 保留 1.5.4 tarball
96
+ ```
97
+
98
+ ### 安装 2.0.0
99
+
100
+ ```sh
101
+ dsh plugin --profile desktop add dsh-blue-team-mode@2.0.0
102
+ ```
103
+
104
+ 或:
105
+
106
+ ```sh
107
+ dsh plugin --profile desktop add \
108
+ https://github.com/FGCGDroid/blue/releases/download/v2.0.0/dsh-blue-team-mode-2.0.0.tgz
109
+ ```
110
+
111
+ ### 升级后验证
112
+
113
+ ```text
114
+ DSH 能启动
115
+ 控制台能打开
116
+ engagement/资产/告警还在
117
+ timeline 连续
118
+ 导出一次证据
119
+ 跑一次 low 风险任务
120
+ ```
121
+
122
+ ### 回滚
123
+
124
+ ```text
125
+ 停止 DSH
126
+ 恢复 blue.db 备份
127
+ 装回 1.5.4
128
+ 重启
129
+ ```
130
+
131
+ ## 已知问题
132
+
133
+ ```text
134
+ soak 按实际采样时间累计,墙钟中间有暂停
135
+ 市场 catalog 可能仍显示 1.5.4,等待重建
136
+ CVE 未外部核验
137
+ 审计锚定仍偏本地
138
+ 没有 RBAC / 静态加密
139
+ OTLP 没有持久队列
140
+ ```
141
+
142
+ ## 发布前必须
143
+
144
+ ```text
145
+ [x] 24h soak completed(实际采样 24h)
146
+ [x] integrity ok
147
+ [x] timeline true
148
+ [x] npm test 全绿
149
+ [x] build/validate 全绿
150
+ [x] 迁移/回滚演练通过
151
+ [x] tarball 可安装
152
+ [x] CHANGELOG 更新
153
+ [x] README 版本号更新
154
+ [x] 已知问题写清楚
155
+ ```
156
+
157
+ ## 发布命令(完成后再执行)
158
+
159
+ ```sh
160
+ npm version 2.0.0 --no-git-tag-version
161
+ npm test
162
+ node scripts/validate.mjs
163
+ npm pack --pack-destination dist
164
+ npm publish dist/dsh-blue-team-mode-2.0.0.tgz --tag latest --access public
165
+ git tag v2.0.0
166
+ ```
167
+
168
+ ## 不要做的事
169
+
170
+ ```text
171
+ soak 没完成就发 latest
172
+ 把 beta 说成正式稳定版
173
+ 为了赶时间跳过迁移/回滚
174
+ ```
package/docs/release.md CHANGED
@@ -3,19 +3,19 @@
3
3
  ## 当前发布状态
4
4
 
5
5
  ```text
6
- 稳定版:1.5.4
7
- npm latest:1.5.4
8
- GitHub Release:v1.5.4
9
- 实验版:2.0.0-beta.32(本地,未发 npm)
10
- 市场 catalog:可能仍显示 1.5.2
6
+ 稳定版:2.0.0
7
+ npm latest:2.0.0
8
+ GitHub Release:v2.0.0
9
+ beta:2.0.0-beta.32
10
+ 市场 catalog:可能仍显示 1.5.4,等待重建
11
11
  ```
12
12
 
13
13
  ## 分支
14
14
 
15
15
  ```text
16
- main 默认分支,1.5.x 稳定线
17
- release/1.5.4 1.5.4 稳定提交
18
- 2.0-dev 2.0 beta
16
+ main 默认分支,2.0.x 稳定线
17
+ release/1.5.4 1.5.4 历史稳定提交
18
+ 2.0-dev 2.0 beta 历史分支
19
19
  automation/maintenance 巡检脚本
20
20
  ```
21
21
 
@@ -25,8 +25,8 @@ automation/maintenance 巡检脚本
25
25
  ## 版本号
26
26
 
27
27
  ```text
28
- 稳定:1.5.x
29
- 测试:2.0.0-beta.x
28
+ 稳定:2.0.x
29
+ 测试:2.0.0-beta.x(历史)
30
30
  ```
31
31
 
32
32
  规则:
@@ -88,9 +88,9 @@ GitHub Release 标记 prerelease
88
88
  ## GitHub Release
89
89
 
90
90
  ```text
91
- tag: v1.5.4
92
- name: v1.5.4 — ...
93
- asset: dsh-blue-team-mode-1.5.4.tgz
91
+ tag: v2.0.0
92
+ name: v2.0.0 — 蓝队防御模式稳定版
93
+ asset: dsh-blue-team-mode-2.0.0.tgz
94
94
  prerelease: false
95
95
  ```
96
96
 
@@ -147,13 +147,22 @@ restored: assets=1, timeline checked=3, engagement=rollback-drill
147
147
  ok: true
148
148
  ```
149
149
 
150
- ## 仍然不是正式版
150
+ ## 2.0.0 发布门槛
151
+
152
+ 本次 2.0.0 已满足:
153
+
154
+ ```text
155
+ 24h 实际采样完成
156
+ integrity ok
157
+ timeline true
158
+ ```
159
+
160
+ 仍然后续要补:
151
161
 
152
162
  ```text
153
- 24h soak 尚未跑完
154
163
  真实告警源只有 ctf-lab 一个
155
164
  没有 Wazuh/Elastic/OTel 实接
156
165
  没有 RBAC/加密存储
157
166
  ```
158
167
 
159
- 这些跑完之前,2.0 仍是 beta。
168
+ 这些是 2.0 之后的欠债,不是 2.0.0 的阻塞项。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-blue-team-mode",
3
- "version": "2.0.0-beta.32",
3
+ "version": "2.0.0",
4
4
  "description": "CTF 网络攻防蓝队防御模式:资产盘点、告警研判、威胁狩猎、应急响应、取证分析与加固修复,内置 SQLite 事实库、独立右侧栏控制台与自主任务派发队列。",
5
5
  "license": "MIT",
6
6
  "author": "FGCGDroid",
@@ -77,7 +77,21 @@ const npmVersion = npm.ok ? String(npm.data.version || '') : ''
77
77
  add('npm-latest', npm.ok ? (npmVersion === packageJson.version ? 'ok' : 'warn') : 'unknown',
78
78
  npm.ok ? `npm 最新版本=${npmVersion},本地版本=${packageJson.version}` : npm.error)
79
79
 
80
- const catalog = await json('https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json?x=' + Date.now())
80
+ const catalogMeta = await json('https://registry.npmjs.org/dsh-plugin-catalog/latest')
81
+ const catalogVersion = catalogMeta.ok ? String(catalogMeta.data.version || '') : ''
82
+ const catalogUrls = []
83
+ if (catalogVersion) {
84
+ catalogUrls.push(`https://cdn.jsdelivr.net/npm/dsh-plugin-catalog@${encodeURIComponent(catalogVersion)}/index.json`)
85
+ catalogUrls.push(`https://unpkg.com/dsh-plugin-catalog@${encodeURIComponent(catalogVersion)}/index.json`)
86
+ }
87
+ // 不带 @version 的 jsDelivr URL 会缓存 @latest 的旧内容;只作最后兜底。
88
+ catalogUrls.push('https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json?x=' + Date.now())
89
+ let catalog = { ok: false, error: 'catalog unavailable' }
90
+ for (const url of catalogUrls) {
91
+ const result = await json(url)
92
+ if (result.ok) { catalog = result; break }
93
+ catalog = result
94
+ }
81
95
  let catalogItem = null
82
96
  if (catalog.ok) {
83
97
  const list = Array.isArray(catalog.data.plugins) ? catalog.data.plugins : (Array.isArray(catalog.data.entries) ? catalog.data.entries : [])
@@ -90,7 +104,7 @@ add('catalog', catalog.ok
90
104
  ? (catalogVersions.includes(packageJson.version) ? 'ok' : 'warn')
91
105
  : 'unknown',
92
106
  catalog.ok
93
- ? `市场目录=${catalogVersions.join(', ') || '缺失'},本地版本=${packageJson.version}`
107
+ ? `市场目录=${catalogVersions.join(', ') || '缺失'},索引版本=${catalogVersion || '未知'},本地版本=${packageJson.version}`
94
108
  : catalog.error)
95
109
 
96
110
  const soakPath = resolve(process.env.DSH_HOME || join(process.env.USERPROFILE || process.env.HOME || tmpdir(), '.dsh'), 'blue', 'soak-beta31.state.json')
@@ -148,7 +162,7 @@ async function updateIssue() {
148
162
  if (!token || !repo) return { ok: false, error: 'GITHUB_TOKEN/GITHUB_REPOSITORY missing' }
149
163
  const api = `https://api.github.com/repos/${repo}`
150
164
  const headers = { authorization: `Bearer ${token}`, accept: 'application/vnd.github+json', 'user-agent': 'dsh-blue-maintenance', 'content-type': 'application/json' }
151
- const title = '[maintenance] 每周巡检'
165
+ const title = '[maintenance] 每日巡检'
152
166
  const issues = await fetch(`${api}/issues?state=open&per_page=100`, { headers, signal: AbortSignal.timeout(15000) })
153
167
  if (!issues.ok) return { ok: false, error: `list issues HTTP ${issues.status}` }
154
168
  const list = await issues.json()