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 可用工具 查询所有已配置 provider 状态。