前言¶
在 DeepSeek Harness（DSH）裏跑長對話或頻繁委派 subagent 時，界面底欄往往只能看到 token 用量，卻很難立刻對照官方價目表心算人民幣或美元。賬單到達之前，峯值時段與閒時是否分開計費、緩存讀寫各算多少，也缺少與本地 Session 日誌一一對應的小計。下面介紹的插件把「當前 Session 及其子 Session」按內置或自定價表折算成費用，顯示在 Composer dock 裏 token 用量旁，並在面板中按峯值/閒時與計費桶拆解明細。
這是什麼¶
dsh-session-cost-live 由維護者 hiyijian 發佈，分類爲客戶端插件（DSH Web profile）。它在官方 token 用量 chip 旁增加一個 live session cost chip：用已提交的 Session 日誌統計用量，再套用 CNY 或 USD 價表得出金額；無計費用量時不顯示 chip。
核心功能¶
Session 合計與子 Session 彙總¶
費用不只算當前 Session 自身日誌，還會掃描 $DSH_HOME/sessions 下所有後代 Session，用與 Host 側一致的摺疊邏輯彙總。委派較多的對話不會因爲子 Session 未計入而顯得偏便宜。
內置雙幣種價表與峯值/閒時¶
開箱內置 DeepSeek 官方 CNY 價目（賬戶計費列表）與 USD 價目（英文定價頁），覆蓋 deepseek-flash、deepseek-v4-pro，無需先寫配置。峯值窗口按北京時區 工作日 09:00–12:00、14:00–18:00 用峯值單價，其餘時間爲閒時單價，兩類用量分開統計。
計費桶與賬單語義對齊：uncached input、cached input、cache write、output 互不重疊。某模型未配置單價時，總額顯示爲 -，面板提示未配置費率，不會借用其他模型價格。
Web UI 內編輯價表¶
在 Plugins → dsh-session-cost-live → Configure 中以表格編輯 CNY / USD 價表：新增模型（provider/model 或 model 加四項費率）、覆蓋內置行、恢復默認；僅持久化覆蓋項，保存後立即重算，無需重啓插件。非 DeepSeek 路由可在同頁添加條目，例如 moonshotai-cn/kimi-k2.6；若供應商不分峯谷，可關閉 Separate peak / off-peak pricing。
離線只讀¶
運行時無網絡請求、無遙測；Host 側只讀 Session 日誌。除在配置頁保存本插件配置外，不寫其他數據。
安裝與啓用¶
插件面向 DSH Web profile，掛載在 Composer dock 與官方 tokenUsage chip 相鄰。安裝後需重啓 dsh web 或刷新頁面。
官方安裝命令（將 web 換成本機 profile 名，例如 desktop）：
dsh plugin --profile web add dsh-session-cost-live
從源碼添加：
dsh plugin --profile web add git+https://github.com/hiyijian/dsh-session-cost-live.git
兼容性：DeepSeek Harness >=0.2.2-rc.1 <0.3.0-0（README 標明在 0.2.2-rc.1 上測試）；依賴 Node >=20。插件當前版本 1.0.0，許可證 MIT。
典型用法¶
- 安裝並重啓或刷新 Web UI 後，在 Composer 底欄查看 session cost；點擊 chip 可看總額，以及峯值/閒時下的 uncached input、cached input、output 等明細行（用量爲零的行不展示），並可在 CNY / USD 間切換（選擇按瀏覽器記住）。
- 需要自定義或非 DeepSeek 模型費率時，打開 Plugins → dsh-session-cost-live → Configure 編輯後保存。
- 高級用戶可將等價配置寫入 profile 的
cordis.patch.yml，例如：
- id: session-cost
name: 'dsh-session-cost-live'
config:
currency: CNY
peakPricing: false
prices: # CNY per 1M tokens
'moonshotai-cn/kimi-k2.6': { input: 4, cacheRead: 0.4, cacheWrite: 4, output: 16 }
pricesUsd: # USD per 1M tokens
'moonshotai-cn/kimi-k2.6': { input: 0.95, cacheRead: 0.16, cacheWrite: 0, output: 4 }
倉庫附帶 tools/reconcile-day.mjs，可在本地重放一日 Session 日誌，用與插件相同的摺疊與價表做覈對；只讀日誌，不調用模型 API。
費用如何計算（簡要）¶
用量來自已提交的 Session log（assistant/message，並處理進行中的 assistant/attempt 與 tokenUsage 重試替換規則），按落賬消息的 model route 歸因。金額在 session projection 的 client 視圖裏用當前價表投影，改價後無需狀態遷移即可重算。
適用場景與注意¶
適合需要在 DSH Web 界面邊聊邊對照官方（或自訂）單價、且常開 subagent 的開發者。插件以當前 dsh 進程權限 讀取 $DSH_HOME/sessions；安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證。社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-session-cost-live 在 token 用量旁補上 CNY/USD、峯谷拆分與子 Session rollup，並支持應用內改價表，適合把本地 Session 用量快速對照賬單桶。目錄頁：https://www.skillhub.cn/plugins/hiyijian/dsh-session-cost-live；源碼與說明：https://github.com/hiyijian/dsh-session-cost-live。
