前言¶

DeepSeek Harness（DSH）在對話裏會流式輸出 token 用量，但通常不會直接告訴你「這一輪花了多少錢」。餘額要在平臺頁面另開標籤查看，會話記錄裏也只有 token 數、沒有人民幣。若你長期在 DSH 裏做智能體開發或日常對話，很難在不離開會話的前提下掌握賬戶餘額、最近一輪實際扣費以及當天累計支出。

dsh-spend-meter（倉庫 lx950/dsh-spend-meter，維護者 lx950）是 DSH 社區目錄中的客戶端類插件：在對話界面注入一塊可拖拽面板，從 DeepSeek 計費計數器（精度 1e-8 CNY）讀取數據，在計數器尚未落賬時用價目表估算並標明來源。下面介紹它的定位、能力與安裝方式。

這是什麼¶

插件對外倉庫名爲 dsh-spend-meter，在 node_modules 與 dsh.profile.bundles 中的包 id 爲 dsh-spend-panel（因 npm 上 dsh-spend-meter 名稱已被佔用）。當前 package 版本爲 0.4.5，許可證 MIT，README 標明 no telemetry。

它解決的核心問題是：在 DSH 桌面會話裏閉環展示「錢包餘額、上輪扣費、今日累計、進行中的本輪預估」，並顯示峯谷計費時段，失敗時在 tooltip 說明哪條數據路徑不可用，而不是靜默顯示橫線。

核心功能¶

面板示意（界面隨 DSH 設計 token 渲染，可拖拽、可摺疊爲一行）：

會話花費                                  谷時  ▾
餘額                    ¥9.6540
上輪                    ¥0.0759
今日                    ¥3.0671
本輪                    ¥0.0412
計費            谷時 → 09:00 轉峯

餘額¶

從已登錄 DeepSeek 賬戶讀取錢包餘額，保留 8 位小數，優先走 platform.deepseek.com/api/v0/users/get_user_summary；若無平臺 grant，依次回退 api.deepseek.com/user/balance（API key）與宿主賬戶服務。

上輪（Last turn）¶

取本對話中最近一條已落賬回覆對應的 lifetime spend 計數器差值；含多步 tool calling 的整輪會合並計算。計數器約一分鐘內才更新時，面板暫用價目表估算，並在 tooltip 中說明。

今日（Today）¶

當前計數器 − 當日首次讀數；插件 midday 才安裝時，當日更早的用量會通過宿主會話 transcript 回填，並用實測/估算比例自校準。計數器來自 total_costs，充值與贈金只動餘額、不動計數器，因此差值不會因 top-up 被誤導。

本輪（Live）¶

對話仍在進行時，「本輪」顯示當前 turn 已產生的費用（估算或已部分落賬的數據）。

峯谷¶

DeepSeek 在北京時間工作日 09:00–12:00、14:00–18:00 按峯時 2× 計價；週末與法定節假日全天谷時。面板展示當前檔位及下次切換提示。

估算兜底¶

當計數器無法說話時（turn 未 settle、或插件安裝前的歷史），按宿主 usage 事件中的 inputTokens / cacheReadTokens / outputTokens 與 lib/pricing.js 價目表計算（reasoning token 已含在 outputTokens，不重複加）。未知 model id 回退 Flash 卡。

環境與要求¶

1. DeepSeek Harness 0.2.0-rc.2 或更新，且使用 desktop profile（面板佔用 client slot，純 Web 版 dsh 會話不會出現面板）。
2. 宿主內 Node 22+ 時支持 transcript 回填（多幀 zstd 依賴 node:zlib）；更舊運行時面板仍可從 balance book 工作，diag.transcript.error 會說明回填關閉原因。package.json 中 engines.node 爲 >=20，與 README 對回填的 Node 22+ 說明並存時，以 README 對回填能力的描述爲準。

插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

安裝與啓用¶

官方從 GitHub 安裝（無需 npm 包）：

dsh plugin --profile <name> add github:lx950/dsh-spend-meter

本地開發可鏈接目錄（改代碼後無需重裝）：

dsh plugin --profile <name> add link:/absolute/path/to/dsh-spend-meter

安裝後重啓 DSH。面板出現在會話中：拖標題欄移動位置，角按鈕摺疊；位置與摺疊狀態按機器寫入 localStorage。

桌面應用說明： desktop profile 由 Electron 殼管理，終端執行 dsh plugin --profile desktop add … 會被拒絕。可在應用內插件管理器從 GitHub 源安裝（若支持），或編輯 %USERPROFILE%\.dsh\profiles\desktop\package.json，在 dependencies 中加入 "dsh-spend-panel": "github:lx950/dsh-spend-meter"，並在 dsh.profile.bundles 中保留原有條目並追加 "dsh-spend-panel"，再在該目錄執行 pnpm install（或使用應用捆綁的 pnpm 路徑）並重啓應用。細節見倉庫 DEVELOPMENT.md。

典型用法¶

經過上面的步驟啓用後，無需額外配置項即可在對話旁查看花費。使用方式即：

1. 在 desktop 配置文件中安裝插件並重啓。
2. 正常發起對話；觀察「上輪」在 turn 結束後約一分鐘內從估算切換爲計數器實測（插件會在 turn 結束後先 2 s 輪詢約 20 s，再退避至 6 s，最長約兩分鐘等待計數器變動）。
3. 需要細節時查看面板 tooltip（餘額路徑、今日是否混用 transcript、峯谷切換時間等）。

計費計數器請求示例（DSH 已持有的 platform grant）：

GET https://platform.deepseek.com/api/v0/users/get_user_summary
x-dsh-auth-token: <the grant DSH already holds for platform.deepseek.com>

響應中的 normal_wallets.balance 與 total_costs.amount 爲面板數值來源。

適用場景與注意¶

適合： 長期在 DSH 桌面客戶端對話、希望實時掌握 DeepSeek 賬戶餘額與按 turn / 按日真實扣費（而非僅 token 數）的開發者與用戶。

注意：

• 必須使用 desktop profile；Web 會話看不到 client 面板。
• 無平臺或 API 餘額權限時，面板會降級並在 tooltip 說明，今日數字可能更多依賴價目表與 transcript。
• 價目表變更需關注倉庫 lib/pricing.js（含節假日表）；與官方 rate card 不一致時，估算段會有偏差，已落賬部分仍以計數器爲準。
• 插件不收集 telemetry（README badge）；仍會以 DSH 已有憑證訪問 DeepSeek 平臺/API，請確認你信任該開源實現。

結尾¶

dsh-spend-meter 把平臺賬單計數器與 DSH 會話用量接在一起：可拖拽面板裏看餘額（8 位小數）、上輪實測扣費、今日累計與進行中的本輪，並標註峯谷與數據來源。進一步瞭解可訪問社區目錄頁與 GitHub 倉庫。

• 目錄頁：https://www.skillhub.cn/plugins/lx950/dsh-spend-meter
• GitHub：https://github.com/lx950/dsh-spend-meter