前言¶
在 DeepSeek Harness（DSH）裏跑多輪對話時，界面通常會顯示 Token 用量，但很少直接給出「這一輪大概花了多少錢、整個會話累計多少」。若要對成本心裏有數，只能自己查官方定價、對照四類 Token 手算，或依賴平臺賬單事後覈對。社區插件 dsh-conversation-cost（維護者 solstice621，分類：模型推理）面向 DSH 桌面版：自動拉取模型單價，在每條助手回答的用量與時間之間顯示 Cost ≈$x，並在輸入框下方展示當前會話累計金額；點擊可查看模型、四類 Token 與價格來源。無需新增 API key，無運行時 npm 依賴，不修改 App 或 asar，可獨立停用、卸載。
這是什麼¶
dsh-conversation-cost 是獨立社區插件，包名 dsh-conversation-cost。它在 Harness 內讀取會話用量與公開價格目錄，按每百萬 Token 單價彙總到「單輪迴答」與「本會話累計」，界面以美元 USD 展示估算值，不進行匯率換算。訂閱渠道會額外給出 API 價格折算的「訂閱等值」參考，明細中與 API 估算分開顯示；該參考不代表訂閱實際扣款。
DSH 生態強調「一切皆插件」；插件目錄頁在 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係。源碼與說明見 GitHub：solstice621/dsh-conversation-cost，許可證 MIT。
界面與顯示規則¶
每輪迴答結束後，順序爲 用量 → Cost → 時間。標籤默認顯示 Cost ≈$x；加載中、讀取失敗、未計價各有標識；後臺校驗時保留已顯示金額，不額外彈出「更新中」類提示。
輸入框下方顯示當前會話自己的累計金額，不重複計入 fork 繼承的上下文。點擊任一 Cost，可查看對應範圍（本輪或會話）的模型、普通輸入、緩存讀取、緩存寫入、輸出及單價，以及價格來源。
核心功能¶
| 能力 | 說明 |
|---|---|
| 每輪迴答費用 | 彙總該輪已記錄的各次模型調用，不混入其他輪次 |
| 會話累計費用 | 僅計本會話記錄，不合並子會話、不重複 fork 歷史 |
| 自動價格同步 | 啓動時讀取，之後每 6 小時刷新；明細中可手動同步 |
| 離線回退 | 同步失敗保留最近成功緩存；首次離線使用隨包公共價格快照 |
| 多模型與分檔 | 每次調用使用自己的模型與價格；上下文檔位按該次完整輸入選擇 |
| 本地費用緩存 | 先展示緩存，後臺校驗；新用量增量更新並落盤 |
價格從哪裏來¶
- deepseek / deepseek-official / deepseek-account：來自 DeepSeek 官方定價頁，按調用時間應用峯谷、週末與中國節假日規則（節假日數據含隨包 2026 年日曆；無可用日曆年份不會猜測峯谷價）。
- 其他 API 渠道：models.dev 公共目錄，精確匹配
provider/model，不會因名稱相似借用其他渠道價格。 - codex-subscription / openai-codex：用 models.dev 中同模型的 OpenAI API 價計算訂閱參考價值。
- opencode-go-subscription / opencode-go：優先 models.dev 的 Go 同模型價；缺價時僅可用 OpenCode Zen 相同模型 ID 的 API 參考價，明細中會註明參考路由。
可與 dsh-openai-auth、dsh-opencode-go-auth 搭配使用；本插件不依賴它們的授權流程，也不負責登錄或查詢訂閱額度。
金額如何計算¶
以每百萬 Token 的單價計算每條用量記錄，再彙總到對應回答和會話：
金額 =（普通輸入 × 輸入單價
+ 緩存讀取 × 讀取單價
+ 緩存寫入 × 寫入單價
+ 輸出 × 輸出單價）/ 1,000,000
推理 Token 已包含在輸出中，不重複相加。單次金額保留計算精度，最終顯示四位小數；極小的正數顯示小於 $0.0001。歷史用量按當前價格重估；價格更新可能改變舊會話顯示，插件不保存歷次賬單或歷史價格版本。因此適合查看成本量級，不是平臺賬單。
統計基於原始日誌中 assistant/message 的有效 usage；工具按次費用、無有效助手用量的失敗嘗試等不保證納入。
安裝與啓用¶
README 記載已在 macOS + DeepSeek Harness Desktop 0.2.1-rc.3 上驗證。插件不設宿主版本門檻，啓動時會檢查會話讀取和認證 Fetch 接口；其他宿主版本與操作系統尚未完成桌面驗證。
安裝前請自行閱讀倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，出站請求僅用於 models.dev、DeepSeek 定價頁及按需的 holiday-cn 年度日曆，不上傳對話、用量或憑據。
- 在 Harness 左側打開「插件」→「添加插件」。
- 填寫以下地址，安裝並啓用：
github:solstice621/dsh-conversation-cost#main
- 若當前窗口尚未出現 Cost，刷新 Harness 界面；仍未出現時完全退出並重新打開。
- 打開一個已有會話，即可看到累計費用和已完成回答的逐輪費用，無需爲驗證功能重新發送模型請求。
固定版本可將 #main 換爲指定提交 SHA；已有 tag 使用各 tag 對應聲明。插件直接提供可運行 JavaScript，無需構建或執行第三方安裝腳本。本地打包、CLI 安裝、更新與卸載見倉庫 docs/INSTALL.md。
典型用法¶
安裝並啓用後無需額外配置項或 API key。正常對話即可：每輪結束後在用量旁查看該輪 Cost ≈$x，在輸入框下方查看會話累計；需要覈對單價或四類 Token 時，點擊 Cost 打開明細。價格長期離線或缺價時，可在明細中使用「立即同步價格」（對應宿主 POST /api/conversation-cost/prices/refresh）。
本地緩存路徑（<DSH_HOME> 爲 Harness 數據目錄）：
<DSH_HOME>/cache/dsh-conversation-cost/prices.json
<DSH_HOME>/cache/dsh-conversation-cost/sessions/<sessionId>.json
快照不含對話正文、密鑰或 replayState；損壞或不匹配時會忽略並重新從會話日誌讀取。
適用場景與注意¶
適合：在 DSH 桌面版裏做智能體或多模型調試、需要快速對照 Token 與美元估算、對比不同路由或模型成本時。
注意：
- 當前版本固定美元顯示，提供逐輪與會話累計兩個入口，尚無隱藏 Cost 或改幣種設置。
- 缺價顯示「未計價」，不會當成免費；部分缺價時標籤只合計可計價部分。
- 恢復或導入會話應使用新會話 ID；費用緩存不重用已刪除會話 ID。
- 進程崩潰可能留下
.json.lock；確認無寫入者後可手動清理該會話殘留鎖。
結尾¶
dsh-conversation-cost 把公開定價與會話用量接到 Harness 界面裏，用最少操作看到每輪與會話的 API 成本估算。目錄頁：skillhub.cn/plugins/solstice621/dsh-conversation-cost；源碼與完整說明：github.com/solstice621/dsh-conversation-cost。
