dsh-pentester
Pentester
Minimal Root-Orchestrator PTES pentesting plugin for DeepSeek Harness
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-pentester@4.0.0
dsh-pentester
Minimal Root-Orchestrator PTES pentesting plugin for DeepSeek Harness
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-pentester@4.0.0
Pentester is published as dsh-pentester and currently resolves to version 4.0.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
面向 DeepSeek Harness 的最小化 Root-Orchestrator PTES 渗透测试插件。
内置 962 个渗透测试 Skill（6 个 bundle + 6 个 standalone），覆盖 Kali 工具、PTES 全阶段、CTF、逆向、漏洞知识库与报告生成。
19 个内置专家 Agent 按 PTES 阶段编排；MCP 集成支持 STDIO / Streamable HTTP / Legacy SSE 三种 transport（Legacy SSE 可直连 PortSwigger Burp MCP Server，无需代理中转）。PTES 阶段可为该阶段所有 Worker 共享 Skills / MCP server，也可配置跨阶段的 Global Worker 共享能力。
唯一事实来源是 docs/plan.md；架构视图见 docs/architecture.md，磁盘布局见 docs/workspace.md，领域术语见 CONTEXT.md。Skill 能力运行时见 docs/skill-runtime-v4.md（Native DSH Skill 集成）。
Builtin Skill Pack 独立分发：上述 Builtin Skills 作为独立 GitHub Release Asset 分发，不随 npm package 安装。首次使用时在 Settings → Pentester → Skills → 初始化 Builtin Skills 点击下载安装。Custom Skills 放在
$DSH_HOME/dsh-pentester/skills/，与 Builtin Skill Pack 完全隔离。
Skill Runtime V4：Worker 的 Skill 加载已完全融入 DeepSeek Harness 原生 Skill 生态 —— Delegation 创建时冻结 grant（Host-private snapshot + manifest），Worker 以官方
skill({name})工具按需加载，catalog 与会话记录由官方dsh-tool-skill产生， 前端直接用官方 Skill Row 渲染。旧pentester_skill_search/pentester_skill_load已退役（历史会话仍可回放）。
欢迎提交issues和PR。
详细英文文档见 docs/README.md。
User ⇄ DSH Root Session（pentester persona preset）
→ Root 是唯一 Orchestrator：判断缺口、派发 Delegation、决定推进/回溯阶段
→ Root 工具面 5 个：pentester_run / pentester_delegate /
pentester_cancel_delegation / pentester_advance_stage / pentester_rollback_stage
→ pentester_run 是唯一生命周期入口（action: start | stop | resume | restart | status）
→ Root 每次 reasoning 前注入 compact run state（target/branch/stage/delegations）
Delegation（并行多个）= 各一个 DSH continuable child session（AgentProfile + 不可变 task_prompt）
→ Worker 工具：pentester_container_exec（dockerode）+ 官方 skill tool（child-scoped frozen SkillProvider，Root 不可见）
→ Worker 的 Skill catalog 由 Harness 官方注入（frozen grant 精确边界）
→ Worker 写/更新 result.md 作为当前可交付结果（continuable child 跨轮持续）
Deliverable = 文件（workspace/stages/<NN>-<stage>/delegations/D-00N/）
设置界面
image
仅通过dockerode与docker daemon交互，定期文件同步，允许远程docker server，可降低本机资源占用。
工具集详见 docker/kali
在 ~/.dsh/dsh-pentester/skills/ 下建一个文件夹放一个 SKILL.md 即可：
~/.dsh/dsh-pentester/skills/
└── my-waf-bypass.skill/
└── SKILL.md # name + description + 指令正文
目录热更新，无需重启；在 Settings → Agent Library 里 grant 给某个 Agent
后，之后新建的 Worker 会在原生 skill catalog 中看到它（模型自行决定
skill({name}) 加载）。详见
docs/skill-runtime-v4.md §4.1。
Worker 调用 Skill 与普通 DeepSeek Harness 会话完全同构：Agent Library
冻结 grant → child-scoped frozen SkillProvider → 官方 dsh-tool-skill 的
durable catalog 与 skill({name}) 工具 → 标准的 <skill_content> 结果与
官方 Skill Row UI。
Worker 会话里模型自主路由并加载 Skill（官方 Skill Row，与普通 DSH 会话无差异）
worker-native-skill-rows
Trace 拓扑：每个成功加载的 Skill 是 Agent 节点外侧的一个芯片元素，用线连接
trace-skill-chips
Output：每 Delegation 的 loaded_skills.md（native 会话事件审计投影）
output-loaded-skills
Settings → Pentester 提供完整的插件配置面（Overview / Agent Library / Docker / Version 四个顶层 Tab）：
Overview：状态摘要（Docker / Toolbox / Skills / Agents / MCP）+ PTES 阶段管线（每阶段参与编排的 Agent） settings-overview
Agent Library：19 个内置专家 Agent（按 PTES 阶段分工，可 Customize 覆盖 skill/MCP 分配） settings-agent-library
每个 PTES 阶段除了指派参与编排的 Agent，还可以配置该阶段所有 Worker 共享的 Skills 与 MCP server；页面顶部的 Global Worker Capabilities 则把共享能力下发给所有 Worker 阶段。共享能力是 additive 的（叠加在 Agent 自身能力之上），并在 Delegation 创建时冻结 —— 已创建的 Worker 不受后续配置变化影响。Root 不继承任何共享能力（仍是纯 Orchestrator 的正向 allow-list）。
MCP Server 支持三种 transport：STDIO（本地进程）、Streamable HTTP（现代远端协议，推荐）、Legacy SSE（旧式 HTTP+SSE 兼容 —— 如 PortSwigger Burp MCP Server，http://127.0.0.1:9876）。Legacy SSE 的 sessionId 握手由官方 MCP SDK 完成，无需手工配置；旧式 server 不再需要 mcp-proxy 中转。
Transport 选择器（完整协议名称，不混淆两种 HTTP 协议） settings-mcp-transport
Burp Suite 以 Legacy SSE 直连：Loaded · 27 tools settings-mcp-burp
Host / Client / Skill Pack 构建版本一目了然（host 与 client bundle 不一致时给出刷新提示）：
settings-version
渗透测试模式
image
授权确认
image
问题诊断
image
使用docker镜像
image
看板与子代理
image
各个TAB
image
时间轴阶段拓扑
image
阶段产出
image
子代理自动汇合推进
image
image报告
image
安装deepseek harness
npm install -g @deepseek-ai/dsh
准备docker镜像
docker pull fb0sh/dsh-pentester-kali:latest
# npm 源
dsh plugin --profile web add dsh-pentester@latest
# github 源
dsh plugin --profile web add github:fb0sh/dsh-pentester
安装后需要重启dsh
| 目录/文件 | 职责 |
|---|---|
src/ | model/stages/store、workspace/git、dsh（childId 预留）/delegations/tools、docker/（host/connection/images/runtime）、rpc/settings-store、targets、migrate、host-manifest、invocations、build-id、index |
src/native-skill/ | Skill Runtime V4：frozen manifest、child-scoped SkillProvider（dsh-pentester-frozen）、agent/created mount seam、native audit 投影、legacy name 迁移 |
src/agent-library/ | Agent Library 组合根（profiles/skills/bundles/settings v2/watcher） |
src/pentest/ | pre-engagement/assets/findings 领域逻辑 |
src/ui/client/ | Settings 的 "Pentester Config" 页 + Pentester Tab（Stages/Trace/Findings/Output） |
src/ui-view/ | Pentester 数据面板（snapshot / native skill audit 投影 / RPC） |
agents/*/profile.yml | 19 个 Builtin AgentProfile（Agent Topology V3：18 个进入默认 PTES 编排 + library-only ctf；见 docs/agent-skill-allocation.md） |
docker/ | Toolbox Dockerfile（kali 等，镜像白名单来源） |
presets/pentester/ | Root persona preset + run-state.mjs（工具面限制 + native skill provider 挂载 + 动态状态注入） |
pnpm run check # typecheck + build（含 client bundle）
pnpm test # node --test
Docker host 优先级：Settings（settings.json）> 插件配置 > 本地 socket 自动发现 > DOCKER_HOST > 默认 socket。本地 Docker 按 Worker 白名单顶层目录逐目录 bind（.git/ 与 .dsh-pentester/ 物理上不在容器内）；远程 daemon 用共享 volume，阶段边界才做 mirror sync（push/pull 双向排除控制态、原子发布、不跟随 symlink）。