前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常對話時，很少有人能準確說出「這週實際掛了多久客戶端」。系統活動統計往往粒度粗，也不按「一次打開到關閉」來記賬。社區插件 dsh-usage-timer（維護者 CQin04，目錄分類爲「記憶」）在 DSH 啓動時自動開始計時、關閉時結束，並在左側欄頁面彙總每次使用與累計時長；退出後 3 分鐘內重新打開會續接同一次記錄，避免頻繁重啓把一次使用拆成多條。下面介紹它的能力、安裝方式與使用時的限制。
這是什麼¶
dsh-usage-timer 是一個面向 DSH Web / Desktop 的客戶端插件（platform: web）。打開 DSH 即開始本次計時，關閉窗口即結束；所有數據只存在本機，不上傳。界面文案隨 DSH 語言在中英文之間切換，未翻譯語言回退英文。
- 倉庫：CQin04/dsh-usage-timer
- 目錄頁：skillhub.cn/plugins/CQin04/dsh-usage-timer
- 許可證：MIT（見倉庫
LICENSE） - 包版本（資料中的
package.json）：1.1.0
核心功能¶
資料中列出的能力如下，安裝啓用後即可使用，無需額外配置項。
- 打開即計時：頁面啓動時自動開始記錄；關閉窗口時結束。
- 連續計時：關閉後 3 分鐘內再次打開，視爲同一次使用，間斷時間仍計入該次時長；超過 3 分鐘則記爲新的使用。
- 每次使用記錄：保存每次的開始時間、結束時間與時長。
- 彙總：累計使用時長、打開次數、平均每次時長。
- 歷史列表：按天分組並顯示每日合計；當前會話實時顯示「進行中」。
- 實時秒錶：「本次使用」卡片每秒刷新。
- 本地存儲：記錄保存在 DSH 本地存儲，鍵名爲
dsh-usage-timer.v1。
界面入口¶
安裝並啓用後，在左側欄「全局面板圖標」區域（Plugins、定時任務圖標之後）會出現時鐘圖標，名稱爲「使用計時」。點開中央頁面包含三塊：
- 本次使用：已用時長、開始時間、計時狀態。
- 累計使用：總時長、打開次數、平均每次。
- 使用記錄：按天分組的歷史，每條爲「開始 → 結束」與該次時長。
安裝與啓用¶
要求：DSH Web / Desktop；本機可用 pnpm；從 Git 地址安裝時還需要 git。README 中記載的測試版本爲 DSH 0.2.2-rc.1。
方式一：Git 倉庫地址（推薦）¶
- 打開 DSH 左側欄 Plugins。
- 點 Add plugin（或箭頭菜單裏的 Install a third-party plugin）。
- 在包名字段填入倉庫地址：
https://github.com/CQin04/dsh-usage-timer
- 確認後等待安裝完成，插件會自動啓用。
方式二：本地目錄¶
- 將倉庫放到本機目錄，例如
C:\plugins\dsh-usage-timer。 - 在 Add plugin 中填入該目錄的絕對路徑，或以
file:/link:開頭的形式。 - 安裝並啓用。
以 link: 方式安裝時，DSH 引用該目錄而非複製文件，安裝後請勿移動或刪除該目錄。
驗證¶
Plugins 列表中出現 Usage timer / 使用計時，詳情頁顯示 README；左側欄出現時鐘圖標即表示插件已運行。
典型用法¶
日常無需命令行操作：保持 DSH 窗口打開即持續計入本次時長；需要查看統計時點左側欄「使用計時」即可。
若短時間內因升級或崩潰重啓 DSH，在 3 分鐘內重新打開，同一條會話會續接，彙總中的「打開次數」不會因此多算一次。需要從零開始記新的一使用時，關閉後間隔超過 3 分鐘再打開即可。
卸載：在 Plugins 中關閉 Usage timer / 使用計時 開關即可停用；卸載會移除代碼，但 localStorage 中的歷史仍在，必要時可在瀏覽器或應用中清除該站點數據。
數據存儲與計時行爲¶
- 桌面版內嵌頁面使用穩定源
_dsh-app://app，重啓應用一般不會丟記錄；通過瀏覽器訪問 Web GUI 時，數據按該頁面地址的源保存。 - 結構爲
{ version: 1, sessions: [{ id, start, end, lastSeen }] }，時間爲毫秒時間戳；end爲null表示仍在計時。 - 每 5 秒寫入一次心跳；正常關閉時立即寫入結束時間。崩潰或強退時，下次啓動會按最後一次心跳時間補上結束點。
適用場景與注意¶
適合誰：想量化自己在 DSH 上花費時間、區分「打開次數」與「總時長」的開發者或重度用戶；數據留在本機，適合作爲個人使用習慣的對照，而非團隊報表。
安裝前：插件在 DSH 客戶端環境中運行，與頁面腳本同級訪問本地存儲。安裝第三方插件前建議瀏覽倉庫源碼並確認 MIT 等許可證條款。
已知限制（來自 README）：
- 同時打開多個 DSH 窗口時，各窗口分別計時，累計時長可能重複。
- 窗口未關閉時（如系統休眠、鎖屏），時長仍會繼續累計。
- 最多保留最近 2000 條記錄。
- 清除該站點本地數據會清空全部記錄。
結尾¶
dsh-usage-timer 用低開銷的方式回答「DSH 開了多久、開了多少次」：自動計時、3 分鐘內重啓續接、側欄彙總與按天曆史，且數據不上傳。需要安裝或源碼細節時，可看目錄頁 skillhub.cn/plugins/CQin04/dsh-usage-timer 與 GitHub 倉庫 github.com/CQin04/dsh-usage-timer。
