前言¶
DeepSeek Harness(DSH)會在信息欄旁展示 token 用量,但 Harness 本身只記錄 token,不記錄金額。若你在本地或 Web 上長時間跑智能體會話,想快速知道「這一輪大概花了多少錢」「本會話累計多少」,只能自己對照官方價目表心算,既慢也容易和界面上的 token 數字對不齊。
下面介紹社區插件 dsh-cost-bar(維護者 WhXcjm,分類:客戶端)。它在 Composer 信息欄裏增加一條成本條,顯示本輪與會話的估算花費;點開可看按計費項拆分的雙欄明細,並與 DSH 的 tokenUsage 投影同源折賬。
這是什麼¶
dsh-cost-bar 是 DeepSeek Harness 插件:在輸入框信息欄顯示本輪與會話的估算花費,點開可看按計費項拆分的明細,以及本會話與全部會話的對比(README 亦描述爲 composer-bar cost pill)。
插件只讀會話數據:不改寫會話日誌,不改動模型請求,也不額外調用模型。金額由 token 數 × 單價估算,不是賬單。
信息欄與彈層顯示什麼¶
信息欄中的成本條位於 token 用量右側。金額標記顯示兩個數字:本輪成本 · 會話成本,各保留 3 位小數。
點開彈層後:
- 表頭:本輪成本、會話成本,保留 4 位小數。
- 左表按計費項拆賬:輸入支出、緩存支出、輸出支出,各給出本輪與會話兩列。
- 右表對比本會話與全部會話:對話輪數、今日支出、總計支出。總計覆蓋本機所有會話,含子代理會話與從持久化日誌回填的歷史會話。
- 底注:本會話緩存命中率、本會話緩存節省(按緩存命中價與輸入價之差估算)。
- 頁腳:當前模型、當前時段(空閒價 / 高峯價)、該時段的輸入 / 緩存 / 輸出單價,單位元每百萬 token。
總計列始終顯示四位:≥1 時保留 4 位有效數字,<1 時保留 3 位小數。會話列固定 3 位小數。
計價方式(與 token 欄同源)¶
Token 取自會話日誌裏每次模型調用結算的用量(assistant/message.usage)。折賬方式與 DSH 自身的 tokenUsage 投影一致:同一步內後到的樣本替換先前的樣本,llm/retry-started 之後的樣本重新累計。因此金額與信息欄旁的 token 數字同源。
每條消息按結算時刻取當時單價。DeepSeek 高峯時段爲北京時間週一至週五(法定節假日除外)9:00–12:00、14:00–18:00,高峯價爲空閒價的兩倍;一輪跨時段時分段計價。節假日按 prices.json 的 holidays 判定。「今日」按運行 DSH 的主機本地時區劃分自然日。
安裝與啓用¶
需要帶 sessions、sessionPersistence、connection 服務的 DSH 桌面或 Web 組合。插件通過已認證的 /api 通道暴露只讀快照,不新增端口。
從 npm 安裝:
npm install dsh-cost-bar
或從源碼安裝(克隆倉庫後,在 DSH 插件頁以本地目錄安裝):
git clone https://github.com/WhXcjm/dsh-cost-bar.git
在 DSH 的插件頁把 dsh-cost-bar 裝爲插件(npm 包名或本地目錄均可;Agent 也可用 plugin_manager 的 install_bundle),重載插件後信息欄出現成本條。
配置¶
bundle 的 cordis.patch.yml 註冊一行 cost-bar:
- insert:
- id: cost-bar
name: 'dsh-cost-bar'
config:
currency: '¥'
currency 只決定金額前綴。另有 coldScanBudgetMs(默認 2000)與 coldScanIntervalMs(默認 60000),控制歷史會話回填的單輪時間片與重掃間隔。
價格表 prices.json¶
價格、峯谷窗口與節假日都在 prices.json 裏,修改後數秒內熱加載,不必重啓或重裝。README 抄錄值(2026-11-01,元 / 百萬 token)如下:
| 模型 | 輸入(緩存未命中) | 輸入(緩存命中) | 輸出 |
|---|---|---|---|
| deepseek-flash · 空閒 | ¥1.00 | ¥0.02 | ¥4.00 |
| deepseek-flash · 高峯 | ¥2.00 | ¥0.04 | ¥8.00 |
| deepseek-v4-pro · 空閒 | ¥4.50 | ¥0.15 | ¥13.50 |
| deepseek-v4-pro · 高峯 | ¥9.00 | ¥0.30 | ¥27.00 |
模型鍵精確匹配,未收錄的模型走 default 行。緩存寫入按輸入價計。價格來源見 DeepSeek 模型與價格;節假日依據國務院辦公廳 2026 年部分節假日安排,次年安排公佈後把新日期補進 holidays。
典型用法¶
- 按上文安裝並重載插件,確認信息欄 token 右側出現成本條。
- 正常對話;觀察「本輪 · 會話」兩位小數字隨每次模型調用更新。
- 點擊成本條打開雙欄彈層,查看輸入 / 緩存 / 輸出拆賬,以及本會話與全部會話的輪數、今日與總計支出。
- 若官方調價或本地模型別名與默認鍵不一致,編輯插件目錄下的
prices.json,保存後等待熱加載即可。
Host 半通過 ctx.sessions 讀實時會話、ctx.sessionPersistence 回填歷史,經 ctx.connection.fetch 註冊只讀路由 /api/cost-bar/snapshot;Client 半向 conversation.composer.dock 註冊 id: cost(order: 2)。
適用場景與注意¶
適合在 DSH 桌面或 Web 上長期調試智能體、需要把 token 用量快速換算成人民幣估算、並希望和界面 token 數字一致的用戶。
插件以當前 DSH 進程的權限運行,並通過已認證 API 讀取會話快照;安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可證。社區目錄 skillhub.cn 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
經過上面的步驟,你可以在 Composer 信息欄直接看到本輪與會話的估算花費,並在彈層裏對照計費項與會話級彙總。更多截圖與開發說明見倉庫 README:
- 目錄頁:https://www.skillhub.cn/plugins/WhXcjm/dsh-cost-bar
- GitHub:https://github.com/WhXcjm/dsh-cost-bar