前言¶

用 DeepSeek 跑智能體時，大家通常要新開一個瀏覽器頁面，登錄平臺控制台，才能看到賬戶餘額和今天的消費。查一次還行，任務跑久了反覆切窗口很煩，而且容易忘記自己今天到底花了多少。

這個插件把這件事壓縮到一行：在 DSH 側邊欄賬戶行的最右端直接顯示餘額和今日消費，鼠標懸停能看到更詳細的請求和 token 信息，點一下就刷新。下面介紹它的定位、功能、安裝方式和使用注意點。

這是什麼¶

chipcats/dsh-sidebar-wallet 是一個 DeepSeek Harness（DSH）客戶端插件，由 chipcats 維護，分類爲客戶端，當前星標爲 0。它解決的問題很具體：讓 DSH 用戶在界面裏持續看到賬戶餘額和今日消費，不用切回控制台。

需要說明的是，DSH 的生態思路是「一切皆插件」，插件由社區作者維護；社區目錄站點是獨立站點，與 DeepSeek 及幻方沒有官方從屬關係，所以這不是官方出品，也不是官方應用商店上架的應用。

插件在 DSH 側邊欄賬戶行的最右側渲染一行讀數，形如：

Balance ¥128.00 · Today ¥12.34

具體能力只有四項，都是 README 中寫明的：

餘額：調用官方 GET /user/balance，優先使用已保存的 DEEPSEEK_API_KEY，沒有時回退到已登錄的 DeepSeek 賬戶錢包。
今日消費：使用官方 Platform 用量導出，按北京日曆日統計，數字與控制台 Usage 頁面一致；拿不到時回退到本地會話日誌估算，並標註 ≈。
懸停與點擊：懸停顯示餘額、今日消費、請求數、輸入 token（命中/未命中）、輸出 token、緩存命中率、峯谷時段倒計時、更新時間和數據來源；點擊觸發刷新。
語言：讀數跟隨 DSH 界面語言（中文/英文），切換語言設置後實時變化。

README 給出的安裝命令如下，需要 DeepSeek Harness ≥ 0.2.1-rc.1（作者在 0.2.1-rc.5 上測試）：

dsh plugin --profile desktop add github:chipcats/dsh-sidebar-wallet

包版本爲 0.2.6，許可證是 MIT，運行環境要求 Node.js ≥ 20。package.json 裏聲明的 DSH 引擎約束是 >=0.2.1-rc.1 <0.3.0-0，裝之前可以先確認當前 DSH 版本落在這個區間內。

裝完以後不需要額外配置。插件直接把讀數畫在側邊欄賬戶行，日常使用就是看和點：

插件不需要手工填 token：官方用量通過 DSH 的 deepseekAccount.getPlatformSession() 讀取已登錄賬戶會話，失效時自動退回本地估算，讀數不會空白。

適合用 DSH 日常跑任務、希望在界面內順手看消費的開發者。

幾個需要留意的地方：

插件以當前 DSH 進程的權限運行，安裝前建議先讀一遍源碼並確認許可證（MIT）。
官方金額口徑是賬戶下所有 API 調用的合計，不限於某個 API key 或客戶端；只有本地會話估算時只統計當前會話。
未登錄 DeepSeek 賬戶時，只顯示本地估算值。
峯谷時段和節假日表只作用於本地估算和倒計時，不影響官方導出金額。
隱私方面，插件只訪問兩個主機：api.deepseek.com（餘額）和 platform.deepseek.com（用量）；token 停留在 Host 進程內存中，不發送給瀏覽器也不落盤；對外只暴露只讀的 GET /dsh-sidebar-wallet/state.json，走 loopback / 同源隔離，沒有寫入、沒有遙測、沒有第三方運行時依賴。

dsh-sidebar-wallet 思路很剋制：不增加控制面板，不改計費邏輯，只是把已有的餘額和用量信息挪到界面裏固定展示，供需要頻繁確認消費的 DSH 用戶使用。