前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在開發智能體或進行長時間對話時，準確掌握當前會話的成本是一個常見需求。會話日誌中通常包含詳細的 token 使用情況，但分散在日誌裏，難以直觀查看。dsh-conversation-cost 插件直接讀取會話日誌中的權威 usage 數據，將 token 消耗轉化爲金額，並按不同時段和緩存策略進行計費。
什麼是 dsh-conversation-cost¶
這是一個由 Uersx 維護的 DSH 插件，分類屬於模型推理。它的核心作用是實時統計當前對話（當前會話）花費了多少錢。它基於會話日誌中每條 assistant/message 攜帶的真實 usage（provider 返回的 token 數），按 DeepSeek V4 官方定價估算費用，並區分高峯與空閒時段。
核心功能¶
- 實時金額顯示：在側邊欄底部常駐顯示
¥X.XX · N 次，每 5 秒自動刷新。該顯示完全替代了出廠 Cordis 面板的徽標位。 - 真實數據讀取：不估算 token 數，直接讀取會話日誌中的權威 usage，包含
inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens和reasoningTokens。 - 分段計費：根據調用實際發生的時間，區分高峯時段（每日 9:00–14:00）和空閒時段，分別累加費用，不做整段統一計價。
- 緩存命中計價：輸入計費包含未命中輸入、緩存寫入（按未命中價）和緩存命中（按未命中價的 1/30）。輸出計費按輸出價計算。
- 模型工具：提供
conversation_cost工具，模型可主動調用，返回逐次明細和彙總。 - 技能：提供
conversation-cost技能，指導模型何時調用該工具以及如何彙報費用。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness 並配置好 profile。支持本地目錄安裝和 GitHub 遠程安裝。
# 從本地目錄安裝
dsh plugin --profile demo add /path/to/dsh-conversation-cost
# 從 GitHub 安裝（自動拉取源碼並構建）
dsh plugin --profile demo add github:Uersx/dsh-conversation-cost
安裝完成後，驗證配置層是否加載成功：
dsh --profile demo --dump-config
輸出中應包含 # == dsh-conversation-cost 層。
典型用法¶
當用戶詢問“當前對話花費多少錢”或“成本”時，模型會自動觸發 conversation_cost 工具。
工具調用參數：
{
"timeBucket": "auto"
}
timeBucket 參數可選：
* auto：默認，按每條調用實際時間分別計費。
* peak：全部按高峯價計費。
* off-peak：全部按空閒價計費。
工具返回示例：
當前對話（會話 session-xxx）模型費用估算（按每次調用實際時段）
- 模型調用：171 次，其中可計價 171 次
- 總費用：¥3.8600
· 空閒時段：¥3.8600（171 次調用）
· 高峯時段：¥0.0000（0 次調用）
- 輸入 tokens：759975（緩存命中 20600448，緩存寫入 0）
- 輸出 tokens：140346
適用場景與注意¶
- 側邊欄顯示限制：側邊欄的金額讀數只在插件以包名安裝進帶完整界面的 profile 時加載（例如
dsh plugin --profile web add ...）。使用--patch源碼路徑掛載時，只會加載 host 半邊（核心邏輯和工具可用，但側邊欄讀數不會出現）。 - 計費準確性：插件顯示的金額爲基於官方定價的估算值，實際以平臺賬單爲準。對於未知模型，會單獨列出 token 統計，但不計入費用。
- pnpm 依賴限制：如果你的 pnpm 版本 ≥ 10 或 ≥ 11，且直接從 Git 安裝該插件，首次安裝可能會報
ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED錯誤。需要在 profile 的pnpm-workspace.yaml中添加allowBuilds配置白名單。
結尾¶
dsh-conversation-cost 爲 DSH 用戶提供了從日誌數據到費用估算的完整閉環，既能通過側邊欄實時監控，也能通過工具讓模型主動彙報成本。適合需要對成本敏感的長期對話或智能體開發場景。
