deepseekplugins

DeepSeek Harness 插件

dsh-balance-pengpeng

Real API balance monitoring for the DeepSeek Harness: polls the official /user/balance endpoint with your API key and shows the true remaining balance in the sidebar（英文原文）

模型与服务商
跳到安装方式

来源信息

GitHub 仓库
PengPeng6845/dsh-balance
最近更新
2026年8月21日
分类
模型与服务商
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-21

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/PengPeng6845/dsh-balance
插件名：dsh-balance-pengpeng
作者：PengPeng6845

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

<div align="center">

💰 dsh-balance

DeepSeek Harness 侧边栏 · 真实 API 余额监控

用你的 API key 直连官方账单端点 —— 只显示真实数据，不做任何估算。

![npm](https://www.npmjs.com/package/@pengpeng6845/dsh-balance) ![CI](https://github.com/PengPeng6845/dsh-balance/actions) ![version](https://github.com/PengPeng6845/dsh-balance/releases) ![license](LICENSE) ![stars](https://github.com/PengPeng6845/dsh-balance)

</div>

> 💡 一句话：模型花掉多少钱，侧边栏里瞄一眼就知道 —— 余额来自官方 API，不是本地估算。

✨ 特性

<table> <tr><th></th><th>特性</th><th>说明</th></tr> <tr><td>💰</td><td><b>真实余额</b></td><td>官方 <code>GET /user/balance</code> 端点，API key 核实，按账户币种显示</td></tr> <tr><td>⚡</td><td><b>SSE 即时推送</b></td><td>余额一变，1 秒内上屏（EventSource 长连接 + 15s 轮询兜底）</td></tr> <tr><td>🚨</td><td><b>低余额告警</b></td><td>低于阈值（默认 ¥5）数字变橙，悬停有提示</td></tr> <tr><td>🌐</td><td><b>中英双语</b></td><td>文案跟随界面语言自动切换</td></tr> <tr><td>🧹</td><td><b>零依赖</b></td><td>无 npm 运行时依赖、无构建步骤；Host 纯 ESM，Client 手写 bundle</td></tr> </table>

🖥️ 界面

侧边栏底部，一行扁平原生风格（无卡片、无边框，hover 才高亮）——就一行，只有余额：

<pre> ┌──────────────────────────┐ │ 余额 ¥22.39 │ └──────────────────────────┘ </pre>

  • 余额低于警戒线 → 数字变 <b>橙色</b>（悬停提示警戒线）
  • 数据过期（网络失败后退避期）→ 数字灰化，仍显示上次成功值
  • 侧边栏折叠 → 只显示金额
  • 标签页不可见 → 自动暂停轮询，省流量

📦 安装

npm（发布后推荐）：

<pre>dsh plugin --profile web add @pengpeng6845/dsh-balance</pre>

GitHub 直装：

<pre>dsh plugin --profile web add github:PengPeng6845/dsh-balance</pre>

然后确认 profile 的 <code>package.json</code> 的 <code>dsh.profile.bundles</code> 里有 <code>"@pengpeng6845/dsh-balance"</code>，重启 <code>dsh web</code>。

⚙️ 配置

在 profile 自己的 <code>cordis.patch.yml</code> 中按 id 覆盖：

<pre>

  • id: balance

config: balanceEnabled: true # 是否轮询官方余额端点 balanceApiKeyEnv: DEEPSEEK_API_KEY # 余额 API key 的凭据引用（环境变量名） balanceBaseUrl: https://api.deepseek.com balanceRefreshMs: 60000 # 兜底轮询间隔（毫秒） lowBalanceAlert: 5 # 低余额警戒线（账户币种单位） </pre>

<table> <tr><th>键</th><th>类型</th><th>默认</th><th>含义</th></tr> <tr><td>balanceEnabled</td><td>boolean</td><td>true</td><td>是否轮询官方余额端点</td></tr> <tr><td>balanceApiKeyEnv</td><td>string</td><td>DEEPSEEK_API_KEY</td><td>余额 API key 的凭据引用</td></tr> <tr><td>balanceBaseUrl</td><td>string</td><td>https://api.deepseek.com</td><td>余额 API 基地址</td></tr> <tr><td>balanceRefreshMs</td><td>number</td><td>60000</td><td>兜底轮询间隔；token 活动后约 20 秒也会主动刷新</td></tr> <tr><td>lowBalanceAlert</td><td>number</td><td>5</td><td>低于该余额数字变橙</td></tr> </table>

余额以账户币种显示，不做任何汇率换算。

🔄 工作原理

<pre> ┌───────────────┐ │ 你的 API key │ (凭据环境变量，每次请求重新解析，绝不落盘) └──────┬────────┘ │ Bearer ▼ ┌──────────────────────────────┐ │ GET /user/balance (官方) │ 每 60s 兜底轮询 │ · token 活动停止 20s 后追查 │ · 失败指数退避 5s→5m │ · 并发去重 / 10s 超时 │ · 退避期继续供上次成功值 └──────────────┬───────────────┘ │ ▼ ┌──────────────────────────────┐ │ 余额采样 → storage 持久化 │ 余额下降差 = 真实花费 │ (schemaVersion 3, 旧数据迁移) │ (充值上涨自动忽略) └──────┬───────────────┬───────┘ │ │ ▼ ▼ 侧边栏小组件 token_usage 工具 (SSE 即时推送) (模型自查 tokens+余额) </pre>

❓ FAQ

<details> <summary>为什么只显示余额，没有成本估算？</summary> 官方没有用量明细 API，本地估算随价格表漂移（历史上曾高估 70 倍）。本插件只信 <code>/user/balance</code> 的账单真值：余额下降就是花费。 </details>

<details> <summary>多久更新一次？</summary> 模型回复结束约 20 秒后主动查一次（计费在回复后结算），查完通过 SSE 长连接 <b>1 秒内</b>推到页面（15 秒轮询仅作兜底）。流式输出过程中余额不动是正常的。 </details>

<details> <summary>余额为 0 或显示"不可用"？</summary> 检查 <code>DEEPSEEK_API_KEY</code> 环境变量/凭据是否配置，以及网络是否可达。悬停小组件可看详细提示。 </details>

📄 许可

<a href="LICENSE">MIT</a> © 2026 <a href="https://github.com/PengPeng6845">PengPeng6845</a>

---

<div align="center"> <sub>Made for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> · 感谢 <a href="https://github.com/dsh-market/dsh-market">dsh-market</a> 生态</sub> </div>

返回搜索打开 GitHub 仓库

更多相关插件

查看分类