opencode-volcengine-stats

English

一个 OpenCode TUI 插件，在会话右侧栏显示火山方舟 Coding Plan 套餐用量（和自带的 context、mcp 面板一样，只在会话中出现， 首页不显示）：

数据来自本机 arkcli ——插件本身不调用方舟 API、不处理鉴权。默认每 60s 自动刷新；按 ctrl+alt+r（或点击进度条下方的 ↻ 行）可立即手动刷新。

安装

前置条件： 已安装并登录 arkcli，且在 PATH 上：

npm i -g @volcengine/ark-cli@latest
arkcli auth login
arkcli usage plan --product coding-plan --format json   # 自检

然后让 OpenCode 自动添加：

opencode plugin opencode-volcengine-stats        # 当前项目
opencode plugin opencode-volcengine-stats -g     # 全局（所有项目）

或手动写入 TUI 配置（全局 ~/.config/opencode/tui.json，单项目 <项目>/.opencode/tui.json）后重启：

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-volcengine-stats"]
}

这是 TUI 插件，通过 tui.json 加载，不走 .opencode/plugins/ （那个目录放的是 server 插件）。

配置

选项通过 plugin 条目的第二个元素传入：

| 选项 | 默认值 | 含义 | |-----------------|-----------------|------------------------------| | product | "coding-plan" | arkcli 产品 id | | bin | "arkcli" | arkcli 二进制名称/路径 | | pollMs | 60000 | 数据重新拉取间隔（毫秒） | | barWidth | 14 | 进度条轨道宽度（单元格） | | showCountdown | true | 是否显示重置倒计时 | | refreshKey | "ctrl+alt+r" | 立即刷新的快捷键 |

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": [["opencode-volcengine-stats", { "pollMs": 30000, "barWidth": 18 }]]
}

许可证

MIT