技能介绍

本地编码代理的“隐形”成本黑洞

在多 Agent 协作或日常开发中，团队往往会引入多个 AI 编码代理。这些代理在本地生成的会话日志往往散落在各处，缺乏统一的聚合视角。当月底核对云账单时，团队常会发现 API 配额意外耗尽，或者预算超标。更隐蔽的问题是“排行榜漂移”——不同代理的实际令牌消耗与官方榜单或预期表现存在偏差，这种差异在缺乏细粒度日志分析时很难被察觉。

核心能力与工作流

该技能通过 Tokscale 引擎，将本地的编码代理会话日志聚合为结构化的花费、令牌和趋势视图。其核心工作流分为三步：

日志采集与解析：扫描并读取本地支持的编码代理日志文件，提取 token 消耗与上下文窗口数据。
本地可视化与分析：在本地仪表板中生成多维度的趋势图表，帮助开发者直观对比不同 Agent 的资源占用情况。
排行榜数据提交：通过 bunx tokscale submit 机制，将聚合后的数据同步至 Tokscale 排行榜，生成公开的消耗画像，从而量化和追踪排行榜漂移现象。

适用边界与注意事项

该方案高度依赖本地会话日志的完整性与格式规范，若代理未开启详细日志记录，聚合结果将存在较大误差。此外，将数据提交至公共排行榜会创建公开的个人或团队资料，在共享敏感项目数据前，需评估代码上下文与令牌消耗数据的隐私合规性。最后，运行环境需预先配置好相应的运行时，且部分高级视图可能需要浏览器或 TUI 环境支持。