安装
在 DeepSeek Harness 里通过 dsh-market 安装
dsh plugin --profile web add dshmarket
或使用命令行
dsh plugin --profile web add @wingsky-1/dsh-opencode-usage
装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。
README
DSH（DeepSeek Harness）Web GUI 插件：OpenCode Go 套餐用量悬浮框 + 三窗口迷你图。
聊天界面右上角常驻悬浮胶囊，实时显示 OpenCode Go 套餐三窗口消耗百分比 （颜色随消耗程度变化：>80% 黄、>95% 红），点击展开详情面板：
- 三张迷你图卡片（rolling 5 小时滚动 / weekly / monthly），各窗口独立自适应 y 轴与 x 轴时间刻度、100% 配额参考虚线、重置标记线（按 resetsAt 反推）
- 后台采样保历史连续（浏览器关闭也持续），数据来自官方
/v1/usage接口 （权威数据，零本地计算）
安装
dsh plugin --profile web add @wingsky-1/dsh-opencode-usage
安装后重启一次 dsh web。
数据源
插件直接调用 OpenCode Go 官方用量接口：
GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <OPENCODE_GO_API_KEY>
响应带 30 秒 TTL 缓存（可配置），避免高频请求。
API Key 解析顺序
- 插件配置
config.apiKey（显式指定，可选） - 环境变量
OPENCODE_GO_API_KEY - DSH 凭据文件
<DSH_HOME>/.credentials.yaml（DSH_HOME 优先，默认~/.dsh） 中的OPENCODE_GO_API_KEY - OpenCode 自身
~/.local/share/opencode/auth.json的opencode-go（回退opencode）条目
配置
| 键 | 默认值 | 含义 |
|---|---|---|
enabled |
true |
插件开关 |
baseUrl |
https://opencode.ai/zen/go/v1/usage |
用量接口地址（可配置，即 token 转发目标） |
timeoutMs |
15000 |
请求超时（毫秒） |
cacheTtlMs |
30000 |
用量缓存 TTL（毫秒） |
limits |
{rolling:12, weekly:30, monthly:60} |
展示用限额（美元/窗口） |
apiKey |
无 | 显式 API Key（缺省走凭据解析链） |
maxAgeDays |
14 |
历史采样保留天数（1–365） |
sampleIntervalMs |
300000 |
宿主后台采样间隔（30s–1h） |
persistFile |
<DSH_HOME>/dsh-opencode-usage/history.json |
历史采样落盘路径 |
路由（全部 loopback 围栏）
| 路由 | 说明 |
|---|---|
GET /api/dsh-opencode-usage/stats |
用量统计（TTL 缓存） |
GET /api/dsh-opencode-usage/history[?days=N] |
历史采样序列 |
GET /api/dsh-opencode-usage/health |
健康检查 |
安全与边界
- token 不落盘、不落日志、不进浏览器端：API Key 仅存于宿主进程内存，
浏览器只经
/stats拿百分比数值（src/index.ts凭据解析链 +stats路由 均不回传 token） baseUrl可配置 = 你的 token 会发送到该地址：仅配置可信的用量接口； 默认官方https://opencode.ai/zen/go/v1/usage- 历史采样落盘
0600权限（tmp + rename 原子写），目录默认<DSH_HOME>/dsh-opencode-usage/ - 所有路由 loopback 围栏（非回环 403 / 方法错 405）
- 官方接口请求频率受控：GUI 轮询 ≤1 次/60 秒 + 后台采样 ≤1 次/5 分钟 （各另有 30s TTL 缓存抑制重复请求），不会限流
验证
# 健康检查（回环）
curl -s http://127.0.0.1:3080/api/dsh-opencode-usage/health
# 源码在 src/，改后必须 build
pnpm --filter @wingsky-1/dsh-opencode-usage build
node test/smoke.mjs
License
MIT