jiutouniao

agent
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 11 GitHub stars
Code Warn
  • network request — Outbound network request in browser-kit/selftest/mock_server.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

通用型实战型 AI 渗透测试智能体:多阶段头编排 + 人工审批 + 确定性治理门 + 证据链报告。仅供书面授权测试使用。 | AI agent platform for authorized penetration testing.

README.md

九头鸟(鬼車)· 通用型实战型 AI 渗透测试智能体

Jiutouniao — an open-source, full-lifecycle AI agent platform for authorized penetration testing: multi-head orchestration, human-in-the-loop approvals, deterministic governance gates, and evidence-chain reporting. For written-authorization engagements only.

当前版本 v5.3.9(单一事实源:server/internal/version/version.go;Web 顶栏与 /api/public/info 同源展示)。
八个阶段专家头 + 三个专项头 + 一个真头(主控),断一头、生一头——阶段间自动回环,直到拿下业务影响证明。(v1.4 起阶段 0 授权并入项目创建页、阶段 9 复测并入人工流程)

架构源自对 46 个开源安全 Agent(strix / pentagi / BreachWeave / VulnBot / hexstrike-ai 等)的共性提炼,流程严格映射《AI 渗透测试全流程图》(10 阶段 + 专项 A/B1/B2/C + 执行循环引擎)。
v1.1 深研国内外头部智能体后移植了 8 个优质功能模块(见下文「移植模块」)。

版本规则(遇十进一):修复级迭代递增末位,末位满 10 进位到前一位(2.9 → 3.0);每次发版必须递增版本常量并在 Web「更新记录」页补条目。完整版本历史见 CHANGELOG.md(与 Web「更新记录」页同源)。

⚠️ 合规声明

仅供书面授权的渗透测试与安全研究使用。 系统内置三道合规护栏(贯穿线三):

  1. 无授权不开工:项目创建时必须填写授权范围与 ROE,阶段 0 强制核验;
  2. 审批矩阵:只读侦察(L0)自动执行;写操作(L1)与利用/横向等高危动作(L2)必须人工在 Web 界面批准;破坏性命令(FORBIDDEN)直接拒绝;
  3. 一键熔断:任何时刻可中止全部自主操作、杀死进程、撤销待批工单、状态落盘;另支持 token 预算熔断;
  4. 确定性治理门(v5.3.1):Execution Profile 双运行模式(policies/execution-profiles.yaml 单一事实源)+ ROE 注册写门 + strict_scope 范围门,经 governanceGates 统一接入 run_command / run_async / shell_write / shell_open / hexstrike / install_tool 全部命令执行通道,在风险分级与审批之前确定性校验并留证。production_safe(默认)禁止植入 webshell/内存马/持久化/隧道/新增账号、上传可执行文件、批量导出数据、修改/删除目标数据、订单支付短信状态变更——只做存在性证明;isolated_lab 须创建项目时显式声明且勾选快照回滚确认,允许受控写(收尾快照恢复),两档均禁向公网分发测试产物与接触生产数据。被拦动作产生审批工单前即拦截,证据链可回溯。

Web 控制台(v2.1)

登录:账号 + 密码 + SVG 图形验证码(会话制 24h;验证码以描边路径渲染,标记中无明文字符)。默认 admin / jiutou@2026(config.json 或环境变量 ADMIN_USER/ADMIN_PASSWORD,部署后必改);API 直连另支持 auth_token。

视觉:专业安全控制台风格(紧凑侧边导航 + 顶栏项目切换),支持明暗双主题(右下角 🌙/☀️ 切换,持久化)。参考 PentAGI 工作区布局与国内安全控制台规范(信息密度、克制用色)。

功能板块(v2.0 重构后导航):

导航/入口 说明
📊 仪表盘 进度/发现/资产/覆盖/Token 成本统计 + 等级分布与覆盖图 + 最近活动
◉ 工作台 左:阶段流水线(含产出文件数/手动重跑);中:执行流·对话工作台(统一消息流 + 对话输入);右页签:审批/提问、子任务、工具调用、覆盖度、交付物
+ 新建项目 授权确认必勾 + 范围/ROE/审批策略/模型/专项
⚔ 漏洞 / ◍ 资产 / ⏱ 时间线 记忆库(证据链并入漏洞页展开查看)
📖 技能库 / 📜 提示词 / 📄 报告 / ⚙ 设置 / 🕘 更新记录 攻击剧本、头提示词全文、report.md 预览、模型与测绘 Key 直配、版本历史

