余额胶囊 AKUSH99/dsh-balance-chip

dsh-balance-chip

在 DSH 应用内直接显示你的 DeepSeek API 余额，共两处：

1. 右下角胶囊 – 始终可见、不阻挡点击（pointer-events: none），圆点 + 金额，每 60 秒自动刷新
2. 侧边栏底部 – 位于设置旁边（栏模式下显示圆点）

截图：DSH 应用右下角的 DeepSeek 余额胶囊

- 🟢 绿色 ≥ $5 · 🟠 橙色 < $5 · 🔴 出错时红色
- 悬停提示显示币种与最后更新时间
- 你的 API Key 绝不随本插件分发 – 它在运行时从本机 DSH 凭证库读取，唯一的网络请求由宿主侧发往官方 api.deepseek.com/user/balance 端点。

前置条件

你的 DeepSeek API Key 必须存储在 DSH 凭证库中，引用名为 DEEPSEEK_API_KEY（与内置 DeepSeek 提供方使用的位置相同 – 网页端 UI 的模型页面会写入此处）。若该引用缺失，显示将呈现 Key?。

安装

dsh plugin --profile web add github:AKUSH99/dsh-balance-chip

重启 dsh web（或使用市场的一键重启）。无需构建步骤，无依赖。

需要 dsh web 0.1.0-rc.6 或更新版本（与插件市场相同的基础版本）。

其他安装方式

- 插件市场： 上架后，在应用内打开 设置 → 插件市场，搜索 "balance"，一键安装。
- 预构建包： 最新发布版 提供现成的 tarball – 市场将其作为更快的安装途径，无需任何构建步骤。

工作原理

| 部分 | 作用 |
| lib/index.js（宿主） | 通过 credentials 服务解析密钥，每 60 秒轮询 GET https://api.deepseek.com/user/balance，并在 GET /dsh-balance 提供缓存状态 |
| client/client.js（网页端） | 注册一个 sidebar.footer.action 项以及一个 shell.overlay 胶囊，二者均请求 /dsh-balance 并渲染圆点 + 金额 |

无遥测，无外部依赖，一切都在你的机器上运行。

故障排查

- 胶囊/圆点显示 Key? – 你的凭证库中没有 DEEPSEEK_API_KEY 引用。请通过网页端 UI 的模型页面（或 credentials 服务）存储密钥，然后重新加载。
- 加载时显示 … – 首次轮询尚未完成；请等待几秒。
- 红点 / 错误 – 宿主无法访问 api.deepseek.com/user/balance；请检查网络与密钥有效性。

中文说明

在 DSH 应用内实时显示 DeepSeek API 余额：右下角常驻胶囊（不阻挡点击）+ 侧边栏底部状态点，每 60 秒自动刷新。余额低于 5 美元显示橙色，出错显示红色，悬停可见币种与更新时间。API Key 绝不内置：运行时从本机 DSH 凭证库读取，仅向官方余额接口发起请求。使用前请确认凭证库中存在 DEEPSEEK_API_KEY 引用（与内置 DeepSeek 提供方相同，网页端模型页面会写入）。

FAQ

为什么有两处显示？ 侧边栏状态点低调且始终触手可及；右下角胶囊则提供一眼可见的状态，且不阻挡点击（pointer-events: none）。
数值有多新？ 宿主每 60 秒轮询一次官方余额端点；两处显示均从该缓存状态刷新。
轮询会消耗令牌吗？ 不会——余额端点与聊天 API 是分开的，不会消耗付费令牌。
货币？ 官方 API 会报告账户货币；显示界面会按原样展示。

许可证

MIT