dsh-blue-team-mode 1.5.4 → 2.0.0-beta.32

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 (65) hide show
  1. package/CHANGELOG.md +357 -12
  2. package/README.md +44 -6
  3. package/SECURITY.md +49 -48
  4. package/docs/architecture.md +248 -0
  5. package/docs/blue-team-repos.md +98 -98
  6. package/docs/branching.md +37 -0
  7. package/docs/compatibility.md +87 -19
  8. package/docs/cve-2026-pack.md +69 -0
  9. package/docs/defense-regression.md +77 -0
  10. package/docs/development.md +143 -143
  11. package/docs/inline-defense.md +172 -0
  12. package/docs/known-issues.md +169 -0
  13. package/docs/maintenance-bot.md +151 -0
  14. package/docs/operational-red-lines.md +106 -0
  15. package/docs/otel.md +103 -0
  16. package/docs/release.md +203 -0
  17. package/docs/request-smuggling.md +94 -0
  18. package/docs/risk-graph.md +44 -0
  19. package/docs/stabilization.md +159 -0
  20. package/lib/anchor.js +63 -0
  21. package/lib/attack.js +78 -74
  22. package/lib/client.js +272 -4
  23. package/lib/compat.js +77 -0
  24. package/lib/controls.js +82 -0
  25. package/lib/cve-campaign.js +119 -0
  26. package/lib/cve-pack.js +277 -0
  27. package/lib/decoy-sync.js +100 -0
  28. package/lib/detection.js +86 -0
  29. package/lib/evidence.js +173 -0
  30. package/lib/gateway.js +211 -0
  31. package/lib/graph.js +91 -0
  32. package/lib/hunter.js +76 -76
  33. package/lib/index.js +2 -0
  34. package/lib/inline-guard.js +151 -0
  35. package/lib/inventory.js +40 -0
  36. package/lib/otlp.js +111 -0
  37. package/lib/playbooks.js +19 -1
  38. package/lib/response.js +88 -0
  39. package/lib/store.js +410 -15
  40. package/lib/telemetry.js +157 -0
  41. package/lib/tools.js +762 -25
  42. package/lib/ui.js +124 -0
  43. package/package.json +7 -2
  44. package/scripts/decoy-server.mjs +499 -243
  45. package/scripts/inline-gateway.mjs +81 -0
  46. package/scripts/maintenance-check.mjs +171 -0
  47. package/scripts/maintenance-daily.cmd +16 -0
  48. package/scripts/maintenance-task.cmd +7 -0
  49. package/scripts/soak-24h-status.cmd +6 -0
  50. package/scripts/soak-24h.cmd +15 -0
  51. package/scripts/soak.mjs +228 -0
  52. package/scripts/test-compat.mjs +15 -0
  53. package/scripts/test-ctf-defense.mjs +134 -0
  54. package/scripts/test-decoy-server.mjs +124 -99
  55. package/scripts/test-hunter.mjs +21 -21
  56. package/scripts/test-inline-gateway.mjs +101 -0
  57. package/scripts/test-migration.mjs +40 -0
  58. package/scripts/test-otlp.mjs +42 -0
  59. package/scripts/test-rollback.mjs +44 -0
  60. package/scripts/test-tools.mjs +190 -9
  61. package/scripts/test-ui.mjs +24 -2
  62. package/skills/deception-defense.md +48 -37
  63. package/skills/decoy-server.md +107 -80
  64. package/skills/honeypot-tarpit.md +43 -43
  65. package/skills/web-attack-triage.md +6 -0
package/CHANGELOG.md CHANGED
@@ -1,29 +1,374 @@
1
1
  # Changelog
2
2
 
