在 DeepSeek Harness (DSH) 的開發流程中，管理多個模型提供商的路由和配額是常見需求。查看賬戶餘額通常需要跳轉到外部平臺或調用接口，缺乏直觀的監控入口。dsh-provider-billing 插件直接在模型設置頁面的每個提供商行內展示賬戶餘額，並提供刷新控制，通過 loopback-pinned RPC 通道實現查詢，確保 API 密鑰始終保留在主機端。
核心功能¶
該插件主要實現以下能力：
- 行內展示：在模型設置頁面的每個提供商行內顯示一行餘額信息。
- 手動刷新：爲每條路由提供刷新控制，允許手動更新余額數據。
- 安全性：API 密鑰從不離開主機，瀏覽器僅發送路由 ID，由主機負責從配置平面解析端點和憑據。
- 標準接口：調用提供商的 OpenAI 兼容
/user/balance端點進行查詢。
安裝與配置¶
插件可以通過 npm、GitHub 或本地路徑安裝。安裝後需要在配置平面中指定要監控的 providers。
安裝¶
使用以下命令之一進行安裝：
dsh plugin --profile web add dsh-provider-billing
或通過 GitHub 安裝：
dsh plugin --profile web add github:ZeroingIn/dsh-provider-billing
配置¶
在 DSH 的配置平面中添加插件實例，並指定要檢查的 providers 列表：
- id: provider-billing
name: dsh-provider-billing
config:
providers: [deepseek-official]
工作原理¶
插件分爲主機端和瀏覽器端兩部分：
- 主機端：註冊了一個 loopback-pinned 的 RPC 通道（
/provider-billing），提供list和query兩個端點。它從配置平面解析路由的端點和憑據，然後向提供商的/user/balance端點發起請求。 - 瀏覽器端：注入到模型設置頁面的
settings.models.row插槽中，渲染餘額卡片（支持中英文顯示）。如果當前 Harness 構建不支持該插槽，插件會明確報告加載失敗。
注意事項¶
- 版本要求：插件依賴 Harness 的
settings.models.row插槽，因此需要較新的 Harness 構建。不支持舊版本，舊版本會直接報錯。 - 構建產物：npm 發佈的 tarball 默認不包含
lib/types目錄（除非在發佈機器上執行了pnpm build），但這不影響運行時功能。 - API 兼容性：插件調用的是
/user/balance接口，僅適配 DeepSeek 官方接口規範，其他自定義接口會返回錯誤信息。
總結¶
dsh-provider-billing 通過在模型設置頁面提供直觀的餘額展示和刷新控制，簡化了多提供商路由的配額監控流程。所有敏感操作均在主機端完成，安全性較高。插件由社區維護者 ZeroingIn 開發，遵循 MIT 許可證。
