Proteus · 千面 — 多模式渗透测试 Agent

一个内核，千种面孔。 Proteus（普罗透斯）：希腊神话中的海上老人，可随心变换任意形态——多模式切换的完美隐喻。 千面：一个内核，适配千种作战场景。

预览

架构总览

30 秒演示（真实作战记录渲染：pentest-standard 侦察任务 + ctf-crypto 编码链解题，含权限闸门拦截与证据链收口）

仓库命名：proteus-agent（GitHub xiabai2008/proteus-agent，命名空间已核验可用，2026-09-17）

Related MCP server: Pentester-MCP

快速开始

0）环境准备：复制 .env.example 为 .env，填入 LLM 端点三键（PENTEST_LLM_BASE_URL / API_KEY / MODEL，OpenAI 兼容）与本机路径（PENTEST_WS / PENTEST_TOOLS / PENTEST_PY312 / PENTEST_G07_ROOT，不填则对应外部工具自动降级跳过）。安装依赖：pip install -r requirements.txt。

入口一 · CLI（日常主用）

# 起一个授权本地靶子
python examples/target.py --port 8080

# 渗透模式侦察任务（真 LLM 决策 + 证据链 + 反幻觉）
python -m penagent run --mode pentest-standard --target http://127.0.0.1:8080 \
    --objective "识别开放端口、Web 技术栈、敏感路径与信息泄漏"

# CTF 模式解题
python -m penagent run --mode ctf-crypto --target data/eval-ctf/encoding_chain.txt \
    --objective "解出 flag"

# 任务后复盘 → 技能沉淀（越用越准的关键一步）
python -m penagent reflect <mission_id>

# 查看经验库 / 作战记录 / 证据链校验 / 技能盲区
python -m penagent skills && python -m penagent missions
python -m penagent verify && python -m penagent gaps

入口二 · Web 控制台（模式选择 / 实时步骤流 / 证据链视图）

python web/server.py            # 默认 http://127.0.0.1:8770

入口三 · 挂到 deepseek-harness（复用沙箱 / 审批 / AgentTeams）

# preset 已在 dsh/.agent-presets/proteus，按 docs/DSH宿主接入指南.md 安装后：
dsh  # 会话内直接用自然语言下任务，工具以 mcp__proteus__* 出现

入口四 · 作为 MCP Server 被任意 LLM 客户端调用（Claude Code / Codex / OpenCode…）

python -m penagent mcp --targets 127.0.0.1

模式清单见 modes/（pentest-standard / ctf-web / ctf-crypto），知识检索（seckb 知识库）与外部工具（RayScan / Chameleon）按 penagent/mcp_servers.json 声明自动接入。

一、项目定位

支持多模式切换的渗透测试 Agent：同一套内核，通过 ModeProfile（模式档案）在常规渗透测试模式、CTF 比赛模式等场景之间机制性切换——工具白名单、参数冻结、权限档位、预算策略、成功判定器全部随模式生效。

主推架构（方案 C 为主线 + 方案 D 为宿主层）：

宿主层（双入口，能力同一套）
  入口一 · 自有 CLI / Python SDK（独立运行，可进 CI）
  入口二 · DSH agent-preset 插件（白拿沙箱 / 审批 / Web UI）
        │
模式层 · ModeProfile（一等公民，本次新建的核心）
  persona / capability / permission / budget / scope / verifier / skills / sandbox
        │
内核层 · XPentest（Python 7210 行 · 64 测试，已有）
  ReAct 决策循环 · 证据链反幻觉 · 记忆与技能进化
        │
工具层 · MCP 统一注册（新增能力不改内核）
  RayScan · Chameleon · poxiao · ruoyi-scan · LogicHunt · 本地 70+ 二进制
        │
环境层 · 隔离与边界（模式可覆盖）
  Docker/WSL2 · 目标白名单硬校验 · 网络出口策略

两条硬规则：

1. 模式约束必须在工具执行前机制性生效（如 safe 模式下 nuclei: null 直接禁用），不能只写在提示词里靠模型自觉。

2. 可插拔 Verifier（成功判定器）是 CTF 与渗透模式的分水岭：CTF 挂 flag_regex，渗透挂 evidence_chain。

二、为什么叫 Proteus · 千面

避开"破晓"（已被 poxiao 与 dawnforge-pentest 同时占用，本就存在撞名）。

三、路线决策（2026-09-17 定稿）

依据你自己定下的原则（《红队平台自建方案》）：手脚不依赖大脑也能跑——dsh 挂了，CLI 照常能用。

四、目录导航

proteus-agent/
├── README.md                                  本文件（项目主页）
├── docs/                                      现行文档（调研与设计基线）
│   ├── 渗透测试Agent调研报告-多模式切换.md       主报告：竞品/资产/路线/方案（2026-09-17）
│   ├── 渗透测试Agent调研报告-多模式切换.html     同内容浅色阅读版
│   ├── 个人渗透Agent产品设计.md                 XPentest 设计基线（LLM 决策第一原则/进化闭环）
│   └── 红队平台自建方案-SRC渗透流水线.md         "手脚与大脑分层"架构原则出处
├── archive/                                   2026-08 旧版调研（已被 09 版收敛取代）
│   ├── 网安agent渗透调研报告-团队版.md
│   ├── 网安agent渗透调研报告.md
│   ├── _research_t1_output.md
│   └── _research-pentest-agent.cjs
└── tools/
    └── md2html.py                             MD 转单文件 HTML（浅色主题），改文档后重新生成阅读版

代码资产（保持原位，不搬迁——路径被 opencode.json 与 external_tools.json 引用，动了会断）：

代码迁入本仓库的时机：等方案 C 阶段一动工（ModeProfile 落地）再把内核 fork 进来独立成仓；现在搬会断 10-pentest-agent 与工作区 git、opencode.json 的关联。

五、当前状态（2026-09-18）

环境变量约定（可移植性）：本仓库入库文件不含任何本机绝对路径。配置 JSON 里写 ${VAR} 占位符，真实路径放在不入库的 .env（模板见 .env.example），由 penagent/envcfg.py 统一装载与展开：

未设置时对应工具自动"未注册/跳过"，不崩溃——CI（无本地工具与靶场）即按此降级运行。

三阶段已全部完成并通过真机验证：

测试：带 torch 204 passed；无 torch 165 passed + 3 skipped（RL 进化链路为可选依赖）。双解释器独立复跑核实。

三链路真机实测（记录见 docs/）：DSH 宿主（preset 发现 / stdio 拉起 / mcp-client 真实调用）· Web 真内核（LLM 决策 + SSE 步骤流 + 证据链 integrity）· RL 进化（步数 6.0→3.0，-50%；闭环评测 Q 层 -39% / PPO 层 -42%）。

安全姿态：PolicyGate 由 ToolRegistry 持有，目标白名单 + 高危授权在 ReAct / MCP / Web 全入口机制性生效；MCP 失败语义修正（isError）；ctf-* 模式的脚本执行强制沙箱档位，无容器环境拒绝而非裸跑。

下一步：端到端实战演练（CTF 三题 + 授权靶场渗透流程）· RayScan / Chameleon MCP 联调 · 竞赛 / 毕设叙事材料。

安全声明：仅用于授权范围内的受控安全实验（自有靶机 / CTF 靶场 / 隔离容器）。目标白名单硬校验 + 高危操作审批 + 全动作证据链留痕是不可妥协的前提。严禁在未授权系统上运行。