3
- ## 1.5.4 — 2026-11-15
3
+ ## 2.0.0-beta.32 — 2026-11-15(本地试用,未发布)
4
+
5
+ ### Added
6
+
7
+ - OTLP/HTTP JSON 日志接收器:`/blue/otlp/v1/logs`,Bearer token 保护,按 service/severity 落告警并去重。
8
+ - ctf-lab access.jsonl 可作为真实遥测源接入。
9
+
10
+ ### Tests
11
+
12
+ - 新增 OTLP 解析/去重/token 测试。
13
+ - 新增可恢复 24h soak 与 1.5.3 回滚演练脚本。
14
+
15
+ ## 2.0.0-beta.31 — 2026-11-14(本地试用,未发布)
16
+
17
+ ### Fixed
18
+
19
+ - 创建 engagement 时自动把 scope 中的具体 host/URL 登记为资产,避免 `blue_risk_graph` 因 assets=0 显示空白。
20
+ - CIDR 和通配符不自动冒充在线资产;仍需人工盘点。
21
+ - 回归测试覆盖 `scope_assets` 与图谱资产来源。
22
+
23
+ ## 2.0.0-beta.30 — 2026-11-14(本地试用,未发布)
24
+
25
+ ### Fixed
26
+
27
+ - CVE 扫描误报:BeyondTrust 规则不再匹配通用 `/api/admin`;NetScaler 规则要求上下文中出现产品名。
28
+ - 增加告警顶层字段契约回归:`title/severity/source` 必须写入,不再静默变成“未命名告警”。
29
+
30
+ ### Tests
31
+
32
+ - 通用 admin/api 文本不命中 BeyondTrust。
33
+ - `blue_alert_ingest` 顶层 title/severity 契约通过。
34
+
35
+ ## 2.0.0-beta.29 — 2026-11-14(本地试用,未发布)
36
+
37
+ ### Docs
38
+
39
+ - 红线补充「只检测不阻断不算防守」:jwt-none 全命中仍转发导致 flag 丢失,高置信规则必须有阻断路径或明确 `not_defended`。
40
+ - 红线补充「证据必须独立」:`attempts=0`、自加工日志、正则命中原文、格式化输出都不能单独作为结论。
41
+ - 红线补充「含中文源码不用 PowerShell 改编码;write/edit 后跑语法检查」。
42
+
43
+ ## 2.0.0-beta.28 — 2026-11-14(本地试用,未发布)
44
+
45
+ ### Docs
46
+
47
+ - 新增 `docs/operational-red-lines.md`,固化三条已踩红线:诱饵 planned/active 不一致、假 flag 误报、2MB 同进程压测打崩 DSH。
48
+ - AGENTS.md、欺骗防御技能和 README 同步红线。
49
+
50
+ ## 2.0.0-beta.27 — 2026-11-14(本地试用,未发布)
51
+
52
+ ### Added
53
+
54
+ - 内联网关增加请求走私防线:拒绝 CL+TE、重复 Content-Length/Transfer-Encoding、非数字 Content-Length、非 chunked TE。
55
+ - 网关设置 headersTimeout/requestTimeout/keepAliveTimeout,clientError 统一 400 关闭。
56
+ - 新增 `docs/request-smuggling.md` 与 Web 研判技能章节:隔离副本、单请求、超时即停,不 live 打无重启目标。
57
+
58
+ ### Notes
59
+
60
+ - 没有对 65288 做 CL+TE live 测试;当前端口也未监听。
61
+ - 没有副本时记录 `blocked_by_availability`,不伪造成“已测试安全”。
62
+
63
+ ## 2.0.0-beta.26 — 2026-11-14(本地试用,未发布)
64
+
65
+ ### Fixed
66
+
67
+ - 诱饵状态与实际运行不一致:有命中的 `planned` 诱饵在列表/命中时自动升级为 `active`。
68
+ - 控制台诱饵表增加「标记运行」按钮,调用 `blue_decoy_update` 把真实已部署的 planned 改为 active。
69
+ - 工具描述和欺骗防御技能明确:planned 只是“已登记”,真实部署后必须改 active。
70
+
71
+ ## 2.0.0-beta.25 — 2026-11-14(本地试用,未发布)
72
+
73
+ ### Fixed
74
+
75
+ - 诱饵「同步事件」在 `decoy-events.jsonl` 不存在时不再抛 ENOENT:自动创建空文件并返回 `missing=true`,控制台显示等待提示。
76
+ - 空文件同步返回 0 条,不再走异常路径。
77
+
78
+ ## 2.0.0-beta.24 — 2026-11-14(本地试用,未发布)
79
+
80
+ ### Added
81
+
82
+ - `blue_risk_graph`:资产—CVE—发现关联图,输出风险分、对外/内部标记和排序。
83
+ - 控制台新增「图谱」页签:资产风险条、关联 CVE、CVE 影响资产数。
84
+ - `docs/risk-graph.md` 说明图谱边界。
85
+
86
+ ### Notes
87
+
88
+ - 风险分只是排查排序,不是 CVSS。
89
+ - CVE 关联未验证版本,不能直接判定资产受影响。
90
+
91
+ ## 2.0.0-beta.23 — 2026-11-14(本地试用,未发布)
92
+
93
+ ### Added
94
+
95
+ - `blue_cve_campaign`:把 CVE 防御包匹配到资产,生成 hardening 核查任务;支持 dry-run、按 CVE/资产过滤、任务去重。
96
+ - 控制台「防线」页新增「生成 CVE 任务」按钮。
97
+
98
+ ### Notes
99
+
100
+ - 只按资产名称/服务/tag 匹配,未验证版本;create=true 也不执行补丁或隔离。
101
+ - CVE 条目仍为用户提供的未核验描述。
102
+
103
+ ## 2.0.0-beta.22 — 2026-11-14(本地试用,未发布)
104
+
105
+ ### Added
106
+
107
+ - 新增 2026 CVE 防御包:12 个条目,覆盖 Node.js Brotli、PHP2Shell、Symfony Mime CRLF、VeloCloud SQLi、AnyDesk、Ivanti、BeyondTrust、NetScaler。
108
+ - `blue_cve_pack`:按 CVE/产品查询补丁动作和缓解措施。
109
+ - `blue_cve_scan`:启发式日志特征扫描,返回命中 CVE 和片段,不写库。
110
+ - 控制台「防线」页签新增 CVE 防御包表。
111
+
112
+ ### Notes
113
+
114
+ - 条目按用户提供描述建模,未联网核验受影响版本和补丁号。
115
+ - 扫描只作线索,不等同于已利用结论。
116
+
117
+ ## 2.0.0-beta.21 — 2026-11-14(本地试用,未发布)
4
118
 
5
119
  ### Changed
6
120
 
