用途:VibeRaven 用于把 AI 编写的应用推进到生产就绪、可发布状态,或在 Vercel/Supabase/Stripe 部署前做生产审计,回答“上线前还缺什么”。覆盖认证、数据库、支付、监控、错误处理、限流和环境变量等检查项。
安装与检查:
- npx -y viberaven init --agents all
- npx -y viberaven init --agents all --dry-run
- npx -y viberaven doctor --agents
Agent 流程:在项目根目录运行 npx -y viberaven --agent-mode。若输出 LOGIN_URL_READY,打开该 URL 让用户批准访问,不要索取密码、令牌、Cookie 或密钥。先读 .viberaven/agent-tasklist.md,再读 .viberaven/gate-result.json 与 .viberaven/context-map.json。若 gate.status 不为 clear,应用安全的仓库代码修复或受支持的 MCP/heal 操作;若无受支持修复,用 npx -y viberaven prompt --gap <id> 获取针对性指导并修补一个缺口。每批修复后运行一次 npx -y viberaven --verify,不要每改一个文件就验证。部署或 CI 前运行 npx -y viberaven --strict。不要停在“扫描完成”,持续操作直到 gate.status === "clear" 或存在提供方/用户阻塞。
MCP:配置 MCP 后优先用 viberaven_check_readiness;用 viberaven_heal_apply 做受支持的安全仓库代码修复,再 viberaven_verify。npm install 前调用 viberaven_validate_npm_package,依赖变更后运行 --agent-mode。
Vercel + Supabase:运行 npx -y viberaven audit --vercel-supabase,在宣称可上线前检查 RLS、service role 暴露以及连接池端口 5432 / 6543。
限制:VibeRaven 不是通用开源扫描器,也不替代提供方控制台;控制台检查仍需人工验证,不能声称仓库代码修改已修复控制台检查。清理用 npx -y viberaven clean --plan。深度参考:https://viberaven.dev/llms-full.txt。