Engineering, orchestration and securityOpen source

DSH Pentester

PTES penetration-testing agent

A PTES-oriented DSH agent with orchestration, scoped tools, evidence, findings, approvals and report generation.

View on GitHub ↗Browse all agents

About this agent

Project README

View on GitHub ↗

dsh-pentester

面向 DeepSeek Harness 的 PTES 渗透测试编排插件。

它是一个标准的 DSH bundle：package.json 声明 dsh.bundle.patch，cordis.patch.yml 将插件插入 profile。

能力

  • PTES 七阶段工作流
  • 自动 Engagement bootstrap（pentester_ensure_engagement，幂等）
  • Orchestrator + subagent Agent Run
  • Agent Template、Skills、MCP、Toolbox
  • Tool Broker（Scope、grant、AUTO / APPROVAL / DENY）
  • Docker 与 MCP 执行后端
  • Artifact / Evidence / Finding 持久化
  • 审批与 capability 控制
  • Native DSH 人机交互（ask_user_question）
  • Pentester Native UI（conversation.view）
  • 报告（report.md）

架构状态：docs/status.md。 AI / 贡献者规则：AGENTS.md。 文档索引：docs/README.md。 英文版 README：docs/README.en.md。

安装

dsh plugin --profile web add .
dsh --profile web --dump-config   # 查找 "# == dsh-pentester"
dsh web --profile web

加载成功会输出 [dsh-pentester] loaded。生产默认：devSeed=false。仅开发 fixture：dsh web --patch ./cordis.dev.patch.yml。

从 GitHub 安装（pnpm ≥10 在允许构建前会拒绝 prepare）：

dsh plugin --profile web add github:fb0sh/dsh-pentester
# 复制到 ~/.dsh/profiles/web/pnpm-workspace.yaml：
#   allowBuilds:
#     dsh-pentester: true
dsh plugin --profile web add github:fb0sh/dsh-pentester

卸载：dsh plugin --profile web remove dsh-pentester。

保持以下名称同步：package.json 的 name、src/index.ts 的 name、cordis.patch.yml 的 id / name。

开发

pnpm install
pnpm test
pnpm run check
pnpm run build

pnpm run check 即 tsc --noEmit 加 pnpm run build（host tsdown + client bundle）。

官方 Quickstart：https://deepseek-harness.github.io/deepseek-harness/guide/quickstart

License

MIT