opencode-glm-status

OpenCode v2 TUI 插件：在输入框 footer 状态区显示智谱 GLM Coding Plan 配额

Show your Zhipu / GLM / Z.ai Coding Plan quota right next to the prompt input bar.

需要 OpenCode v2.0+（V2 插件 API）。v1 用户请用 0.4.0。

效果预览 / Preview

> 请输入你的问题…                                 GLM 69% ↻14:00

• 5h token：5 小时滚动 token 窗口剩余比例（低额度变黄/红）
• ↻14:00：下一次配额重置时间

每 30 秒自动刷新，并在每次回复完成时立即刷新。

安装 / Installation

在 ~/.config/opencode/cli.json（无则新建）的 plugins 数组添加一行：

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["opencode-glm-status"]
}

重启 opencode 即生效（opencode 会用 Bun 自动安装 npm 包，无需手动装依赖）。

前置条件 / Prerequisites

• opencode ≥ 2.0（V2 插件 API）
• 已配置智谱 GLM Coding Plan 账号，凭据存放在以下任一位置：
  • ~/.local/share/opencode/auth.json（推荐，opencode auth 添加）
  • opencode provider 配置（options.apiKey）
• 支持平台自动识别：
  • 智谱开放平台（国内）：open.bigmodel.cn
  • Z.ai（国际）：api.z.ai

工作原理 / How it works

1. 从 opencode 认证信息中发现智谱 provider 及 API key（不读取环境变量，仅本机凭据）
2. 直接请求智谱官方监控接口 /api/monitor/usage/quota/limit
3. 渲染到 TUI prompt.footer.status 插槽（输入框 footer 状态区）

你的 API key 仅用于请求智谱官方接口，不会被上传到任何第三方服务。

常见问题 / FAQ

Q: 什么都不显示？ 检查 cli.json 配置是否正确，并确认已通过 opencode auth 添加智谱 Coding Plan 账号（provider id 含 zhipu / zai / bigmodel，或 baseURL 指向 open.bigmodel.cn / api.z.ai）。

Q: 显示 GLM ?？ 插件未能在本机找到智谱凭据或请求失败，查看 opencode 日志（~/.local/share/opencode/log/）定位。

Q: 用的是国内站还是国际站？ 自动识别。若你的 key 来自 Z.ai，插件会请求 api.z.ai；来自智谱开放平台则请求 open.bigmodel.cn。

卸载 / Uninstall

从 cli.json 移除 "opencode-glm-status" 并重启 opencode 即可。

从源码构建 / Build from source

npm install
bun run build   # 产出 dist/tui.js + dist/index.js（需 bun ≥ 1.3）

注意：npm 包入口是编译后的 dist/*.js（solid 编译产物），不要把 exports 改指向 src/*.tsx——opencode 的 Bun 运行时不转译 node_modules 内的 TSX，直接发布源码会导致插件静默加载失败。

License

MIT