前言¶

在 DSH Web 界面裏工作時，有時需要把專注計時和當前工作窗口放在同一處。DSH 的理念是「一切皆插件」，因此可以把番茄鍾作爲一個 web 插件掛到 DeepSeek Harness Web UI 上。下面介紹 causebefore/dsh-pomodoro。

這是什麼¶

dsh-pomodoro 是一個 DeepSeek Harness Web 插件，給 DSH Web 界面加入專注和休息循環。它提供側邊欄入口、可拖拽浮層面板、可配置時長、階段控制，以及階段結束時的應用內提醒和可選通知。維護者爲 causebefore，許可證爲 MIT。

核心功能¶

下面列出已覈實的能力：

• 在 DSH Web UI 中加入專注和休息循環。
• 從側邊欄打開面板，並在 DSH 插件設置頁管理配置。
• 支持開始、暫停、重置、跳過當前階段。
• 顯示圓形進度指示、階段狀態和已完成專注次數。
• 重新加載 DSH，或關閉標籤頁、重啓瀏覽器後再打開，可以從原截止時間繼續；若關閉期間當前階段已過期，會在恢復時結算一次。
• 支持 mini 模式，把面板收起爲階段、倒計時和主要控制，同時保留拖動、展開、關閉操作。
• 可分別設置專注時長和休息時長。
• 可選擇休息或下一次專注會話是否自動開始。
• 階段結束時提供 DSH 應用內提醒，並可選擇聲音和後臺系統通知。
• 跟隨 DSH 全局語言，支持中文和英文；切換語言時更新已掛載的插件界面，不重置計時器或未保存的設置草稿。
• 適配 DSH 淺色和深色主題、鍵盤操作，以及減少動畫偏好。

安裝與啓用¶

先確認環境：

• DeepSeek Harness >=0.1.0-rc.7，資料顯示其驗證於 0.1.1-rc.2。
• Node.js ^22.19.0 或 >=24.0.0。
• DSH profile 爲 web；headless profile 不提供 UI。
• 命令行可訪問 pnpm。

先做安裝：

dsh plugin --profile web add dsh-pomodoro

再做啓動或重啓：

dsh web

經過上面的步驟，如果側邊欄底部出現 dsh-pomodoro 按鈕，說明插件已加載。

典型用法¶

在 Web 界面中：

1、點擊側邊欄底部的 dsh-pomodoro 按鈕，打開或關閉面板。
2、拖動標題欄調整面板位置。
3、在面板中開始、暫停、重置或跳過當前階段。
4、使用面板的 Mini / Expand 切換緊湊佈局和完整控制。
5、打開 DSH 設置頁：

Settings → Plugins → Plugin configuration → Pomodoro

配置專注時長、休息時長、自動開始、聲音和系統通知。

如果你更習慣在 Web UI 內安裝，資料裏還給出兩條可選社區路徑。

先安裝 dsh-market：

dsh plugin --profile web add dshmarket

再重啓 DSH Web：

dsh web

打開：

Settings → Plugin Market

搜索 dsh-pomodoro，再安裝它。

另一條路徑是安裝 dsh-find-plugin：

dsh plugin --profile web add dsh-find-plugin

重啓 DSH Web：

dsh web

然後讓代理安裝 dsh-pomodoro。這裏屬於社區路徑，不應理解爲官方應用商店。

適用場景與注意¶

適合希望把番茄鍾放在 DSH Web 界面旁邊的開發者。

注意以下限制：

• DSH 仍處於 developer preview，升級 DSH 後需要重新檢查插件兼容性。
• 插件只適用於 web profile；headless profile 無法提供該 UI。
• 系統通知要求 DSH 從 localhost、127.0.0.1 或 HTTPS 提供服務，並且 DSH 頁面保持打開。
• 當所有 DSH 頁面都關閉時，瀏覽器無法在準確截止時間播放聲音或發送通知；下次啓動 DSH 會恢復計時器，並結算和報告一次過期階段。
• 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼、依賴和 MIT 許可證，確認符合你的使用要求。

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/causebefore/dsh-pomodoro
• GitHub：https://github.com/causebefore/dsh-pomodoro