7
- - 发布元数据与市场 listing 更新到 `1.5.4`。
8
- - README 的 GitHub Release / 本地 tarball 链接更新为 `1.5.4`。
9
- - 仅文档与版本元数据变更,无运行时行为变化。
121
+ - 诱饵服务按 50579 复盘改成“死线索 + 假成功”模型:
122
+ - `/robots.txt` 默认返回 `/admin/` 死线索,不暴露真实备份路径。
123
+ - `/flag` 和 `/flag.txt` 返回 200 格式合法的随机假 flag。
124
+ - `/backup/flag.txt` 默认固定 403,且禁止加入假 flag 路径。
125
+ - 路径先解码两次并折叠 `./`、`../`、反斜杠,再匹配保护表和诱饵表。
126
+ - 新增 `--protect`、`--robots-disallow`、`--fake-flag`、`--tarpit-min/max`。
127
+ - 欺骗防御技能补充入口线索、假成功、真假隔离、旁路边界。
128
+
129
+ ## 2.0.0-beta.20 — 2026-11-14(本地试用,未发布)
10
130
 
11
- ## 1.5.3 — 2026-11-14
131
+ ### Added
132
+
133
+ - `blue_evidence_export`:导出事实库快照、审计链/锚点状态、Ed25519 签名,写入数据目录 `evidence/`。
134
+ - `blue_evidence_verify`:校验 schema、digest 和签名,能发现包内容被改。
135
+ - 证据包按敏感键和常见凭据文本脱敏;限制在 evidence/ 或工作区读取。
136
+
137
+ ### Notes
138
+
139
+ - 证据包是 JSON 快照,不是磁盘/内存镜像,也不是法庭取证规范。
140
+ - 签名只证明内容与签名时一致,不证明采集过程未被操控。
141
+
142
+ ## 2.0.0-beta.19 — 2026-11-14(本地试用,未发布)
12
143
 
13
144
  ### Changed
14
145
 
15
146
  - `engines.dsh` 从 `>=0.2.1-rc.5` 下调到 `>=0.2.1-rc.1`,覆盖 0.2.1 的早期 rc。
16
- - 新增 `docs/compatibility.md`,说明 DSH/Node 支持范围。
17
- - README 的 Release / 本地 tarball 版本号更新为 `1.5.3`。
18
- - 仅配置与文档变更,无运行时行为变更。
147
+ - 新增运行时版本检测;`blue_session_info`、`blue_autopilot status` 返回 `dsh` 能力。
148
+ - DSH < 0.2.1-rc.1 时,`next/cycle` 和控制台领取会明确拒绝 `agent_preset` 派发,不静默用错角色。
149
+ - 新增 `docs/compatibility.md` 和 `test:compat`。
19
150
 
20
- ## 1.5.2 — 2026-11-13
151
+ ## 2.0.0-beta.18 — 2026-11-13(本地试用,未发布)
21
152
 
22
153
  ### Docs
23
154
 
