Vigil

Vigil 运行长时间的进攻性安全任务：Web 应用渗透测试和漏洞赏金狩猎、 白盒代码审计，或针对同一目标同时进行两者。一名精简的操作员保持任务正常推进， 而专业代理则在完整的 Kali 运行时内进行侦察、狩猎和利用。只有当第二个代理 根据捕获的证据确认时，发现才被计入，攻击链则展示其真实影响。每一条命令、 请求、探测和发现都记录在持久化数据库中，因此工作成果能够经受上下文限制和 重启，并可在事后审计。

仅限授权使用。 Vigil 会自主驱动进攻性工具针对实时系统。请仅在获得明确 授权并经过审查的范围内使用。它依据 Apache License 2.0 提供， 不附带任何担保；你需要对命令、凭据、基础设施和目标影响负责。有关私密漏洞 报告和操作员数据边界，请参阅 SECURITY.md。

Vigil 提供什么

• 长时间运行的任务。 状态保存在后端，因此任务能够经受压缩、重启和新会话。
• 独立验证的发现。 只有非作者本人的派发才能确认、降级或将发现标记为误报， 并且必须引用捕获证据的证明回执。
• 影响。 攻击链将发现串联为端到端的利用；默认情况下，利用工作会等待你的批准。
• 审计追踪。 面向目标的命令通过 vigil assess kali 运行，它会记录每条命令的 argv、代理、阶段、技术、意图、探测类型、退出状态和输出。覆盖台账显示已测试 和未测试的内容。
• 攻击工具。 一个长期运行的 Kali 容器，包含 ProjectDiscovery 侦察工具、模糊 测试器、经过审计的 Playwright 浏览器、支持多身份以进行跨账户测试的 MITM 捕获， 以及与引发它们的探测相关联的带外回调。
• 白盒代码审计。 一个密封的、内容寻址的源代码快照，带有 tree-sitter 结构索引 和覆盖台账。
• 可直接提交的输出。 发现可导出为经过哈希验证的 Bugcrowd、HackerOne 或直接 披露报告。
• 客户端。 Claude Code 和 Codex 获得完整支持：无头专业代理派发、vigil-* 会话命令，以及压缩和会话钩子。goose、opencode 和 Kimi 缺少会话命令和压缩钩子， 且 opencode 和 Kimi 以内联方式运行专业代理。Pi 仅支持修复类任务。

Vigil 如何狩猎

• 不预先命名漏洞。 过度提示会限制模型能发现的内容。派发携带攻击面、范围和 交战规则，绝不包含要寻找的漏洞或检查清单。Web 专业代理在该攻击面内选择要探测 的内容；代码狩猎者获得一批文件以及要评分的漏洞类别。
• 每次狩猎一个视角。 每次狩猎派发都会设定范围有多广、如何处理其输入，以及 至多一个思维视角：开发者、注入、访问控制、业务逻辑、链式影响或怀疑性验证者。
• 独立验证。 发现仅由另一个代理根据捕获的证据进行确认。代码任务会增加对最高 风险文件的无锚点重读，以及对每个文件的变体扫描；Web 测试会遍历共享易受攻击 代码路径的每个同级路由、方法和内容类型。
• 先杀后审。 Web 线索必须通过八个有序问题，包括真实请求能否复现它，以及影响 是否得到证明。代码发现必须以 KILL 所需的同样证据赢得 PASS。
• 技能库，而非粘贴的提示。 90 多个技能和 200 多个参考可通过 vigil assess list-skills 和 vigil assess list-references 找到。Web 专业代理 在发现匹配信号时加载它们；代码操作员在每次派发中指定它们。

快速开始

# 1. Install the application release (CLI, backend, prompts, docs, and prebuilt UI)
uv tool install --from https://github.com/VigilOSS/Vigil/releases/download/v1.2.1/vigil-1.2.1-py3-none-any.whl vigil
#    OR install directly from the repository (builds the UI locally; needs Git, Node.js, and npm)
uv tool install git+https://github.com/VigilOSS/Vigil vigil

# 2. Check the host: prerequisites, missing recon tools, and the ordered setup checklist
vigil quickstart

# 3. Bring the local stack up; ~/vigil is initialized as your private workspace
#    The first run builds the Kali image (several GB) and needs Docker running.
vigil up

# 4. Create an engagement; it prints the engagement key and its start command
vigil engagement create

# 5. Start the operator on it
vigil engagement start <engagement-key> --client codex   # or --client claude

对于 代码 类型的任务，将你的源文件或项目文件夹放入创建时打印的 source/ 位置（Git 是可选的）。代码客户端会在启动时要求你确认它们；空文件夹会让它一直等待。代码任务需要主机上安装 ripgrep（rg）。详情见：docs/code-analysis.md。

