前言¶
在 DeepSeek Harness 里長時間寫提示、跑代理時，計時往往靠系統時鐘或單獨開一個小工具，和當前會話不在同一界面。DeepSeek Harness 支持通過客戶端插件在 Web 界面裏掛組件；下面介紹 Kseleven 維護的 dsh-pomodoro-timer（包名 dsh-pomodoro-card），它把番茄鍾放在會話輸入框下方的環境欄（conversation.composer.dock），專注、短休息、長休息三段循環與倒計時同屏可見，刷新頁面後仍可繼續。
這是什麼¶
dsh-pomodoro-timer 是 DeepSeek Harness 的客戶端插件：在輸入框下方環境欄常駐一個番茄鍾，用圓環顯示剩餘時間與當前階段，並提供專注 / 短休息 / 長休息循環。維護者爲 Kseleven，在插件社區目錄中歸類爲「客戶端」；倉庫簡介爲 a pomodoro timer plugin in deepseek-harness。Host 側 index.js 爲空實現，計時與 UI 完全在 Client 模塊 client.js 中完成。
- 目錄頁：https://www.skillhub.cn/plugins/Kseleven/dsh-pomodoro-timer
- 源碼：https://github.com/Kseleven/dsh-pomodoro-timer
- 許可證：MIT（資料中
package.json與 README 一致）
核心功能¶
以下能力均來自倉庫 README 與 package.json 聲明，未在資料中出現的數字或行爲不寫。
三段循環與界面
- 專注 → 短休息 → 專注 …，每完成可調次數的專注後進入長休息（默認每 4 個專注一次長休息，間隔 1–8 個可調）。
- 圓環倒計時：點擊開始 / 暫停 / 繼續；圓環隨剩餘時間收縮，階段顏色分別爲專注番茄紅、短休息綠、長休息藍。
- 階段名與循環內圓點進度（例如 ● ● ○ ○）；重置本階段、跳過本階段（跳過不計入完成數）、設置面板（⚙，可用
Esc收起）。
統計與持久化
- 按本地日期統計當日完成的專注數，跨天自動歸零。
- 狀態寫入
localStorage，鍵名爲dsh:pomodoro:timer:v1；用絕對結束時間記錄，刷新或重開頁面後繼續倒計時；同一 Harness 窗口內多個會話共享同一計時器。
提醒與設置
- 階段結束：輸入框下方計時卡彈出提醒（說明下一階段、時長及自動開始或待手動開始），約 10 秒後自動收起，可點 × 關閉；完成提醒不寫入
localStorage，刷新後不會重複彈出。 - 完成提示音：Web Audio 三音提示；瀏覽器需先有頁面點擊 / 按鍵才能出聲，插件在開始計時後會保持音頻解鎖。
- 可選系統通知（默認關）；設置面板顯示授權狀態，可「發一條測試通知」驗證；桌面通知約 12 秒後自動關閉，聲音由提示音負責。
- 可調：專注 / 短休息 / 長休息時長（分鐘範圍見 README）、長休息間隔、自動開始下一階段、完成提示音、系統通知；支持一鍵恢復默認（僅重置設置項，不清除運行狀態鍵需自行刪
localStorage鍵）。 - 文案跟隨 Harness 語言設置，內置中 / 英文，默認回退英文。
技術側
- 純 Client 模塊，無需構建；註冊在
conversation.composer.dock槽位。 - 計時邏輯以 250ms ticker 驅動，僅在顯示秒數變化或階段切換時通知訂閱者，動作與階段切換時落盤，不會每秒寫
localStorage。 - 主題使用 Harness 的
--dsw-alias-*設計令牌。
安裝與啓用¶
插件通過 Harness 插件管理器以本地 bundle 安裝（在 profile 的 node_modules 中以 symlink 指向插件目錄）。資料未提供 dsh plugin add github:... 一類命令，請勿憑插件名拼接。
在本會話中，可讓代理執行（將路徑換成本地克隆或下載後的插件目錄絕對路徑）：
plugin_manager(action: "install_bundle", target: "<本目錄的絕對路徑>")
或在 Harness 插件管理界面選擇「從本地目錄安裝」，指向包含 package.json 與 cordis.patch.yml 的目錄。
安裝完成後輸入框下方應出現番茄鍾；若未出現，刷新一次 Web 界面。若修改了 package.json 裏的 name 或 dsh 清單，需重新安裝一次；僅改 client.js 等代碼時，刷新即可（profile 內爲 symlink）。上架到插件市場供 Discover 搜索的步驟見倉庫內 MARKETPLACE.md。
典型用法¶
| 操作 | 行爲 |
|---|---|
| 點擊圓環 | 開始倒計時 / 暫停 / 繼續 |
| ↺ | 重置當前階段到完整時長（不改變已完成數） |
| ⏭ | 跳過當前階段，不計入完成數 |
| ⚙ | 展開 / 收起設置 |
設置項要點（細節以 README 爲準）：
- 專注時長 1–120 分鐘，短休息 1–60 分鐘，長休息 1–120 分鐘。
- 關閉「自動開始下一階段」時，每段結束停在待開始狀態，需再點圓環；提醒中會提示「已暫停，點開始繼續」。
- 專注完成時「今日完成」與循環圓點 +1；跳過專注不增加統計。
- macOS 上使用系統通知時，需在系統設置中爲 DeepSeek Harness 允許通知並將提醒樣式設爲「橫幅」或「提醒」，否則可能只進通知中心。
清除 localStorage 鍵 dsh:pomodoro:timer:v1 可恢復默認運行狀態；設置面板「恢復默認」只重置設置項。
開發自測（在插件目錄內）：
npm test
等價於 node test/run-tests.mjs，無需瀏覽器或 React 運行時。
適用場景與注意¶
適合誰
- 在 Harness Web 界面里長時間對話、寫提示或盯代理執行，希望計時器與輸入區同屏、不另開應用的用戶。
- 需要番茄工作法三段循環、今日專注計數，且希望刷新頁面後倒計時仍能接續的場景。
注意
- 插件在 DeepSeek Harness 客戶端（Web）進程中運行，讀寫本機
localStorage；安裝前請自行查看源碼與 MIT 許可證，確認符合你的環境與合規要求。 - 社區目錄（skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標與 discover 數據以各站點展示爲準（資料中 GitHub 星標爲 0）。
- 提示音與系統通知受瀏覽器與操作系統策略限制；首次使用提示音需在頁面上有一次交互。
結尾¶
dsh-pomodoro-timer 把番茄鍾嵌進 Harness 輸入框下方的 dock，用圓環、階段進度和本地持久化解決「計時與對話分離、刷新丟狀態」兩類常見不便。若要查看條目說明或跟進 issue，可訪問 插件目錄頁 與 GitHub 倉庫。
