前言¶
DeepSeek Harness（DSH）採用插件化架構。在 Web 界面進行智能體開發或調試時，精確控制單次會話的 API 調用成本是常見需求。dsh-session-cost 插件爲此提供了實時、基於官方計價引擎的成本統計功能，幫助開發者直觀監控 DeepSeek 模型的使用情況。
插件簡介¶
這是一個運行在 DeepSeek Harness Web 界面的會話花費插件，由 Lzh3070 維護。它會在輸入框旁顯示當前會話的 DeepSeek API 累計花費。
核心功能¶
- 輸入框實時花費：在
conversation.input.right槽位（模型選擇器左側）顯示當前會話的 DeepSeek API 花費，每 5 秒刷新一次。 - 嚴格模型門檻：僅當會話當前模型爲 DeepSeek 時生效。使用其他模型（如 MiniMax、Kimi）時，徽標自動隱藏，且非 DeepSeek 模型的請求不計價、不進入統計。
- 懸停浮窗展示明細：鼠標懸停在花費徽標上，會彈出與界面風格一致的浮窗，展示：
- 會話花費明細表格（輸入/緩存命中/輸出 × 數量 × 有效單價 = 金額）。
- 今日（DSH）用量：本機 DSH 會話今日（北京時間）消耗的 DeepSeek 花費。
- 賬戶餘額：通過讀取憑證中的
DEEPSEEK_API_KEY，經 DeepSeek 官方user/balance接口獲取。
- 官方計價引擎：按 DeepSeek 官方價格時間表，對每條
assistant/message消息按其發生時刻逐條計價。包含 2026-08-17 起的高峯/空閒定價（北京時間 09:00–12:00 / 14:00–18:00 爲高峯，其餘時段半價），並包含插件安裝之前的歷史。 - 性能友好：會話日誌按 revision 緩存（5 秒輪詢 = 一次 stat 比對，不重複解壓解析）；今日/餘額獨立 60 秒節奏。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add @phynez_1103/dsh-session-cost
- 安裝完成後，重啓 dsh web 服務，並在瀏覽器執行硬刷新（Ctrl+Shift+R）以加載新插件。
- 首次使用時，需在設置 → 模型中配置
DEEPSEEK_API_KEY。未配置時餘額顯示--，但會話花費仍可顯示。
典型用法¶
- 在設置中配置 DeepSeek API 憑證。
- 切換當前會話模型爲 DeepSeek 系列。
- 進行對話交互，輸入框旁會出現花費徽標（例如
¥0.12）。 - 鼠標懸停在徽標上，查看詳細的計價表格、今日用量及賬戶餘額。
注意事項¶
- 包名區分：本插件的 npm 包名是帶 scope 的
@phynez_1103/dsh-session-cost。npm 上的裸名包dsh-session-cost（如 ChengChe106/dsh-session-cost）是另一個同名插件，與本倉庫無關。 - 計價範圍：僅對 DeepSeek 模型計價，其他模型不計價且不顯示。
- 許可證：許可證爲 MIT。
結語¶
dsh-session-cost 提供了一個輕量級、基於官方計價引擎的解決方案，適合需要在 Web 界面監控 DeepSeek API 成本的開發者。更多細節可參考 GitHub 倉庫 或 社區目錄。
