红队行动台 chongfenglaosiji/dsh-redops

dsh-redops — DSH 红队行动记录与渗透测试模式

面向 DeepSeek Harness（dsh）的授权红队 engagement 工作台：在授权范围内记录目标与授权、拆解意图、留证事实、确认漏洞与资产，并在 Web 中以链路图、漏洞和资产视图实时展示，支持跨会话历史与 8 种报告格式。

本仓库是自包含 bundle 包（dsh-redops）：宿主插件、Web 界面和 sqlite 后端通过包内 exports 一同分发，单个 tarball 即可安装。

关于来源： 本项目的功能本体来自 howmp/dsh-pentest，由 shine-233/dsh-redteam 二次开发，本仓库在其基础上做 DeepSeek Harness 0.2.x 适配与缺陷修复。功能集与上游 v1.10.0（master）一致，没有删减。三者均为 MIT，详见 NOTICE。

为什么会有这个仓库： 上游最后推送于 2026-09-12，未跟进 DSH 0.2.0-rc.1 的 agent-presets 机制变更，因此在 0.2.x 上无法注册预设，29 个工具全部不可用；其发布包自 v1.2.0 起还带有三处静默缺陷（含一处使子代理只读围栏完全失效）。本仓库在修复这些问题之外不做功能改动。

宿主版本要求

DSH ^0.2.0-rc.1，实测于 0.2.0-rc.2。

peer 范围是显式声明的（@deepseek-ai/dsh- 全部为 ^0.2.0-rc.1），所以 dsh 自身的兼容性门禁会真正生效——上游写的 >=0.1.0-rc.2 没有上限，导致不兼容版本被放行。

本分支不支持 0.1.x。src/preset-root.ts 保留了旧 resolvedRoots 接口的回退代码，但未在 0.1.x 上验证。

相对上游的修复

上游发布包在 0.2.x 上有三处会导致预设无法注册，另有一处会静默失效：

| # | 问题 | 后果 | 本分支的处理 |
| 1 | preset-root 无条件读取 agentPresets.resolvedRoots | 0.2.x 上抛 Cannot read properties of undefined，预设注册失败，29 个工具全部不可用 | 优先走 0.2.x 的 register()，仅在其缺席时回退旧接口；用宿主 include loader 加载包内 YAML |
| 2 | commander persona 用 text: | rc.2 的 @deepseek-ai/dsh-persona 强制要求 prefix:，校验失败 | 改为 prefix: |
| 3 | preset 引用 @deepseek-ai/dsh-workflow-worker-thread | 该包在 0.1.6 已改名，rc.2 不存在，组内加载失败 | 改为 @deepseek-ai/dsh-workflow-ptc |
| 4 | 两个子代理的 toolFilter: 键被并进乱码行 | deny 名单变成 persona 字符串的尾巴，执行子代理的只读围栏完全不生效，子代理可自行创建 goal、发报告、继续委派 | 恢复为真正的 toolFilter 映射（各 29 条） |
| 5 | preset/redteam/agent.cordis.yml 中文乱码 | 注释与两个子代理 persona 为损坏文本（U+E0xx 私有区字符，多轮编码损坏，不可逆） | 注释重写为英文；persona 以干净的上游 howmp/dsh-pentest 文本为底本重建，再补上本包特有的 evidence/credentials/artifacts 字段 |

第 4 项值得单独说明：它不报错，tests/bundle.spec.ts 原本只做文本匹配，所以围栏失效时测试照样通过。本分支把该测试改为解析 YAML 后断言 toolFilter.deny 的结构，并显式检查 deny 名单没有被吞进 persona——修复后该断言在损坏文件上会失败（已验证）。

安装

从 npm

dsh plugin --profile web add dsh-redops

从 Release 安装

dsh plugin --profile web add https://github.com/chongfenglaosiji/dsh-redops/releases/latest/download/dsh-redops.tar.gz

从本地文件安装

dsh plugin --profile web add file:/path/to/dsh-redops-<version>.tgz

