前言¶

在 DeepSeek Harness 裏做多輪對話或智能體流程時，成本通常不只取決於單次輸出，還會受到緩存命中、緩存讀取、緩存寫入，以及高峯/空閒時段計價影響。若需要在一個會話裏逐輪查看 token 用量對應的成本，而不是隻看一個總數，就需要把用量時間線投影到前端並做成本讀數。下面介紹 dsh-usage-cost 插件。

這是什麼¶

dsh-usage-cost 是一個 DeepSeek Harness 插件，用於按會話逐輪 token 用量即時計算 DeepSeek API 成本，並在 8/17 起自動切換峯谷計價。

倉庫地址爲：

https://github.com/Dino6021/dsh-usage-cost

許可證爲 MIT。

核心功能¶

插件包含兩部分：

1、服務端 session projection 投影 usageTimeline：逐條 assistant/message 的 token 桶（未命中 / 輸出 / 緩存讀 / 緩存寫），並記錄完成時間戳。

2、conversation.composer.dock 槽 usage-cost：提供四段成本讀數（對話 / 工作區 / 今日 / 5小時）。

計價邏輯上，8/17 零點自動由平峯切爲峯谷，逐輪按時間戳判峯谷。若沒有時間線（舊會話/投影缺失），插件回退平峯價。

安裝與啓用¶

安裝命令如下，使用 web profile，從 git 源安裝 main 分支：

dsh plugin --profile web add "github:Dino6021/dsh-usage-cost#main"

該插件採用官方 bundle 形態（dsh.bundle.patch + dsh.client），構建產物已入庫，因此從 git 源安裝時無需額外構建。

執行安裝命令後，重啓 web 並刷新頁面。經過上面的步驟，對話底部（統計行下方）會出現成本行。

典型用法¶

安裝完成後，可在對話底部看到四段成本讀數：對話、工作區、今日、5小時。

若需要覈對或調整單價，可以編輯 lib/client.js 頂部的單價定義。改價後生效步驟如下：

1、編輯 lib/client.js。

2、重新執行安裝命令：

dsh plugin --profile web add "github:Dino6021/dsh-usage-cost#main"

3、刷新頁面。

計價以官方價爲準：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing/

其中，緩存寫入價按「緩存未命中」價計；DeepSeek 未單列寫入價，該桶實際常爲 0。

已裝插件也可以用 plugin-registry 的薄控制檯管理，即瀏覽器面板。

適用場景與注意¶

適合在 DeepSeek Harness web 端運行，需要查看單輪、對話、工作區、今日和 5 小時成本的人。若會話較舊或服務端投影缺失，插件會使用平峯價作爲回退，而不是保留峯谷價。

安裝前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 安裝後必須重啓 web 並刷新頁面。
• 單價維護在 lib/client.js 頂部；調整前建議先對照官方價。
• 本插件從 git 源安裝時無需構建，但仍建議確認倉庫源碼、依賴與許可證後再安裝。

結尾¶

dsh-usage-cost 的價值在於把逐輪 token 用量和成本讀數放進 DSH 對話界面，便於在峯谷計價切換後覈對實際費用。倉庫地址：

https://github.com/Dino6021/dsh-usage-cost