dsh-account-balance：DeepSeek 與 OpenRouter 雙賬戶餘額監控插件

前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的架構，插件生態獨立於 DeepSeek 官方或幻方集團。在使用 DSH 進行開發或交互時，若同時管理 DeepSeek 與 OpenRouter 兩個賬戶，頻繁手動查詢餘額會打斷工作流。本插件旨在解決這一痛點，在 Web 界面會話頭部提供一個常駐的雙賬戶餘額芯片。

是什麼¶

這是由開發者 305037991x-pixel 維護的客戶端插件 dsh-account-balance。它通過在會話頭部注入一個卡片，同時顯示 DeepSeek 和 OpenRouter 的餘額。插件運行在宿主側，不依賴特定版本的 DSH 核心包，支持 3 分鐘自動刷新。

核心功能¶

雙源顯示：一枚芯片同時展示 DeepSeek 與 OpenRouter 餘額。OpenRouter 的餘額計算公式爲 充值 - 已用。
明細查看：鼠標懸停芯片，氣泡內分兩段展示：
- DeepSeek：總餘額、充值、贈送。
- OpenRouter：可用餘額、充值、已用。
容錯機制：任一數據源（如 OpenRouter API 調用失敗）出錯時，僅在該來源上顯示錯誤標記，不影響另一家數據的顯示。
自動刷新：支持 3 分鐘自動刷新，並提供手動刷新按鈕（同時刷新兩家）。
智能緩存：餘額數據與定時器爲模塊級共享緩存。切換會話時不會重複發起請求。
安全性：API 密鑰僅存儲於宿主環境（.credentials.yaml 或環境變量），瀏覽器端永不接觸密鑰。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add github:305037991x-pixel/dsh-account-balance

安裝完成後，需要重啓 dsh web 服務並執行硬刷新以加載新插件：

停止當前運行的 dsh web。
重新啓動 dsh web。
在瀏覽器頁面按 Ctrl + Shift + R 硬刷新。

若在本地開發此插件，可使用包內自帶的 install-into-dsh.ps1 腳本，以 link: 方式註冊本地源碼目錄。修改源碼後重啓即可生效，無需重新安裝。

典型用法¶

插件依賴於宿主提供的憑證服務。在 $DSH_HOME/.credentials.yaml 中配置以下密鑰即可顯示對應餘額（缺省則不顯示）：

DEEPSEEK_API_KEY: sk-xxx
OPENROUTER1_API_KEY: sk-or-v1-xxx

配置完成後，會話頭部將自動出現餘額芯片。

兼容性與注意事項¶

與核版本解耦：所有 @deepseek-ai/dsh-* 核心包被聲明爲可選的 peerDependencies（範圍 >=0.1.0-rc.6 <0.2.0）。插件自身不攜帶核心包副本，運行時直接使用宿主正在運行的那份核。
依賴接口：
- 宿主半區（lib/index.js）：僅依賴 dsh-credentials 的 credentialRef 和 dsh-launch-environment 的 launchEnvironmentOf。
- 瀏覽器半區（lib/client.js）：通過 dsh.client.inject 由宿主客戶端模塊表提供依賴。
版本鎖定警告：切勿將核心包寫入 dependencies 並釘死具體版本。若寫入，插件目錄內會出現一份舊核心包。當宿主升級核版本後，這份舊包會遮蔽宿主的新包，導致插件以 failed to import 加載失敗。
許可證：MIT。

小結¶

dsh-account-balance 是一款輕量級、無侵入的雙賬戶餘額監控工具。它利用 DSH 的插件機制，在不修改宿主核心代碼的情況下，爲 Web 界面提供了便捷的餘額查詢入口。適合需要同時管理 DeepSeek 與 OpenRouter 餘額的開發者使用。

插件目錄：SkillHub
源碼地址：GitHub