重启 dsh 后，在新会话中选择自动注册的「红队模式」预设。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm pack:bundle

关于类型检查的一个坑

tsconfig.json 的 paths 把 @deepseek-ai/ 映射到仓库自带的 types/ 手写声明（标注为 pinned against upstream 0.1.1-rc.2），vitest.config.mjs 又把同一批模块 alias 到 tests/fakes/。

这带来两个可移植性好处（不需要 dsh checkout 就能构建和跑测试），代价是 pnpm typecheck 与 pnpm test 都不校验真实的宿主 API——本分支修掉的第 1 项就是这么漏过去的。改动宿主交互代码时，请务必在真实 dsh 上装包验证，不要只依赖 CI。

许可与归属

MIT。功能本体来自 howmp/dsh-pentest，由 shine-233/dsh-redteam 二次开发，本分支在其上做 0.2.x 适配。详见 NOTICE。

与上游（dsh-pentest）的差异

| 能力 | dsh-pentest | dsh-redteam |
| 证据链 | 无 | redteam_add_evidence（command / output / screenshot / file / url），fact 通过 evidenceIds 引用 |
| 跨会话历史 | 单会话作用域，无续跑 | redteam_engagements 列出全部历史；新 goal 关闭旧 engagement 但不删除任何记录 |
| 报告格式 | Markdown 渲染 | Markdown（人读）/ JSON（程序消费）双格式，含时间线与严重度分布 |
| 协议语言 | 中文 | language: 'zh' \| 'en' 双语配置 |
| 边存储 | edges 表显式存边 | 边从引用（intent.goalId / fact.intentId / finding.intentId / asset.parentId）读取时派生，记录不可能悬空 |
| CVSS 定级 | 无 | finding 给 cvssVector（CVSS v3.1 基础向量）即按 FIRST 规范自动计算分值 |
| MITRE ATT&CK | 无 | finding 可映射 techniqueIds（如 T1110.003），写入时校验格式 |
| Kill-chain 阶段 | 无 | intent / fact 可标 phase（recon / enumeration / exploitation / post-exploitation / reporting） |
| 凭据追踪 | 无 | redteam_add_credential 登记口令/哈希/API key/token，Web 视图与报告自动脱敏，明文只进本地库；redteam_update_credential 验证后更新 valid/invalid 并留证 |
| 任务树生命周期 | 无（PentestGPT PTT 风格） | intent 有 active/done/blocked 状态，redteam_update_intent 推进；UI 进度板与报告进度行 |
| 漏洞复测闭环 | 无（Strix find-and-fix 风格） | redteam_retest_finding 记录 fixed/still-vulnerable 复测结果，报告标注 ✅ 已修复与复测时间 |
| OWASP Top 10 | 无 | finding 可映射 owaspIds（如 A01:2021 / A05:2017），写入时校验格式 |
| 资产指纹标签 | 无 | asset 可挂 tags（服务名/组件/版本），资产表与报告展示 |
| 资产锚点与覆盖度 | 无（ARTEX 双图架构风格） | intent 用 assetIds 锚定目标资产，redteam_state / 报告 / 资产视图输出已测 vs 未测覆盖 |
| fact→intent 派生边 | derived_from 边 | intent 用 derivedFrom 引用触发它的事实，血缘链入图 |
| 多步攻击链依赖 | 无（ARTEX planner todolist 风格） | intent 用 dependsOn 声明前置步骤（注入→取凭据→横向→提权），图中虚线呈现 |
| 目标显式结论 | 无（ARTEX prove_goal 风格） | redteam_close_goal 以 achieved/partial/not-achieved 收尾并留摘要，报告头部与历史列表引用；收尾后报告/状态/图仍可完整读取 |
| SARIF 导出 | 无 | redteam_report format=sarif 输出 SARIF 2.1.0（GitHub/GitLab code scanning 可直接摄取），CVSS 映射 security-severity，ATT&CK/OWASP 作为 tags |
| 产物追踪 | Artifact 实体（PentAGI ER 模型） | redteam_add_artifact 登记 engagement 的交付物（战利品/截图/日志/exp 脚本/转储），与 evidence 区分：产物是输出，证据支撑论断；Web 产物标签页 + 报告产物表 |
| 提交事务性 | 无对照 | redteam_submit 两阶段提交——批内任何校验失败零残留，子代理重试不会产生重复记录 |
| 收尾后可读 | 无对照 | redteam_close_goal 之后 state/graph/report 仍完整可读（最终报告工作流） |
| 人工转向黑板 | Hint 原语（Cairn 黑板架构） | redteam_add_hint 把用户/客户/操作者的方向性指令原文入档（user/operator/client 来源标注），Web 头部指示条 + 报告「人工转向」段 |
| 漏洞去重标记 | issue dedup（Dradis 类平台） | redteam_add_finding duplicateOf 标记重复漏洞（子代理双报场景），报告标注 dup of |
| 检测状态追踪 | VECTR 红/蓝对抗度量 | finding/retest 记录蓝队反馈 undetected/logged/alerted/prevented，报告输出防御触达率；Web 漏洞卡片带检测徽章、统计页输出触达率面板 |
| ATT&CK 技术覆盖 | VECTR/Navigator 覆盖矩阵 | intent 标计划技术、finding 证实用技术，state/报告输出 proven vs attempted-only 覆盖摘要 |
| CWE 弱点映射 | PwnDoc 漏洞库标配 | finding 可挂 cweIds（CWE-79 格式），写入校验，SARIF tags 携带 |
| 样本登记 | 恶意软件分析报告惯例 | redteam_add_sample 以 sha256（64 hex 强制）为保管链锚点登记二进制/文档/内存转储，附 md5/sha1/格式/架构 |
| IOC 追踪 | MISP/Cuckoo 提取工作流 | redteam_add_ioc 按 ip/domain/url/hash/mutex/registry/filepath/user-agent 分类记录指标，可挂样本与意图，报告输出 IOC 附录表 |
| 目标核对单 | CTFd flag 模型 / Cairn prove_goal | redteam_add_objective + redteam_prove_objective：逐项成功标准（拿域管/读 PII 表）独立证明或撤回，报告核对单带证明时间戳 |
| CVE 引用 | NVD/DefectDojo 惯例 | finding 可挂 cveIds（CVE-2024-12345 格式校验），SARIF tags 携带 |
| 分诊状态 | DefectDojo triage 工作流 | redteam_flag_finding：under-review / false-positive / out-of-scope / risk-accepted（说明+证据留痕，none 清除）；标记不删记录——报告徽章标注，SARIF 对误报输出 suppressions |
| 跨表搜索 | DefectDojo Watson 检索 | redteam_search 一条关键词扫 12 类记录返回分组片段；原始密文不可检索 |
| 全局度量面板 | DefectDojo metrics dashboard | redteam_overview 跨全部 engagement 聚合表计数、严重度分布、检测反馈、分诊状态与修复数 |
| CVSS v4.0 定级 | FIRST CVSS v4.0 规范 | finding 的 cvssVector 接受 v3.1 或 v4.0 向量（CVSS:4.0/AV:N/AC:L/AT:N/…），v4 分值按官方 RedHat 计算器算法逐行移植（MacroVector + 深度再分配，270 项查找表），与 FIRST 校验向量完全一致 |
| 扫描器导入 | Metasploit workspace / Faraday ingestion | redteam_import_scan format=nmap-xml|nessus-xml：nmap 主机/开放端口→资产树+侦察事实，Nessus ReportItem→严重度映射的 CVE 关联漏洞（plugin_output 作复现步骤、标题+主机去重）；原始 XML 存为证据 |
| JIRA 双向桥 | DefectDojo/Jira remediaiton workflow | redteam_jira_export 输出 issue payload（summary/priority/labels+findingId 台账），redteam_jira_apply 回写 jiraKey/jiraStatus；tracker 侧 Done 不自动关闭——必须走复测留证 |
| 多用户角色门禁 | 协作 RBAC（Faraday workspace） | redteam_add_operator 注册 commander/operator/viewer；协作写入接受 as 参数过角色门（未注册即拒，viewer 只读，匿名单人不受限） |
| SLA 时限追踪 | DefectDojo SLA | 漏洞按严重度策略自动盖截止章（critical 7 / high 30 / medium 90 / low 180 天，可 slaDays 覆盖）；state 输出逾期清单与升级提示，Web 卡片显示 ⏰ 徽章 |
| ATT&CK Navigator 导出 | mitre-attack/attack-navigator | redteam_report format=navlayer 输出 layer v4.5：证实技术 100 分（绿）/ 仅尝试 50 分（琥珀），注释携带意图与漏洞出处，Navigator 直接打开 |
| STIX 2.1 导出 | MISP / oasis-open STIX 工作流 | redteam_report format=stix 输出 bundle：漏洞→vulnerability（severity 标签 + CVE 外部引用），IOC→indicator（ip/domain/url/hash/email/mutex/registry 标准 pattern） |
| 凭据复用分析 | BloodHound/Faraday 曝面分析 | 同一口令材料跨目标/资产出现时，redteam_state 与报告输出复用分组（脱敏掩码，明文不出库），提示横向尝试 |
| 执行摘要与下一步建议 | PwnDoc/Dradis 报告标配 + Strix planner 风格 | markdown 报告头部自动生成执行摘要（结论/最高风险/覆盖率/复用告警）；redteam_state 输出 nextSteps 启发式（覆盖缺口、受阻意图、未验证凭据、仅尝试技术…） |
| 范围结构化注册表 | 授权边界数字化（ROE 条款入档） | redteam_add_scope kind=in/out 注册目标模式；资产/漏洞/IOC 自动判定越界（out 命中）与漏登（有 in 清单但零匹配），state/统计面板/全部报告输出合规表 |
| IOC CSV 导出 | MISP/Cuckoo 提取工作流 | redteam_report format=ioc-csv 输出带表头的 CSV 行（id/type/value/sample/intent/时间/上下文，含引号转义） |
| TAXII 2.1 信封导出 | oasis-open TAXII 集合响应 | redteam_report format=taxii 输出 {more,next,data} 信封包裹同一批 STIX 对象，可直接喂 OpenCTI/MISP 连接器 |
| HTML 报告 | PwnDoc 自包含页面惯例 | redteam_report format=html 单文件深色主题页面（内联 CSS 无 JS）：摘要芯片、严重度条形、漏洞卡片、范围合规表、时间线、证据折叠附录，打印友好 |

