前言¶
如果你在用 DeepSeek Harness（DSH）的 Web UI 管理會話，常會想查看本機 DSH 會話記錄裏的 tokens 用量、會話數量、消息數量、活躍情況、最常用模型，以及每日 token 消耗趨勢。下面介紹一個 DSH Web UI 插件：dsh-usage-lens。它安裝後會在設置面板新增「用量統計」頁面，用於直觀展示這些本地使用數據。
這是什麼¶
dsh-usage-lens 是 yokesky 維護的 DeepSeek Harness（DSH）Web UI 用量統計面板。
它對應的 npm 包名是 @yokesky/dsh-usage-lens，倉庫地址是：
https://github.com/yokesky/dsh-usage-lens
資料中給出的許可證爲：
MIT © 2026 yokesky
本次資料未給出星標數、目錄頁 URL 或完整 dsh client 配置，本文不展開這些內容。
核心功能¶
安裝後，DSH 設置面板會新增「用量統計」頁面。已覈實的功能包括：
- 總覽卡片：
tokens用量、會話數量、消息數量、活躍天數、當前連續天數、最常用模型。 - 活躍熱力圖：GitHub 風格的 280 天活躍熱力圖。
- 每日 Token 趨勢：按天查看
token消耗，可切換「模型 / 廠商」視角。 - 模型用量雙環餅圖：支持「彙總 / 廠商 / 模型」三種查看方式。
- 面板自動跟隨 DSH 的亮色 / 暗色主題。
安裝與啓用¶
方式一：通過 npm 包安裝¶
先安裝或確認已有 dsh CLI，然後執行插件安裝命令。
1、安裝 dsh CLI。如果已經安裝，可跳過這一步：
npm install -g @deepseek-ai/dsh # 先安裝 dsh CLI，然後才能執行 dsh 命令
2、給 Web 插件 profile 添加 dsh-usage-lens：
dsh plugin --profile web add @yokesky/dsh-usage-lens
3、重啓 web 服務，打開設置面板即可看到「用量統計」。
方式二：通過源碼安裝¶
源碼方式適合需要本地修改代碼、重新構建後再啓用的場景。資料中給出的 engines 聲明爲：
node >=24
請先確認本機 Node.js 版本滿足要求。
1、克隆倉庫並進入目錄：
git clone https://github.com/yokesky/dsh-usage-lens.git
cd dsh-usage-lens
2、安裝依賴並構建：
pnpm install
pnpm build
3、用 link: 方式指向本地源碼安裝：
dsh plugin --profile web add link:<本倉庫絕對路徑>
這裏的 link: 方式指向本地源碼。修改代碼後，重新執行 pnpm build 並重啓 web 服務即可生效，無需重新安裝。
典型用法¶
安裝完成後，先重啓 web 服務，再打開 DSH 設置面板，進入「用量統計」。
下面是一些常見查看路徑：
- 查看總覽卡片，確認
tokens用量、會話數量、消息數量、活躍天數、當前連續天數和最常用模型。 - 打開每日 Token 趨勢，按天查看
token消耗，並切換「模型 / 廠商」視角。 - 打開模型用量雙環餅圖，切換「彙總 / 廠商 / 模型」三種查看方式。
- 如果使用源碼方式安裝，修改代碼後執行
pnpm build，再重啓 web 服務。
適用場景與注意¶
適合以下開發者：
- 已經使用 DSH Web UI。
- 希望查看本機 DSH 會話記錄中的
tokens、會話數量、消息數量和活躍情況。 - 想按天查看 token 消耗趨勢。
- 想查看模型或廠商層面的用量分佈。
- 想通過本地源碼方式修改插件展示邏輯。
使用時注意：
- 所有數據來自你本機的 DSH 會話記錄，只在本地處理，不會上傳到任何地方。
- 面板自動跟隨 DSH 的亮色 / 暗色主題。
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解成官方應用商店。
鏈接¶
- GitHub 倉庫：
https://github.com/yokesky/dsh-usage-lens
- 社區目錄：本次資料未給出可覈實的目錄頁 URL，因此這裏不附目錄頁鏈接。