24
- - 安全支持范围更新为 `1.5.x`。
25
- - README 的 Release / 本地 tarball 版本号更新为 `1.5.2`。
26
- - 仅文档与版本元数据变更,无运行时行为变化。
155
+ - `SECURITY.md` 支持范围从过时的 `1.3.x` 改为 `2.0.x beta` + `1.5.x stable`。
156
+ - 无运行时变更。
157
+
158
+ ## 2.0.0-beta.17 — 2026-11-13(本地试用,未发布)
159
+
160
+ ### Added
161
+
162
+ - 诱饵支持 `--tls-cert/--tls-key` 启用 HTTPS,可用真实证书链。
163
+ - `--lures` 控制 admin/git/phpmyadmin/backup/shell/status 的暴露子集。
164
+ - `--token` 金丝雀标识写入假 git 配置和 SQL dump;日志记录 canary。
165
+ - 首页构建号、假后台服务行、SQL 数据随机化,降低静态模板特征。
166
+
167
+ ### Notes
168
+
169
+ - 仍然不是不可识别;真实证书、真实反向代理和隔离网络更重要。
170
+ - 仍是本地 beta,没有发布 npm 或市场。
171
+
172
+ ## 2.0.0-beta.16 — 2026-11-13(本地试用,未发布)
173
+
174
+ ### Changed
175
+
176
+ - 诱饵服务降低指纹:按主题返回 Server / X-Powered-By,补 ETag、Last-Modified、Set-Cookie,静态 CSS、favicon、robots、首页和登录后假面板。
177
+ - 移除响应里的 `synthetic decoy` 等自曝字符串;假 SQL 改成真实 dump 形态。
178
+ - 登录后访问管理页返回假面板,不再总是登录页。
179
+
180
+ ### Notes
181
+
182
+ - 这只能提高识别成本,不能保证红队一定识破不了。
183
+ - 仍是本地 beta,没有发布 npm 或市场。
184
+
185
+ ## 2.0.0-beta.15 — 2026-11-13(本地试用,未发布)
186
+
187
+ ### Added
188
+
189
+ - Sigma-lite 检测规则:`blue_detection_rule_add/list`,JSON selection + all/any,点路径和 `*` 通配符。
190
+ - `blue_detection_scan` 用启用规则扫描遥测源,返回命中,不写库。
191
+ - 遥测轮询自动套用启用规则:无规则时保留原始事件,有规则时只落规则命中和 guard 事件。
192
+ - 控制台「防线」页签新增检测规则表。
193
+
194
+ ### Notes
195
+
196
+ - JSON 规则不是完整 Sigma,不支持 aggregation/时间窗/转换后端。
197
+ - 仍是本地 beta,没有发布 npm 或市场。
198
+
199
+ ## 2.0.0-beta.14 — 2026-11-13(本地试用,未发布)
200
+
201
+ ### Added
202
+
203
+ - 文件型遥测接入:`blue_telemetry_source_add/poll/health`,按完整行 cursor 增量读取,overview 自动轮询 active 源。
204
+ - 防线控制验证:`blue_control_scan/list`,检查审计链、审批闸、遥测健康、诱饵在线、审计锚定。
205
+ - 审计链外部锚定:本机 Ed25519 签名链头,`blue_audit_anchor` / `blue_audit_anchor_verify`。
206
+ - 受控响应台账:`blue_response_plan/update/list`,只生成高风险待审批任务和回滚方案,不执行命令。
207
+ - 控制台新增「防线」页签:控制分、遥测源、响应动作。
208
+
209
+ ### Notes
210
+
211
+ - 锚定不是外部公证;响应动作仍由人工执行。
212
+ - 仍是本地 beta,没有发布 npm 或市场。
213
+
214
+ ## 2.0.0-beta.13 — 2026-11-13(本地试用,未发布)
215
+
216
+ ### Added
217
+
218
+ - 时间线新增 SHA-256 哈希链:每条事件带 `prev_hash/hash`,旧库自动补链。
219
+ - 新增 `blue_audit_verify`:检测时间线被改、被插队或链断裂;不是外部公证。
220
+ - 控制台时间线页显示审计链状态;Timeline 页的 `audit` 字段随 overview 返回。
221
+
222
+ ### Notes
223
+
224
+ - 仍是本地 beta,没有发布 npm 或市场。
225
+
226
+ ## 2.0.0-beta.12 — 2026-11-13(本地试用,未发布)
227
+
228
+ ### Fixed
229
+
230
+ - 修复 beta.11 的启动崩溃:旧库的 `decoy_hits` 还没有 `event_key` 列,但 schema 里提前创建了引用该列的唯一索引,导致 `no such column: event_key`。
231
+ - 唯一索引改为迁移补列后再创建;新增 `test:migration` 覆盖旧库升级。
232
+
233
+ ### Notes
234
+
235
+ - 这是 beta.11 页面/接口加载失败的根本原因。
236
+ - 仍是本地 beta,没有发布 npm 或市场。
237
+
238
+ ## 2.0.0-beta.11 — 2026-11-13(本地试用,未发布)
239
+
240
+ ### Added
241
+
242
+ - 新增 `blue_decoy_sync`:把外部诱饵 JSONL 事件同步进事实库,自动补登记未知诱饵并按事件去重。
243
+ - 诱饵页新增「同步事件」按钮;设置 `BLUE_DECOY_EVENTS` 后,overview 会自动同步,页面随 2 秒刷新更新。
244
+ - `decoy_hits` 增加 `event_key` 唯一键,避免重复导入。
245
+
246
+ ### Notes
247
+
248
+ - 仍是本地 beta,没有发布 npm 或市场。
249
+
250
+ ## 2.0.0-beta.10 — 2026-11-13(本地试用,未发布)
251
+
252
+ ### Fixed
253
+
254
+ - 案件状态机:拒绝 `closed -> contained` 等非法迁移,允许 `closed -> open` 重开。
255
+ - 案件关联改为先全量校验再更新,避免“告警挂上了、任务不存在”导致部分写入。
256
+ - 决策记录校验关联的案件/任务/告警必须属于当前防守目标。
257
+ - 诱饵状态机:`retired` 不能重新激活,只允许 `planned -> active/retired`、`active -> retired`。
258
+
259
+ ### Notes
260
+
261
+ - 仍是本地 beta,没有发布 npm 或市场。
262
+
263
+ ## 2.0.0-beta.9 — 2026-11-13(本地试用,未发布)
264
+
265
+ ### Added
266
+
267
+ - 案件页签增加「调查 / 控制 / 关闭」操作,走同源 `/blue/api` 的 `updateIncident`。
268
+ - `blue_incident_update` 和 UI 更新都会写入时间线。
269
+
270
+ ### Fixed
271
+
272
+ - ATT&CK 覆盖说明从 13 条规则修正为 16 条,避免文档和实际规则数不一致。
273
+
274
+ ### Notes
275
+
276
+ - 仍是本地 beta,没有发布 npm 或市场。
277
+
278
+ ## 2.0.0-beta.8 — 2026-11-13(本地试用,未发布)
279
+
280
+ ### Added
281
+
282
+ - 新增 `lib/inline-guard.js`:路径规范化、重复 Cookie、JWT `alg=none`、原型污染、权限字段检查。
283
+ - 新增 `scripts/inline-gateway.mjs`:可选内联 HTTP 网关,检查后转发并写访问日志。
284
+ - 新增 `test:gateway` 回归:转发、路径、重复 Cookie、JWT、原型、权限字段、日志。
285
+
286
+ ### Notes
287
+
288
+ - 网关需要上游只监听回环/内网才有意义,不会自动改端口。
289
+ - 仍是本地 beta,没有发布 npm 或市场。
290
+
291
+ ## 2.0.0-beta.7 — 2026-11-13(本地试用,未发布)
292
+
293
+ ### Fixed
294
+
295
+ - `blue_access_log_ingest` 使用 `raw_path` 识别 `/./config`、`/%2e/config` 这类被规范化后的路径异常。
296
+
297
+ ### Notes
298
+
299
+ - 仍是本地 beta,没有发布 npm 或市场。
300
+
301
+ ## 2.0.0-beta.6 — 2026-11-13(本地试用,未发布)
302
+
303
+ ### Fixed
304
+
305
+ - `blue_access_log_ingest` 现在会把 ctf-lab `guard` 拦截事件和路径规范化异常标成高危告警。
306
+ - 补充回归测试,覆盖 4 条访问日志事件。
307
+
308
+ ### Notes
309
+
310
+ - 仍是本地 beta,没有发布 npm 或市场。
311
+
312
+ ## 2.0.0-beta.5 — 2026-11-13(本地试用,未发布)
313
+
314
+ ### Added
315
+
316
+ - 新增 `scripts/test-ctf-defense.mjs`:本地 ctf-lab 防守回归测试,验证 M05/M06/M12/M16,只发 GET、只允许回环地址。
317
+ - `npm run test:ctf-defense` 可输出 PASS/FAIL 矩阵。
318
+
319
+ ### Notes
320
+
321
+ - 仍是本地 beta,没有发布 npm 或市场。
322
+
323
+ ## 2.0.0-beta.4 — 2026-11-13(本地试用,未发布)
324
+
325
+ ### Added
326
+
327
+ - `blue_access_log_ingest` 识别 `guard` 拦截事件和路径规范化异常,生成高危告警。
328
+ - ctf-lab `CTF_LAB_GUARD=strict`:阻断重复 `token` Cookie、`alg=none`、`./`/`../`/编码路径;403 不回显规则名。
329
+
330
+ ### Notes
331
+
332
+ - 仍是本地 beta,没有发布 npm 或市场。
333
+
334
+ ## 2.0.0-beta.3 — 2026-11-13(本地试用,未发布)
335
+
336
+ ### Fixed
337
+
338
+ - 控制台增加 2 秒自动刷新:前台每 2 秒拉取 overview,页面切到后台时暂停,切回来立即补一次。
339
+ - 审批、告警、任务、案件等外部变更不再需要手动点刷新。
340
+
341
+ ### Notes
342
+
343
+ - 仍是本地 beta,没有发布 npm 或市场。
344
+
345
+ ## 2.0.0-beta.2 — 2026-11-13(本地试用,未发布)
346
+
347
+ ### Added
348
+
349
+ - 新增 `incidents` 案件表:把多条告警、发现和任务归到同一事件下。
350
+ - 新增 `decisions` 决策记录表:记录决策、理由、置信度和证据。
351
+ - 新增 `blue_incident_open/list/update/attach` 和 `blue_decision_add/list`。
352
+ - 控制台新增「案件」页签。
353
+ - 报告新增案件和决策记录段落。
354
+ - 任务/告警/发现增加 `incident_id` 关联字段,旧库自动补列。
355
+
356
+ ### Fixed
357
+
358
+ - `blue_scope_check` 支持 CIDR、`host:port` 和 URL;不再把真实目标误判为范围外。
359
+ - `blue_alert_ingest` 顶层 `title/severity/note` 不再被 JSON 路径吞掉;新增独立 `event_time` 列。
360
+ - 重复告警返回 `ingested=0`、`updated=1`,不再假装新入账。
361
+ - `blue_log_scan` 支持 `custom_rules` 自定义字段规则;补 HTTP 401 登录失败、JWT `alg=none`、`Process.Start` 型 ASPX 马。
362
+ - 新增 `blue_decoy_update`,可把诱饵从 `planned` 更新为 `active`。
363
+ - 诱饵日志目录不可写时回退到 workspace `.blue-decoy/`,并支持 `BLUE_LOG_DIR`。
364
+ - 未知/缺失的本地插件不再阻塞 profile reconcile。
365
+ - ctf-lab 题目服务新增 access.jsonl 访问日志;新增 `blue_access_log_ingest`。
366
+ - ctf-lab 支持 `CTF_LAB_GUARD=jwt-none` 的可选内联阻断,默认关闭。
367
+
368
+ ### Notes
369
+
370
+ - 2.0 仍是本地 beta,没有发布 npm 或市场。
371
+ - 45 个工具、19 个技能、10 个控制台页签、12 张事实表。
27
372
 
