前言¶
在 DSH 里用大模型做网络安全评估，常见问题是「跑得快、说不清」：同一攻击面重复试、硬骨头就换方向、报告里堆「疑似」却拿不出矩阵级的覆盖证明。DeepSeek Harness 社区里有不少单点工具型插件；dsh-voredteam（维护者 xydijkkk，SkillHub 分类为工作流）走的是另一条路：单模式（网络安全模式）、黑板状态图、六阶段检查矩阵、总控派单与作战面板，把一次测试当成有门禁、有证据、有复核的项目来管。
下面介绍它是什么、核心能力、如何按 README 部署启用，以及使用前必须满足的授权边界。
这是什么¶
dsh-voredteam 是 npm 包 @dsh-external/dsh-voredteam（当前资料记载版本 0.1.0，MIT 许可，要求 Node.js ≥ 22）。README 将其定位为 DSH 插件形态的单模式安全作战系统：核心范式是把渗透测试还原为 状态空间搜索——黑板上的 Fact（事实）与显式「事实 → 意图」边；组织上是 总控做 reason、12 个专业子 agent 做 explore，进度与成果集中在作战面板。
它不是「替模型打靶」，而是回答：谁在测哪个面、测到哪一步、哪些面没测、结论有没有证据与独立复核——数据落在 SQLite 黑板库里，可视化在面板，交付走报告规范。
硬约束（唯一门禁）：禁 DDoS、禁爆破、模糊测试低频化；README 强调这是技术下限，不等于测试授权，合法性取决于书面授权。
核心功能¶
黑板：Fact / Intent / Hint 与资产矩阵¶
数据层为 SQLite（node:sqlite），一个会话对应一个项目，图 append-only。主要对象与工具包括：
| 对象 | 含义 | 代表工具 |
|---|---|---|
| Fact | 已确认事实 + 证据路径 | bb_fact_add、bb_fact_review |
| Intent | 待探索方向（图上边） | bb_intent_propose、bb_intent_claim、bb_intent_conclude |
| Hint | 人类给出的范围/凭据/禁测项 | bb_hint_add、bb_hint_list |
| Asset | 可测对象清单 | bb_asset_add、bb_assets |
| Check | 资产 × 六阶段 × 检查项 | bb_asset_check、bb_asset_checks |
README 写明共 23 个工具（21 个 bb_* + vore_agent_card / vore_agents_list）。系统提示会 逐轮注入图快照（阶段、矩阵完成度、待认领意图、人类提示等），避免模型「凭记忆」自述进度。
发现新资产时会 回灌：六张矩阵同时出现缺口，阶段退回 P1 起点（reflow_pending=1），需再收一轮确认「连续 0 新增」才解封。
六阶段作业法 + 六张检查矩阵¶
流程自 P1 起点（多来源并发收集）经 P2 信息收集、P3 浅层（含 verifyInfo + shallow）、P4 中间层（verifyShallow + OWASP Top 10）、P5 深层（deep 八类）、到 P6 成果（缺口清零、未测面声明、事实复核、报告）。
纪律是 每一层先核实上一层；六张矩阵是唯一判据。hit 须证据，漏洞事实进报告须 reviewed；na / wrong / unknown 须写足理由；未测面须声明原因（报告必带）。阶段推进不满足时，bb_phase_advance 会拒绝并列缺口。
总控与 12 个专业子 agent¶
子 agent 领域包括：recon、js-reverse、api-security、web-injection、auth-logic、component-cve、app-reverse、internal-network、cloud-ai、exploit-dev、reviewer（独立 confirm/challenge）、reporter。角色卡在 agents/*.md。
派单方式：总控调用 vore_agent_card <role>，带上目标标识、授权边界、子目标、成功标准、intent_id、project=<项目 id> 及要覆盖的资产/检查项。总控不得替子 agent 填写检查行结论——执行者写矩阵，总控只核对。
作战面板与设置¶
会话页签 「作战面板」 含三个分栏：
- 实时情况：八条泳道（起点 → 信息收集 → 浅层 → 中间层 → 深层 → 线索 → 死点 → 成果），资产纵向连线；支持缩放、全屏、右侧详情栏与面板写 Hint。
- 任务汇总：成果分级计数、「复制 Markdown」、死路与未排除面。
- 覆盖矩阵：P1–P6 与六张矩阵完成度、
na与真测过分列、未测面与复核进度。
会话分类：一个会话一个项目；顶栏可切换历史项目（钉住后显横幅），避免新会话误继承旧图。子 agent 按父会话与工作目录回退命中同一张图。
设置面板（会话「设置」或弹窗内「dsh-voredteam 设置」）：测绘 API（FOFA / Shodan / YesCaptcha / Grok 等，读写 ~/.dsh/voredteam/settings.json，密钥掩码回显）、技能管理（内置技能根 + 环境变量 VORE_EXTRA_SKILL_DIRS）、MCP 勾选与速率门禁参数。
门禁、技能与 MCP¶
- vore-guard（
plugins/vore-guard）：在ctx.tools.guard()对网络安全模式及其子 agent 做命令执行前拦截；拒绝记录可落到vore-guard-log.md。 - 内置技能：自研 4 个 +
vendor/skills/第三方合集；skills/registry.yaml为 247 条盘点（README 目录亦写 246 个可装载技能，以仓库npm run skills为准）。 - 内置 MCP 注册表：19 条（
mcp/registry.yaml），路径与密钥用${VAR}占位。
安装与启用¶
本插件依赖宿主 DSH 的 tools / slots / systemPrompt / webServer / guard 等扩展点。README 快速开始 未使用 dsh plugin add github:... 形式，而是通过仓库内 deploy CLI 幂等写入预设与 profile。典型步骤如下（需先将插件源码放到本机，例如从 GitHub 或 SkillHub 目录页 获取包后再进入该目录）：
# 0) 前置：可用的 DSH 检出
export DSH_HOME="$HOME/.dsh"
export DSH_CHECKOUT="/path/to/deepseek-harness"
# 1) 只读体检 → 2) 预演 → 3) 应用
node deploy/deploy.mjs
node deploy/deploy.mjs --dry-run
node deploy/deploy.mjs --apply
# 4) 安装 profile 依赖并重启 dsh web，新建会话选「网络安全模式」
cd "$DSH_HOME/profiles" && pnpm install
pwsh -File deploy/restart-dsh-web.ps1 -DelaySeconds 25
node deploy/deploy.mjs --apply 会重建预设实体目录、备份并更新 profile 的 package.json、建立 node_modules 链接；出厂路径通过 {{PROJECT_ROOT}} 渲染为本机绝对路径。
启用后打开会话页签 「作战面板」，由总控执行 bb_project_init，在 origin / goal（及 hint）中写清授权与目标，黑板图开始累积。
典型用法¶
开工前五问与项目初始化¶
README 要求仅在 已获得明确书面授权 的渗透测试或安全评估中使用。开工前须能回答：授权在哪、测哪些资产、时间窗、强度上限、出事联系谁；答案应写入 bb_project_init 的 origin / hint，使总控与各子 agent 每轮可见。完整条款见仓库 AUTHORIZED-USE.md。
面板或对话中可用 bb_hint_add / 面板输入框补充人类提示；总控下一轮读图吸收。
派单子 agent 与推进阶段¶
无依赖方向可并行派多个子 agent（subagent / workflow 扇出）；有依赖则串行。派单前用 vore_agents_list 或 vore_agent_card 对齐角色纪律与矩阵责任。
每轮收尾在 P1 等阶段调用 bb_coverage { endRound: true }；满足矩阵与门禁后使用 bb_phase_advance 进入下一阶段。P6 前须清零复核与未测面声明。
运维与自检（可选）¶
维护者提供的离线验证命令：
npm test
npm run verify
node deploy/deploy.mjs --check
适用场景与注意¶
适合谁：已在 DSH 上跑授权红队/渗透评估流程、需要 可审计覆盖矩阵 与 多专业 agent 分工 的团队或个人；SkillHub 将其归为 工作流 类插件。
必须注意：
- 授权：未授权扫描、探测、利用在多数法域违法；门禁放行不代表合法。
- 权限：插件以当前 dsh 进程权限 运行，子 agent 可执行命令与 MCP；安装与
--apply前请阅读源码、LICENSE、AUTHORIZED-USE.md、SECURITY.md，确认第三方技能与 MCP 许可（见vendor/THIRD-PARTY.md、NOTICE.md）。 - 门禁边界：README 写明 guard 主要覆盖命令行路径；
fs、MCP、脚本内动作不过闸，仍须人工遵守授权范围。 - 环境：Node ≥ 22；重启脚本示例为 PowerShell（
deploy/restart-dsh-web.ps1），Linux 环境需按本机 DSH 启动方式等价重启dsh web。 - 已知权衡：覆盖缺口见
docs/COVERAGE-GAPS.md；面板在资产极多时使用「适应窗口」比例可能偏小，需手动缩放查看细节。
结尾¶
dsh-voredteam 把 DSH 上的网络安全模式收敛成 一套可审计作业法：黑板状态图、六阶段六矩阵、总控 + 12 专业子 agent、作战面板三栏与唯一速率/爆破类门禁。若你的痛点是「模型测过什么说不清」，它用数据和面板而不是自述来约束过程。
- SkillHub 目录：https://www.skillhub.cn/plugins/xydijkkk/dsh-voredteam
- 源码与 README：https://github.com/xydijkkk/dsh-voredteam
（SkillHub 为 DSH 社区插件目录站点，与 DeepSeek / 幻方无官方从属关系；安装与事实以仓库 README 为准。）
