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/）

准备

安装deepseek harness

npm install -g @deepseek-ai/dsh

准备docker镜像

docker pull fb0sh/dsh-pentester-kali:1.0.0

安装

# npm 源
dsh plugin --profile web add [email protected]

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

安装后需要重启dsh

布局

开发

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。