dsh-opencode-usage
DSH Web GUI 插件：订阅用量 / 余额监控（多 provider，当前支持 opencode-go 用量 + deepseek 余额）。两个表面共享同一份数据：
- 侧边栏底部徽标（
sidebar.footer.action，设置入口上方，全局常驻——首页/空态也可见）：显示主 provider（首个 usage 型）5h 0% 周 87% 月 46%，主 provider 为余额型时显示DS CNY 110.00；侧边栏折叠时退化为小圆点，任一 provider 异常变红+红点； - 全局详情卡（
shell.overlay，点击徽标在左侧弹出，徽标正上方）：每个 provider 独立区块（用量三格/余额卡、重置倒计时、趋势、告警）+ 分 provider 的 API Key 配置；Esc 或点遮罩关闭。
用于在额度被他人盗刷/余额异常消耗时第一时间发现异常，不遮挡会话内容。
数据来源
| provider | 类型 | 接口 |
|---|---|---|
| opencode-go | usage（5h/周/月） | GET https://opencode.ai/zen/go/v1/usage（官方未公开文档化接口，cc-switch #6433 发现） |
| deepseek | balance | GET https://api.deepseek.com/user/balance |
安装
Profile Bundle（推荐）——路径用 Windows 正斜杠：
dsh plugin --profile web add "C:/path/to/dsh-opencode-usage" # 或发布后: dsh plugin --profile web add dsh-opencode-usage
验证安装：
dsh --profile web --dump-config | grep opencode-usage
# → - id: opencode-usage
# name: 'dsh-opencode-usage'
运行验证（agent 端到端）：dsh run "查一下 opencode 用量"（agent 会调用 opencode_usage 工具）。
然后重启 dsh web（Ctrl+C 后重新运行），侧边栏底部（设置入口上方）出现用量徽标。
配置 API Key（分 provider，环境变量优先——key 不落盘）
- opencode-go：环境变量
OPENCODE_API_KEY>~/.local/share/opencode/auth.json（opencode /connect登录）> 面板手动配置； - deepseek：环境变量
DEEPSEEK_API_KEY> 面板手动配置。
手动 Key 明文存 ~/.dsh/dsh-opencode-usage.json（权限 0600；Key 不经模型上下文，浏览器直连本机接口）——仅作兜底，推荐用环境变量。
能力与限制
- opencode-go：官方用量统计（5h 滚动 / 周 / 月百分比 + 重置时间），写入本地历史（
~/.dsh/dsh-opencode-usage-history.json，0600），默认每 5 分钟采样一次；deepseek：余额快照（不写历史）； - 页面 60 秒自动刷新（全局单轮询）、重置倒计时每秒更新；
- 告警：用量型单次增幅 ≥5%（6h 内）、深夜时段（23:00–06:59）增长 ≥1%、或 5h 滚动 ≥80% 标红；余额型 ≤20（任意币种）警告、≤0 标红；
- agent 可用工具
opencode_usage查询所有已配置 provider 状态。
安全提示：手动填写的 API Key 以明文保存在本机私有文件（0600），仅本机用户可读；请勿在不受信任的环境使用。怀疑 Key 泄露时，请到对应平台立即吊销并更换。
结构
lib/core.js 纯逻辑：Key 解析、/v1/usage 抓取与解析、历史采样、告警推导（可单测）
lib/index.js 宿主插件：/api/dsh-opencode-usage/{status,usage,refresh,config} 路由、
opencode_usage 工具、systemPrompt 公告（loopback 信任围栏）
lib/client.js 浏览器端：composer.dock 一行 + sidebar.footer.action 徽标 + shell.overlay
详情卡（React，shell 提供；共享 usage store 单轮询）
test/ 自检：node test/selfcheck.mjs
自检（14 项）
npm test # node test/selfcheck.mjs：解析/抓取/Key 解析/配置迁移/历史/告警（含深夜时段）/DeepSeek 余额/注册契约
