巴尔霍克：验证你的VIBECODE
代理验证与编排操作系统
██████╗ █████╗ ██████╗ ██████╗ ██╗ ██╗ █████╗ ██╗ ██╗██╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██╔══██╗██║ ██║██╔══██╗██║ ██║██║ ██╔╝
██████╔╝███████║██████╔╝██████╔╝███████║███████║██║ █╗ ██║█████╔╝
██╔══██╗██╔══██║██╔══██╗██╔══██╗██╔══██║██╔══██║██║███╗██║██╔═██╗
██████╔╝██║ ██║██║ ██║██║ ██║██║ ██║██║ ██║╚███╔███╔╝██║ ██╗
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚══╝╚══╝ ╚═╝ ╚═╝
v0.5.0 | TRIPARTITE RELEASE“如果你的特工不能自我测试，那只是幻觉。”
______________________________________________________________________
v0.5.0的新增功能
- 统一堆栈 -单一命令
bun run barrhawk开始一切 - 集成仪表板 -实时监控
http://localhost:7000/dashboard - 体验系统 -跨会话学习的自我修复选择器
- 刀具注射 -新工具实时向正在运行的点火器广播
- 雷击 -被卡住时，Igor自动升级为Claude
- 集线器模式 -多点火器测试编排
--hub旗帜
______________________________________________________________________
快速开始
# 1. Clone and install
git clone git@github.com:barrhawk/barrhawk_premium_e2e_mcp.git
cd barrhawk_premium_e2e_mcp
bun install
# 2. Start the stack
bun run barrhawk
# 3. Submit a test
curl -X POST http://localhost:7001/plan \
-H "Content-Type: application/json" \
-d '{"intent":"take a screenshot of the homepage","url":"https://example.com"}'堆栈模式
bun run barrhawk # Full tripartite stack (Bridge, Doctor, Igor, Frank)
bun run barrhawk --minimal # Just Bridge + Igor (lightweight)
bun run barrhawk --hub # Full stack + Test Orchestration Hub______________________________________________________________________
三方架构
四个通过WebSocket通信的专用服务器：
| 组件 | 端口 | 角色 |
|---|---|---|
| 桥 | 7000 | 信息总线、断路器、仪表板 |
| 医生 | 7001 | 计划器、意图解析器、体验引擎 |
| 伊戈尔 | 7002 | 闪电打击双模执行器 |
| 弗兰肯斯坦 | 7003 | 浏览器控制，动态工具锻造 |
运作原理
- 你 向医生发送意向：
"test the login flow" - 医生 参考经验，制定计划，选择工具
- 伊戈尔 一步一步地执行计划
- 弗兰肯斯坦 控制浏览器，截图
- 经验 记录下次有效的方法
雷击（双模点火器）
Igor以“哑巴模式”启动——基于正则表达式的快速执行。当一个步骤失败3次时，Igor会“罢工”——提升到完全的克劳德推理来解决问题，然后重新启动。
______________________________________________________________________
端点
医生（端口7001）
# Submit a plan
POST /plan
{"intent": "click the login button", "url": "https://example.com"}
# Check plan status
GET /plans
GET /plans/:id大桥（港口7000）
# Health check
GET /health
# Live dashboard
GET /dashboard点火器（端口7002）
# Status
GET /status
GET /health
# Current tool bag
GET /toolbag弗兰肯斯坦（7003港）
# Health and tools
GET /health
GET /tools______________________________________________________________________
项目结构
/
├── bin/barrhawk.ts # CLI entry point
├── tripartite/ # The Core Stack
│ ├── bridge/ # Message Bus + Dashboard (7000)
│ ├── doctor/ # Planner + Swarm Logic (7001)
│ ├── igor/ # Executor + Lightning (7002)
│ ├── frankenstein/ # Browser + Tool Forge (7003)
│ └── shared/ # Common utilities
│ ├── experience.ts # Learning system
│ ├── tool-registry.ts # 120+ tool definitions
│ └── types.ts # Shared types
├── hub/ # Test Orchestration (--hub mode)
│ ├── index.ts # Hub API (7010)
│ ├── coordinator.ts # Multi-Igor sync (7011)
│ └── igor-db.ts # Database watcher (7012)
├── packages/ # Feature modules
│ ├── golden/ # Visual regression
│ ├── self-heal/ # Selector strategies
│ └── ... # 30+ packages
└── docs/ # Documentation
└── specs/ # Component specifications______________________________________________________________________
MCP集成
BarrHawk为Claude Code、Cursor和其他AI助手提供了MCP工具。
配置Claude代码
./scripts/generate-mcp-configs.sh关键工具
// Natural language automation
frank_execute({ task: "Log into github.com", url: "https://github.com" })
// Parallel testing
frank_swarm_execute({ intent: "Test checkout flow", maxIgors: 4 })
// OS-level control (extensions, dialogs)
frank_os_mouse({ action: "click", x: 100, y: 200 })
frank_os_keyboard({ combo: "ctrl+shift+i" })
// Screenshots
frank_screenshot({ fullPage: true })______________________________________________________________________
体验系统
BarrHawk从每次测试运行中学习：
- 选择器：哪些CSS选择器适用于哪些元素
- 时间安排：每个站点通常需要多长时间的操作
- 错误：常见错误模式及其修复
- 站点：具有预映射选择器的已知站点模式
数据存储在 experiencegained/experience.json （可通过以下方式配置 EXPERIENCE_DIR).
______________________________________________________________________
发展
# Run tests
bun test
# Type check
bun run typecheck
# View logs
tail -f /tmp/tripartite-*.log______________________________________________________________________
许可证
麻省理工学院
______________________________________________________________________
“信任，但要核实。” --BarrHawk