架构速览

- 领域模型（src/spec.ts）：storage domain redteam（version 1，增量演进兼容旧库）——goals / intents / facts / assets / findings / evidence / credentials 七张表。goal 按会话键控，其余记录 id 为 <kind>-<n>（按会话计数，重开 goal 归零）。
- 确定性 id（src/store.ts）：工具返回 id 供模型跨调用引用；会话投影从日志纯重放同一张图。
- 工具（src/tools.ts）：29 个 —— redteam_add_goal（authorization 必填，重开 goal 关闭旧 engagement）/ redteam_add_intent（可选 phase）/ redteam_add_evidence / redteam_add_fact（evidenceIds 引用、可选 phase）/ redteam_add_asset（parentId 留空为根资产，tags 指纹）/ redteam_add_finding（reproducibleSteps 必填；cvssVector 支持 v3.1 与 v4.0 自动算分；techniqueIds/owaspIds 校验；SLA 按策略盖章）/ redteam_add_credential（凭据登记，脱敏展示）/ redteam_update_intent（任务树状态推进）/ redteam_retest_finding（复测闭环）/ redteam_flag_finding（DefectDojo 式分诊：误报/范围外/风险接受/审核中）/ redteam_update_credential(验证凭据) / redteam_submit（子代理分批直写指定父 intent）/ redteam_add_scope（结构化授权边界 in/out）/ redteam_add_operator（协作角色注册）/ redteam_import_scan（nmap/Nessus XML 摄取）/ redteam_jira_export|redteam_jira_apply（JIRA 双向桥）/ redteam_state（含 nextSteps 建议与凭据复用、范围合规、SLA 逾期）/ redteam_search（12 类记录跨表检索）/ redteam_overview（部署级全局度量）/ redteam_graph / redteam_report（markdown|html|json|sarif|navlayer|stix|taxii|ioc-csv）/ redteam_engagements（历史列表）。
- CVSS 计算（src/cvss.ts）：FIRST CVSS v3.1 基础分实现（含官方 roundup 防浮点漂移），20 个参考向量测试覆盖。
- 会话投影（src/projection.ts）：折叠已日志化的 redteam_ 调用为 { goal, nodes, assets, findings, credentials, counts }，镜像 store 的引用拒绝；密文永不进入投影。
- Web 标签页（src/client/）：按会话注册（当前会话或祖先链含 redteam 预设即显示）；十二个子标签——链路（canvas 力导向图：拖拽/缩放/悬停高亮/点选详情抽屉——事实节点显示真实详情与证据引用/方向粒子流）、统计（严重度环形图、任务树与覆盖度动画进度条、ATT&CK 覆盖墙、防御触达率、kill-chain 泳道、范围合规）、立体（零依赖 3D 攻击地形：轨道旋转/推拉/自动旋转/深度排序）、漏洞（检测徽章+重复标记）、资产、凭据（脱敏列表）、产物、证据（证据元数据+事实清单，内容不进视图）、样本、IOC（类型筛选）、目标（crown-jewel 清单）、报告。13 张表全部有可视化入口。
- 协议（src/instructions.ts）：系统提示词段 redteam:protocol（order 50），双语逐字撰写而非运行时翻译；要求授权留痕、事实必留证、漏洞必可复现、凭据不落明文。