实体文件产出与承接(防幻觉机制)

  • 强制产出:每个阶段收口时引擎校验工作区必须有本阶段新增文件,否则拒绝收口并提示补写(deliverables/<阶段>-<名称>.md,报告为 report.md);
  • 文件承接:下一阶段开工上下文自动携带工作区文件清单,头用 read_file 索取上一阶段产出,以文件内容为事实来源;list_files 工具可随时列出;
  • 同步落盘:发现/时间线除入库外同步写入交付物文件,保证文件自洽,防流程中断后上下文丢失。

移植模块(v1.1,源自对头部智能体的深研)

模块 来源 用法
覆盖度账本 strix(outcome 枚举/唯一键/证据强制)+ PentesterFlow(endpoint×param×vulnClass 三元组原地更新) 头工具 update_coverage;UI「覆盖度」Tab 看矩阵;报告含「安全向量/盲区」两章
技能库 strix(运行时 load_skill 双通道)+ PentesterFlow(SKILL.md 约定+关键词路由) skills/ 目录 109 个中文攻击剧本(v3.2.0 能力原语凑链、v3.3.0 内网横向/边界设备/AD 扩容/WebShell 落点);头按需 load_skill 注入,不撑爆上下文
hexstrike 工具桥 hexstrike-ai(/health、/api/command 原样兼容) 配置 hexstrike_url 后头工具 hexstrike_command 直调远端 150+ 安全工具(同样过审批矩阵)
Token/成本账本 deadend-cli(按 agent 分账)+ strix(双账)+ BoxPwnr(stats) 按阶段分账;UI 实时显示 token 与估算成本;max_project_tokens 超限自动熔断
记忆检索 pentagi/VulnBot RAG 的轻量版 头工具 search_memory 关键词扫描发现/资产/时间线
SARIF/JSON 导出 strix/shannon 结项自动产出 findings.json + findings.sarif 2.1.0,可直接导入安全平台
断点续跑 seclab-taskflow(ResultStore 快照思想) 流水线跳过 done 阶段;/stage/{id}/run 手动重跑任意阶段
Web 访问令牌 外网暴露安全护栏 auth_token 配置后全站 Basic/Bearer/?token= 认证
确定性循环检测(v3.2) ctf-agent(签名窗口 warn@3/break@5)+ cai(卡壳续跑) 归一化签名 12 轮滑窗计数,同签名第 3 次注入换路预警、第 5 次自动召导师评审——「换编号逐条枚举」式空转引擎级拦截
能力原语凑链(v3.2) CyberStrikeAI(能力原语 + 状态空间搜索) 技能 capability-primitive-search:低危发现标注 READ/WRITE/EXEC/SSRF/SQLI/AUTHZ/CRED 原语,按 RCE 六等式凑链,正向扩展/反向回推找缺口
输出治理三层(v3.3) strix(溢出落盘)+ pentagi/HackSynth(窗口压缩/摘要即状态) >16KB 溢出落盘 .tool-output/ + head/tail 智截断 + 消息链预算压缩(确定性零 LLM 成本)——治 98% 输入占比与注意力稀释
项目黑板(v3.3) CyberStrikeAI(pentest-blackboard) upsert_fact 幂等事实账本(confirmed/tentative/deprecated 三态,负结果落库防重复试错),黑板 Top25 随上下文包自动注入
战利品库(v3.3) BoxPwnr(flag 库)+ EVA(verification 状态) record_loot 掩码登记凭据/票据/flag(不存明文),S5/S6 横向复用第一入口
持久交互会话(v3.3) strix/CAI/BoxPwnr(PTY 会话) shell_open/write/read/close:stdin 管道+增量读+进程组清理,mysql/ssh/nc 类多轮交互不再拆轮次
确定性质量门(v3.4) T3MP3ST(REFUTE 引证校验) 反思门 LLM 不可用时引擎硬校验兜底:高危确证必须引用 EV-/evidence/ 证据,覆盖矩阵非空
攻击路径缝合器(v3.4) communitytools(attack-path-stitcher) 结项自动把黑板 facts(links=边)+ 战利品(凭据复用边)缝合成 attack-graph.dot/md,单点发现升维影响链
错误自愈(v3.4) hexstrike-ai(错误分类重试) run_command 失败按特征给处置建议(超时→后台化/403→WAF 分型/DNS→核范围),stderr 独立捕获
组织级教训库(v3.4) BoxPwnr(失败后分析注入) record_lesson 跨项目脱敏经验(引擎强校验去标识),最近 8 条随上下文注入,跨项目零迁移清零
后台任务持久化(v3.4) 断点续跑强化 run_async 元数据落盘 sidecar,引擎重启后 poll_async 恢复状态与日志尾部
技能进化评测环(v3.5) 评测体系与平台分离(v4.7.1):平台仅含通用判分器 scripts/eval_run.py;靶标/埋点清单/对抗模拟器在外部评测扩展包(独立私有发行物,JTN_EVALPACK_PATH 加载)——部署包/镜像零靶场信息
验证码本地 OCR(v3.5) 实证失败模式 #4 browser_login --captcha-ocr(可选档):ddddocr 识别自动填入,失败回退人工读码,默认关闭
阶段内并行扇出(v3.6) strix agents_graph / CAI spawn_subagent/poll_subagents:独立测试单元派给 ≤3 路受控子代理并行(独立消息链、共享黑板/审批),收口前强制收结果——攻「严格串行+轮次预算不足」的吞吐瓶颈
人工屏障超时(v3.4) 实证失败模式修正 barrier_timeout_sec(默认 30min):审批/提问不再无限挂起流水线,超时工单标 expired

