前言¶

用 DeepSeek Harness（DSH）跑對話或智能體時，餘額和當日消耗往往要切到網頁或控制台才能看清；未登錄平臺賬號時，官方用量接口也不完整。下面介紹的 dsh-usage-sidebar 把餘額、Token 與費用匯總進 DSH 側欄與設置頁：已登錄 DeepSeek 時走平臺官方統計，未登錄時從本地 session 日誌彙總 Token，並在界面上區分兩種數據來源。

這是什麼¶

dsh-usage-sidebar 由社區維護者 wnk-ke 發佈，歸類爲 DSH 客戶端插件（當前 package 版本 0.4.2，許可證 MIT）。它在 DSH 側邊欄展示 DeepSeek 餘額與用量 chip，點擊可展開近 7 日明細；同時在 Settings → DeepSeek balance and usage 提供餘額明細、可選 API Key 配置與用量統計。界面支持 8 種語言：簡體中文、繁體中文、English、日本語、Français、Русский、Deutsch、Español。

核心功能¶

側欄 chip¶

左側顯示餘額：餘額 ≥ ¥5 時爲綠色，低於 ¥5 時爲紅色。右側顯示當日用量，格式類似 Today: 119.72M @ ¥6.44（具體數值隨賬號與數據來源變化）。

彈出層（Popover）¶

展示近 7 日 Token 與費用；當日行高亮，用量最高的一天加粗。支持自動刷新開關與刷新間隔（默認 5 分鐘），以及語言切換。

設置頁¶

在 DSH 設置中進入 DeepSeek balance and usage，可查看餘額構成、可選填寫 API Key，並查看用量統計。

數字從哪裏來¶

插件在不同登錄狀態下數據來源不同，README 中的對照如下：

要點如下：

• 餘額：通過官方接口 GET https://api.deepseek.com/user/balance，使用環境或配置中的 DEEPSEEK_API_KEY。
• 已登錄用量：複用 DSH 賬號會話（deepseekAccount.getPlatformSession()），無需用戶自行提供 userToken。
• 未登錄 Token：讀取 $DSH_HOME/sessions 下的多幀 zstd 日誌，按本地日曆日彙總 assistant/message 的 usage。
• 日界：平臺按 UTC 日聚合，網站按本地日展示；插件按本地小時分佈把每個 UTC 日拆到本地日，以保證合計一致。

安裝與啓用¶

插件在 Host 進程中運行，安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認與當前 DSH 版本兼容（見下文「兼容性與注意」）。

命令行安裝¶

將 <profile> 換成你實際使用的 DSH profile 名稱：

# 固定 commit（與市場索引安裝一致）
dsh plugin --profile <profile> add "git+https://github.com/wnk-ke/dsh-usage-sidebar.git#70fe100190762eddc5fa91bd2b8336a126354550"

# 跟蹤 main 分支（開發用）
dsh plugin --profile <profile> add git+https://github.com/wnk-ke/dsh-usage-sidebar.git

從插件市場索引添加¶

市場索引地址：

https://raw.githubusercontent.com/wnk-ke/dsh-usage-sidebar/main/market-index.json

在 DSH 中：Settings → Plugins → Discover → Add index source，填入上述 URL 後從發現頁安裝。社區目錄站點 SkillHub 插件頁 提供介紹與鏈接，與 DeepSeek / 幻方無官方從屬關係，僅作生態索引參考。

典型用法¶

1. 按上一節命令或市場索引完成安裝並重啓/刷新 DSH 客戶端 Web 界面。
2. 在側欄查看餘額與「Today」一行；需要近 7 日明細時打開 Popover，按需開啓自動刷新並調整間隔。
3. 若需穩定餘額或官方 Token/費用：在設置頁配置 DEEPSEEK_API_KEY（可選），並儘量保持 已登錄 DeepSeek；未登錄時仍可看本地 Token 彙總，費用列會隱藏並提示。
4. 在 Popover 或設置相關 UI 中切換 8 種界面語言之一。

隱私與安全¶

README 說明的設計要點：

• API Key 與賬號會話保留在 Host 進程；瀏覽器側只收到數值，沒有路由返回密鑰。
• 本地路由僅接受 loopback、校驗同源、寫操作需要 x-dsh-spend 頭並限流。
• 解析 session 日誌時只統計用量，不讀取或外傳消息正文。
• 對外請求僅指向 api.deepseek.com 與 platform.deepseek.com。

適用場景與注意¶

適合：長期在 DSH 裏開發或調試、需要側欄一眼看餘額與當日消耗、並希望近 7 日趨勢與多語言 UI 的開發者。

注意：

• 依賴 DSH 版本 >=0.2.1-rc.5 且 <0.4.0（見 package.json 的 engines.dsh）。
• 賬號模式依賴 DSH 內部 deepseekAccount 服務，屬 best-effort；不可用時回退到本地日誌。
• 插件以 當前 dsh 進程權限 運行，安裝前請自行審查源碼與許可證；勿在不可信環境盲目添加索引或跟蹤 main 分支。

結尾¶

dsh-usage-sidebar 把 DeepSeek 餘額、Token 與（登錄後的）費用收進 DSH 側欄與設置，並在未登錄時用本地 session 補 Token 統計。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。