前言¶
在使用 DeepSeek Harness 進行開發或日常對話時，我們通常需要知道當前的餘額、近期的 Token 消耗以及價區（峯谷）價格。這些信息在官方平臺以卡片或表格形式展示，但需要手動跳轉。DeepSeek Harness 提供插件化能力，可以在同一界面中完成這些信息的實時查詢與展示。deepseek-balance-dsh 正是爲此目的開發的插件，它通過一個懸浮組件在頁面右下角提供餘額、週期消費、Token 使用與價區提醒。
插件定位¶
deepseek-balance-dsh 是一個面向 DeepSeek Harness 的餘額與用量監控插件，由維護者 OwlNjust 維護，分類爲聯網工具。它通過一個懸浮組件顯示總餘額、週期消費（今天/24h/7天/自定義）、Token 使用情況（緩存命中/未命中/輸出），並提供梁文峯（峯期）與梁文谷（谷期）的價區提醒與倒計時。插件無運行時依賴，通過 npm 包 deepseek-balance-dsh 發佈，並在 DeepSeek Harness 中以 bundle-layer 或 manual patch-layer 的方式啓用。
核心功能¶
- 餘額顯示：通過官方
GET /user/balance接口獲取總餘額與充值餘額，輪詢間隔默認 5 分鐘。 - 週期消費：支持今天、24 小時、7 天、自定義起始日期，按模型拆分消費數據（
/usage/cost）。 - Token 使用：緩存命中輸入、緩存未命中輸入、輸出，與平臺儀表盤一致（
/usage/amount）。 - 價區提醒：區分梁文峯（峯期：工作日 09:00–12:00、14:00–18:00，除法定節假日外，價格 ×2）與梁文谷（谷期：其餘時間，包括週末與法定節假日，價格 50%），實時倒計時，峯期高亮，節假日顯示 🎉 徽章。
- 懸浮組件：右下角懸浮膠囊，顯示當前價區、餘額與週期消費概覽。點擊展開面板，支持拖拽調整位置（右鍵按住膠囊拖動），位置自動保存，窗口調整時自動回彈。面板底部提供「重置位置（右下角）」按鈕。
- 語言跟隨：優先使用宿主偏好，否則使用瀏覽器語言；面板頂部提供 EN/中 切換按鈕，狀態本地保存。
安裝與啓用¶
插件以 bundle-layer 方式安裝（推薦），需要 DeepSeek Harness 版本 ≥ 0.2.0。
- 在終端中執行以下命令之一（選擇一個即可）：
dsh plugin --profile <profile> add deepseek-balance-dsh
或
dsh plugin --profile <profile> add https://github.com/OwlNjust/deepseek-balance-dsh
-
使用桌面應用：菜單欄 → “Manage plugins” → 輸入
deepseek-balance-dsh或倉庫地址，確認安裝。 -
重啓 DeepSeek Harness（
dsh web或桌面應用重啓），刷新頁面後右下角應出現懸浮膠囊。
本地 checkout + 手動 patch-layer 的方式需要編輯 ~/.dsh/profiles/web/cordis.patch.yml，詳見 README 的 Route B。
配置與使用¶
- API Key / userToken：點擊懸浮膠囊 → 配置，粘貼 DeepSeek API Key（從 platform.deepseek.com → API keys 獲取），可選粘貼 userToken（從 DevTools → Application → Local Storage 獲取，用於精確統計）。
- 時間窗口：點擊膠囊展開面板，使用頂部標籤切換今天、24h、7天或自定義日期。
- 刷新：面板內「刷新」按鈕，或依賴配置的
pollIntervalMs（默認 5 分鐘）；標籤頁隱藏時自動暫停輪詢。 - 語言：默認跟隨宿主/瀏覽器；面板頂部 EN/中 按鈕可手動切換，狀態本地保存。
- 拖拽佈局：右鍵按住膠囊拖動到任意位置；左鍵點擊展開面板；窗口調整時膠囊自動回彈到視圖內；面板底部「重置位置（右下角）」恢復默認。
架構與權限¶
插件採用模塊化結構，host 端負責配置校驗、狀態/服務構建、路由註冊與定時輪詢；client 端通過 window.__ModuleLoader__ 加載懸浮組件與本地化文案。所有 /dsbal/* 路由均通過宿主的認證門禁（ctx.connection.admit(req)），基於 Host/Origin 信任與瀏覽器 Cookie 認證。配置與歷史狀態存儲於 ~/.deepseek-balance.json（權限 0600），避免明文泄露。
注意事項¶
- 插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
- 不要同時使用 bundle-layer 與手動 patch-layer，否則可能重複插入插件條目（建議使用
dsh --profile web --dump-config | grep -c 'id: deepseek-balance-dsh'檢查條目數量）。 - npm 包名爲
deepseek-balance-dsh，不要使用dsh-deepseek-balance（該名稱屬於無關項目）。 - 卸載時需從
cordis.patch.yml移除插件條目，並刪除node_modules/deepseek-balance-dsh目錄。
適用場景¶
- 需要持續監控 DeepSeek 賬戶餘額與週期消費的開發者。
- 需要實時瞭解峯谷價區與倒計時的用戶，以優化調用時機。
- 使用 DeepSeek Harness 進行批量調用或長時間對話，希望在一個界面獲取多維度數據。
總結¶
deepseek-balance-dsh 將餘額、週期消費、Token 使用與價區提醒集成到 DeepSeek Harness 的右下角懸浮組件中，避免手動切換平臺頁面，提升使用效率。插件安裝簡單、配置透明，適合需要精細管理與成本控制的場景。
- 目錄頁：https://www.skillhub.cn/plugins/OwlNjust/deepseek-balance-dsh
- GitHub：https://github.com/OwlNjust/deepseek-balance-dsh