评测环(make eval)

make eval   # 起本地靶场(127.0.0.1:18080) → 跑完整项目 → 按预期清单判分 → eval/results/ 产出报告

前置:容器就绪 + config.json 配置真实 LLM 与 auth_token + 外部评测扩展包(JTN_EVALPACK_PATH,v4.7.1 起独立私有发行物——靶标/埋点/预期清单不在平台内)。判分三指标:自述面召回(覆盖下限)+ 清单外盲挖(隐藏项命中=0day 能力度量)+ 匿名高危召回(无凭证高危能力度量);未命中清单是技能库迭代的直接输入。

外网访问

config.json 设置 auth_token 后监听 0.0.0.0;两种暴露方式:

# 方式一:Cloudflare 快速隧道(无需域名/账号,WebSocket 支持)
cloudflared tunnel --url http://localhost:8787
# 输出形如 https://xxx-yyy.trycloudflare.com —— 访问时输入令牌(Basic 认证任意用户名,密码=auth_token)

# 方式二:自有服务器 frp/nginx 反代 —— 反向代理到 8787 即可,务必保留令牌认证

架构

                         ┌─────────────────────────────┐
                         │      Web 控制台 (中文)        │
                         │ 项目看板·执行流·审批队列·报告  │
                         └──────────────┬──────────────┘
                                  WebSocket + REST
┌────────────────────────────────────────┼─────────────────────────────────────┐
│  Go 核心引擎(并发:goroutine 池 / 单二进制)                                     │
│                                        ▼                                      │
│  ┌──────────┐   ┌───────────────────────────────┐   ┌──────────────────────┐ │
│  │ 主控·真头 │──▶│ 执行循环(流程图 E 引擎 9 步)    │──▶│ 审批矩阵 + 熔断器      │ │
│  └──────────┘   │ 决策→分级→审批→执行→观察→       │   └──────────────────────┘ │
│                 │ 反思→记忆→停止                  │   ┌──────────────────────┐ │
│                 └───────────────┬───────────────┘──▶│ 工具执行器(沙箱+留证)  │ │
│                                 ▼                   └──────────────────────┘ │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │ 八个阶段头 + 三个专项头(中文提示词 = 方法论编码)                          │  │
│  │ s1资产 s2侦察 s3威胁建模 s4漏洞发现 → [专项A/B1/B2] →                    │  │
│  │ s5利用 s6后渗透 s7收尾 s8报告              (↺ 阶段4↔5 新线索回环)      │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                 ▼                                            │
│  bbolt 记忆库:项目状态 / 资产 / 发现 / 攻击时间线 / 审批 / 证据链                │
└─────────────────────────────────────────────────────────────────────────────┘
                                 ▼
                  LLM(OpenAI 兼容:官方 API / 中转站 / Ollama / vLLM)

