前言¶

用 DeepSeek Harness（DSH）做本地智能體開發時，API 餘額和可用模型往往要切到 DeepSeek 控制檯或單獨寫腳本查詢。對話過程中也不容易判斷當前 Key 還剩多少額度、高峯時段定價是否生效。

下面介紹的 dsh-balance 是社區維護的客戶端插件，把餘額查詢和模型列表集成進 DSH 的設置頁，並在聊天框下方持續顯示摘要。API Key 僅由本機 Host 使用，不會發送到瀏覽器。

這是什麼¶

dsh-balance 由 crazywoola 維護，歸類爲客戶端插件，在 SkillHub 目錄 可找到安裝入口。npm 包名爲 @pinkbanana/dsh-balance，當前版本 0.4.1，採用 MIT 許可證。

插件面向已在使用 DSH Web 配置文件的開發者：在 Harness 內直接查看 DeepSeek 賬戶餘額、充值餘額、贈送餘額，以及當前 API Key 可用的模型列表，無需離開對話界面。

核心功能¶

根據項目 README，插件提供以下能力：

• 查看總餘額、充值餘額和贈送餘額
• 在聊天框下方持續顯示餘額摘要
• 查看當前 API Key 可用的模型
• 緩存查詢結果，並支持手動刷新
• 依據 DeepSeek 峯谷定價，在北京時間 9:00–12:00、14:00–18:00 高峯時段，將聊天框下方的餘額指示燈變爲橙色
• 原生支持簡體中文和英文，跟隨 Harness 系統語言切換
• 支持 Harness 已保存的 DEEPSEEK_API_KEY，也可在「設置 → 模型」中配置 API Key

安裝與啓用¶

先在 DSH 中安裝插件，再以 Web 配置啓動 Harness：

dsh plugin --profile web add @pinkbanana/dsh-balance@latest
dsh --profile web

安裝完成後打開 http://127.0.0.1:3080/，進入「設置 → DeepSeek 餘額」。該入口位於「Agent 預設」下方。若已在「設置 → 模型」保存 API Key，或通過環境變量 DEEPSEEK_API_KEY 提供，插件即可發起餘額與模型查詢。

典型用法¶

完成安裝並配置 API Key 後，可按下面步驟使用：

1. 打開 Harness Web 界面，進入「設置 → DeepSeek 餘額」，查看總餘額、充值餘額、贈送餘額及可用模型列表。
2. 返回已有會話，聊天框下方會顯示餘額摘要，無需每次進入設置頁。
3. 需要最新數據時，在設置面板手動刷新；插件會緩存查詢結果以減少重複請求。
4. 若當前處於 DeepSeek 高峯定價時段（北京時間 9:00–12:00、14:00–18:00），聊天框下方的餘額指示燈會變爲橙色，便於留意計費變化。

API Key 的兩種配置方式：

• 在 Harness「設置 → 模型」中保存
• 通過環境變量 DEEPSEEK_API_KEY 提供

適用場景與注意¶

適合誰

• 日常在 DSH 中調試智能體、需要隨時掌握 API 餘額的開發者
• 希望在同一會話界面確認當前 Key 可用模型、避免額度耗盡後才發現的用戶
• 關注 DeepSeek 峯谷定價、需要在高峯時段留意餘額狀態的場景

使用前注意

• 插件以當前 dsh 進程的權限運行，安裝前應閱讀 GitHub 源碼 並確認 MIT 許可證條款。
• 本插件面向 Web 配置文件（--profile web），安裝命令中的包名爲 @pinkbanana/dsh-balance，與 GitHub 倉庫 crazywoola/dsh-balance 對應同一項目。
• SkillHub 爲社區插件目錄，與 DeepSeek、幻方無官方從屬關係；插件能力以 README 與源碼爲準。
• 開發構建需 Node.js >= 20；貢獻者可執行 pnpm install 與 pnpm check 進行校驗。

結尾¶

dsh-balance 把 DeepSeek API 餘額與模型查詢嵌入 DSH 設置頁和聊天界面，減少在控制檯與 Harness 之間來回切換。若你正在用 DSH 做本地智能體開發，可從目錄頁或 GitHub 獲取插件並按上述命令安裝。

• 目錄頁：https://www.skillhub.cn/plugins/crazywoola/dsh-balance
• GitHub：https://github.com/crazywoola/dsh-balance