852d091c22706bd6976f80a177fbfc2a9b9ea1ed
dsh-opencode-usage
在 DSH 左侧栏看 OpenCode Go 套餐用量:滚动窗口 / 本周 / 本月 三条配额的已用百分比与重置倒计时。
服务端直连 https://opencode.ai/zen/go/v1/usage,API Key 不经过浏览器。
功能
| 能力 | 说明 |
|---|---|
| 左侧栏卡片 | 三条配额的百分比、进度条、重置倒计时;标题旁显示本月重置日 |
| 刷新按钮 | SVG 圆形箭头,加载时旋转;手动刷新(不自动轮询) |
| 颜色分档 | <70% 绿 / 70–89% 橙 / ≥90% 红 |
opencode_usage 工具 |
让 agent 也能查(「opencode 用了多少」) |
GET /plugin/opencode-usage |
JSON 接口,15 秒缓存 |
返回结构:
{
"ok": true,
"fetchedAt": 1794204531,
"source": "config.apiKey",
"buckets": [
{ "key": "rolling", "label": "滚动窗口", "status": "ok", "percent": 2,
"resetsAt": "2026-11-09T11:01:12.000Z", "resetInSeconds": 17539 }
],
"cached": false
}
安装
cd ~/.dsh/profiles/<你的 profile>
pnpm add file:/path/to/dsh-opencode-usage
然后在 profile 的 dsh.profile.bundles 里加上 dsh-opencode-usage,重启 DSH。
配置凭证
五级查找,从上到下第一个命中即用:
| 顺序 | 来源 | 说明 |
|---|---|---|
| 1 | config.apiKey |
显式配置,优先级最高 |
| 2 | config.envFile 指向的 .env |
文件里的 OPENCODE_API_KEY |
| 3 | DSH 的 launchEnvironment | DSH 启动时读的 .env 层(process / project-env / user-env) |
| 4 | 进程环境变量 OPENCODE_API_KEY |
由 DSH 或你的 shell 注入 |
| 5 | 自动发现 | 见下 |
自动发现(默认开启)
第 1–4 级全落空时,插件自己去找,范围是有界的:
| 顺序 | 位置 |
|---|---|
| 1 | $DSH_HOME/.env(通常 ~/.dsh/.env) |
| 2 | DSH 启动目录的 .env |
| 3 | 每个 DSH 工作空间根目录下的 .env(工作空间来自 $DSH_HOME/storages/workspace.json) |
| 4 | 工作空间内递归查找 .env*,深度 ≤ 4,跳过 node_modules / .git / .pnpm / dist / build / target / .venv 等,最多 400 个 |
只读文件名匹配 .env* 的文件,只取 OPENCODE_API_KEY 这一行;值不写日志、不进接口响应(响应里只有百分比和 source 路径)。
想关掉:config.autoDiscover: false。
写在你自己 profile 的 cordis.patch.yml(不要改本包):
- id: opencode-usage
config:
apiKey: oc_sk_xxx
或者从 .env 文件读:
- id: opencode-usage
config:
envFile: /path/to/.env
其他可选配置
- id: opencode-usage
config:
baseUrl: https://opencode.ai/zen/go/v1 # 上游地址
cacheSeconds: 15 # 缓存秒数
timeoutMs: 12000 # 单次请求超时
envKey: OPENCODE_API_KEY # 变量名
autoDiscover: true # 是否自动发现 .env(默认 true)
实现要点
- 纯 JS,无需构建:客户端通过
window.__ModuleLoader__.load()注册,服务端是标准 ESMapply(ctx, config)。 - 凭证不落浏览器:前端只拿到三条百分比,Bearer 只在服务端拼。
defineTool动态解析:插件装在 profile 的local/下,模块解析链上找不到@deepseek-ai/dsh-tools, 所以用realpath(argv[1])建createRequire,从 DSH 自己的依赖树里取。- value schema DSL 有约束:不吃
required: [...]数组、不吃type: ["number","null"]这类 union、additionalProperties必须显式。所以未知值用哨兵(-1/"")。
隐私
本包不含任何凭证、个人路径或主机名。凭证只在你自己的 profile 配置或环境变量里。
License
MIT
Description
OpenCode Go 用量插件(DSH 左侧栏卡片 + opencode_usage 工具)
94 KiB
0 Stars
1 Watchers
0 Forks
Languages
JavaScript
100%