目录结构

jiutouniao/
├── server/              # Go 核心引擎(vendor 内置,go build 离线自洽)
│   ├── main.go
│   ├── cmd/             # 运维子命令(hashpass/cleanup-projects/wipe 等)
│   └── internal/
│       ├── config/      # 配置与默认护栏规则
│       ├── llm/         # OpenAI/Anthropic 双协议客户端 + Mock(演示模式)
│       ├── store/       # bbolt 持久化(项目/发现/资产/时间线/审批/证据)
│       ├── tools/       # 命令执行器:风险分级、限流、超时、熔断、路径沙箱
│       ├── engine/      # 编排器:流水线、执行循环、审批矩阵、头注册、治理门
│       ├── events/      # 事件总线(WebSocket 推送)
│       └── web/         # REST API + WS + 静态托管
├── web-app/             # Web 控制台源码(Vue3 + Vite,多语言/双主题/ECharts)
├── web/                 # 前端构建产物(make web 或 Docker 构建生成,不入库)
├── heads/               # 12 个头的提示词(方法论编码,可直接编辑调优)
│   ├── main.md          # 主控(真头)
│   ├── s1.md ... s8.md  # 八个阶段专家头(s0/s9 已并入项目创建页与人工流程)
│   └── specA/B1/B2.md   # 专项:AI(LLM)目标 / APP双链 / 小程序
├── skills/              # 中文攻击剧本库(manifest.json 机器可读清单)
├── policies/            # Execution Profile / 覆盖契约(治理门单一事实源)
├── prompts/loop-core.md # 执行循环宪法(9 步循环 + 红线,注入每个头)
├── browser-kit/         # 真实浏览器认证套件(Playwright + 系统 Chromium)
├── tools-extra/         # 自研工具脚本(差分矩阵/盲注裁决/原语图等)+ vendored sqlmap(GPL-2.0)
├── eval/                # 评测门(判分器/质量门/ROE 校验;靶标在外部评测扩展包)
├── scripts/             # 打包/发版核查/敏感扫描/评测判分等工程化脚本
├── projects/            # 运行时项目工作区(交付物、PoC、report.md,不入库)
├── config.example.json  # 配置模板(复制为 config.json 使用)
└── docs/                # 方法论文档映射 + 脱敏实战案例

仓库与社区

快速开始

# 1. 构建(需 Go 1.23+;本地运行还需构建前端,Docker 部署可跳过 make web)
make build
make web        # web-app(Vue3+Vite) → web/(首次本地运行必需)

# 2. 配置 LLM:编辑 config.json
#    - 真实模型:填 base_url / api_key / model,并把 "mock": false
#      (支持任何 OpenAI 兼容端点:官方、中转站、Ollama http://localhost:11434/v1 等)
#    - 无 Key 演示:保持 "mock": true

# 3. 启动
make run        # 默认 http://localhost:8787

# 4. 打开浏览器 → 新建项目(填目标/授权范围/ROE,勾选专项)→ ▶ 启动全流程
#    Web 界面:阶段流水线、实时执行流、待审批工单(批准/拒绝)、发现/资产/时间线/证据/报告

推荐 Docker 部署(Kali 全量工具链开箱即用),见下文「Docker 部署」;本地 make run 模式下安全工具按各阶段头的降级指引执行。

模型接入(OpenAI / Anthropic 双协议)

切换边界(v2.7 A8):多模型自动切换仅适用于供应商拒绝类错误(HTTP 4xx / 内容风控,如 Content Exists Risk)——网络超时/连接失败走同模型重试,不切换模型。接管模型锁定至项目结束并全量留痕。

config.json → llm.protocol:

