dsh-receipt：DeepSeek Harness 會話用量小票插件

前言¶

在使用 DeepSeek Harness 進行復雜開發或調試時，跟蹤單個會話的 Token 消耗、模型調用頻率以及實際產生的費用是剛需。原生界面通常只展示基礎統計，難以滿足對成本控制和模型分佈的精細化分析需求。dsh-receipt 插件通過在會話頭部增加“小票”入口，提供類似超市小票的概覽與明細視圖，幫助開發者直觀掌握會話成本。

插件簡介¶

插件名稱：dsh-receipt
維護者：bluechips-zhao
核心價值：本地計算並展示當前會話（含子代理）的用量與費用，支持按模型、按層級拆解。

核心功能¶

插件主要提供以下視圖與操作：

會話用量概覽：顯示總費用、小計、模型調用次數、Token 總量、緩存命中率以及平均每次費用。
費用與用量分佈：展示四色 Token 結構，支持切換查看金額或 Token 佔比最多的前五個模型。同時顯示模型耗時與會話跨度。
逐模型明細：展開查看具體調用次數、各類 Token 數量及計算出的費用。推理 Token 已包含在輸出 Token 中計算。
子代理費用：支持按層級展開，分別查看本代理費用及含所有後代的分支費用。支持按名稱或會話 ID 搜索，同級代理每次加載 20 條。
實用操作：支持複製文本摘要、鍵盤快捷鍵、窄屏適配、深淺主題切換以及減少動畫設置。

安裝與啓用¶

安裝插件後需重啓 GUI 才能加載新功能。

# 在 DeepSeek Harness web profile 目錄下執行
pnpm dsh plugin --profile web add github:bluechips-zhao/dsh-receipt

啓用步驟：
1. 安裝完成後退出並重新啓動 GUI。
2. 打開任意會話。
3. 在會話頭部右側點擊“小票”按鈕。
4. 點擊“查看全部模型明細”可切換到逐模型視圖。

配置與定價¶

插件內置了截至 2026-09-27 覈對的 DeepSeek 官方定價（空閒時段），並支持分時計價（峯谷）。

定價配置¶

在 profile 的 cordis.patch.yml 中配置覆蓋定價：

- id: dsh-receipt
  config:
    currency: ¥
    pricing:
      # 覆蓋示例，單位爲 ¥/1M tokens
      deepseek-flash: { input: 1, cacheRead: 0.02, output: 4 }
      deepseek-v4-pro: { input: 4.5, cacheRead: 0.15, output: 13.5 }
    # 補充非內置的法定節假日日期
    offPeakDates: ['2026-10-01']

計價邏輯：本地基於配置定價表估算費用。未配置單價的模型會顯示“未計價”。峯谷時段基於樣本時間判定，內置默認倍率爲 2。
推理 Token：屬於輸出 Token 的一部分，合計時不重複相加。
幣種：默認爲 CNY（¥），可在配置中修改。

權限與安全¶

插件運行在嚴格的只讀權限範圍內：
* 無外部依賴：不依賴外部服務，無網絡請求，無命令執行。
* 數據權限：僅讀取 host 端的 receipt 投影與 useSessions 行數據。
* 隔離性：不訪問文件系統、不讀取憑據、不啓動子進程。

兼容性¶

Node.js：^22.19.0 || >=24
DSH 版本：已驗證兼容 0.1.7-rc.2。

結尾¶

dsh-receipt 爲 DeepSeek Harness 用戶提供了本地化、實時的會話成本追蹤能力，適合需要精細化控制模型調用與預算的開發場景。

GitHub 倉庫：bluechips-zhao/dsh-receipt
社區目錄：DSH-Plugin Hub