28
373
  ## 1.5.0 — 2026-11-13
29
374
 
package/README.md CHANGED
@@ -10,7 +10,11 @@
10
10
  > 本仓库是蓝队编排、事实记录与辅助研判的工程实现,**不包含攻击、漏洞利用或未授权探测代码**。
11
11
  > 使用者必须自行确保对目标拥有书面授权,并遵守比赛规则与当地法律。
12
12
 
13
- **37 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 9 个控制台页签 · 10 张事实库表**
13
+ **66 个 `blue_*` 工具 · 19 个随 npm 包技能 · 6 个执行角色 · 12 个控制台页签 · 17 张事实库表**
14
+
15
+ > 🧪 当前源码是 `2.0.0-beta.32` 本地试用版,**没有发布到 npm / 市场**。
16
+ > 正式安装仍用 `1.5.3`;2.0 用本地 tarball 装。
17
+ > DSH 兼容:最低 `0.2.1-rc.1`,当前验证 `0.2.2-rc.3`;详见 `docs/compatibility.md`。
14
18
 
15
19
  ---
16
20
 
@@ -37,7 +41,7 @@ dsh plugin --profile desktop add dsh-blue-team-mode
37
41
 
38
42
  **环境准备**:本插件不提供 nmap、tshark、suricata、zeek、yara、volatility、fail2ban 等外部工具的下载或安装;运行 `blue_preflight` 查看缺什么,工具由你自行准备。
39
43
 