{
  "protocol": "openai",     // "openai"(官方/中转站/Ollama/火山方舟等兼容网关)| "anthropic"(Claude 官方/兼容网关)
  "base_url": "https://ark.cn-beijing.volces.com/api/coding/v3",
  "api_key": "ark-xxx",
  "model": "glm-5.3-flash",
  "max_tokens": 8192,
  "mock": false
}
  • OpenAI 协议:POST {base_url}/chat/completions,Bearer 鉴权;tool_calls 自动按严格嵌套格式打包/解包(兼容火山方舟等严格校验网关)
  • Anthropic 协议:POST {base_url}/v1/messages,x-api-key + anthropic-version 头;system 抽离、tool_use/tool_result 块自动转换
  • 内置工程化保障:请求级重试(TLS 抖动/5xx/429 指数退避)、IPv4 优先连接、LLM 错误落盘(stdout + 阶段摘要)
  • 环境变量覆盖:LLM_PROTOCOL / LLM_BASE_URL / LLM_API_KEY / LLM_MODEL
  • 已验证:火山方舟 glm-5.3-flash(OpenAI 协议,真实渗透阶段跑通);Anthropic 协议经协议桩端到端验证(tool_use↔tool_result 配对)

新机部署 Quickstart(v5.1.2:部署包收包方视角,此前缺失)

从 dist/jiutouniao_v<版本>_部署包.zip 在一台全新 Linux(amd64)机器上部署:

# 0. 前置:Docker Engine 24+ 与 compose v2 插件;磁盘 ≥60GB 空闲(镜像 ~27GB,构建期峰值更高);
#    联网(拉底座镜像 + github clone×3 + go install×4;受限网络见下「代理」);bash/unzip/python3
# 1. 解压(zip 含 UTF-8 中文名与符号链接——用 unzip 或 python3 -m zipfile,勿用不保留 symlink 的工具)
unzip jiutouniao_v<版本>_部署包.zip -d jiutouniao && cd jiutouniao   # 包名以 dist/ 实际产物为准(当前 v5.1.4)
# 2. 创建配置(【致命步骤】包内无 config.json,缺失则容器启动即崩溃循环):
cp config.example.json config.json
#    必填:llm.api_key / llm.base_url / llm.model(OpenAI 兼容或 Anthropic 协议均可);
#    必改:admin_password(默认 admin/jiutou@2026 为公开文档化默认值);auth_token 会话令牌
# 3. 构建并启动(首次构建 15-40 分钟:拉 24GB 底座 + 编译 + 语料克隆,失败重试 3 次内自动恢复)
docker compose up -d --build
# 4. 验收:curl http://127.0.0.1:8787/api/public/info 应返回 {"version":"<版本>"...}
#    浏览器打开 http://127.0.0.1:8787 → admin + 你设置的密码 → 新建项目(目标/授权范围/ROE)→ ▶ 启动
# 5. 升级:替换 heads/ skills/ prompts/ 三个目录即热生效(bind-mount);引擎/工具/web 更新需重建镜像;
#    升级前备份 projects/(含记忆库与 secret.key)

⚠ 安全提示(v5.1.2a):8787 端口默认绑定全网卡(0.0.0.0,兼容远程访问场景)且存在公开文档化的默认口令——部署后必改 admin_password;加固方式:.env 里设 JT_WEB_BIND=127.0.0.1(仅本机)或前置反代+TLS;公网暴露(tunnel profile)仅限测试。资源限制/healthcheck 默认未配置,生产部署建议自行加 mem_limit/cpus。

已知边界(v5.2.0 更新):底座 vxcontrol/kali-linux 与 wheelhouse(cp314 wheel)、/opt/venv 路径强耦合——更换底座需同步重建 wheelhouse;RUNTIME_BASE 切最小底座当前不可用(终检强制 chromium/interactsh-client,未适配)。供应链已锁定(v5.2.0):三阶段基础镜像 digest、4 个 go 工具(nuclei/subfinder/httpx/ffuf)版本、3 个语料仓库(nuclei-templates/PayloadsAllTheThings/wxappUnpacker)commit sha——上游漂移时构建 FATAL 拒绝产出,升级需人工更新 Dockerfile 内 PIN。离线边界:构建期需联网(拉底座+编译工具+克隆语料);构建完成后运行时离线可用(install_tool/测绘 API 等按需联网项除外);wheelhouse 仅覆盖 playwright 依赖栈。许可:主项目 MIT;tools-extra/sqlmap 为 GPL-2.0 vendored 上游(随包分发遵循其许可),商用分发请自行评估合规。

