前言¶

DSH 支持通过插件扩展 web 宿主。@choi-p/dsh-deepseek-balance 是一个余额监控插件：它在 dsh web 侧边栏底部、Settings 按钮上方展示 DeepSeek 账户余额，并支持实时配置显示币种和预警阈值。

这是什么¶

@choi-p/dsh-deepseek-balance 是一个 DSH 插件，仓库作者为 Choi-Peng，许可证为 MIT。

它解决的问题是：在当前 DSH Web 界面内持续查看 DeepSeek 账户余额，并允许在插件设置页调整显示方式和预警阈值。

该插件从环境变量读取 DeepSeek API 密钥，在 host 端注册代理路由和 settings 命名空间，在 client 端把余额展示注入侧边栏，并在插件设置页提供配置卡片。

核心功能¶

• 在左侧边栏底部、Settings 上方展示当前 DeepSeek 账户余额。
• 余额每 60 秒自动刷新。
• 支持三种显示模式：仅 CNY、仅 USD、同时显示 CNY/USD。
• 支持为 CNY 和 USD 分别配置预警阈值。
• 配置实时生效，无需重启 dsh web。
• 侧边栏收起为 rail 模式时，自动隐藏余额展示。
• 从 DEEPSEEK_API_KEY 环境变量读取 API 密钥。
• 在 设置 → 插件 → Balance Monitor 卡片中编辑配置并保存或重置。

Host 与 Client 接入点¶

该插件包含 host 端和 client 端两部分：

• Host 端注册 /deepseek-balance 代理路由和 deepseek-balance settings 命名空间。
• Client 端在 sidebar.footer.action 槽位注册余额展示，并在 settings.plugin.item 注册 Balance Monitor 卡片。

API 密钥只由 host 端持有，并以 Bearer 方式随请求发送，不会下发到浏览器。

安装与启用¶

先确认宿主版本。该插件面向 dsh >= 0.1.2-alpha.3；如果宿主是 0.1.1 世代，应安装：

@choi-p/dsh-deepseek-balance@0.4.0

通过 plugin-registry 安装¶

在 设置 → 插件 → 安装 中，source 填：

@choi-p/dsh-deepseek-balance

或：

github:Choi-Peng/dsh-deepseek-balance

手动安装¶

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

卸载¶

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

典型用法¶

1、设置环境变量 DEEPSEEK_API_KEY 后启动 dsh web。

DEEPSEEK_API_KEY

启动后，侧边栏底部、Settings 上方会显示余额读数，每 60 秒刷新一次。

2、进入 设置 → 插件 → 余额监控 卡片。

选择显示币种，并设置 CNY / USD 预警阈值，然后保存。配置会实时生效，不需要重启 dsh web。

默认配置¶

插件的 base 层默认配置为：

displayCurrency: cny
warningThresholdCny: 0
warningThresholdUsd: 0

其中 displayCurrency 控制余额显示币种，warningThresholdCny 和 warningThresholdUsd 分别控制 CNY、USD 的预警阈值。

依赖版本¶

package.json 声明的 peerDependencies 为：

{
  "@deepseek-ai/cordis": "^4.0.2",
  "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
  "@deepseek-ai/schemastery": "^3.18.2"
}

适用场景与注意¶

这个插件适合需要在 DSH Web 宿主中常驻查看 DeepSeek 余额、并想避免手动查询 API 的开发者。

使用前注意：

• 插件由 AI 生成，可能存在错误、安全隐患或不符合预期之处，使用前需自行 review 代码并实测。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证。
• API 密钥通过 DEEPSEEK_API_KEY 注入 host 端，浏览器端不会拿到密钥。
• 保存采用 revision 乐观并发；如果配置已在别处修改，冲突会返回 409 或提示加载最新值。
• 插件包自带 cordis.patch.yml，安装时由 dsh 自动应用，无需手改 profile 层的 cordis.patch.yml。

结尾¶

@choi-p/dsh-deepseek-balance 的价值很小但明确：把 DeepSeek 余额从外部查询变成 DSH Web 侧边栏里的一个实时读数，并允许本地调整显示与阈值。

GitHub 仓库：https://github.com/Choi-Peng/dsh-deepseek-balance