**Windows** (PowerShell, x64 & arm64):```powershell
irm https://raw.githubusercontent.com/JoasASantos/NeuroSploit/main/install.ps1 | iex

## ⚡ 快速开始（60秒）```bash
# easiest path — just run it; the interactive session asks everything:
neurosploit

# or one-liner (subscription login, no API key needed):
neurosploit run http://testphp.vulnweb.com/ --subscription --model anthropic:claude-opus-4-8 -v

# white-box — review a source repository (SAST agents, file:line evidence):
git clone https://github.com/digininja/DVWA /tmp/DVWA
neurosploit whitebox /tmp/DVWA --subscription --model anthropic:claude-opus-4-8 -v

# grey-box — review the code AND exploit the running app together:
neurosploit greybox /tmp/DVWA --url http://localhost:8080/ --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 --mcp -v

# host / infra — Linux / Windows / Active Directory (SSH/Win creds in creds.yaml):
neurosploit host 10.0.0.10 --creds creds.yaml --subscription --model anthropic:claude-opus-4-8 -v

# 🛰  Mission Control TUI — live panels (header/feed/findings/targets) + a composer
#    you can type in WHILE the run streams (summary · pause · errors · notes):
neurosploit tui http://testphp.vulnweb.com/ --subscription --model anthropic:claude-opus-4-8 --mcp

- **5 步式任务向导** — 资产（模式 + 目标/仓库）→ 范围与认证（目标、重点、
  范围外）→ 线索（下文的 435 个代理面板）→ 模型与运行（提供商/模型选择器、
  API 密钥与订阅切换、投票/链深度/侦察）→ 审查。每次任务都会预先命名，
  因此运行记录在历史中可通过名称识别，而非仅靠原始目标字符串。
- **线索看板** — 全部 435 个代理自动分类（业务逻辑、访问控制失效、
  注入、LLM 应用、认证与会话、SSRF 与网络、云与基础设施……）。可切换单个
  线索或整个类别（部分选中时为半选状态），或使用 **全选 / 全部清除**——
  该操作遵循当前生效的搜索过滤器。全部关闭时，则交由 harness 自身
  基于侦察驱动的选择来挑选。
- **自定义线索 → 真实代理** — “+ 自定义线索”不只是添加文本提示：它会调用
  `claude` CLI（Opus，使用你的 Anthropic 订阅）生成真正的专家代理
  markdown 文件到 `agents_md/vulns/`，格式与所有内置代理一致，可立即置顶。
  若 Claude 不可用，则回退为纯文本的重点提示。
- **实时运行视图** — 阶段/进度通过 SSE 从 CLI 自身的 stdout 流式传输，包含发现
  结果表格，以及**生成式攻击路径链接**：节点/边图（根节点 = 目标，每个已确认
  发现对应一个节点，按攻击链阶段定位，当 harness 设置了 `chains_from` 时
  以其为边），而非平面列表——点击任意节点或行可查看完整发现详情，
  包括利用代理写入 `pocs/` 的任何 PoC 脚本。
- **认证与密钥**（统一菜单）— 目标认证头 + 用于 IDOR/BOLA/BFLA 测试的命名角色
  （为本次运行生成临时的 `creds.yaml`），以及各提供商的 API 密钥，仅保存在
  服务器进程内存中——绝不写入磁盘。
- 支持页面刷新：进行中的运行会重新连接到同一实时流，而不是
  重置回向导。

