Vigilis

👁️ Vigilis

AI 编写代码的 QA 把关工具。
它会修复安全的测试偏差，拒绝真正的回归问题，并将每项决策签署为独立、可验证的凭证。

---

问题

让任意编码 Agent “让 CI 通过”，最快让 CI 变绿的办法就是**删除那个发现漏洞的测试。**如今，AI 会自行编写和修复测试——因此，唯一重要的问题是：你能相信它做的事吗？

Vigilis 给出了答案。让它检查你现有的 Playwright、Cypress 或 Selenium 测试套件。测试失败时，它会判断：

• 外观偏差（选择器重命名）→ 修复定位器，重新运行以验证结果为绿，并创建 PR。
• 真正的行为变化（结账总额从 $49 变为 $0）→ 它会拒绝修改测试，让把关失败，并揭示漏洞，而不是将其掩盖。

并且，每项决策都会由独立公证方封存为已签署、可离线验证的凭证——这样，拒绝操作有据可证，而不只是口头声称。

自我修复只是切入点。可验证的证据才是目的。

**团队使用场景：**把关 AI 编写的代码 · 修复问题而不掩盖漏洞 · 可审计的测试运行 · 符合 SOX／支付控制审计要求的证据 · 面向 Agent 原生设计（MCP）。→ 查看使用场景

看看它如何拒绝真正的漏洞

Agent 运行了测试规格，看到测试失败，确认所有选择器都正确，得出应用的登录功能确实损坏的结论，并拒绝修复——随后封存一份任何人都能离线验证的凭证。

快速开始

npm i -D vigilis                      # in your Playwright / Cypress / Selenium project
npx playwright install chromium       # one-time, for browser automation
export ANTHROPIC_API_KEY=sk-ant-...   # a pay-as-you-go API key (not a Claude.ai subscription)

npx vigilis init                                   # scaffold vigilis.config.json (auto-detects your framework)
npx vigilis generate https://your-app.com --run    # explore the app → write + run a real spec
npx vigilis heal https://your-app.com --spec tests/login.spec.ts   # heal drift → verify green → PR (refuses real bugs)

# already have a suite running in CI? attest the run you just did — no API key, no secrets:
npx playwright test --reporter=json > report.json
npx vigilis attest-run report.json --commit $GITHUB_SHA --exit-code $?
npx vigilis verify .vigilis/attestation/qa-run-*.json    # offline: chain intact, or broken at record #N

使用你自己的密钥和 chromium 在 CI 中运行。快速模型（--model claude-haiku-4-5）每次运行约 10¢；默认使用 Opus，以获得更高质量。

有何不同

	Vigilis
修复	为外观偏差重写定位器，重新验证结果为绿，并创建 PR。
拒绝	遇到真正的回归问题时，会严格执行失败即关闭的约定——绝不削弱发现漏洞的断言。
证明	每次修复和每次拒绝都会封存为独立、可离线验证的凭证（通过 Treeship）。

证明可验证且可审计——它会按顺序、不加篡改地证明Agent 做了什么。它不会声称 Agent 的判断是正确的。这种坦诚正是关键：Vigilis 提高信号质量，而不是掩盖失败。

为何拒绝可信：没有任何一层会为自己的工作打分。 执行者（任意 Agent）编写代码和测试；Vigilis 判断行为并把关部署；独立公证方（Treeship）签署判定结果。Vigilis 绝不为自己的作业签字——这使得不信任你的人也有理由相信这份证明。

可选：拒绝时发送提醒

遇到真正漏洞而拒绝修复时，Vigilis 可以发送 Slack 提醒并创建去重后的 Linear 工单——每条都附有已签署的凭证。此功能默认关闭；只有设置 SLACK_WEBHOOK_URL／LINEAR_API_KEY 后才会启用。详见 docs/REFUSAL-ACTIONS.md。

从 Claude 驱动（MCP）

相同的工具也以 MCP 服务 的形式提供（vigilis-mcp，收录于官方 MCP 注册表）——可直接从 Claude Desktop、Claude Code 或 Cursor 生成、分类处理并修复。将其添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "vigilis": {
      "command": "npx",
      "args": ["-y", "vigilis-mcp"],
      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
    }
  }
}

完整设置说明：docs/MCP.md。

来源凭证

凭证开箱即用，无需任何密钥——无需账户、API 密钥或网络：

