双账户余额芯片 305037991x-pixel/dsh-account-balance

dsh-account-balance

DeepSeek + OpenRouter 双账户余额芯片 · DeepSeek Harness Web 的双账户余额芯片

会话头部常驻的 双账户余额芯片：同时显示 DeepSeek 与 OpenRouter 的可用余额，3 分钟自动刷新，悬停查看两家明细。

会话头部常驻的 双账户余额芯片：同时显示 DeepSeek 与 OpenRouter 的余额，每 3 分钟自动刷新，悬停时显示各账户明细。

功能 / Features

- 一枚芯片同时显示两家余额：¥xx.xx · $xx.xx（OpenRouter 可用余额 = 充值 − 已用）
- 悬停气泡分两段明细：
- DeepSeek：总余额 · 充值 · 赠送
- OpenRouter：可用 · 充值 · 已用
- 一家失败不影响另一家：任一来源出错只在芯片上显示该来源的错误标记
- 3 分钟自动刷新 + 手动刷新按钮（两家同时刷）
- 切换会话不重复拉取：余额数据与定时器为模块级共享缓存
- 密钥只存在于宿主侧，浏览器永不接触

安装 / Install

dsh plugin --profile web add github:305037991x-pixel/dsh-account-balance

重启 dsh web 并硬刷新页面（Ctrl+Shift+R）。

本机开发可用 install-into-dsh.ps1（包内自带）以 link: 方式注册本地源码目录，改源码后重启即生效。

兼容性 / Compatibility

与核版本解耦：所有 @deepseek-ai/dsh- 核心包都声明为可选 peerDependencies （范围 >=0.1.0-rc.6 <0.2.0），插件自身不安装、也不携带任何核心包副本，运行时一律使用宿主正在运行的那份核。升级 DSH 核不需要重装本插件。

切勿打包或固定核心包：每个 @deepseek-ai/dsh- 导入都会解析到宿主当前正在运行的任意核心，因此插件无需重新安装即可在核心升级后继续使用。

- 宿主半区（lib/index.js）只依赖两个稳定接口：dsh-credentials 的 credentialRef 与 dsh-launch-environment 的 launchEnvironmentOf。
- 浏览器半区（lib/client.js）通过 dsh.client.inject 由宿主的客户端模块表提供依赖，同样与核版本无关。
- dsh.compatibility.dshReleases 记录已验证可用的核版本。
- ⚠️ 不要把核心包写进 dependencies 并钉死具体版本：那样插件目录里会出现一份旧核心包，核升级后它会遮蔽宿主的那份，插件会以 failed to import 加载失败。

配置 / Configuration

在 $DSH_HOME/.credentials.yaml 中配置（或环境变量同名，缺哪个来源就只显示另一个）：

DEEPSEEK_API_KEY: sk-xxx
OPENROUTER1_API_KEY: sk-or-v1-xxx

工作原理 / How it works

| 端 | 文件 | 职责 |
| Host | lib/index.js | 注册 GET /dsh-account-balance（DeepSeek）与 GET /dsh-account-balance/openrouter（OpenRouter）：各自从凭证服务（环境变量 → $DSH_HOME/.credentials.yaml → .env）解析密钥后调上游接口，响应原样透传 |
| Client | lib/client.js | 在 conversation.session.header.utilities 槽位注册芯片；模块级共享两家数据 + 3 分钟定时器 |

余额数据来源：
- DeepSeek API - Get User Balance
- OpenRouter API - Get Credits（total_credits − total_usage = 可用）

License

MIT