前言¶

在 DSH 的插件化方式下，Web 對話視圖可以通過獨立包擴展功能。如果你已經在用 DSH Web 對話，想要在同一頁面查看某次、若干次或全部歷史對話的 token 用量，而不只是看單次消息的零散信息，@az7627/dsh-token-usage 提供的是一個用量統計抽屜：分時段堆疊柱狀圖，加上精確到個位的總計和每對話明細。

這是什麼¶

• 插件名：@az7627/dsh-token-usage
• 維護者：az7627
• 定位：DeepSeek Harness 插件，用於在 Web 對話視圖統計 token 用量
• 許可證：MIT
• 資料明確 package.json version 爲 0.1.1
• 倉庫：https://github.com/az7627/dsh-token-usage

它的核心數據來自會話日誌重放（/usage RPC 通道），因此歷史對話裝上後即可看到數據。

核心功能¶

1、入口：會話頭右緣「用量統計」按鈕，點擊後打開右側抽屜。

2、對話選擇：支持多選，默認當前對話 / 全選 / 僅當前。

3、時間粒度：15 分鐘 / 1 小時 / 1 天；範圍：近 7 天 / 近 30 天 / 全部。

4、用量分桶：

• 緩存輸入：cacheReadTokens
• 輸入：inputTokens + cacheWriteTokens
• 輸出：outputTokens

5、展示：ECharts 堆疊柱狀圖，按本地時區日曆對齊；tooltip 精確到個位；提供總計與每對話明細。

安裝與啓用¶

先執行安裝命令。這裏使用 npm 包名，包名帶作用域；無作用域的 dsh-token-usage 已被他人佔用。

npx @deepseek-ai/dsh plugin --profile web add @az7627/dsh-token-usage

安裝後重啓 dsh web：

npx @deepseek-ai/dsh web

更新時重新執行上面的 add 命令，pnpm 會裝最新版。

卸載：

npx @deepseek-ai/dsh plugin --profile web remove @az7627/dsh-token-usage

典型用法¶

安裝並重啓後，打開 DSH Web 對話視圖，在會話頭右緣點擊「用量統計」。先選擇要統計的對話，再選擇分度和範圍，然後查看堆疊柱狀圖、tooltip、總計以及每對話明細。

如果要在本地開發該插件，可以改用本目錄絕對路徑安裝：

npx @deepseek-ai/dsh plugin --profile web add <本目錄的絕對路徑>

修改源碼後執行構建，再重啓 dsh web：

pnpm run build
npx @deepseek-ai/dsh web

這一步無需重新執行 add。

本地開發的常用命令：

pnpm install
pnpm run build
pnpm test

適用場景與注意¶

適合在 DSH Web 中需要覈對 token 用量的人：比如查看近 7 天 / 近 30 天 / 全部歷史對話，比較 15 分鐘 / 1 小時 / 1 天粒度，覈對緩存輸入、輸入、輸出三類桶，以及精確到個位的總計。

安裝前注意：

• 插件會加載到當前 dsh 環境中運行；安裝前應檢查源碼與許可證。該項目許可證爲 MIT。
• 注意 npm 包名作用域，避免誤裝無作用域名稱。
• 依賴說明：zod 運行期；echarts 打進瀏覽器 bundle。
• peerDependencies 包含多個 @deepseek-ai/dsh-* 包，以及 react 和 react-dom ^18.2.0。
• 類型檢查依賴同目錄下 deepseek-harness 源碼樹裏已構建的 lib/types；這是僅編譯期引用，運行期全部由 dsh 安裝提供。

結尾¶

@az7627/dsh-token-usage 的價值比較直接：在 DSH Web 對話視圖中把 token 用量按時間、按對話、按輸入輸出分桶展示出來，並且歷史對話裝上即可查看。

倉庫：https://github.com/az7627/dsh-token-usage。

目錄頁：已覈實資料未提供固定 URL；如通過 DSH 插件目錄查找，請以目錄頁實際展示爲準。DSH 插件目錄是獨立社區站點，與 DeepSeek / 幻方無官方從屬關係。