前言¶

DeepSeek Harness (DSH) 是一個基於插件的智能體開發框架。在開發智能體或使用 DeepSeek 模型時，追蹤每個對話的 token 消耗和對應費用是成本控制的關鍵環節。雖然模型會上報 usage 數據，但 DSH 原生並未提供按會話彙總並以貨幣形式展示的功能。dsh-session-cost 插件通過解析會話日誌中的 usage 數據，提供按會話統計的 token 用量及人民幣估算費用。

插件簡介¶

這是一個由 jyhn-hunao 維護的 DSH 插件，採用 MIT 許可證。它不依賴構建工具，是一個純 JS 實現的插件，能夠讀取模型上報的 token 統計信息，並將其轉換爲人民幣費用進行展示。

核心功能¶

1. 會話級統計：按會話統計模型上報的 token 用量。
2. 工具調用：提供 session_cost 工具，供 Agent 查詢一個或多個對話的消耗（不傳 sessionIds 時默認查詢當前對話）。
3. 命令行查詢：
   • /session-cost [sessionId]：查看當前對話或指定會話的累計消耗。
   • /session-cost-config：查看當前價格表。
4. 側邊欄展示：在側邊欄顯示會話累計費用（需特定環境支持）。

安裝與啓用¶

使用官方提供的安裝命令添加插件：

dsh plugin --profile <name> add github:jyhn-hunao/dsh-session-cost

首次安裝時，如果 pnpm 提示構建腳本未授權，可以在 profile 的 pnpm-workspace.yaml 中加入 allowBuilds: dsh-session-cost: true 並重試。該提示可安全忽略，因爲本插件實際沒有構建步驟。

使用方法¶

查看消耗¶

用戶可以通過命令行查看消耗：

/session-cost                 # 查看當前對話的累計消耗
/session-cost <sessionId>     # 查看指定會話的累計消耗

查看價格表¶

查看當前價格表：

/session-cost-config

讓 Agent 查詢¶

讓 Agent 查詢時直接說「查一下每個對話消耗了多少錢」，Agent 會自動調用 session_cost 工具。

價格表配置¶

默認價格表僅包含 DeepSeek 常規費率。DeepSeek 自 2026-08-17 起執行峯谷定價，高峯時段費率更高，默認值爲常規費率估算，請按你的實際結算費率覆蓋。

在 profile 的 cordis.patch.yml 中按 id 覆蓋整行 config（整表替換，未列出的模型回退到 *）：

- patch:
    - id: session-cost
      config:
        pricing:
          deepseek-chat: { inputPerM: 2, cacheReadPerM: 0.5, cacheWritePerM: 2, outputPerM: 8 }
          deepseek-reasoner: { inputPerM: 4, cacheReadPerM: 1, cacheWritePerM: 4, outputPerM: 16 }
          '*': { inputPerM: 2, cacheReadPerM: 0.5, cacheWritePerM: 2, outputPerM: 8 }

已知依賴與限制¶

• 數據來源：費用基於會話日誌中模型上報的 usage（assistant/message / assistant/chunk），與 DSH 內置 token 統計同源，數據準確，非估算。
• 側邊欄顯示限制：側邊欄行內金額 UI 需要官方倉庫支持 sidebar.workspaces.sessionRow 插槽。原版 DSH 尚未包含此插槽，因此側邊欄金額在原版上可能靜默不生效（session_cost 工具與 /session-cost 命令不受影響）。若要啓用側邊欄顯示，需要安裝帶對應插槽的 DSH 構建。

總結¶

該插件解決了智能體開發中成本追蹤的需求，通過解析會話日誌中的 token 使用數據，提供直觀的費用展示。安裝後即可通過命令或配置查看會話費用。

插件目錄：
https://www.skillhub.cn/plugins/jyhn-hunao/dsh-session-cost

源碼倉庫：
https://github.com/jyhn-hunao/dsh-session-cost