Balanov 第五个工具：equal 把 API 流量变成确定性资产

Balanov 第五个工具来了：equal。151 星，MIT，Go 写的 7.4 MB 静态二进制，11 月 4 日深夜创建。它的功能一句话说清：把真实 API 流量变成本地沙盒和 OpenAPI 文档。应用只需要一个可配置的 HTTP base URL，跑一遍正常工作流，equal 把观察到的请求和响应变成三样东西：一个本地 API 服务器（返回录制响应不联系真实服务）、一份可审阅可编辑可版本控制的 JSONL 磁带、一份 OpenAPI 3.1 文档。

一、用在哪

离线开发（飞机上、受限网络、服务方宕机时继续工作）；确定性 CI（不再依赖沙盒可用性和限流）；更少的真实凭据（用测试凭据录制，之后跑本地沙盒不需要真实密钥）；跨技术栈共享 fixture（同一份磁带给 Python、Node、Go、移动端和 CI 用，不用每种语言各装一套录制器）；从现实生成 API 文档（不再手写第一版 OpenAPI）；迁移对比（可选把录制请求重放到另一个实现上检查字段级差异）。

二、Balanov 五件套

两天内五个工具，现在是完整的一套：shim（模型适配，451 星）管 agent 接什么模型；verdict（结果验证，233 星）管命令是否真的执行成功；skein（编排控制，263 星）管多 agent 怎么分任务和停；latch（服务通信，185 星）管 agent 和外部服务的安全边界；equal（API 沙盒，151 星）管 API 不可用时的替代环境。五件事覆盖了 agent 开发从模型到编排到测试的完整生命周期。

三、冷水：三条都得泼

一，equal 是开发和测试工具，不是生产代理，README 明确写了只证明录制过的流量。二，两天五个工具的单人产出密度，意味着每个工具都需要社区接手。三，磁带方法有固有限制：只录制过的情况能回放，API 行为变了磁带就过期。

四、判断

equal 的价值在「让 API 依赖变成确定性资产」：录一次真实流量，之后 CI 不受沙盒可用性影响、离线能开发、不需要真实凭据。对 agent 开发者来说，equal 加 latch 的组合解决了两个常见的痛点：agent 测试依赖外部 API（用 equal 磁带替代），agent 调用外部服务没有审批（用 latch 五步流程）。

来源：github.com/Balanov/equal（第一手，README 全文已读，2026-11-05 直读）。