vole

Vole 是一款面向 AI 编码代理的本地优先用量、成本和异常监控工具。它专为同时运行多个代理、并希望了解代理是否行为异常而不仅是花了多少钱的开发者设计。 该应用运行在搭载 Apple 芯片的 macOS 26 及以上系统，并驻留在菜单栏中。它读取编码工具已写入磁盘的日志，将其规范化为通用 schema，并让所有数据保留在本地：没有云 API，不需要账户，也不存储提示或工具内容。它只需要可选的通知权限，并且不请求完全磁盘访问权限，因为数据来源是本地点文件和应用程序支持文件。 Vole 支持多种工具，包括 Claude Code、OpenCode、Codex CLI、Grok CLI、Cursor、Devin 和 Antigravity。它区分数据置信层级：直接从工具日志读取的精确值、带有已记录方法的确定性估算，以及当工具仅记录某次调用发生但没有足够细节计量 token 时的仅活动行。总计会说明包含哪些层级，未知模型返回 NULL，而不是进行猜测。 仪表板提供主要 token 和成本数字、迷你走势图、各工具条形图以及带事件标注的时间线。时间线按工具堆叠 token 并标记事件，使峰值及其成因更易于检查。菜单栏项可显示实时 token、成本或仅显示状态标记，并在事件未解决时着色。 异常检测包括针对计费消耗激增、重复调用循环、错误风暴、限流压力和上下文压力的规则。基线采用留一比较法，因此单个峰值不会隐藏在其自身基线中。循环检测结合调用量、持平输出和上升的缓存读取，以减少误报。 成本按标价计算为等效 API 价值，而非订阅账单。定价费率以版本化数据存储，可按安装实例覆盖，未知模型则保留为 null。验证命令会根据源记录独立重新推导已存储行，以发现定价或解析错误。 该项目还包含 CLI 命令，用于实时会话、摘要、PR 用量表、状态行、优化发现、预算上限、模型效率和健康检查。MCP 服务器向代理公开相同的本地数据，使代理能够查询自身会话成本、上下文用量和事件状态。在支持的情况下，预算上限可通过受支持的 hook 强制执行；对于不支持 hook 的工具，则仍仅作为建议。 已知限制包括：Devin 和 Antigravity 的本地 token 数据有限；Cursor 消息时间部分派生；Cursor 近期缺少本地 token 计数；错误覆盖仅限 API；某些工具的生成速度仅为下界；以及上下文窗口解析仅支持第一方模型 ID。