• vigilis attest-run <report.json> 可将任何测试运行（不只是 Vigilis 自身的测试运行）封装为凭证：它会将 Playwright 报告的摘要、提交 SHA 和运行器的退出代码哈希链接到 .vigilis/attestation/ 下的防篡改数据包中。在 CI 中现有的 playwright test 步骤后添加此命令，每次运行都会留下证据。
• vigilis heal 会以相同方式封装整个分类处理与修复会话——按顺序将每次工具调用和每个决策进行哈希链接。
• vigilis verify <bundle> 会离线重新遍历链，并报告链完整或在记录 #N 处中断。任何持有该文件的人都可以检查；编辑或删除任何步骤都会破坏其后的所有哈希。

如果存在 Treeship CLI，heal 凭证还会由独立公证方签名——使用 treeship verify last 验证，或分享托管 URL。没有硬性依赖；可使用 --no-receipt 选择退出。参见 docs/TREESHIP.md。

本地数据包可验证、可审计（它们能证明Agent 做了什么，且内容未经更改、顺序完整——但不能证明其判断正确）；Treeship 会进一步将其升级为由独立公证方签名的凭证。

我为什么构建它

我整个职业生涯都在 QA 领域，而 AI 刚刚彻底改写了这份工作：现在 Agent 可以自行编写和修复测试。速度提升巨大——但它也悄然破坏了测试存在的唯一目的。当 Agent 把红色测试变成绿色时，它是修复了 bug，还是删除了发现 bug 的测试？规模一大，就没人能手动检查每一项改动。

因此，Vigilis 并不是另一个自我修复工具——修复正逐渐成为一种商品。它是一层能够如实决定哪些故障可以修复、哪些必须拒绝的机制，并为每次调用签名，让你不必只听它的一面之词。

我的理解是：git 是代码的账本；Vigilis 是 Agent 决策的账本——这份证明可以交给一个尚未信任你的人。

— Piyush

---

构建方式

Vigilis 只定义一次 QA 工具，却以两种方式提供——作为 MCP 服务和 CLI——共用一个 Claude Agent 循环：

                     ┌──────────────────────────────┐
                     │   core                       │  Anthropic Messages API + tool use
                     │   Agent loop + Tool Registry │  browser · dom · fs · playwright · git
                     └───────┬───────────────┬──────┘
                ┌────────────▼──┐         ┌──▼───────────────┐
                │ vigilis-mcp   │         │ vigilis (CLI)    │
                │ MCP server    │         │ npx vigilis ...  │
                │ (Claude)      │         │ (used in CI)     │
                └───────────────┘         └──────────────────┘

循环流程：生成（探索 URL → 编写规格）→ 分类处理（真实 bug、偏差还是不稳定测试）→ 修复（修复偏差 → 验证通过 → 创建 PR，拒绝处理真实 bug）。编写（自然语言意图 → 测试计划）已列入路线图。

仓库结构

vigilis/
├─ packages/
│  ├─ core/   # agent loop, tool registry, Claude client, prompts, refusal actions
│  ├─ mcp/    # MCP server wrapping the registry
│  └─ cli/    # the `vigilis` command (generate | triage | heal | attest-run | verify)
├─ apps/
│  ├─ sample-shop/   # Next.js demo target (login + products + cart, with seeded drift/bug toggles)
│  ├─ cloud/         # governance cloud — org audit dashboard over signed receipts
│  └─ web/           # landing page → vigilis.dev
└─ tests/            # generated specs land here

开发

pnpm install
cp .env.example .env    # add ANTHROPIC_API_KEY
pnpm build && pnpm test

观看针对捆绑演示应用运行的完整流程——参见 docs/DEMO.md。

路线图

• ✅ 生成 · 分类处理 · 修复（Playwright、Cypress 和 Selenium — 均已通过实时验证）
• ✅ GitHub Actions QA 门禁 · 签名来源凭证 · MCP 服务
• ✅ 拒绝操作（Slack + Linear）· governance-cloud 审计仪表板
• ✅ 无密钥证明：attest-run + verify — 适用于任何测试运行的凭证，无需密钥
• 🚧 编写（意图 → 测试计划）· 扩展 Agent 证明范围

致谢

来源凭证由**Treeship** 提供支持——它是独立证明原语；受治理的记忆则由 ZMem 提供。二者均由 Zerker Labs 构建。感谢 Zerker Labs 团队提供 Vigilis 所依托的信任原语。

许可证

MIT © Piyush Pathak