dsh-balance：對話界面餘額監控

前言¶

DeepSeek Harness (DSH) 採用插件化架構，方便擴展功能。在開發或日常使用中，監控 API 餘額消耗是剛需。dsh-balance 插件通過在對話界面下方嵌入餘額組件，解決了“餘額不足未察覺”的問題。

插件定位¶

這是一個客戶端插件，由 Shawnxxboxx 維護，開源 MIT 協議。它的核心作用是在 DSH web 界面的消息區與輸入框之間，顯示 DeepSeek 賬戶的當前餘額。

核心功能¶

• 界面嵌入：在 conversation.input.dock 槽位渲染緊湊餘額條，例如 💰 CNY 19.63。
• 自動刷新：每 15 秒自動刷新余額，輪詢 host 路由 /dsh-balance/balance。
• 交互詳情：鼠標懸停可查看“贈送/充值”拆分詳情。
• 容錯處理：餘額不可用時顯示降級文案，不打擾對話。
• 安全設計：零依賴、無構建腳本，API key 僅保留在 host 側，永不下發瀏覽器。

安裝與啓用¶

前置條件：DSH 已安裝且 dsh web 可運行；Node.js ≥ 20；pnpm ≥ 10。

1. 執行安裝命令：

    dsh plugin --profile web add dsh-balance-dock

2. 重啓 dsh web（插件包含 host 側邏輯，需要重啓掛載）。
3. 硬刷新瀏覽器（Cmd/Ctrl+Shift+R）。

典型用法¶

• 在插件列表中搜索 dsh-balance-dock。
• 確認 DEEPSEEK_API_KEY 已在模型設置頁配置。

注意事項¶

• 命名差異：npm 包名是 dsh-balance-dock，GitHub 倉庫名是 dsh-balance，兩者是同一個插件。
• pnpm 11 策略：如果遇到新版本安裝失敗或裝到舊版本，需在 profile 的 pnpm-workspace.yaml 中添加 minimumReleaseAgeExclude 策略排除該包。
• 熱更新差異：host 側改動需重啓 dsh web，client 側改動刷新頁面即可生效。

總結¶

該插件通過輕量級的設計實現了餘額監控，適合需要精細化管理 API 使用的開發者。更多詳情可訪問 GitHub 或 技能庫目錄。