Docker 部署(推荐)

v2.5 起运行时基础系统为 Kali GNU/Linux Rolling(2026.3):默认全量底座开箱即得
nmap / sqlmap / nikto / hydra / gobuster / john / hashcat / masscan / whatweb / dirb / wfuzz /
ffuf / subfinder / httpx / nuclei / amass / dig / whois 等全链工具;缺什么装什么——
Kali 仓库数千款渗透工具均可经 install_tool(apt 官方源)或 run_command 的 apt-get install 现场安装。

# 构建 + 启动(数据持久化在宿主机 ./projects,heads/skills/prompts 卷挂载可热编辑)
docker compose up -d --build

# 验证
docker compose ps
curl "http://localhost:8787/api/projects?token=<auth_token>"

# 环境变量覆盖 config.json(无需改文件):.env 或直接导出
#   AUTH_TOKEN / LLM_MOCK / LLM_BASE_URL / LLM_API_KEY / LLM_MODEL /
#   HEXSTRIKE_URL / MAX_PROJECT_TOKENS / PRICE_IN / PRICE_OUT /
#   TOOL_PROXY(工具安装代理,默认空=直连;受限网络时按需注入)
AUTH_TOKEN=你的令牌 LLM_MOCK=false LLM_BASE_URL=https://api.x.com/v1 \
LLM_API_KEY=sk-xxx LLM_MODEL=gpt-4o docker compose up -d

# 外网访问(可选):自动获得 trycloudflare.com 公网地址
docker compose --profile tunnel up -d
docker compose logs tunnel        # 查看公网 URL(带 auth_token 访问)

# hexstrike-ai 工具网关(可选,需本地有 ../Agent/hexstrike-ai 源码)
docker compose --profile hexstrike up -d
# 然后在 .env 设置 HEXSTRIKE_URL=http://hexstrike:9023 后重启

代理接入(v2.6 方针:代理仅限工具下载与容器构建,其余流量一律直连)

环节 变量 默认值 说明
构建(npm/go/apt) HTTP_PROXY / HTTPS_PROXY(build-arg) 空=直连 国内源已内置(goproxy.cn/npmmirror/apt 多镜像,直连更快);受限网络时经 docker-compose.override.yml 或 build-arg 注入
运行时工具安装(install_tool 的 apt/pip/git、智能体外网下载) TOOL_PROXY(容器环境) 空=直连 仅作用于下载类命令;测试环境经 docker-compose.override.yml 注入
LLM 出口 LLM_PROXY(容器环境) 空=直连 默认直连;如需经代理:LLM_PROXY=http://… docker compose up -d
靶机测试流量 — 引擎级强制直连 执行器剥离子命令的标准代理环境变量(TOOL_PROXY 保留,智能体可显式 env http_proxy=$TOOL_PROXY <命令> 引用),与 LLM/工具安装路径彻底解耦

部署包纪律:config.json(密钥/口令)、projects/(运行数据)、docker-compose.override.yml(环境专属地址)等一律不进包——make pack 自动排除,详见 scripts/pack.py。

底座切换:RUNTIME_BASE=kalilinux/kali-rolling:latest docker compose build 换官方最小底座
(约 130MB,构建期从 kali-rolling 官方源装齐工具,需构建期网络)。

安全说明:容器以 root 运行(nmap SYN 扫描等需要特权),建议仅在内网/受控环境部署;
公网暴露务必设置强 auth_token,并尽量走隧道 + HTTPS。

使用真实模型跑一次侦察

{
  "llm": { "base_url": "https://你的端点/v1", "api_key": "sk-...", "model": "gpt-4o", "mock": false },
  "engine": { "max_stage_iterations": 40, "max_concurrent_exec": 4, "command_timeout_sec": 300 }
}

新建项目 → 启动后九头鸟将依序执行 s1→s8(专项按目标类型插入):nmap/httpx/nuclei 等工具由各阶段头按需调用(本机未安装的工具会给出安装指引或降级方案),所有命令先分级、高危等你在界面批准,全程证据入库,阶段 8 自动产出 projects/<项目>/report.md。

审批矩阵(默认规则,config.json 可调)

