前言¶
在 DeepSeek Harness（DSH）裏跑多個對話、切換不同 Provider 時，餘額、本場 token 消耗、峯谷計費時段和後臺任務狀態往往分散在不同頁面。想確認「還剩多少錢」「這場對話花了多少」「現在是不是高峯價」，通常要打斷當前工作流去別處查看。
下面介紹的 DeepSeek Harness Control Center（npm 包名 deepseek-harness-wallet）由社區維護者 feibi-mochi 開發，是一個本地優先的 DSH 客戶端插件。它把餘額監控、用量估算、峯谷時鐘、多賬戶切換、完成提醒和充值入口收攏到輸入框旁，讓你不用離開當前對話就能掌握賬戶狀態。
這是什麼¶
Control Center 是 DSH 生態中的客戶端插件（分類：客戶端），當前 GitHub 與 npm 穩定版爲 v0.3.4，採用 MIT 許可證。
一句話定位：在 DSH 對話界面旁提供餘額、用量、峯谷計費、加密多賬戶、健康檢查、提醒、充值與會話控制的本地控制中心。
它與官方 DeepSeek 平臺無從屬關係；插件數據保存在本地，不存儲提示詞或回答正文。
核心功能¶
餘額與會話用量¶
插件在輸入框旁顯示緊湊標籤，典型形態如下：
餘額 ¥5.89 · 本場 ¥0.72 · 官 18.8M | 三方 800K · ↗充
- 官方 DeepSeek：每 60 秒刷新余額（啓動時有快速重試），並估算當前會話花費。花費按每次用量發生時的價格鎖定，支持 2026-08-17 起實施的 v4 峯谷定價。
- 第三方 Provider：僅統計本會話 token（輸入 / 緩存讀 / 輸出），不做餘額猜測和費用換算，零配置。
- Provider 分桶：設置頁列出已觀察到的包裝路由；勾選後後續調用計入官方 token/花費桶，既有歷史不追溯重分桶。
點擊標籤可打開詳情面板，查看按幣種拆分的餘額、token 明細、手動刷新，以及跳轉官方充值頁（首次點擊會顯示域名供確認，防釣魚）。
v4 峯谷計費時鐘¶
側邊欄提供 24 小時環形時鐘，適用於 v4-flash、v4-pro 和 v4-flash-vision-exp：
- 工作日高峯：北京時間 09:00–12:00、14:00–18:00
- 週六、週日全天按低谷價計費（2026-08-23 起）
- 週五 18:00 後預覽「週末全天低谷」；週一 09:00 前顯示距高峯剩餘時間
插件會定期同步官方價格頁，只有完整校驗通過的價格表纔會應用；網絡失敗時沿用上次已驗證規則。
365 天本地用量賬本¶
從 v0.3.2 起收集本地用量事件，最多保留 365 天。穩定請求標識去重，官方費用按發生時鎖定，官方與第三方數據分開存儲，不保存提示詞或回答正文。錢包設置頁常態顯示熱力圖；「清除本會話錢包數據」只清當前對話記錄，與「清除歷史賬本」是獨立操作。
多賬戶加密切換¶
在錢包面板 → 賬戶管理（Account Management） 中添加賬戶（名稱 + API Key）、切換或刪除：
- 添加的第一個賬戶自動成爲當前賬戶，並同步寫入 DSH 憑證庫。
- 切換前會彈確認框——因爲後續 LLM 請求將按新賬戶計費。
- 切換通過
credentials.set('DEEPSEEK_API_KEY', ...)寫入憑證庫，llm-deepseek路由按請求解析，下一次 LLM 調用即用新賬戶，無需重啓。 - 賬戶 key 加密存於
$DSH_HOME/storages/accounts.json：Windows 使用 DPAPI，其他平臺使用僅限所有者訪問的 AES-GCM 密鑰文件。界面只顯示掩碼 key。
若啓動環境已提供 DEEPSEEK_API_KEY 環境變量，切換會被拒絕；需在 shell 中取消該變量後才能啓用多賬戶切換。
Z.ai Coding Plan 監控¶
通過通用官方套餐適配器監控已配置的全球區和中國區套餐，不向瀏覽器暴露憑據。5 小時模型 Token 窗口與月度 MCP 工具額度分開顯示，以剩餘比例爲主；查詢失敗時保留最近成功快照，不把套餐額度換算成人民幣餘額。
提醒、佈局與會話控制¶
- 對話完成提醒：可選常駐或定時關閉；多對話同時完成時排隊去重，跨標籤頁協調；系統通知不可用時改用頁面內提醒。
- 低餘額提醒：低於閾值時標籤變紅並觸發一次桌面通知，餘額回升後自動復位。閾值按賬戶與幣種分別持久化，兩位小數，不跨幣種比較。
- 移動與縮放：標籤可自由拖動、吸附，切換橫排/豎排佈局，比例 100%–125%；明細面板可脫離爲懸浮窗口或最小化爲圓點。
- 可選永久刪除：僅當 DSH 宿主真正提供會話刪除能力時，用戶可在設置中開啓；不支持的環境保持禁用。
安裝與啓用¶
從 npm 安裝（當前穩定版 v0.3.4）：
dsh plugin --profile web add deepseek-harness-wallet
或直接安裝 GitHub main 源碼版：
dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center
安裝後重啓 dsh web，並強制刷新頁面。
更新與卸載：
dsh plugin --profile web update deepseek-harness-wallet
dsh plugin --profile web remove deepseek-harness-wallet
包名在 0.1.1 從
dsh-wallet改爲deepseek-harness-wallet。若曾安裝舊包名，請先執行dsh plugin --profile web remove dsh-wallet，避免兩份副本同時註冊 UI。
典型用法¶
經過上面的安裝步驟後，按以下流程使用：
- 點擊錢包卡片或峯谷卡片，打開控制面板；也可在 Harness 設置中查看健康檢查卡片。
- 按需調整峯谷卡片橫排/豎排和 100%–120% 縮放；錢包標籤在輸入框內爲 100%–105%，停靠或浮動時最高 125%。
- 若需縮小卡片，可關閉官方充值按鈕；官方和第三方數據可分別顯示或隱藏。
- 將卡片拖到空白位置；佈局切換後若找不到，在面板中點擊「歸位/停靠」恢復到側邊欄。
- 需要多賬戶時，打開錢包面板 → 賬戶管理，添加名稱與 API Key，確認切換後即可按新賬戶計費。
卡片會跟隨 DSH 淺色/深色主題；升級插件後請強制刷新，確保加載新版前端。
適用場景與注意¶
適合誰：
- 長期在 DSH 中使用官方 DeepSeek 或 Z.ai Coding Plan，需要隨時查看餘額和本場用量
- 需要在多個 DeepSeek 賬戶間切換，且希望 key 本地加密存儲
- 使用 v4 模型，想對照峯谷時段控制調用成本
- 希望對話完成時收到提醒，或餘額低於閾值時獲得通知
使用前請注意：
- 插件以當前
dsh進程的權限運行，會向官方/user/balance接口發送當前 API Key 查詢餘額；啓用多賬戶切換後，所選 key 還會寫入 DSH 憑證庫供後續模型請求使用。安裝前應閱讀源碼並確認 MIT 許可證條款。 - 會話花費爲插件本地估算，不是官方賬單；以官方接口返回的餘額爲準。
- 用量賬本從 v0.3.2 起收集，舊版聚合數據沒有可信日期，不會回填。
- 本版已在 Windows + Edge + DSH Web 完成真實環境檢查；其他瀏覽器和桌面殼按能力設計兼容，但不代表每種組合都做過真機驗證。
結尾¶
DeepSeek Harness Control Center 把餘額、用量、峯谷計費和賬戶管理收攏到對話旁，減少在多個頁面間來回切換。如果你經常在 DSH 裏跑長對話或多賬戶開發，這個插件值得試用。
- 社區目錄：SkillHub 插件頁
- 源碼與文檔：GitHub 倉庫