已知边界

- 数据库：红队记录写入 $DSH_HOME/storages/redteam.db（sqlite，经 bundle 补丁路由）。宿主其它域的存储不受影响（仍为宿主默认 json 后端）。
- 授权：只测试有授权的目标。authorization 是必填审计事实（授权对象/书面许可引用），写入状态与最终报告留痕；它不是门禁——扫描/利用动作仍受部署沙箱与审批约束。
- Web 图为窗口视图：投影有节点上限，超出后最旧被逐出；完整记录以 redteam_state / redteam_report（读存储层）为准。
- 运行时要求：sqlite 后端使用 Node.js node:sqlite，需 Node.js >= 22.5（engines: ^22.19.0 || >=24.0.0）。

开发

pnpm install
pnpm build # tsdown 构建到 lib/
pnpm typecheck # tsc --noEmit
pnpm test # vitest run
pnpm pack:bundle # npm pack 出可安装 tarball

目录结构：

dsh-redteam/
├── package.json # bundle manifest：exports 子路径 + dsh.bundle.patch + dsh.client ├── cordis.patch.yml # 补丁层：UI、sqlite 后端、storage-domain 路由、preset root ├── src/ # 源码 │ ├── plugin.ts # 宿主插件装配（tools + protocol + projection） │ ├── spec.ts / store.ts # 领域模型与 engagement 存储 │ ├── tools.ts # 11 个 redteam_ 工具 │ ├── projection.ts # 会话投影定义 │ ├── instructions.ts # 双语协议提示词段 │ ├── client/ # 浏览器半：RedteamView / ChainGraph(canvas 力导向) / Stats / View3D / Findings / Assets / Credentials / Artifacts / Samples / Iocs / Objectives / Report │ └── storage-sqlite/ # sqlite 后端（node:sqlite） ├── preset/redteam/ # 「红队模式」agent 预设（bundle 自动注册） ├── lib/ # 构建产物（npm pack 内容） └── tests/ # vitest：bundle / store / tools / projection

参考项目

- howmp/dsh-pentest — 本项目的前身与基础
- ARTEX

License

MIT