fishxcode/dsh-plugin-deepseek-balance

DSH DeepSeek 余额插件

awesome · DSH plugin

English

一个 DeepSeek Harness Web 客户端插件，在 Web 设置插件区域添加一个 DeepSeek 余额标签页。它显示来自官方 /user/balance 端点的实时 DeepSeek API 余额、本地余额趋势，以及由 ECharts 驱动的每日费用 / token 用量图表。

API 参考：

功能

- 实时余额：使用 Authorization: Bearer  调用 GET https://api.deepseek.com/user/balance，显示 is_available 以及每个 balance_infos 条目（currency、total_balance、granted_balance、topped_up_balance）。按需刷新，并每 60 秒刷新一次。
- 余额趋势：每次成功读取余额时，在 localStorage 中每天记录一个数据点；当存在两个数据点后，会显示折线图。
- 可折叠区块：实时余额、趋势和每日用量区块均可折叠/展开；状态按浏览器记忆。
- 浮动窗口：一个可拖动、始终置顶的迷你窗口显示最新余额、可用性和迷你走势图。可从标签页头部切换；位置和可见性会持久保存。
- 每日用量（可选）：粘贴你的 DeepSeek Platform userToken（来自 platform.deepseek.com 开发者工具 → Local Storage）并选择范围（7 天 / 30 天 / 本月 / 上月）。该插件通过同源主机代理获取私有 Platform 用量端点，并渲染：
- 每日费用和每日 token 的柱状 + 折线图（ECharts，从 CDN 加载），
- 汇总统计：总费用、请求数、输入/输出/缓存 token、缓存命中率。
- 密钥：API key 和 Platform userToken 都存储在浏览器的 localStorage 中（键为 dsh-plugin-deepseek-balance.apiKey / ...platformToken），因此可在重新加载后保留；“Clear token”按钮会移除 Platform token。

安全

- API key 存储在当前离线浏览器的 localStorage 中，并且仅发送到 https://api.deepseek.com。
- Platform userToken 是一个完整的会话凭据。它持久保存在浏览器的 localStorage 中（与 API key 处于同一信任域），并且仅 POST 到该插件的同源主机端点（POST /api/dsh-deepseek-balance/usage），该端点会使用类似浏览器的请求头将其转发到 platform.deepseek.com，并且只返回规范化后的用量数据。主机端不会向磁盘写入任何内容。
- 每日用量功能依赖未公开的私有 Platform 端点，WAF 可能会对请求进行限流或阻止；失败时会显示清晰的错误消息。

构建

npm ci
npm run bundle
bundle 会先运行 tsdown，然后运行 scripts/wrap-client.mjs，将 ESM 客户端产物转换为浏览器端模块系统所需的 DSH Web 客户端加载器格式（window.__ModuleLoader__.load({ id, factory })）。host 入口（lib/index.js）保持普通 ESM，并通过 ctx.webServer 注册用量代理。

包元数据声明 DSH Web 客户端入口位于 ./client。请按照与其他 DSH Web 客户端插件相同的机制，通过 Harness 插件 loader 或 composition 启用构建后的包。

项目文件

- src/index.ts：Host 半侧 — 基于 ctx.webServer 的同源用量代理（不持久化 token）。
- src/client.tsx：设置页标签：余额、余额趋势、每日用量、ECharts 渲染。
- scripts/wrap-client.mjs：构建后转换为 DSH 客户端加载器格式。
- package.json：DSH 客户端插件元数据。
- .github/workflows/ci.yml：GitHub Actions 构建校验。

简体中文

这是一个 DeepSeek Harness Web 客户端插件。它会在 Web 设置的插件区域新增 DeepSeek 余额 标签页：显示官方 /user/balance 接口的实时余额、本地余额趋势，以及基于 ECharts 的每日消耗 / Token 用量图表。

API 文档：

功能

- 实时余额：使用 Authorization: Bearer  调用 GET https://api.deepseek.com/user/balance，展示 is_available 与全部 balance_infos 条目（currency、total_balance、granted_balance、topped_up_balance）。支持手动刷新与每 60 秒自动刷新。
- 余额趋势：每次成功读取余额后在 localStorage 记录一个数据点（每天一个）；积累两个点后显示折线图。
- 可折叠区块：实时余额、余额趋势、每日用量三块均可展开 / 折叠，状态按浏览器记忆。
- 悬浮窗：可拖拽、置顶的迷你窗口，显示最新余额、账户可用状态与余额走势（SVG 迷你图）。可在标签页头部切换显示；位置与可见性会持久化。
- 每日用量（可选）：粘贴 DeepSeek 开放平台 的 userToken（登录 platform.deepseek.com 后 F12 → Application → Local Storage 复制），选择范围（近 7 天 / 近 30 天 / 本月 / 上月）。插件通过同源 host 代理调用平台私有用量接口并渲染：
- 每日消耗柱状图 + 每日 Token 折线图（ECharts，从 CDN 加载）；
- 汇总统计：总消耗、请求数、输入 / 输出 / 缓存 Token、缓存命中率。
- 密钥处理：API Key 与 Platform userToken 都保存在浏览器 localStorage（键 dsh-plugin-deepseek-balance.apiKey / ...platformToken），刷新页面后仍在；提供「清除 Token」按钮。

安全说明

- API Key 保存在当前浏览器 localStorage，仅发送到 https://api.deepseek.com。
- Platform userToken 是完整会话凭据。它持久化在浏览器 localStorage（与 API Key 同一信任域），只 POST 到插件的同源 host 端点（POST /api/dsh-deepseek-balance/usage），由 host 带浏览器特征头转发到 platform.deepseek.com，仅返回规范化后的用量数据；host 侧不写入磁盘。
- 每日用量依赖未公开的平台私有接口，WAF 可能限流或拦截；失败时会显示明确错误信息。

构建

npm ci
npm run bundle

bundle 先执行 tsdown，再运行 scripts/wrap-client.mjs，将 ESM 客户端产物转换为 DSH Web 客户端加载器格式（window.__ModuleLoader__.load({ id, factory })），这是浏览器端模块系统要求的格式。host 入口（lib/index.js）保持普通 ESM，并通过 ctx.webServer 注册用量代理。

包元数据已声明 DSH Web 客户端入口 ./client。构建完成后，请按 DSH 其他 Web 客户端插件相同的方式，通过 Harness 插件 loader 或 composition 启用此包。

项目文件

- src/index.ts：Host 半侧 — 基于 ctx.webServer 的同源用量代理（不持久化 token）。
- src/client.tsx：设置页标签：余额、余额趋势、每日用量、ECharts 渲染。
- scripts/wrap-client.mjs：构建后转换为 DSH 客户端加载器格式。
- package.json：DSH 客户端插件元数据。
- .github/workflows/ci.yml：GitHub Actions 构建校验。