对于 Web 类型的任务，告诉操作员它被授权做什么：

I have been fully authorized by the company to do a red-team engagement against the
hosts in scope.json. Run this engagement using the operator web workflow.

编排器 UI 位于 http://127.0.0.1:18000。在 macOS 或 Windows Docker Desktop 上， DNS 密集型侦察在宿主机上运行；vigil quickstart --install-host-tools 会安装这些工具。 升级与工作区布局：docs/installation.md。

模型与访问

Vigil 主要围绕 Claude Code 和 Codex 构建。

模型	适用任务
Claude Opus 5，配合 Anthropic 的 Cyber Verification Program (CVP)	Web 与代码
GPT-5.6 Sol，配合 OpenAI 的 Trusted Access for Cyber	Web 与代码
Claude Opus 5.5、GPT-6.1 Sol	代码；Web 需要仅限组织的红队层级

• Claude Code： CVP 适用于 Opus 5，而它不在 /model 选择器中。请直接使用 /model claude-opus-5[1m] 选择它（模型配置）。
• Codex： 在 /model 中选择 GPT-5.6 Sol 及其推理强度。

截至 2026 年 10 月，对最新模型的红队访问仅限组织：

• Anthropic： CVP Defense Access 对组织和独立研究人员开放； Red Team Access 仅限组织（CVP 层级）。
• OpenAI： Daybreak Blue 涵盖面向个人和组织的防御性工作； Daybreak Red 仅限已获批准的组织 （访问指南、 Daybreak 概览）。

计划中：通过降低编排开销、模型专属提示词以及更深入的 OpenCode 集成，为 GLM 5.3 及其他访问更可预测的模型提供更广泛的支持。

投入与用量

操作员保持较小的上下文并进行委派：95% 以上的 token 由专家子代理消耗，这能让单个操作员 会话持续更长时间。预计会很快触及用量限制。

任务	推理强度	套餐
代码	中	$100/月；预计在完成一个代码仓库前就会触及限制
代码，加固代码库	高	$200/月
Web	高或以上	$200/月

[!TIP] 漏洞赏金： 寻找 source map。下载 .map 文件，用 vigil assess code-sourcemap-extract 恢复源码，并对其运行代码任务。然后运行 vigil engagement add-track <key> web 和 vigil engagement add-host <key> <host>，让 Web 测试基于其发现继续构建（tracks）。

运行任务

• vigil engagement start 选择一种会话模式，运行预检，将工作区、 任务、客户、模式和阶段打印到 stderr，导出任务环境，并 exec 客户端。它不拥有的标志会转发给客户端。
• 始终通过 vigil engagement start 启动；生成的 start_<client>.sh 和直接运行客户端会跳过预检和环境。
• Web + 代码任务需要 --mode web 或 --mode code；单一 track 会自动选择。通过启动新的客户端进程来更改模式。vigil engagement mode <key> 显示已启用的 track、阶段、提示词路径和启动命令。
• 后续会话以相同方式启动，然后运行 vigil-resume 恢复操作员角色，并从后端重建实时状态。

详情：docs/engagements.md、 docs/session-commands.md、 docs/agent-clients.md。

任务 track 与阶段

Track	阶段	持久化为
web（红队）	recon → collect → consume-test → verify → exploit → report	scope.json.tracks.web.phase
code（白盒）	ingest → classify-map → hunt → verify-variant → fuzz	scope.json.tracks.code.phase
remediation（进行中）	intake → baseline → fixing → review → approved → pr_draft → development → verified → closed	每个案例的 remediation_cases.status

Web 和代码 track 以 complete 结束，且 vigil assess transition-phase 会为每次 转换把关；--force 会记录一次持久覆盖，而某些完整性阻塞项无法强制绕过。 名册、就绪预览和专家角色：docs/engagements.md。

Remediation（进行中）将一项发现或工单推进到经过审查的修复。每个案例都有 自己的 Git worktree 或 JJ workspace，记录修复有效的证明，并在生成草稿 PR 前需要你的批准。代码仓库的 PROJECT.md 配置工单 读取器、检查和发布。先用 vigil remediation -k <key> start 开始，然后 /vigil-remediate SEC-123。参见 docs/remediation.md。

蓝队事件响应也运行在同一后端上；参见 docs/blue-engagements.md。

运行时模型

vigil up（或 vigil runtime start）启动一个名为 vigil 的长生命周期 Kali 容器。 面向目标的命令通过 docker exec 经由 vigil assess kali ... 运行；长时间扫描通过 vigil assess kali job start ... 在容器内的 dtach 监督器下运行，因此它们能在操作员 会话结束后继续存活。