vole

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