Tokei AI Usage

GitHub Copilot 用量分析与额度监控

Tokei 将 Copilot 账户额度、官方 Credits 和本地 Token 指标集中呈现在 VS Code 中。通过概览、调用流水和项目报表，查看额度消耗趋势，了解不同模型与项目的使用情况。

用量记录保存在本机，支持按时间、项目和模型筛选。状态栏提供额度摘要，完整明细可随时导出为 CSV。

核心功能

日常使用

概览集中展示账户额度、所选时段的 Credits 与 Token 构成，帮助快速了解当前使用情况。

调用流水按会话组织模型调用，可展开查看单次调用的扣费、Token 和耗时。支持项目与模型筛选，长列表分页展示。

项目报表汇总各工作区的 Copilot 与自定义 API Token 和模型分布；官方 Credits 仅统计 Copilot 订阅调用。点击项目后，流水中分别展示订阅调用与自定义 API 用量。

三个视图共享今日、本周、本月和全部时间范围。界面自动适配浅色、深色及高对比度主题；后台刷新保留当前阅读位置和展开状态。

快速开始

需要 VS Code 1.135 或更高版本，并安装、登录 GitHub Copilot Chat。

1. 安装插件后，打开活动栏中的 Tokei。
2. 插件会尝试复用已有的 GitHub 登录。若显示“额度读取需要授权”，点击“授权并同步额度”，允许 Tokei 使用当前登录态；尚未登录时点击“连接 GitHub”。
3. 点击“启用 Token 采集”，按提示确认并重新加载 VS Code。
4. 完成一次 Copilot 模型调用后，在面板中查看新采集的用量。

使用 VSIX 安装包时，可在扩展面板菜单中选择“从 VSIX 安装”，安装完成后重新加载窗口。

数据说明

账户额度来自 GitHub Copilot 的官方接口，反映订阅层面的额度状态。切换项目或模型筛选不会改变账户总额度。

额度优先使用 VS Code 已授权的 GitHub 会话。GitHub CLI 作为回退来源时，必须与已识别的 VS Code 账号一致；另一个 CLI 账号的余额不会覆盖当前账号。接口缺少额度字段表示同步未成功，不等同于没有订阅。

调用明细来自 Copilot 在本机生成的 OpenTelemetry 指标。详细指标从 Copilot 启用采集后开始记录，插件会读取仍然存在的全部记录，不按插件安装时间截断。已被源程序清理且未留存的数据无法追溯。

聊天历史 Token另外读取当前 VS Code 工作区的 chatSessions 历史文件，可找回其中已有的输入和输出 Token。它按聊天请求汇总，与逐次模型调用可能重叠，因此单独展示、不计入调用总量或 Credits。相同会话和请求的副本会去重；缺失字段保持未知。这部分自动保存在用量账本中，源文件清理后仍可查看。卡片支持项目与模型选择、请求明细和独立 CSV 导出，缺失字段在 CSV 中留空。

Credits直接读取 Copilot 提供的官方扣费值。缺少扣费记录的调用显示为未知；汇总不完整时，以 ≥ 标识已知小计。官方确认扣费为零的调用在界面中隐藏，本地记录仍保留。

自定义 API优先按本地指标中明确的提供方识别 OpenAI、Gemini 和自定义端点等调用；未标明提供方或提供方为 GitHub 时，按配置的请求模型 ID 精确匹配。它们与 Copilot 订阅调用分开统计。默认识别本机已观测到的 gemini-3.8-flash-high；可在“设置与诊断”中勾选其他自定义 API 模型 ID，或修改 tokeiCopilot.customApiModelIds。若日志未明确提供方且两种来源共用同一 ID，单靠模型 ID 无法区分。概览中的自定义 API 卡片展示调用、Token 和参考费用，可展开查看各模型，并单独导出 CSV；聊天历史 Token 独立列出，避免与逐调用数据重复相加。

自定义 API 费用标为 API 参考估算（USD），不并入官方 Credits。gemini-3.8-flash-high 按 Google gemini-3.8-flash 的 high 推理级别映射，采用 Google Gemini API 标准付费价：2026 年底前每百万输入、输出、缓存读取 Token 分别为 $0.75、$3.75、$0.075；2027 年起分别为 $1.50、$7.50、$0.15。输出价格包含推理 Token；若本机推理计数大于输出计数，才将推理计数补入计价输出量，避免明显漏算。该别名映射基于模型 ID，代理实际计价与免费层未知；缺少已核实价格或 Token 计费口径不明时显示“未计价”，不会套用相似模型的价格。估算不包括缓存存储、工具调用等额外费用。

账户额度与本地调用小计的覆盖范围不同。其他设备上的使用、启用采集前的调用及尚未提供扣费值的记录，都可能使两者存在差异。

当前版本统计 VS Code 内的 GitHub Copilot 用量。Copilot CLI 与 Agent Host 的会话元数据仅用于项目发现，其 Token 暂未纳入统计；其他 AI 服务尚未接入。

隐私与本地存储

OTel 采集只查询指标白名单列。聊天历史恢复会在本机解析包含正文的 JSONL 文件，但只提取请求标识、时间、模型和 Token 字段，不保存或展示提示词、回答正文或工具参数与结果。用量分析在本机完成，历史账本保存调用标识、项目关联、模型、时间及用量等字段。

额度查询使用已有的 GitHub 登录，访问令牌不写入插件账本或日志。启用 Token 采集时，插件会检查并关闭正文采集设置。

历史记录保存在当前 VS Code 用户数据目录中。插件升级会继续读取已有账本，并尝试合并旧版本记录。清理用户数据或切换环境前，请先备份账本；设置与诊断提供完整账本 JSON 备份和合并恢复，包含调用、工具元数据、聊天历史及额度快照；重复记录保留现有版本。CSV 用于分析，不作为恢复格式。

可配置选项

在面板右上角打开“设置与诊断”，可调整以下选项。

本地指标变化后自动刷新。网络连接或数据源异常时，面板会标明缓存状态或缺失范围，并提供诊断信息。

许可证

MIT

额度历史按已识别的 GitHub 账号隔离。旧版未标记账号的额度快照仍保留在完整备份中，不自动归入当前账号；账号暂时无法识别时仅展示当前快照。

消耗去向与额度预测

概览显示高消耗会话，按当前筛选范围内已知的官方 Credits 排序，可进入会话明细查看模型调用与失败情况。扣费缺失可能改变排名，调用失败次数不等于重试次数，也不用于推断任务是否完成。

额度可用天数根据最近最多七天、同账号同套餐同周期的官方余额变化估算，至少需要 24 小时记录；余额回升后重新积累样本，超过两天的采样间隔不拼接。数据超过一小时未更新时暂停预测。预测不受项目筛选影响，也不从本地 Token 推算订阅余额。