dsh-pentester

面向 DeepSeek Harness 的最小化 Root-Orchestrator PTES 渗透测试插件。

唯一事实来源是 docs/plan.md；架构视图见 docs/architecture.md，磁盘布局见 docs/workspace.md，领域术语见 CONTEXT.md。

心智模型

User ⇄ DSH Root Session（pentester persona preset）
   → Root 是唯一 Orchestrator：判断缺口、派发 Delegation、决定推进/回溯阶段
   → Root 工具面 4 个：pentester_delegate / pentester_cancel_delegation /
     pentester_advance_stage / pentester_rollback_stage
   → Root 每次 reasoning 前注入 compact run state（target/branch/stage/delegations）
Delegation（并行多个）= 各一个 DSH child session（AgentProfile + 不可变 task_prompt）
   → Worker 工具只有 pentester_container_exec（dockerode；Root 不可见）
   → Worker 写完 result.md 即完成任务（完成标志）；缺失 → failed
Deliverable = 文件（workspace/stages/<NN>-<stage>/delegations/D-00N/）

安装

# github 源
dsh plugin --profile web add github:fb0sh/dsh-pentester
# npm 源
dsh plugin --profile web add dsh-pentester

布局

| 目录/文件 | 职责 | | --- | --- | | src/ | model/stages/profiles/store、workspace/git、dsh/delegations/tools/worker-tools、docker/（host/connection/images/runtime）、rpc/settings-store、index | | src/ui/client/ | Settings 的 “Pentester Config” 页（Tab：Docker Engine） | | agents/*/profile.yml | 7 个 AgentProfile（systemPrompt/skills/mcpServers） | | docker/ | Toolbox Dockerfile（kali 等，镜像白名单来源） | | presets/pentester/ | Root persona preset + run-state.mjs（工具面限制 + 动态状态注入） |

开发

pnpm run check   # typecheck + build（含 client bundle）
pnpm test        # node --test

Docker host 优先级：Settings（settings.json）> 插件配置 > 本地 socket 自动发现 > DOCKER_HOST > 默认 socket。本地 Docker 用 bind mount（host workspace == 容器 /workspace）；远程 daemon 用共享 volume，阶段边界才做 mirror sync。