前言¶

在 DeepSeek Harness（DSH）中，隨着會話變長，上下文佔用增加，緩存讀取的成本往往佔據賬單的絕大部分。開發者在決策是否保留上下文、如何優化提示詞時，往往缺乏精確的實時數據。

插件介紹¶

dsh-axia-cachebilling（蝦算賬）是一個 DSH Web 插件，由 Animal2404 維護。它將計費與緩存監控功能直接掛載到 DSH 自帶的“上下文佔用彈層”中，無需額外頁面，也不遮擋聊天主界面。

核心功能¶

該插件提供以下能力：

1. 三檔賬單統計
   - 提供當前步、當前輪、本會話三檔賬單。
   - 每檔明細包含：命中、未命中、輸出三部分的費用與統計。
   - 底部顯示當前使用的模型膠囊（包含供應商/模型、谷價/峯價、貨幣）。

2. 上下文統計（8項指標）
   - 基於會話日誌事件的真實計數，而非估算或佔比推算。
   - 指標包括：輪次、步數、工具調用、圖片、剪枝、注入、壓縮等，並附帶預估費用。

3. Token 統計
   - 展示總 Token、緩存輸入 Token、未緩存輸入 Token、輸出 Token。
   - 同時提供絕對量與百分比展示。

4. 計費與匯率
   - 多幣種自動統一：支持元與美元，通過實時匯率取自 open.er-api.com 統一折算，取不到時退化爲並列展示。
   - 峯谷價支持：支持按峯谷時段分別計價。
   - 價目目錄自動填價：內置 Open Code / Command Code / GLM / Kimi / MiniMax / MiMo 等模型價格，新增或修改模型時自動填價，也可手動刷新。

5. 配置集成
   - 供應商與模型列表直接從 DSH 已配置的列表中拉取。
   - 設置頁支持自定義條目（一口價、峯谷價、貨幣），修改即時生效，無需重啓 DSH。

安裝與啓用¶

執行以下命令安裝插件：

dsh plugin --profile web add github:Animal2404/dsh-axia-cachebilling

安裝完成後重啓 DSH，打開任意會話的“上下文佔用彈層”即可看到實時賬單。

注意事項¶

• 源碼與構建：插件的構建流程僅在 GitHub Actions 中執行，本地無需構建環境。
• 匯率來源：實時匯率數據取自 open.er-api.com。
• 權限與許可：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。