完整 API 参考：**[web/API.md](https://github.com/joasasantos/neurosploit/blob/HEAD/web/API.md)** · 快速开始：**[web/README.md](https://github.com/joasasantos/neurosploit/blob/HEAD/web/README.md)**。

---

## 🔌 集成（GitHub · GitLab · Jira）

将 NeuroSploit 接入你的 SDLC。可通过 REPL（`/integrations`）或 CLI
（`neurosploit integrations enable github|gitlab|jira`）切换。**令牌绝不会被存储**
——仅保存环境变量的*名称*；其值从你的环境中读取。```bash
export GITHUB_TOKEN=ghp_...                 # PAT with `repo` scope (private repos)
neurosploit integrations enable github

# Review a Pull Request's code (clones the PR head, white-box) and comment back:
neurosploit pr digininja/DVWA 42 --subscription --model anthropic:claude-opus-4-8 --comment

# Same, but BLOCK the merge on a confirmed critical: fails the check, sets a
# `neurosploit/security` commit status, and posts a REQUEST_CHANGES review.
neurosploit pr digininja/DVWA 42 --model anthropic:claude-opus-4-8 --comment --fail-on critical

# Watch a branch and re-review on every new commit:
neurosploit watch myorg/private-app --branch main --subscription --model anthropic:claude-opus-4-8

# Private GitLab repo (token-injected clone) — works in whitebox/greybox:
export GITLAB_TOKEN=glpat-... ; neurosploit integrations enable gitlab
neurosploit whitebox https://gitlab.com/myorg/private-svc --subscription --model anthropic:claude-opus-4-8

# Open a Jira card per finding (any engagement):
export [email protected] JIRA_API_TOKEN=...      # set base/project once: /integrations setup jira
neurosploit whitebox https://github.com/myorg/app --jira --subscription --model anthropic:claude-opus-4-8

I don't see any content after "INPUT:" in your message. There's nothing to translate. Could you resend the chunk with the Markdown content included?```bash
neurosploit host my-cloud-account --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 -v

请提供需要翻译的 Markdown 内容。```bash
neurosploit run https://app.example --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 -v

需要 Rust 工具链（`rustup`）。**推荐：在 Kali Linux 上运行**（或
Kali Docker 镜像），这样代理使用的攻击性工具已经就绪：```bash
docker run -it --rm kalilinux/kali-rolling
apt update && apt install -y curl nmap ffuf nodejs npm
# rustscan (faster port scan): cargo install rustscan   (or grab a release from GitHub)

或者直接运行它：```bash
# Black-box — subscription (no API key), Opus, browser via Playwright if present, verbose
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --subscription --model anthropic:claude-opus-4-8 --mcp -v

# Black-box — API keys, multi-model voting panel (1st finds, others adjudicate)
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --model anthropic:claude-opus-4-8 --model openai:gpt-5.1 --vote-n 3

# White-box — clone a vulnerable app and review its source
git clone https://github.com/digininja/DVWA /tmp/DVWA
./target/release/neurosploit whitebox /tmp/DVWA \
    --subscription --model anthropic:claude-opus-4-8 -v

# Offline pipeline self-test (no keys/login needed)
./target/release/neurosploit run http://testphp.vulnweb.com/ --offline

# Utilities
./target/release/neurosploit agents     # library counts
./target/release/neurosploit models      # providers & models
./target/release/neurosploit --help        # full help with examples

或者把密钥放进 `.env` 并 source 它（`cp .env.example .env`；编辑；`set -a; . ./.env; set +a`）。

**Provider → 环境变量 → 端点**（全部兼容 OpenAI）：

| `--model` 前缀 | 环境变量 | 基础 URL |
|------------------|---------|----------|
| `anthropic:` | `ANTHROPIC_API_KEY` | api.anthropic.com |
| `openai:` | `OPENAI_API_KEY` | api.openai.com |
| `gemini:` | `GEMINI_API_KEY` | generativelanguage.googleapis.com |
| `xai:` | `XAI_API_KEY` | api.x.ai |
| `nvidia_nim:` | `NVIDIA_NIM_API_KEY` | integrate.api.nvidia.com |
| `deepseek:` | `DEEPSEEK_API_KEY` | api.deepseek.com |
| `mistral:` | `MISTRAL_API_KEY` | api.mistral.ai |
| `qwen:` | `DASHSCOPE_API_KEY` | dashscope-intl.aliyuncs.com |
| `groq:` | `GROQ_API_KEY` | api.groq.com |
| `together:` | `TOGETHER_API_KEY` | api.together.xyz |
| `moonshot:` | `MOONSHOT_API_KEY` | api.moonshot.ai |
| `openrouter:` | `OPENROUTER_API_KEY` | openrouter.ai |
| `opencode:` | `OPENCODE_API_KEY` | opencode.ai/zen（OpenCode Zen 网关） |
| `nous:` | `NOUS_API_KEY` | inference-api.nousresearch.com（Hermes 4） |
| `litellm:` | `LITELLM_API_KEY` | 你的 LiteLLM 代理（`LITELLM_BASE_URL`，默认 localhost:4000） |
| `azure:` | `AZURE_OPENAI_API_KEY` | 你的 Azure OpenAI 资源（`AZURE_OPENAI_ENDPOINT`） |
| `ollama:` | _（无）_ | localhost:11434 |
| `llamacpp:` | _（无）_ | localhost:8080 |

运行 `./target/release/neurosploit models` 可查看完整的 provider/model 列表。

> **本地、无审查、仅限 CPU** — `ollama:` 和 `llamacpp:` 完全在你的机器上运行，
> 无需 API 密钥，数据也不会离开主机。`llamacpp:` 面向
> [`llama-server`](https://github.com/ggml-org/llama.cpp) OpenAI 兼容
> 端点（可用 `LLAMACPP_BASE_URL` 覆盖）；`model` 就是你加载的任何 gguf。
> 非常适合离线任务和无过滤的攻击性提示。

#### 2) 通过订阅（无需 API 密钥）

`--subscription` 直接使用你本地的 agentic-CLI 登录状态，而非 API 密钥 —
请先安装并登录其中一个 CLI：

| `--model` 前缀 | 使用的 CLI | 登录 |
|------------------|----------|-------|
| `anthropic:` | `claude`（Claude Code） | `claude` 然后 `/login` |
| `openai:` | `codex` | `codex` login |
| `gemini:` | `gemini` | `gemini` login |
| `xai:` | `grok` | `grok` login |
| `opencode:` | `opencode` | `opencode` auth login`（或 TUI 中的 `/connect`）— Zen/plan 账户 |
| `nous:` | `hermes` | `hermes` setup --portal` — Nous Portal OAuth |

`opencode:` 也像 anthropic/openai 一样支持 Playwright MCP（`--mcp`）。
`nous:` 则依靠 Hermes 自身内置的工具集（web/terminal/computer-use）— 它没有 CLI 级别的 MCP 钩子。```bash
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --subscription --model anthropic:claude-opus-4-8 --mcp -v

每次运行都会写入一个自包含的文件夹 `runs/ns-<ts>-<target>/`：

| 文件 | 内容 |
|------|----------|
| `status.json` | `running` → `complete` 并附带摘要 |
| `recon.json` / `recon.md` | 映射的攻击面 |
| `exploitation.md` | 每个代理的原始记录 |
| `findings.json` / `findings.md` | 已验证的发现（可供其他工具/AI 复用） |
| `report.html`, `report.typ`, `report.pdf` | 最终报告（PDF 通过 Typst 引擎生成） |

强化学习奖励存储（`data/rl_state_rs.json`）会影响代理
在后续运行中的选择。

## 代理库 — `agents_md/` (435)

| 类别 | 数量 | 用途 |
|----------|-------|---------|
| `vulns/` | 245 | 利用特定漏洞类别（Web/API） |
| `code/` | 78 | 白盒源代码（SAST）审查 |
| `ai/` | 30 | AI/LLM 红队测试、越狱、MCP 威胁 |
| `infra/` | 34 | 主机/云：Linux、Windows、AD、AWS/GCP/Azure |
| `meta/` | 23 | 编排器、验证器、评分器、报告器、RL |
| `chains/` | 13 | 多阶段攻击链（SQLi→RCE→LPE、SSRF→云等） |
| `recon/` | 12 | 信息收集 / 攻击面 |

每个代理都是自包含的 Markdown 操作手册（`## User Prompt` 方法论 +
`## System Prompt` 严格的反误报规则）。将新的 `.md` 放入
匹配的文件夹——或从 Web 控制台的“+ Custom lead”（见上文）生成一个——工具链
会自动识别；`neurosploit agents` 显示实时数量。

---

## 安全

仅限**授权**测试。代理被指示保持在范围内，绝不运行
破坏性/DoS 操作，并要求提供利用证明。你有责任
确保对任何目标拥有权限。

## 致谢

**Joas A Santos** & **Red Team Leaders**。

## 许可证

MIT。