前言¶
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
