前言¶

在 DeepSeek Harness（DSH）裏跑長會話時，輸入框下方那條統計條會常駐輪次、步數、吞吐和 token 總量，但不會直接告訴你：這次對話在 DeepSeek 官方渠道上大概花了多少錢，賬號裏還剩多少額度。若你同時配置了官方 API Key（deepseek-official）或官方賬號渠道（deepseek-account），又需要按高峯/空閒檔理解計費，單靠統計條裏的 token 數還要自己對價目表心算。

下面介紹社區插件 dsh-deepseek-usage-meter（維護者 AyahaShirane，MIT）。它在同一條統計條裏、緊跟 token 用量之後增加一枚指示器，顯示本次會話在官方渠道上的估算開銷與DeepSeek 官方賬號剩餘額度，並可在點擊後展開按模型、按計費項拆分的明細。

這是什麼¶

dsh-deepseek-usage-meter 是 DSH 的客戶端類插件：Host 側註冊會話投影 deepseekCost，瀏覽器側讀取投影並按 DeepSeek 官方價目表折算金額，同時可選調用 ctx.remote.account.getBalance() 拉取平臺側餘額。只處理 DeepSeek 官方路由；未配置官方 provider 時插件不註冊、不渲染，避免在其它 provider 上出現無意義的 ¥0 指示器。

社區目錄頁：https://www.skillhub.cn/plugins/AyahaShirane/dsh-deepseek-usage-meter
源碼與說明：https://github.com/AyahaShirane/dsh-deepseek-usage-meter

界面上會看到什麼¶

指示器掛在 conversation.composer.dock 槽位，與 token 統計條（id: "stats"）同一行，樣式沿用 DSH 設計 token，淺色/深色主題與統計條一致。

常駐一行大致形如：

● ≈¥2.2103 · 餘額 ¥11.23

行首圓點表示當前計費時段：綠燈爲空閒時段，紅燈爲高峯時段（懸停有說明，每分鐘重算）。點擊可展開面板，內容包括：各模型下未緩存輸入、緩存讀取、緩存寫入、輸出各花了多少錢（token 數在懸停提示裏）、該模型緩存命中率、本次開銷在高峯/空閒兩檔上的拆分，以及充值餘額與贈送餘額。面板刻意不重複統計條已顯示的會話總 token 與會話級緩存命中率。

數據從哪來、怎麼計價¶

金額按 DeepSeek 官方價目表計算（USD 與 CNY 兩套官方價，不做匯率換算），貨幣優先跟隨賬戶錢包。價目依據見官方文檔：https://api-docs.deepseek.com/zh-cn/quick_start/pricing。README 中列出的 CNY 示例（每百萬 tokens）包括 deepseek-flash 與 deepseek-v4-pro 在空閒/高峯下緩存命中、緩存未命中與輸出的單價；緩存寫入按緩存未命中價計入。

Host 側實現要點：同一 (turn, step) 重放時替換而非累加；llm/retry-started 之後的再次嘗試纔再次計入；按 (provider, model, 高峯|空閒) 分桶，歷史用量不會因當前時刻被重新定價。金額在瀏覽器側 lib/client.js 計算，Host 只提供可覈對的事實字段。

激活條件¶

兩層判定，且監聽 llm/adapters-updated 動態掛上或摘下投影：

1. Host：ctx.llm.listProviders() 中出現 deepseek-official 或 deepseek-account 才註冊 deepseekCost。
2. 瀏覽器：無投影則不渲染、不查餘額；若本會話有調用但全部走非官方路由，同樣不顯示；官方與非官方混用時會照常顯示。

安裝與啓用¶

README 中的安裝方式面向已把插件以 link: 形式放進 desktop profile 的開發/集成場景，而非通用的 dsh plugin add github:… 一行命令。資料原文示例：

"dependencies": { "dsh-deepseek-usage-meter": "link:<此目錄>" },
"dsh": { "profile": { "bundles": [ ..., "dsh-deepseek-usage-meter" ] } }

改代碼後讓客戶端重新加載 bundle（在 Plugins 頁關閉再開啓該插件）即可生效；重新安裝同名包需要重啓應用。

卸載：在 Plugins 頁停用並移除，或在 $DSH_HOME/profiles/desktop 執行 pnpm remove dsh-deepseek-usage-meter，並從 dsh.profile.bundles 中刪除該 bundle 名。

插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證，確認符合你的環境策略。社區目錄站點與 DeepSeek、幻方無官方從屬關係。

典型用法¶

1. 在 DSH 中配置並啓用 DeepSeek 官方渠道（deepseek-official 或 deepseek-account），開啓插件 bundle。
2. 正常對話；在輸入欄下方統計條右側查看 ≈¥… 與會話開銷相關的餘額片段。
3. 需要覈對「錢從哪來」時，點擊指示器查看按模型與計費項拆分的明細及高峯/空閒金額拆分。
4. 若已登錄官方賬號且 Remote 可用，餘額會與平臺側充值/贈送分列展示；餘額查詢失敗時僅影響餘額一半，開銷估算仍顯示。

維護者在倉庫提供 Host 摺疊語義、計價格式化與組件渲染的自測腳本（test/test-host.mjs、test/test-client.cjs、test/test-render.cjs），需 DSH 自帶 Electron 或 Node 環境，詳見 README「自測」一節。

適用場景與已知限制¶

適合：主要走 DeepSeek 官方 API Key 或官方賬號渠道、希望在同一界面看到會話級估算成本與賬號餘額的 DSH 用戶。

注意：

• 價目表爲 內置常量（lib/client.js 的 PRICES），官方調價後需手動更新插件。
• 節假日表目前只覆蓋 2026 年（lib/index.js 的 CN_HOLIDAY_RANGES_2026）；未列入的法定假日會按高峯計價，可能略微高估。
• 金額爲按官方價目表的估算，平臺賬單爲準；只統計當前會話，無跨會話或按天累計。
• 當前 package 版本爲 1.0.1（以倉庫 package.json 爲準）。

結尾¶

dsh-deepseek-usage-meter 把 DeepSeek 官方渠道的 token 用量、高峯/空閒檔與官方價目表接到輸入欄統計條上，在不大改 DSH 的前提下補全會話開銷與餘額這一層信息。需要細節時以 GitHub README 爲準：

• 目錄頁：https://www.skillhub.cn/plugins/AyahaShirane/dsh-deepseek-usage-meter
• 倉庫：https://github.com/AyahaShirane/dsh-deepseek-usage-meter