sapper-v2

项目简介

sapper-v2 是面向自主渗透测试的多智能体编排框架，而非单一智能体。它让 AI 指挥官读取局面、做出决策并派发任务，同时由将军、侦察兵和士兵等角色在 tmux 会话中并行工作，零策略看门狗负责维持运行。知识会写入分层事实—意图图，并在单个智能体会话结束后继续保留。README 说明每个角色背后的智能体与模型均可替换，且项目面向竞赛场景设计。

核心功能

• 角色分工包括指挥官、将军、侦察兵和士兵，并配有看门狗进程；指挥官不亲自执行攻击。
• 分层事实—意图图以标题、摘要和证据文档三层组织共享记忆并控制上下文。
• 创建、语言和历史三项能力分别通过 tmux 启动新的 AI 会话、向彼此的输入框输入内容，以及将知识持久化到图中。
• 模型分层为指挥官和将军使用 GLM-5.3，士兵和侦察兵使用 DeepSeek V4.1 Flash。
• 每个角色可替换智能体命令行与模型，角色构成在作战条令中定义。
• 项目报告了自发涌现的角色与实践，包括信号兵、绩效审查和继承经验。

适用场景

• 适用于腾讯智能攻防挑战赛等竞赛 CTF 场景。
• 适用于由指挥官协调多个并行智能体、针对目标开展经授权的渗透测试活动。
• 可复刻项目并替换竞赛条令，用于办公、科研或工程等其他长周期协作工作。
• 也可基于 nvwabase 基础构建具备创建、语言和历史能力的通用多智能体工作。

快速开始

• 运行 bash install.sh 以建立 sapper CLI 的符号链接；该安装仅使用标准库且无依赖。
• 运行 sapper setup 并传入目标与 --agents 参数，以初始化看板与待办前沿。
• 运行 sapper status 查看看板与前沿。
• 若需完整集群，可用 docker build -f docker/Dockerfile.commander -t sapper:latest . 构建，或从 v18-champion 发布包加载预构建镜像。

部署与要求

• 完整集群需要 Docker，可选择从 docker/Dockerfile.commander 构建，或加载预构建镜像（约 1.2GB，包含完整 Kali 工具链、sapper 与离线知识库）。
• 模型网关、密钥池和预算通过环境变量配置，详见 docker/ENV.md。
• sapper CLI 安装仅使用标准库且无依赖。
• tmux 用于在面板中运行 AI 会话。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。