dsh-usage-dash：DSH 侧栏额度监控插件

前言¶

在智能体开发过程中，管理多个平台的额度是常见痛点。频繁切换至 OpenCode Go、火山引擎或 DeepSeek 官方平台查看余额会打断工作流。DeepSeek Harness (DSH) 提供了插件化扩展能力，这款插件旨在解决上述问题，通过 Web 界面提供常驻的额度概览。

是什么¶

dsh-usage-dash 是一个 DSH Web 插件，作者为 yanzoro926。它通过在 DSH 侧栏底部展示各 Coding Plan 的剩余百分比，帮助开发者快速掌握资源消耗情况。该插件支持 OpenCode Go、火山引擎 CodingPlan、DeepSeek 官方余额及自定义套餐。

核心功能¶

侧栏常驻徽章：在侧栏底部显示常驻徽章，两行一组展示各套餐的剩余百分比。当侧栏折叠时，显示最紧张窗口的剩余量。
详情弹窗：点击徽章后，上方浮出详情卡片，展示进度条与重置倒计时。
预警机制：剩余额度 ≤10% 时显示红色，≤40% 时显示橙色。
自动刷新：每 60 秒自动刷新数据。
峰谷状态：显示 DeepSeek 官方峰谷状态（闲时为绿色圆点，忙时为橙色圆点）。高峰时段为北京时间 09:00-12:00 和 14:00-18:00。
多源支持：支持 OpenCode Go、火山引擎 CodingPlan、DeepSeek 官方 API 和自定义套餐。

安装与启用¶

安装前需确保已安装 DeepSeek Harness CLI (dsh)。

# 1. 安装插件
dsh plugin --profile web add dsh-usage-dash

# 2. 重启 DSH Web
#    在运行 dsh web 的终端按 Ctrl+C 停止，重新执行 dsh web
# 3. 浏览器硬刷新 (Ctrl+Shift+R)

配置与使用¶

OpenCode Go¶

无需额外配置。插件会自动读取 ~/.local/share/opencode/auth.json 中的 Go key 进行调用。如需覆盖，可在设置中手动填入。

火山引擎¶

推荐使用火山引擎 CLI 进行认证：

npm i -g @volcengine/cli
ve login
arkcli auth login

兜底方案是使用 arkcli auth login volc-sso。

DeepSeek 官方 API¶

在 DSH 设置中填入 DeepSeek API Key（可在 platform.deepseek.com/api_keys 创建）。

自定义套餐¶

在 设置 → 额度显示 → 自定义套餐 中添加。插件会自动识别以下两种 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": "..." }
      ]
    }

安全与限制¶

本地运行：插件仅接受 loopback Host（127.0.0.1 / localhost / [::1]）请求，并基于同源浏览器标记验证，防止跨站攻击（DNS rebinding 防护）。
数据安全：所有 Token 仅存储在本地用户目录（0600 权限），数据完全属于用户自己。

总结¶

dsh-usage-dash 通过侧栏常驻徽章和详情卡片，为 DSH Web 用户提供了直观的额度管理入口。结合 DeepSeek 官方峰谷状态显示，它能够帮助开发者在不离开当前界面的情况下，快速掌握资源消耗与充值状态。

GitHub 仓库: https://github.com/yanzoro926/dsh-usage-dash
社区目录: https://www.skillhub.cn/plugins/yanzoro926/dsh-usage-dash