DeepSeek Harness 的核心哲學是「一切皆插件」。在實際使用中,開發者往往需要追蹤 Token 消耗與對應的金錢成本。dsh-cost-stats 是一個客戶端插件,它直接在聊天界面中展示每輪對話的 USD 成本、統計圖表和交互式支出時間線。
該插件由 thezavtrak-a11y 維護,旨在解決 DeepSeek Harness 僅傳遞 Token 而不傳遞貨幣金額的問題。它通過本地費率表計算成本,並將結果集成到消息操作行、會話彙總和獨立選項卡中,無需對上游邏輯進行打補丁。
核心功能¶
每輪 USD 成本芯片¶
每條可計費的消息都會在操作行右側顯示 USD 芯片。芯片顯示總費用,並按功能分類(工具、推理、讀取)拆分,使用圖標區分。點擊芯片可查看分項詳情,包括請求/Token 數量、費用細分以及 Token 桶表。
交互式支出時間線¶
時間線工具支持縮放、平移和查看累積成本。默認開啓空閒壓縮,當對話暫停超過 20 分鐘時,該區域會被繪製爲斜線區域,避免非活動時間拉平圖表。支持的時間範圍包括 1 小時、6 小時、24 小時、7 天和全部歷史。
統計圖表與 KPI¶
在“Расход”選項卡中,可以查看成本 KPI、圖表、評級和費率表。圖表包含按輪次劃分的 Token 堆疊、成本分佈、時間分佈等。
會話費用匯總¶
在撰寫器下方,可以查看整個會話的總成本和剩餘餘額。
安裝與啓用¶
該插件使用 dsh.client 和 dsh.bundle.patch 聲明,安裝方式與其他 DSH 插件一致。
# 從 checkout 安裝或從已發佈的副本安裝
dsh plugin --profile <profile> add <checkout>
安裝後刷新頁面即可加載新插件。如果需要手動掛載,需依賴 cordis.patch.yml,並確保 Node 版本 >= 22。
典型用法¶
- 查看單次成本:在聊天對話中,操作行右側會顯示每輪的 USD 芯片,點擊可查看詳細分項。
- 分析會話支出:切換到“Расход”選項卡,查看 KPI、圖表和模型費用佔比。
- 分析流量趨勢:在時間線工具中,使用鼠標滾輪縮放、拖拽平移,或雙擊重置視圖。
- 監控會話預算:在撰寫器下方查看會話總成本及賬戶剩餘餘額。
注意事項¶
- 本地費率表:DSH 僅傳遞 Token,插件必須依賴本地費率表來計算精確的金錢成本。
- 降級處理:當精確計費不可用時,會根據請求重建數據並標記爲
≈;若缺少特定路由,相應區塊將不顯示。 - 許可證:插件使用 MIT 許可證。
- 依賴:安裝和運行需要 Node.js >= 22。
總結¶
dsh-cost-stats 通過將成本數據直接嵌入 DeepSeek Harness 的用戶界面,解決了開發者難以直觀感知單次對話和整體會話支出的痛點。它提供了從微觀(單輪芯片)到宏觀(時間線與圖表)的完整成本分析能力。
- 項目主頁: https://www.skillhub.cn/plugins/thezavtrak-a11y/dsh-cost-stats
- GitHub: https://github.com/thezavtrak-a11y/dsh-cost-stats