dsh-deepseek-account:DeepSeek Harness 餘額查看與查詢插件

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.triggerExtra slot。這會在側邊欄的設置按鈕旁插入錢包按鈕,並負責渲染餘額卡片的彈出層。

注意事項

  • 僅顯示餘額:該插件目前僅用於顯示餘額,不涉及其他賬戶操作。
  • 密鑰安全:API 密鑰由 Harness 統一管理。本插件不會存儲密鑰,它們始終保留在 Harness 的 Settings 下的 DEEPSEEK_API_KEY 憑證中。
  • 源碼審查:由於插件運行在本地進程權限下,建議在使用前查閱源碼:https://github.com/sunyuhuirong/deepseek-account。

結語

dsh-deepseek-account 是一個輕量級且安全的輔助工具,它將餘額查詢功能無縫集成到了 DSH 的工作流中。通過側邊欄按鈕和 Agent 工具的結合,開發者可以更專注於智能體邏輯的開發,而不必手動切換頁面查看餘額。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