dsh-balance DSH 插件

该插件在 DSH Web GUI 左下角添加一个可拖拽的悬浮徽章，同时显示 DeepSeek API 账户余额（人民币/美元）和 OpenCodeGo 计划余量（近 5 小时/近 7 天/近 30 天三个窗口）。点击徽章展开详情面板，可查看明细、管理 Key 并手动刷新。同时提供独立的设置页面分区。

ui-productivity

如何安装 dsh-balance DSH 插件

dsh plugin --profile web add github:linshule/dsh-balance

复制不会执行命令。安装 dsh-balance DSH 插件前请核对仓库和版本。

dsh-balance DSH 插件数据来源

dsh-balance DSH 插件快照日期：2026年8月16日

discovered

dsh-balance DSH 插件能做什么

以单段可拖拽徽章显示 DeepSeek 余额和 OpenCodeGo 余量
根据剩余百分比显示状态圆点（绿/黄/红/白）
点击弹出详情面板，包含明细、进度条和重置时间
支持内联保存/清除 DeepSeek 和 OpenCodeGo 的 API Key
可配置自动刷新间隔（30 秒/1 分钟/5 分钟），重启后保持
网络韧性：使用 HTTP/1.1、自动重试和并发请求去重
所有 API 路由仅限回环地址（127.0.0.1/localhost）访问，确保安全

dsh-balance DSH 插件适合哪些场景

在 DSH Web GUI 中随时查看 DeepSeek API 余额，无需离开界面
跟踪 OpenCodeGo 计划在三个时间窗口（滚动/周/月）的使用量
当余额或余量低于阈值时获得视觉警告
直接从徽章或设置页面管理两个服务的 API Key
调整刷新间隔以平衡更新频率和 API 调用开销

dsh-balance DSH 插件适合谁

需要监控 DeepSeek API 账户余额的 DSH Web GUI 用户
使用 OpenCodeGo（opencode.ai Go 计划）并希望与 DeepSeek 余额一起跟踪余量的开发者

dsh-balance DSH 插件的限制

仅支持 DeepSeek 账户余额和 OpenCodeGo 计划余量，不支持其他监控目标
需要用户自行提供两个服务的 API Key（DeepSeek Key 必填；OpenCodeGo Key 可选，自动读取凭据）
依赖对外部网络 api.deepseek.com 和 opencode.ai 的访问
插件处于早期版本（v0.3.0），可能测试有限
浏览器缓存可能导致客户端更新不及时，可能需要强制刷新
OpenCodeGo 余量需要用户在 opencode.ai 上拥有有效的 Go 计划订阅

dsh-balance DSH 插件的仓库 README 摘录

以下文字摘自 dsh-balance DSH 插件的上游仓库 linshule/dsh-balance 的 README，版权归原作者，仅作引用。

> DeepSeek API 账户余额 + OpenCodeGo（opencode.ai Go 计划）余量 · dsh web GUI 常驻插件一个为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）Web GUI 打造的**双指标监控插件**：左下角悬浮徽章同时显示 **DeepSeek 账户余额**（人民币/美元）与 **OpenCodeGo 计划余量**（近 5 小时 / 近 7 天 / 近 30 天三窗口），点击可展开详情、就地管理 Key，并支持自动刷新。 ![界面预览](docs/preview.png) > 上图为示意渲染。实际徽章位于左侧边栏左下角、设置按钮上方，可拖拽。 --- ## 功能特性 ### 徽章（左下角悬浮，可拖拽） - **双段显示**：`DeepSeek 余量 ¥4.92 · Go 余量 100%` - **状态圆点**：🟢 可用 / 🟡 偏低（剩余 20–50%）/ 🔴 不可用或出错 / ⚪ 未配置 - **可拖拽**：按住拖动调整位置，松手记忆（浏览器 localStorage，默认 `left:12, bottom:110`） - **点击弹层**：DeepSeek 余量明细（总余额 / 充值 / 赠金、可用状态）+ OpenCodeGo 三窗口进度条（已用 % · 剩余 % · 重置时间）+ Key 内联保存 / 清除 + 立即刷新 ### 设置页（设置 → 两个独立分区） - **DeepSeek 余额**：API Key 管理（保存 / 清除）、自动刷新间隔（30 秒 / 1 分钟 / 5 分钟）、余额明细 - **OpenCodeGo 余量**：Key 管理（选填，留空自动读取 DSH 凭据）、三窗口余量明细与重置时间 ### 刷新策略 - 模块级轮询：插件存活期间始终按设定间隔刷新**余额 + 余量**（与哪个界面挂载无关） - 默认 1 分钟，可调；刷新间隔跨重启记忆 - 网络抖动自愈：curl 走 HTTP/1.1 + 自动重试（规避 Windows schannel 瞬时断连 exit 56） ### 安全 - 所有 `/api/ds-balance/*` 路由**仅回环地址（127.0.0.1 / localhost）可访问**，Key 绝不离开本机 - Key 以 `0600` 权限持久化在 `~/.dsh/ds-balance.json`（仅本机可读） - 设置页在线保存后重启不丢失 --- ## 安装 ### 方式一：从 GitHub 仓库安装（推荐） ```bash dsh plugin --profile web add github:linshule/

阅读完整 README仓库许可: MIT

dsh-balance DSH 插件常见问题

如何配置 DeepSeek API Key？

点击 DSH Web GUI 左下角的徽章，在内联输入框中粘贴 DeepSeek API Key（以 sk- 开头）并保存。也可以前往设置页面的「DeepSeek 余额」分区管理 Key。Key 以 0600 权限持久化在 ~/.dsh/ds-balance.json 中，重启后不会丢失。

为什么徽章显示「未配置」？

表示 DeepSeek 和 OpenCodeGo 的 API Key 都未配置。点击徽章打开详情面板，输入 DeepSeek Key。对于 OpenCodeGo，插件会自动从 DSH 凭据（~/.dsh/.credentials.yaml）中读取，前提是默认提供商为 opencode-go；否则你可以在设置页面手动设置 Key。

如何更改刷新间隔？

打开设置页面（设置 → DeepSeek 余额或 OpenCodeGo 余量），从下拉菜单中选择新的间隔：30 秒、1 分钟或 5 分钟。该间隔保存在浏览器 localStorage 中，重启后保持。

徽章上的彩色圆点代表什么？

圆点表示两个指标的整体状态。绿色表示两者剩余均 >50%，黄色表示 20-50%，红色表示 <20% 或受限/错误，白色表示未配置 Key。颜色基于 OpenCodeGo 三个窗口和 DeepSeek 余额中最低的剩余百分比。

我没有 OpenCodeGo 订阅，能使用这个插件吗？

可以。插件会正常显示 DeepSeek 余额。对于 OpenCodeGo，如果没有提供 Key 或 Key 没有 Go 计划，会显示错误或「未配置」。你可以忽略 OpenCodeGo 部分，不影响 DeepSeek 余额监控。