前言¶
DeepSeek Harness (dsh) 會爲每個會話寫入日誌。讀取這些日誌是回答“這臺機器實際花費了多少，在什麼上”的唯一方法—— harness 自身的投影僅覆蓋它運行的主機。此插件在數據層合併了兩個之前的插件，因此一個索引驅動一個儀表板，且數字在各處一致。
核心功能¶
該插件提供機器級 token 賬目：
- 每個 dsh 家目錄：掃描
~/.dsh、~/.dsh_desktop/<version>、$DSH_HOME。讀取舊版session.jsonl[.zstd]和版本化日誌。 - 一個範圍控制：今天 / 7 天 / 14 天 / 30 天 / 全部時間 / 自定義。該範圍控制標題卡片、趨勢、模型面板、會話排名、調用表和成本。
- 一個模型面板：每行顯示份額、堆疊輸入/緩存讀/緩存寫/輸出條、調用數和（如果定價）成本。
- 會話排名：按 token 排序；點擊行以篩選調用表。
- 平滑多系列趨勢：總/輸入/輸出/緩存讀，帶可切換圖例和懸停讀出。
- 調用詳情：時間、響應時間、輸入、輸出、緩存率、模型、思考 effort。帶篩選器（模型/提供商/閾值）和分頁。
- 導出：當前窗口的 CSV / JSON。
- UI 功能：可摺疊面板、中/英支持、淺色/深色主題。打開的面板每 60 秒自動刷新。
- 可選成本估算：本地定價表，帶高峯/非高峯加權。
安裝與啓用¶
使用官方命令安裝：
dsh plugin --profile web add github:satan9394/dsh-usage-unified
安裝後重啓 Web 配置文件。儀表板顯示在側邊欄頁腳的“使用統計 / Usage Stats”中，或作爲設置下的一個部分。
注意：插件在市場被阻止（需要文件系統/網絡訪問），但支持手動安裝。
典型用法¶
- 打開側邊欄頁腳條目（或設置 -> 使用統計）。
- 選擇日期範圍（今天/7天/14天/30天/全部時間/自定義）以篩選數據。
- 點擊會話排名行以篩選調用表。
- 在調用詳情表中使用篩選器（模型/提供商/閾值）。
- 通過 loopback API 端點訪問數據：
/usage-unified/v1/snapshot,/calls,/export.csv,/export。
適用場景與注意¶
- 版本要求：需要 DeepSeek Harness (dsh) 0.1.5-rc.1 或更新。
- 運行時：需要 Node.js ^22.19.0 || >=24.0.0。
- 隱私：完全在本地運行，瀏覽器端無網絡調用。
- 安裝：由於文件系統訪問要求，插件在市場被阻止，但支持手動安裝。
短結尾¶
該工具爲 DSH 提供了一個統一的視圖，用於跨不同會話日誌進行成本分析和使用模式追蹤。更多詳情請訪問 GitHub。
