前言¶
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-balancesettings 命名空间。 - 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
