dsh-deepseek-balance

dsh-deepseek-balance

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

[!NOTE] AI 生成声明:本插件由 AI 生成，可能存在错误、安全隐患或不符合预期之处，使用前请自行 review 代码并实测；发现任何问题欢迎提交 issue 或 PR 修正。

特性

• 在左侧边栏底部、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 将设置保存/重置回 profile 的 cordis.patch.yml 中本插件所在行，启动时若该行不存在则写入默认配置）
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：

层	来源	生效方式
默认值	代码内置（cny，两个阈值均为 0）	—
主存储	profile 的 cordis.patch.yml 中 deepseek-balance 行的 config —— 设置 → 插件 → Balance Monitor 的保存/重置会直接改写该行（只替换该行的 config 块，文件中的注释、!!js 表达式与其他行原样保留；行文本无法识别时才整文件重写）；插件启动时若 profile patch 中尚无本插件行，则自动追加一行默认配置	dsh web 监听 patch 层（HMR）；写入后自动用新配置重启此 fiber，无需重启

卡片暴露 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