前言¶

DSH 的插件化思路是「一切皆插件」。如果你在日常使用或調試 DeepSeek Harness（DSH）時，希望直接看到今日 token 總量，並進一步查看近 7 天、近 30 天用量、近 30 天模型堆疊圖、模型排行和會話統計，可以用 zhangzheng25/dsh-token-monitor。

下面介紹它的定位、核心功能、安裝與使用方式。

這是什麼¶

zhangzheng25/dsh-token-monitor 是一個 DeepSeek Harness 插件，由 zhangzheng25 維護，使用 MIT 許可證。

它會在 DSH 側邊欄底部（設置圖標旁）放一張「今日用量」卡片，顯示今日 token 總量。點擊卡片後彈出統計窗口，展示今日 / 近 7 天 / 近 30 天 token 用量、近 30 天按模型的堆疊用量圖、按模型使用排行，以及會話統計。

核心功能¶

• 側邊欄「今日用量」卡片即時顯示今日 token 總量，點擊彈出完整統計窗口。
• 統計今日 / 近 7 天 / 近 30 天 token 總量。
• 展示近 30 天按模型的堆疊用量圖。
• 展示按模型使用排行，窗口固定爲 30 天。
• 統計今日 / 近 7 天 / 近 30 天頂層對話數，副文字顯示對應時段的模型請求次數。
• 每 30 秒自動輪詢刷新，支持冪等重掃，也可手動點擊「刷新」與「回填歷史」。
• 數據持久化到 $DSH_HOME/plugins/token-monitor/data.json，按天按模型分桶，保留 181 天。
• 通過會話日誌冪等回填歷史用量，可以統計插件安裝之前的用量，重複運行不會重複計數。

安裝與啓用¶

插件要求 Node.js >=20。安裝前，建議先查看 GitHub 倉庫源碼、許可證和 AI 輔助生成聲明。

從倉庫安裝：

dsh plugin --profile web add github:zhangzheng25/dsh-token-monitor

從本地目錄安裝。下面命令使用 README 中的示例路徑，實際路徑需替換：

dsh plugin --profile web add E:\path\to\dsh-token-monitor

安裝完成後，需要重啓 DSH。啓動後，側邊欄底部（設置圖標旁）會出現「今日用量」卡片。

典型用法¶

安裝並重啓 DSH 後：

1、查看側邊欄底部（設置圖標旁）的「今日用量」卡片。

2、點擊卡片，打開統計窗口。

3、在窗口內查看今日、近 7 天、近 30 天 token 用量，近 30 天模型堆疊圖，模型使用排行和會話統計。

4、如果數據未更新，可點擊「刷新」。

5、如果需要把插件安裝之前的用量統計進來，可點擊「回填歷史」。

統計窗口支持 Esc、✕、點擊遮罩關閉，並在打開時鎖定背景滾動。

如果你只是做語法檢查，可以運行：

node --check src/index.js && node --check client/bundle.js

數據與限制¶

• 會話日誌是唯一數據源。
• sessionQuery 爲 live-preferred，可讀取內存活躍會話和落盤日誌。
• 會話數只計入頂層會話，即 delegationDepth === 0，不含子代理內部會話。
• 數據持久化到 $DSH_HOME/plugins/token-monitor/data.json。
• 數據按天按模型分桶，保留 181 天。
• 回填歷史是冪等重掃，重複運行不會重複計數，舊桶髒數據會自動自愈。
• 頁面每 30 秒輪詢刷新。

適用場景與注意¶

適合需要查看 DSH 日常 token 用量、近 30 天模型分佈和會話統計的使用者。也適合在本地檢查 DSH 插件行爲時查看插件提供的統計窗口。

使用注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 項目許可證爲 MIT。
• 項目 README 聲明：本項目由 AI 輔助生成，僅供學習與技術交流使用，不構成任何形式的商業保證或支持承諾。
• 安裝後需重啓 DSH。
• client/bundle.js 爲手工編寫的 web bundle，無需構建步驟。

參考¶

• GitHub：https://github.com/zhangzheng25/dsh-token-monitor
• 目錄頁線索（未在本次已覈實資料中確認）：https://www.skillhub.cn/plugins/zhangzheng25/dsh-token-monitor