dsh-usage-dash

DSH web 插件：在侧栏底部显示各 Coding Plan 的剩余额度（OpenCode Go / 火山引擎 CodingPlan / 自定义套餐），点击弹出详情卡片。

效果

• 侧栏底部常驻徽章，两行一组按套餐展示剩余百分比（折叠成窄栏时显示圆形最紧张窗口的剩余量）：

Go 额度
5h: 80%   wk: 90%  30d: 95%
火山
session: 88%   wk: 70%   30d: 45%

• 点击徽章 → 徽章上方浮出详情卡：每个套餐一栏，进度条、重置倒计时；卡头有 ⚙ 设置入口
• 剩余 ≤10% 红色、≤40% 橙色预警；每 60 秒自动刷新
• DeepSeek 官方峰谷状态点：DeepSeek 标题旁显示圆点——闲时绿色、忙时橙色（高峰时段 09:00-12:00 / 14:00-18:00 北京时间，闲时半价，官方定价页口径）；每 30 秒自动更新

提供方

提供方	数据源	窗口	需要配置
OpenCode Go	官方 API GET https://opencode.ai/zen/go/v1/usage（优先），fallback 本机 opencode.db 本地估算	5h / 周 / 月	无需（自动用 ~/.local/share/opencode/auth.json 的 Go key），可在设置里覆盖 token
火山引擎 CodingPlan	官方 OpenAPI GetCodingPlanUsage（通过 arkcli usage plan）	session / 周 / 月	推荐认证：npm i -g @volcengine/cli → ve login → arkcli auth login（ve 借登录态，STS 自动续期防互锁）；兜底 npm i @volcengine/ark-cli -g → arkcli auth login volc-sso
DeepSeek 官方 API	官方余额 API GET https://api.deepseek.com/user/balance（与 platform.deepseek.com/usage 同源）	余额（总/赠送/充值）	在设置里填 DeepSeek API key（platform.deepseek.com/api_keys 创建）
自定义套餐	任意返回标准 JSON 的额度 API（见下方契约）	任意	在设置里填名称 / URL / 可选 token

自定义套餐（自服务扩展）

在 设置 → 额度显示 → 自定义套餐 里添加你自己的套餐。URL 返回的 JSON 自动识别两种格式之一：

// A. opencode 风格
{ "usage": { "rolling": { "percent": 4, "resetsAt": "..." },
             "weekly":  { "percent": 3, "resetsAt": "..." },
             "monthly": { "percent": 1, "resetsAt": "..." } } }

// B. 扁平列表
{ "windows": [ { "label": "5h", "percent": 20, "resetAt": "..." },
               { "label": "weekly", "percent": 40, "resetAt": "..." } ] }

• percent 为已用百分比（0-100），显示层自动换算剩余量
• label 支持：5h/rolling/rolling5h、weekly/week/wk、monthly/month/30d、session
• token 可选，默认 Authorization: Bearer
• 配置明文存本机 ~/.dsh/storages/dsh-usage-dash-custom.json（0600）

安装

前置条件：已安装 DeepSeek Harness（dsh CLI）。