等级 含义 示例 处置
L0 只读侦察 nmap -sV、cat、curl -s、dig 自动执行
L1 写操作/扫描载荷 nuclei、wget、apt install 人工批准
L2 利用/横向/提权 sqlmap --dump、exploit、自研 PoC 执行 人工批准
FORBIDDEN 破坏性/DoS rm -rf /、mkfs、iptables -F 直接拒绝

API 一览

POST /api/projects                     # 创建项目 {name,target,scope,roe,specializations:["A","B1","B2"]}
GET  /api/projects                     # 项目列表
GET  /api/projects/{id}                # 详情(状态/发现/资产/时间线/审批/证据)
POST /api/projects/{id}/start          # 启动全流程流水线
POST /api/projects/{id}/stage/{s}/run  # 手动运行/重跑某阶段(s1..s8, specA, specB1, specB2)
POST /api/projects/{id}/kill           # ⛔ 一键熔断
POST /api/approvals/{id}/decide        # 审批决策 {approve:true|false}
GET  /api/projects/{id}/report         # 获取 report.md
GET  /ws?project={id}                  # 实时事件流

与流程图的模块映射

流程图 九头鸟模块
主流程 1-8 heads/s1.md ... s8.md(进入条件/分步动作/交付物/红线全量编码)
专项 A(LLM 目标,A1-A11) heads/specA.md(OWASP LLM Top10 + MITRE ATLAS 映射)
专项 B1(APP 静态+动态双链) heads/specB1.md(jadx 静态链 + Frida 动态链)
专项 B2(小程序 W1-W6) heads/specB2.md(解包→密钥审计→逻辑推理→接口/云侧)
引擎 E(执行循环 + 护栏) prompts/loop-core.md + internal/engine(9 步循环、审批矩阵、熔断)
贯穿线一(全程记录) 证据链 EvidenceRecord + 攻击时间线
贯穿线二(人机协作) Web 审批队列 + 人工批准点(◆)
贯穿线三(合规红线) FORBIDDEN 禁令 + ROE 核验 + 一键熔断

专项 C(免杀对抗)按流程图要求默认禁用、不予实现——仅限书面授权红队且需 ROE 专项允许,属受限支线。

二次开发指引

  • 调优某个头的打法:直接改 heads/*.md(纯中文提示词,改完重启生效)。
  • 换模型:改 config.json;任何 OpenAI 兼容端点均可。
  • 加工具:无需注册——智能体可执行任意命令并自写 PoC;建议把新的风险特征加进 config.json 的护栏正则。
  • 升级存储:internal/store 当前为 bbolt(单机并发安全);换 SQLite/Postgres 只需实现同名 CRUD。
  • 自主编排:heads/main.md 预留真头自主决策扩展点(当前流水线由引擎按固定顺序驱动 + 回环)。

测试

make test   # 单元测试:风险分级、路径沙箱、审批批准/拒绝/熔断、头注册与流水线

E2E 验证(Mock 模式):创建项目→启动→11 个阶段全部 done→证据链落库→阶段 8 产出 report.md。

开源许可

本项目以 MIT License 发布(见 LICENSE)。以本项目方式使用时请遵守目标所在司法辖区的法律法规——本项目仅面向书面授权的安全测试场景(合规声明见文首)。

第三方组件声明

组件 许可 引入方式
vxcontrol/kali-linux 底座 MIT Docker 运行时镜像(含 Kali 工具链,各自许可以其上游为准)
sqlmap(tools-extra/sqlmap,仅底座缺 sqlmap 时回退使用) GPL-2.0(上游自带) 独立程序、子进程调用(独立程序边界,不与本项目代码链接)
subfinder/httpx/nuclei/ffuf/interactsh-client MIT(projectdiscovery/ffuf 上游) 构建期 go install,二进制随镜像分发
wxappUnpacker(rtcatc fork) 随上游 构建期 git clone
Playwright(Python 绑定) Apache-2.0 wheel 固化(wheelhouse/),驱动系统 Chromium
Vue/Vite 及 npm 依赖 各自上游 随 web-app 构建

各组件版权归其各自权利人所有;如需商用分发,请逐一核对其上游许可条款。

Reviews (0)

No results found