| name | opencode-usage |
| description | OpenCode Token 消耗统计插件,读取本地 SQLite 数据库生成 token 和费用消耗报表,提供 TUI 斜杠命令与 CLI 模式。 |
| metadata | {"internal":true} |
opencode-usage
OpenCode Token 消耗统计插件。读取 OpenCode 本地 SQLite 数据库,生成 token 和费用消耗报表。
功能
- TUI 斜杠命令:在 OpenCode TUI 中键入
/usage(或别名 /cost、/tokens)弹出统计弹窗
- 时段统计:今日 / 本周 / 本月 / 总计
- 每日明细:最近 30 天逐日统计
- 模型维度:按 provider/model 逐模型拆分
- CLI 模式:也可作为独立命令行脚本运行
CLI 用法
node .opencode/skills/opencode-usage/usage.mjs
node .opencode/skills/opencode-usage/usage.mjs daily
node .opencode/skills/opencode-usage/usage.mjs models
node .opencode/skills/opencode-usage/usage.mjs today
node .opencode/skills/opencode-usage/usage.mjs week
node .opencode/skills/opencode-usage/usage.mjs month
node .opencode/skills/opencode-usage/usage.mjs all
数据来源
读取 OpenCode 的 SQLite 数据库:
| 环境变量 | 用途 |
|---|
OPENCODE_DB | 指定完整数据库路径 |
OPENCODE_DATA_DIR | 指定数据目录 |
XDG_DATA_HOME | XDG 数据目录(Linux/macOS) |
APPDATA / XDG_DATA_HOME | 数据目录(默认 ~/.local/share/opencode) |
安装
插件已声明在 .opencode/tui.json 中,OpenCode TUI 会自动加载该插件。
全局安装(可选)
若要在所有项目中都可用,可将 plugin 声明添加到 ~/.config/opencode/tui.json:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": ["/absolute/path/to/cmyr-skills-agents/.opencode/skills/opencode-usage/usage-plugin.ts"]
}
依赖
@opencode-ai/plugin — OpenCode TUI 插件 API