DeepSeek Harness 採用“一切皆插件”的架構。對於開發者而言,在開發過程中實時查看賬戶 API 餘額,或者讓智能體(Agent)具備查詢餘額的能力,是提升效率的關鍵需求。dsh-deepseek-account 插件通過在 Web GUI 側邊欄增加錢包按鈕,解決了這兩個問題。
插件定位¶
這是一個爲 DeepSeek Harness 設計的賬戶插件。它不直接存儲 API 密鑰,而是作爲 UI 和工具的補充層,幫助用戶在側邊欄快速查看餘額,併爲 Agent 提供查詢餘額的接口。該插件由 sunyuhuirong 維護,遵循 MIT 許可證。
核心功能¶
該插件提供以下已覈實的能力:
- 側邊欄錢包按鈕與餘額彈窗:在 Web 界面的側邊欄中增加一個錢包按鈕。點擊後顯示餘額卡片。該功能適配了側邊欄的不同狀態(rail/wide sidebar)。
- 智能體工具接口:向 Harness 中的 Agent 暴露
deepseek_balance工具,允許 Agent 在運行時主動查詢賬戶餘額。 - 國際化支持:提供英文和簡體中文界面。
安裝與啓用¶
在安裝前,請確保你的 DeepSeek Harness 環境滿足要求:Node.js 版本需爲 ^22.19 或 >=24,且使用 ~/.dsh profiles。
安裝插件並啓用 Web profile:
dsh plugin add @deepseek-ai/dsh-deepseek-account --profile web
安裝完成後,無需額外的配置步驟。你只需在 Harness 的 Settings 中配置好 DEEPSEEK_API_KEY 憑證即可。插件會自動讀取該憑證。
工作原理¶
該插件分爲兩部分協作運行:
- Host Half (
src/index.ts,src/balance.ts):
負責註冊deepseek_balance工具。當 Agent 調用該工具時,Host half 會通過 Harness 的憑證服務讀取DEEPSEEK_API_KEY,並調用 DeepSeek 的餘額 API 獲取數據。 - Client Half (
src/client/):
負責註冊到settings.triggerExtraslot。這會在側邊欄的設置按鈕旁插入錢包按鈕,並負責渲染餘額卡片的彈出層。
注意事項¶
- 僅顯示餘額:該插件目前僅用於顯示餘額,不涉及其他賬戶操作。
- 密鑰安全:API 密鑰由 Harness 統一管理。本插件不會存儲密鑰,它們始終保留在 Harness 的 Settings 下的
DEEPSEEK_API_KEY憑證中。 - 源碼審查:由於插件運行在本地進程權限下,建議在使用前查閱源碼:https://github.com/sunyuhuirong/deepseek-account。
結語¶
dsh-deepseek-account 是一個輕量級且安全的輔助工具,它將餘額查詢功能無縫集成到了 DSH 的工作流中。通過側邊欄按鈕和 Agent 工具的結合,開發者可以更專注於智能體邏輯的開發,而不必手動切換頁面查看餘額。