elder-plinius/T3MP3ST

项目介绍

T3MP3ST 是一个可自托管的攻击性安全框架，用本机已有的 AI 编程代理或本地模型作为推理后端，外面套上一组按攻击阶段划分的算子：侦察、扫描、利用、横向移动、数据提取、持久化、指挥控制和分析，并按 MITRE ATT&CK 阶段组织。README 说明侦察是实时、有工具支撑的引擎；后续算子虽然跑同一套 ReAct 循环，但作为协同蜂群仍标记为实验性，部分高级模块只是 src/stubs/ 里的接口占位。适用对象是获得授权做安全测试、CTF、白盒源码审计和开源软件漏洞挖掘的人员，覆盖 Web 应用、代码和嵌入式/OT 等方向。

快速使用

无需 API Key 的最快路径是启动本地 War Room，并接入你已登录的编程代理：

npm install
npm run server        # War Room → http://127.0.0.1:3333/ui/

打开 War Room，在 Settings 中连接本地代理（Claude Code、Codex、Hermes、OpenCode 或 Oh My Pi），然后向 Op Admiral 用自然语言描述目标并启动任务。操作细节见快速开始和入门指南。

完全离线运行可先用 Ollama 拉起模型，再把框架指向 OpenAI 兼容服务：

ollama serve && ollama pull llama3
export TEMPEST_LOCAL_BASE_URL=http://localhost:11434/api
export TEMPEST_LOCAL_MODEL=llama3
npm run build
npx tempest   # 选择 "Change default provider" → local

也可以用 Docker 部署：复制 .env.example 为 .env，执行 docker compose up -d，再访问 http://localhost:3333/api/health 检查服务；容器只绑定 localhost。完整说明见 Docker 部署文档。

README 中的基准数字可以从仓库数据复算：

npm run verify-claims

测评口径

项目公布了 XBOW 104 题（黑盒 pass@1 90.1%）、Cybench（无提示 23/40）以及 10 个截断日期后的真实 CVE（单代理精确到文件/行/CWE 为 8/10，完整包 10/10 找到）等结果。README 明确这些数字来自单代理 ReAct 循环，不是八个算子的协同蜂群，蜂群的端到端利用尚未测评。基准章节给出了方法、白盒与黑盒分开报告的口径，以及复算说明。

使用约束

只能用于自己拥有或获得明确书面授权的系统测试；项目本身是攻击性工具，许可证声明不承担误用责任。默认开启的出站范围限制是框架层面的一道保护，不能替代交战规则。复用本地 Claude Code 会话默认关闭，因为恢复的会话可能保留供应商侧上下文，超出 Arsenal 的凭据边界；打开 T3MP3ST_TRUST_CLAUDE_SESSION=1 不等于获得强制沙箱。使用 Novita 等托管服务时，模型 ID、提示与上下文、生成结果和请求元数据会发送给该服务。本地代理响应可能较慢，可用 T3MP3ST_LOCAL_AGENT_TIMEOUT_MS、T3MP3ST_TASK_TIMEOUT_MS、T3MP3ST_GENERAL_TIMEOUT_MS 调整超时。项目采用 AGPL-3.0，分发或集成分支时需要考虑许可证义务。

已知限制

成熟部分集中在侦察；利用、横向、提取、持久化这几个算子仍是实验性，云、移动、身份/AD、二进制逆向等方向处于开发中或仅能复现已知漏洞。白盒源码解析也标记为实验性，部分语言解析不到代码块时会直接放行。投入实际任务前，应以 README 的状态表为准，区分已交付和路线图内容。

HotRepo 点评

2026-11-06，T3MP3ST 进入 TypeScript 日榜第 5 名，当天新增 238 Star。这只能说明它在某个 TypeScript 榜单上有过一次集中的单日关注，不能据此推断长期趋势。更值得跟踪的是协同蜂群能否从实验状态走到有测评支持的状态：README 自己把单代理成绩和蜂群表现分开写，这让它成为一个可以核验的具体里程碑，而不只是宣传话术。