40
- > 前置:DSH 能正常 `dsh web` 启动;Node.js ≥ 22.13(依赖内置 `node:sqlite`)。DSH 最低 `0.2.1-rc.1`,详见 `docs/compatibility.md`。
44
+ > 前置:DSH 能正常 `dsh web` 启动;Node.js ≥ 22.13(依赖内置 `node:sqlite`)。
41
45
  > 建议跑在专用的演练机、Docker 或虚拟机里,不要直接跑在存有生产密钥的宿主机账户下。
42
46
 
43
47
  <details>
@@ -47,7 +51,7 @@ dsh plugin --profile desktop add dsh-blue-team-mode
47
51
 
48
52
  ```sh
49
53
  dsh plugin --profile desktop add \
50
- https://github.com/FGCGDroid/blue/releases/download/v1.5.4/dsh-blue-team-mode-1.5.4.tgz
54
+ https://github.com/FGCGDroid/blue/releases/download/v1.5.2/dsh-blue-team-mode-1.5.2.tgz
51
55
  # 装完重启一次 dsh web
52
56
  ```
53
57
 
@@ -55,7 +59,7 @@ dsh plugin --profile desktop add \
55
59
 
56
60
  ```sh
57
61
  npm pack --pack-destination dist
58
- dsh plugin --profile desktop add ./dist/dsh-blue-team-mode-1.5.4.tgz
62
+ dsh plugin --profile desktop add ./dist/dsh-blue-team-mode-1.5.2.tgz
59
63
  ```
60
64
 
61
65
  **从源码目录安装**:
@@ -99,16 +103,39 @@ dsh plugin --profile desktop add .
99
103
  - **开工前预检**:`blue_preflight` 检查本机工具链和 key,缺什么、能降级到什么方案,一次说清;不假装工具可用。
100
104
  - **风险闸**:高风险动作(隔离、封禁、删除、改防火墙、杀进程、重置凭据)进入 `pending_approval`,必须人工批准后才能派发;不会自动执行。
101
105
  - **自主派发**:`blue_autopilot` 生成候选任务、按并发名额领取、派给对应角色;子智能体回报后查库核对,再回收闭环。带轮次上限和冷却。
102
- - **右侧常驻控制台**:态势 / 告警 / 资产 / 发现 / 任务 / IOC / 诱饵 / 时间线 / 报告 九个页签,支持拖拽调宽和全屏浏览。
106
+ - **右侧常驻控制台**:态势 / 案件 / 防线 / 图谱 / 告警 / 资产 / 发现 / 任务 / IOC / 诱饵 / 时间线 / 报告 十二个页签,支持拖拽调宽和全屏浏览;前台每 2 秒自动刷新,后台暂停。
103
107
  - **面板跟着会话走**:多会话并行时,左侧切到哪个会话,右侧就显示该会话绑定的防守目标;没绑定的会话回落到最近一个活跃目标。
104
108
  - **任务书**:每个任务带目标、已知事实、约束、验收标准和期望输出,统一由 TaskSpec 渲染,避免“让子智能体自己猜”。
105
109
  - **报告**:从事实库生成 Markdown,包含态势、关键资产、告警研判、脆弱性、IOC、任务与时间线;只允许写到 `$DSH_HOME/blue/reports/`。
106
110
  - **欺骗防御(可选)**:金丝雀文件/URL、假管理入口、假凭据、低交互 tarpit;登记诱饵、记录命中、生成 `deception` 告警。诱饵默认自动过期(24–168 小时),但真实部署仍需人工下线。
107
111
  - **蜜罐 / 焦油坑(可选)**:`blue_tarpit_plan` 生成 Endlessh、Nginx 假路径、有界慢响应和 fail2ban 7 天 jail 配置;`blue_honeypot_ingest` 把命中转成告警和待审批封禁任务。插件不直接调用 `iptables` / `nft` / `fail2ban-client`。
108
112
  - **可选诱饵程序**:包内自带手动启动的 HTTP 诱饵,默认只监听 `127.0.0.1`,公开监听必须显式 `--allow-public`;提供 `generic/tomcat/thinkphp/wordpress` 静态主题;不执行命令、不抓指纹、不做无限响应。
