前言¶
DeepSeek Harness(DSH)自帶的面板通常聚焦於單輪迴復的統計,而開發者往往需要了解整個會話的推理成本與結構。當模型提供商未提供每輪思考 Token 的報告時,手動統計會變得繁瑣且不準確。dsh-thinking-token-stat 插件解決了這個問題,它通過摺疊計算會話總數據,並在 Composer Dock 中提供直觀的統計視圖。
插件簡介¶
這是一個客戶端插件,由 Six6stRINgs 維護,開源協議爲 MIT。它通過 DSH 的會話投影機制進行一次性的持久化計算,讀取結果並在界面 Dock 中展示。其核心價值在於將分散在多輪對話中的推理 Token 統計彙總,並按輪次提供可過濾的詳情。
核心功能¶
- 會話級統計展示:在消息框下方的統計行中顯示會話總思考 Token 數、推理輸出佔比以及實際思考的輪次數。
- 按輪次詳情視圖:提供按輪次查看的表格,列出每輪的思考 Token、輸出內容、來源(已報告/已推導)、模型及佔比。
- 過濾與篩選:在按輪次視圖中,通過開關篩選僅顯示“已報告計數”、“已推導計數”或“無思考計數”的輪次。
- 估算處理:對於無法從文本推導或未報告的數字,使用
~標識,並區分“已報告”與“已推導”的計數來源。 - 持久化計算:利用 DSH 的會話投影機制,確保統計基於整個會話的完整日誌,而非僅限於當前窗口,且在頁面刷新後數據保持一致。
安裝¶
安裝命令在提供的源文中未明確列出。該插件可通過以下方式獲取源碼或查看文檔:
- GitHub 倉庫:Six6stRINgs/dsh-thinking-token-stat
- 技能庫目錄:dsh-thinking-token-stat
典型用法¶
- 查看會話概覽:打開一個包含多輪思考的對話,在 Composer Dock 的統計行中會顯示類似
💭 37.2K · 70.7% · 4 / 6 turns的信息。這分別代表總思考 Token 數、推理輸出佔比、實際思考輪次與總輪次。 - 點擊查看詳情:點擊該統計行,會彈出會話詳情面板。面板底部提供跳轉按鈕,可進入按輪次的視圖。
- 篩選輪次:在按輪次視圖中,使用頂部的開關過濾特定類型的輪次(例如僅查看需要推導 Token 的輪次)。
- 跳轉回復:在按輪次表格中,點擊行尾的跳轉按鈕,可快速定位到該輪次的具體回覆內容。
注意事項¶
- 不覆蓋單輪統計:插件不顯示單條回覆的思考 Token 數值,因爲 DSH 官方面板已提供該功能。
- 數據精度與格式:百分比保留一位小數,大數值使用 K 格式(如 24.8K)。
- 估算標識:所有基於文本摺疊或推導得出的數字均帶有
~前綴,表示估算值。 - 分頁限制:按輪次視圖每頁僅渲染 100 輪,超過部分需通過“Newer / Older”翻頁。
- 包含失敗輪次:列表包含所有輪次,包括失敗的或未產生回覆的輪次,這些輪次在表格中會顯示爲
—和None。
結語¶
dsh-thinking-token-stat 爲 DeepSeek Harness 用戶提供了一個可靠的會話級推理 Token 分析工具。它通過投影機制保證了數據的準確性,並通過清晰的界面幫助開發者理解模型在會話層面的推理行爲。對於需要精細控制推理成本或分析模型思考模式的開發者,該插件提供了必要的可視化支持。