前言¶

DSH（DeepSeek Harness）的界面里没有专门的额度面板。想看账户余额，通常要打开 DeepSeek 控制台；想确认 OpenCode Go 的套餐窗口还剩多少，又得另开一个页面。两个数字分处两地，长期跑 Agent 的人只能反复切窗口确认，或者干脆靠脚本查接口。

dsh-quota-overview 解决这个问题。它是 joyboy-yy 维护的 DSH Web 插件，在侧边栏底部、用户头像上方新增一整行「额度」入口，同时展示 DeepSeek 账户余额与 OpenCode Go 的 5 小时 / 本周 / 本月用量；点击入口弹出详情弹窗，可以看明细与重置倒计时，缺失密钥时还能直接在弹窗里填入 API Key。下面介绍它的功能、安装与用法。

它是做什么的¶

一句话定位：给 DSH Web 客户端补一个常驻侧边栏的额度入口，把 DeepSeek 账户余额和 OpenCode Go 套餐用量聚合到一处。

仓库地址：https://github.com/joyboy-yy/dsh-quota-overview 。许可证 MIT（© 2026 joyboy-yy），npm 上最新版本 1.0.1（2026-11-05 发布）。GitHub 星标为 0，属于个人维护的早期项目。

它解决的是「查额度要离开 DSH」的麻烦：入口常驻侧边栏，鼠标一停就能看到摘要，点开就是详情，不需要手工写脚本轮询。

核心功能¶

侧边栏入口¶

入口是一整行，分两排展示摘要：

1. 第一排：DeepSeek ¥余额；
2. 第二排：OpenCode Go 的 5 小时 / 本周 / 本月三档用量徽章，颜色规则是 <60% 绿、60–85% 黄、≥85% 红；
3. 悬停显示完整摘要；侧边栏折叠成窄栏时，入口自动变成图标。

详情弹窗¶

点击入口打开弹窗，支持 Esc、点击遮罩、右上角 ✕ 三种关闭方式。弹窗内分两张卡片：

• DeepSeek 卡片：总额、充值余额、赠金、可用状态、数据来源；
• OpenCode Go 卡片：三条进度条（5 小时 / 本周 / 本月）、百分比、重置时刻，以及每秒跳动的倒计时。

右上角有刷新按钮。需要绕过缓存时，插件提供 ?fresh=1 参数跳过 30 秒缓存，另有「全部刷新」按钮一次刷新两类数据。

密钥解析顺序¶

插件先读凭据，通常零配置即可工作。解析顺序如下：

1. DSH 凭据存储：DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY（也覆盖启动环境变量提供的值）；
2. 同名进程环境变量；
3. OpenCode CLI 登录文件 ~/.local/share/opencode/auth.json 中的 opencode-go 条目。

缺失即提示填入¶

两类 Key 都没找到，或上游返回 401 时，弹窗内对应卡片直接显示密码输入框。保存会写入 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 两个 DSH 凭据，与 DSH 模型供应商共用同一份密钥，保存后立即重新查询。

插件还支持「更换密钥」「清除」已保存的 Key（清除需要二次确认）。如果 Key 来自环境变量、属于只读，插件会拒绝操作并提示原因。

安装与启用¶

安装命令来自 README：

# 从 npm 安装（发布后）
dsh plugin add dsh-quota-overview

# 或指定 profile
dsh plugin --profile desktop add dsh-quota-overview

也可以在 DSH 的「设置 → 插件」中，通过插件市场搜索 dsh-quota-overview 安装（收录后）。

插件包要求 Node >= 22.19.0（见 engines字段），属于 Web 平台客户端。启用后无需额外配置即可在侧边栏看到入口。

典型用法¶

安装好之后，日常使用分三步：

1. 看摘要：侧边栏底部常驻的「额度」行显示 DeepSeek 余额和 OpenCode Go 三档用量。5 小时窗口临近耗尽时，徽章会从绿变黄再变红，不需要点开也知道大概状况。
2. 看详情：点击入口打开弹窗。5 小时窗口快用完时，进度条下方是逐秒跳动的倒计时，可以直接判断是先等重置还是先换任务。需要新数据时点右上角刷新，或在需要绕缓存的场景下请求 ?fresh=1。
3. 补密钥：首次使用时如果凭据和环境变量都没有 Key，弹窗内会显示密码输入框。填入 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 后保存，插件立即重新查询，之后入口正常显示数值。

密钥只在 Host 进程内使用，不会返回浏览器；浏览器侧只拿到余额、百分比与来源描述。这样即使弹窗渲染的是客户端页面，API Key 也不会暴露到浏览器上下文。

数据来源¶

插件查询上游接口的方式如下：

• DeepSeek：GET https://api.deepseek.com/user/balance（Bearer DEEPSEEK_API_KEY）
• OpenCode Go：GET https://opencode.ai/zen/go/v1/usage（Bearer OPENCODE_GO_API_KEY）

凭据来源与这两个接口均来自 README 的「数据来源」与「密钥解析顺序」两节。

适用场景与注意¶

适合以下几类人：

• 长期在 DSH 里跑任务、需要频繁确认 DeepSeek 余额和 OpenCode Go 窗口的用户；
• 希望查额度「不离开界面」而不是维护轮询脚本的人；
• 想在同一个弹窗里完成查明细、看重置倒计时、补 API Key 的操作的人。

需要注意三点：

• 插件以当前 dsh 进程权限运行。安装前应先检查源码（index.js、client.js、cordis.patch.yml）与许可证（MIT），确认它的路由、凭据读写行为与自身环境匹配；
• GitHub 星标为 0，npm 发布时间不长，依赖上游接口行为，DeepSeek 或 OpenCode 调整接口时插件可能需要同步更新；
• 插件会读写 DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY 两份 DSH 凭据，与模型供应商共用同一份 Key，如果这不符合你的密钥管理习惯，需要自行评估。

结尾¶

dsh-quota-overview 的价值是把查额度这件事收回到 DSH 界面里：一行入口承担摘要，弹窗承担明细和重置倒计时，缺失密钥时用弹窗补进去。对同时使用 DeepSeek 和 OpenCode Go 的用户来说，它减少的是反复切窗口确认的代价。

目录页：https://www.skillhub.cn/plugins/joyboy-yy/dsh-quota-overview
GitHub：https://github.com/joyboy-yy/dsh-quota-overview