113
+ - **运行红线**:诱饵部署后要写回 active、假 flag 不是泄露、禁止对 DSH 同进程目标做 2MB 压测;详见 `docs/operational-red-lines.md`。
114
+ - **范围自动入库**:创建 engagement 时自动把 scope 中的具体主机登记为资产,避免“开了目标但图谱空白”;CIDR/通配符仍只作为范围,不冒充在线资产。
115
+ - **请求走私防线**:内联网关直接拒绝 CL+TE、重复长度头、歧义 TE,并设置 headers/request/keep-alive 硬超时;测试策略见 `docs/request-smuggling.md`,不拿无重启能力的 live 目标做实验。
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`。
118
+ - **攻击面图谱**:`blue_risk_graph` 把资产、CVE 匹配和未关闭发现关联成风险排序图;控制台「图谱」页签直接看对外资产、风险条和关联 CVE。
119
+ - **2026 CVE 防御包**:`blue_cve_pack` 查看 Node.js/PHP/Laravel/Ivanti/NetScaler 等补丁动作,`blue_cve_scan` 做启发式日志匹配,`blue_cve_campaign` 按资产名/服务/tag 生成 hardening 核查任务;不包含利用代码,具体版本以厂商公告为准。
120
+ - **证据包**:`blue_evidence_export` 导出事实库快照、审计链/锚点状态和 Ed25519 签名;`blue_evidence_verify` 校验 digest 与签名,敏感字段脱敏。
121
+ - **低指纹诱饵**:按主题返回 Server / X-Powered-By / ETag / Last-Modified / Set-Cookie,补齐 favicon、robots、CSS 和登录后假面板;响应里不再写 `synthetic decoy` 这类自曝字符串。
122
+ - **50579 式欺骗**:`/robots.txt` 返回死线索,`/flag` 返回 200 格式合法的假 flag,真路径 `/backup/flag.txt` 固定 403;保护表优先于诱饵表,并先规范化路径再匹配。
123
+ - **诱饵可配置**:`--lures` 控制暴露哪些诱饵,`--token` 写入金丝雀标识,`--tls-cert/--tls-key` 可挂真实证书启用 HTTPS;页面构建号和资源版本随机化。
109
124
  - **自动化流量标注**:诱饵服务按来源 IP 维护 1 秒行为窗口,命中高频请求、路径扫描或工具 UA 时打上 `automation_burst` / `path_sweep` / `automation_tool` 标签;只做研判,不自动封禁。
125
+ - **诱饵状态与日志回退**:`blue_decoy_update` 可把诱饵从 `planned` 更新为 `active`;`blue_decoy_sync` 把外部 JSONL 事件同步进事实库;默认日志目录不可写时回退到 workspace,也可用 `BLUE_LOG_DIR` 指定。
110
126
  - **执行摘要**:报告开头用事实库数字概括关键资产、未闭环高危告警、待审批任务和诱饵命中,方便直接发给人看。
111
- - **ATT&CK 覆盖映射**:`blue_attack_coverage` 把内置 13 条日志规则映射到技术和战术,标出未映射规则;明确说明这不是全量覆盖。
127
+ - **案件与决策记录**:`blue_incident_*` 把多条告警/发现/任务归到同一案件;`blue_decision_*` 记录决策、理由、置信度和证据,方便复盘。
128
+ - **接入字段可回退**:`blue_alert_ingest` 支持顶层 `title/severity/note`,并单独保存 `event_time`,重复投递返回 `updated` 而不是假 `ingested`。
129
+ - **范围支持 URL / host:port**:`blue_scope_check` 同时识别 CIDR、`host:port` 和 URL,避免把真实目标误判为范围外。
130
+ - **日志规则补齐**:增加 JWT `alg=none`、HTTP 401 登录失败、`Process.Start` 型 ASPX 马;支持 `custom_rules` 自定义字段规则。
131
+ - **可选内联网关**:`scripts/inline-gateway.mjs` 在同一入口检查路径、重复 Cookie、JWT `alg=none`、原型污染和权限字段,写访问日志后再转发;不自动改端口。
132
+ - **ctf-lab 访问日志接入**:ctf-lab 的题目服务会写 `access.jsonl`,`blue_access_log_ingest` 把 401/403/5xx/404 转成告警;设置 `CTF_LAB_GUARD=jwt-none` 或 `strict` 可启用内联阻断。
133
+ - **Sigma-lite 检测**:`blue_detection_rule_add` 用 JSON selection + all/any 写规则,`blue_detection_scan` 扫描遥测源,遥测轮询会自动套用启用规则。
134
+ - **遥测接入**:`blue_telemetry_source_add/poll/health` 增量读取 JSONL/access log,按 cursor 去重落告警,overview 自动轮询 active 源。
135
+ - **防线控制验证**:`blue_control_scan` 检查审计链、审批闸、遥测源健康、诱饵在线和审计锚定,输出控制分。
136
+ - **受控响应台账**:`blue_response_plan` 只生成高风险待审批任务和回滚方案,`blue_response_update` 回填执行/回滚证据,不执行命令。
137
+ - **审计链**:时间线按 SHA-256 哈希链串联,`blue_audit_verify` 能发现事后改记录、插队或断链;只证明库内一致性,不是外部公证。
138
+ - **ATT&CK 覆盖映射**:`blue_attack_coverage` 把内置 16 条日志规则映射到技术和战术,标出未映射规则;明确说明这不是全量覆盖。
112
139
  - **数据只在本机**:全部落在 `$DSH_HOME/blue/`,无遥测、无上报、无云端同步。
113
140
 
114
141
  ---
@@ -120,6 +147,9 @@ dsh plugin --profile desktop add .
120
147
  | 页签 | 内容 | 可执行操作 |
121
148
  | --- | --- | --- |
122
149
  | 态势 | 资产/告警/发现/IOC/任务统计、关键告警、任务队列 | 规划任务、刷新、调整并发、生成报告 |
150
+ | 案件 | 级别、标题、状态、负责人、摘要 | 调查、控制、关闭 |
151
+ | 防线 | 控制分、控制项、检测规则、CVE 防御包、遥测源、响应动作 | 验证防线、拉取遥测、生成 CVE 任务、导出证据 |
152
+ | 图谱 | 资产风险分、对外/内部、关联 CVE、关联发现 | 按风险排序查看 |
123
153
  | 告警 | 级别、来源、状态、时间 | 确认、标误报、转处置任务 |
124
154
  | 资产 | 关键级别、地址、端口、服务、状态 | 新增/更新资产 |
125
155
  | 发现 | 严重级别、类型、状态 | 标记已修复、接受风险 |
@@ -208,7 +238,15 @@ $DSH_HOME/blue/
208
238
  - 安全问题:[SECURITY](SECURITY.md)
209
239
  - 问题反馈:[Issues](https://github.com/FGCGDroid/blue/issues)
210
240
  - 开发说明:[docs/development.md](docs/development.md)
241
+ - 内联防御边界:[docs/inline-defense.md](docs/inline-defense.md)
242
+ - 防守回归测试:[docs/defense-regression.md](docs/defense-regression.md)
211
243
  - 蓝队开源项目调研:[docs/blue-team-repos.md](docs/blue-team-repos.md)
244
+ - 维护策略:[MAINTENANCE.md](MAINTENANCE.md)
245
+ - 交接手册:[HANDOFF.md](HANDOFF.md)
246
+ - 架构说明:[docs/architecture.md](docs/architecture.md)
247
+ - 发布流程:[docs/release.md](docs/release.md)
248
+ - 已知问题:[docs/known-issues.md](docs/known-issues.md)
249
+ - 贡献指南:[CONTRIBUTING.md](CONTRIBUTING.md)
212
250
 
213
251
  发版流程、测试命令和目录结构见开发说明。
214
252
 
package/SECURITY.md CHANGED
@@ -1,48 +1,49 @@
1
- # Security Policy
2
-
3
- ## 支持范围
4
-
5
- 当前维护版本:
6
-
7
- ```text
8
- 1.5.x
9
- ```
10
-
11
- 更早版本只保留升级建议,不保证修复。
12
-
13
- ## 报告安全问题
14
-
15
- 请使用 GitHub 的 **Private vulnerability reporting**:
16
-
17
- ```text
18
- https://github.com/FGCGDroid/blue/security/advisories/new
19
- ```
20
-
21
- 不要在公开 issue 里贴:
22
-
23
- - 真实 token、Cookie、Authorization
24
- - 客户/比赛敏感日志
25
- - 可复现的真实主机地址
26
- - 未授权的目标信息
27
-
28
- 如果私密报告入口不可用,请开一个**不含敏感信息**的 issue,只写“需要私密渠道”,维护者会跟进。
29
-
30
- ## 安全边界
31
-
32
- - 本项目是蓝队编排、记录和辅助研判工具,不是 EDR/IPS/WAF/防火墙/备份系统。
33
- - 不承诺拦截、阻断或恢复攻击;生产使用前请自行评估、备份和回滚演练。
34
- - 高风险动作(隔离、封禁、删除、改防火墙等)必须人工审批;插件不直接调用 root 防火墙。
35
- - 诱饵程序默认只监听 `127.0.0.1`;公开监听必须显式 `--allow-public`。
36
- - 诱饵日志不记录 Cookie/Authorization;body/query 中的 password/token/secret/cookie/session 会脱敏。
37
- - 不收集 WebRTC 真实 IP、Canvas/硬件指纹。
38
-
39
- ## 不在范围内
40
-
41
- - 用户对未授权目标的使用
42
- - 用户自行修改代码、删除审批闸或接入 root 执行器导致的问题
43
- - 第三方工具(Endlessh/Nginx/fail2ban/EDR 等)的配置错误
44
- - 真实生产环境的网络、主机和凭据管理
45
-
46
- ## 隐私
47
-
48
- 插件默认不主动上传数据;事实库和诱饵日志保存在本机。外部情报查询由用户显式调用,并自行承担合规责任。
1
+ # Security Policy
2
+
3
+ ## 支持范围
4
+
5
+ 当前维护版本:
6
+
7
+ ```text
8
+ 2.0.x beta(本地试用,尚未发布 npm)
9
+ 1.5.x stable(npm)
10
+ ```
11
+
12
+ 更早版本只保留升级建议,不保证修复。
13
+
14
+ ## 报告安全问题
15
+
16
+ 请使用 GitHub 的 **Private vulnerability reporting**:
17
+
18
+ ```text
19
+ https://github.com/FGCGDroid/blue/security/advisories/new
20
+ ```
21
+
22
+ 不要在公开 issue 里贴:
23
+
24
+ - 真实 token、Cookie、Authorization
25
+ - 客户/比赛敏感日志
26
+ - 可复现的真实主机地址
27
+ - 未授权的目标信息
28
+
29
+ 如果私密报告入口不可用,请开一个**不含敏感信息**的 issue,只写“需要私密渠道”,维护者会跟进。
30
+
31
+ ## 安全边界
32
+
33
+ - 本项目是蓝队编排、记录和辅助研判工具,不是 EDR/IPS/WAF/防火墙/备份系统。
34
+ - 不承诺拦截、阻断或恢复攻击;生产使用前请自行评估、备份和回滚演练。
35
+ - 高风险动作(隔离、封禁、删除、改防火墙等)必须人工审批;插件不直接调用 root 防火墙。
36
+ - 诱饵程序默认只监听 `127.0.0.1`;公开监听必须显式 `--allow-public`。
37
+ - 诱饵日志不记录 Cookie/Authorization;body/query 中的 password/token/secret/cookie/session 会脱敏。
38
+ - 不收集 WebRTC 真实 IP、Canvas/硬件指纹。
39
+
40
+ ## 不在范围内
41
+
42
+ - 用户对未授权目标的使用
43
+ - 用户自行修改代码、删除审批闸或接入 root 执行器导致的问题
44
+ - 第三方工具(Endlessh/Nginx/fail2ban/EDR 等)的配置错误
45
+ - 真实生产环境的网络、主机和凭据管理
46
+
47
+ ## 隐私
48
+
49
+ 插件默认不主动上传数据;事实库和诱饵日志保存在本机。外部情报查询由用户显式调用,并自行承担合规责任。