dsh-account-balance

DeepSeek + OpenRouter 双账户余额芯片 · Dual account balance chip for DeepSeek Harness Web

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

A persistent dual-account balance chip in the conversation header: shows both DeepSeek and OpenRouter balances, auto-refreshes every 3 minutes, with per-account breakdowns on hover.

功能 / 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 核不需要重装本插件。

Never bundle or pin core packages: every @deepseek-ai/dsh-* import resolves to whatever core the host is currently running, so the plugin survives core upgrades without reinstalling.

• 宿主半区（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