dsh-deepseek-balance

一个常驻的 DeepSeek Harness Cordis 插件，用于在侧边栏底部、Settings 按钮正上方展示你的 DeepSeek 账户余额。

特性

• 在左侧边栏底部、Settings 上方展示当前 DeepSeek 账户余额，每 60 秒自动刷新。
• 支持 CNY 与 USD 两种货币显示，配置阈值以用颜色警告。
• 配置热加载 —— 编辑 cordis.patch.yml 或使用 设置 → 插件 → Balance Monitor；两者均无需重启 dsh web 即可生效。
• 当侧边栏收起（rail 模式）时自动隐藏。
• 从 DEEPSEEK_API_KEY 环境变量读取 API 密钥。

架构

端	文件	作用
Host	lib/index.js	注册 /deepseek-balance（代理 DeepSeek Get User Balance API）和 /deepseek-balance/settings（GET 生效配置；POST 将 UI 覆盖项保存/重置到 $DSH_HOME/deepseek-balance.json）
Client	lib/client.js	在 sidebar.footer.action 槽位注册余额展示（60 秒轮询），并在 设置 → 插件 中注册可编辑的 Balance Monitor 卡片

Browser (Client half)  --fetch /deepseek-balance-->  Host HTTP route  -->  api.deepseek.com/user/balance

安装

通过 plugin-registry 安装

设置 → 插件 → 安装,source 填 @choi-p/dsh-deepseek-balance 或者 github:Choi-Peng/dsh-deepseek-balance

手动安装

1. 将插件安装到 web profile：

dsh plugin --profile web add "github:Choi-Peng/dsh-deepseek-balance"

2. 在 profile 的 patch 层挂载插件行：

# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
    - id: deepseek-balance
      name: '@choi-p/dsh-deepseek-balance'
      config:
        displayCurrency: cny
        warningThresholdCny: 0
        warningThresholdUsd: 0

卸载方式：

先从 cordis.patch.yml 移除该行（实时生效），然后：

dsh plugin --profile web remove @choi-p/dsh-deepseek-balance

配置

插件设置为分层结构，两层都实时生效，无需重启 dsh web：

层	来源	生效方式
基础层	profile 的 cordis.patch.yml 中 deepseek-balance 行的 config	dsh web 会监听 patch 层（HMR）；保存文件会用新配置重启此 fiber
覆盖层	$DSH_HOME/deepseek-balance.json —— 由 设置 → 插件 → Balance Monitor 写入	host 在每次 /deepseek-balance/settings 请求时都会重新读取该文件，编辑立即生效；覆盖项按字段优先级更高

生效配置 = patch 基础层叠加 UI 覆盖项。卡片暴露 displayCurrency（下拉框）以及两个告警阈值（数字输入框），并提供 保存 / 恢复默认值；保存后，侧边栏余额展示会立即刷新（同时也会每 60 秒重新轮询一次）。

API 密钥按以下顺序解析：

1. DEEPSEEK_API_KEY 环境变量
2. ~/.api_keys 文件 —— 形如 export DEEPSEEK_API_KEY="sk-..." 的行

余额 API 在存在时会同时返回 CNY 与 USD 余额；插件优先使用 CNY，缺省时回退到 USD。

开发

# 校验 host 半部分可被干净地导入：
node --input-type=module -e "import('@choi-p/dsh-deepseek-balance').then(m => console.log(m.name, m.inject))"

# 对 client bundle 做语法检查：
node -e "new Function(require('fs').readFileSync('lib/client.js', 'utf8'))"

License

MIT