omp-token-usage

English

Oh My Pi 的 Token 用量统计扩展。你可以通过全屏交互面板或 query_token_usage 工具，按模型、时间范围、提供商、会话和文件夹查看 Token 消耗与预估费用。

安装

omp install omp-token-usage

快速开始

在 OMP 中运行：

/token-usage

扩展会在每次查询前将 OMP 会话记录同步到 ~/.omp/stats.db。结果包含已写入磁盘的最新记录。

语言偏好

默认显示语言为英文，扩展内置中文（zh-CN）。

保存默认语言

打开 设置 → 插件 → omp-token-usage，选择 locale；也可以使用 CLI：

omp plugin config set omp-token-usage locale zh-CN
omp plugin config set omp-token-usage locale en
omp plugin config get omp-token-usage locale
omp plugin config delete omp-token-usage locale

保存的偏好会用于后续工具调用和 /token-usage 命令。

临时覆盖单次查询

使用 --locale 或 -l 可以只改变本次命令的语言，不会修改已保存的偏好：

/token-usage --locale zh-CN
/token-usage -l en

调用 query_token_usage 时，在工具参数中传入 locale：

{
  "timeRange": "month",
  "groupBy": "model",
  "locale": "zh-CN"
}

优先级

1. 工具的 locale 参数，或命令的 --locale / -l
2. .omp/plugin-overrides.json 中的项目级覆盖
3. 已保存的插件设置
4. 内置默认值：en

outputFormat: "json" 不会本地化，始终返回原始数据库字段和值。

命令别名

无论当前显示语言是什么，原有中文查询别名都可以继续使用。

| 英文 | 中文别名 | |---|---| | detail | 明细 | | today | 今日 | | yesterday | 昨日 | | week | 本周 | | month | 本月 | | all | 全部 | | model: | 模型: | | provider: | 提供商: | | folder: | 文件夹: |

TUI 操作

界面布局

• 页签：模型、按天、提供商、会话、文件夹。
• 摘要：请求数、预估费用、Token 总量和当前时间范围。
• 时间范围：今日、昨日、近 7 天、近 30 天和全部时间。
• 表格：分组名称、请求数、总 Token、费用和缓存命中率。

键盘与鼠标

| 输入 | 操作 | |---|---| | Tab / Shift+Tab | 切换维度 | | ← / → | 切换时间范围 | | ↑ / ↓ / j / k | 选择行 | | Enter | 钻入子维度 | | Space | 查看当前筛选条件的详情 | | Backspace | 返回上一层 | | q / Esc | 关闭面板 | | 鼠标 | 点击页签或行，滚轮滚动表格 |

钻入路径

• 模型 → 按天（Enter）→ 详情（Space）
• 提供商 → 模型（Enter）→ 按天（Enter）→ 详情（Space）
• 会话 → 模型（Enter）→ 按天（Enter）→ 详情（Space）

详情视图

按 Space 查看当前筛选条件下的请求数、缓存写入/读取 Token、总上下文 Token、缓存命中率、输出 Token、预估费用和耗时。

费用计算

扩展使用固定的每 Token 单价估算费用，实际账单以 API 提供商为准。

| 类型 | 单价 | |---|---| | 输入 Token | 每百万 $1.00 | | 缓存读取 | 每百万 $0.20 | | 输出 Token | 每百万 $3.00 |

缓存命中率 = 缓存读取 /（缓存写入 + 缓存读取）

局限

• 只读取 ~/.omp/stats.db，不会统计 OMP 外发出的请求。
• 使用固定费率估算，不同提供商和模型的实际价格可能不同。
• TUI 和 Markdown 标签会本地化；JSON 有意保持原始格式，不会本地化。

许可证

MIT © CorunLing