前言¶
在 Harness 裏寫代碼、跟 agent 對話時，專注時段往往被會話切換、設置面板和主題改動打斷。瀏覽器標籤頁或系統裏的獨立番茄鍾可以計時，但一般不會掛在 Harness 窗口上，也容易和當前工作上下文脫節。
下面介紹社區插件 dsh-pomodoro-timer（維護者 pzdn2009，分類：客戶端）。它在窗口級浮層 shell.overlay 裏註冊計時 UI，切換會話、打開設置、換主題時不會被卸載，適合需要在 Harness 界面內做番茄工作法的開發者。
這是什麼¶
dsh-pomodoro-timer 是 DeepSeek Harness 的懸浮番茄專注計時器插件。簡介爲：A floating Pomodoro focus timer plugin for DeepSeek Harness。
- 目錄頁：https://www.skillhub.cn/plugins/pzdn2009/dsh-pomodoro-timer
- 源碼：https://github.com/pzdn2009/dsh-pomodoro-timer
- 許可：MIT（見倉庫 LICENSE）
- 包版本（package.json）：
1.1.0
計時邏輯完全在瀏覽器端運行；Host 側 index.js 爲空 apply，不引入額外運行時依賴。
核心功能¶
默認節奏（時長可在設置裏改）：
- 專注 25 分鐘 → 短休息 5 分鐘
- 每完成 4 個專注 → 長休息 15 分鐘
界面與反饋：
- 圓環進度、今日完成數、階段提示
- 窗口右上角膠囊顯示剩餘時間；點擊展開計時卡片（向下展開，不遮擋膠囊）
- 樣式僅用宿主主題 token（
--dsw-alias-*），隨淺色/深色主題切換；文案隨界面語言在中英文間切換（locale/en.json、locale/zh.json）
階段結束：
- 彈出提示條
- 自動播放約 2 分鐘輕音樂（WebAudio 實時合成，倉庫無音頻文件、不依賴外部音源），可隨時停止
- 「自動開始下一段」打開時，階段結束後直接進入下一段
可調項（卡片頭部設置）：
- 專注 5–120 分鐘，休息 1–60 分鐘
- 開關「自動開始下一段」與階段結束輕音樂
計時與狀態：
- 基於絕對截止時間；後臺標籤節流、刷新頁面、重啓應用不影響準確性（以 README 說明爲準）
- 狀態保存在
localStorage
安裝與啓用¶
插件面向 dsh 0.2.x 的插件 manifest 與 slot API；需已安裝 DeepSeek Harness。
README 給出的獲取與安裝步驟如下。先將倉庫克隆到本機目錄（示例路徑可按環境修改）：
git clone https://github.com/pzdn2009/dsh-pomodoro-timer.git ~/dsh-pomodoro-timer
在 Harness 對話裏讓 agent 用 絕對路徑 安裝該目錄，例如：
用 plugin_manager 安裝
/Users/<you>/dsh-pomodoro-timer
安裝成功後窗口右下角會出現番茄色膠囊；若未出現，刷新一次頁面。
插件以當前 dsh 進程及瀏覽器環境運行；安裝前建議自行查看 client.js 等源碼並確認 MIT 許可是否符合你的使用場景。
典型用法¶
- 看窗口右上角膠囊上的剩餘時間；點擊展開卡片。
- 使用卡片按鈕：開始 / 暫停 / 繼續、重置當前階段、跳到下一階段。
- 階段結束時會有提示條與可選輕音樂；膠囊下方可能出現「輕音樂播放中 · 停止」橫條。
- 在卡片頭部進入設置，調整專注與休息時長，以及自動開始、輕音樂開關。
- 按
Esc收起卡片。
本地改 client.js 後，讓 agent 對同一目錄重新執行 plugin_manager 的 install_bundle；界面無變化時再刷新頁面。
結構與實現要點¶
| 文件 | 作用 |
|---|---|
package.json |
清單：dsh.bundle.patch 與 dsh.client（platform: web, immediately: true） |
cordis.patch.yml |
插入 pomodoro-timer 插件行 |
index.js |
Host 半邊（空 apply） |
client.js |
狀態機、shell.overlay 槽、React 組件與樣式、WebAudio 輕音樂 |
locale/*.json |
插件管理器標題與描述 |
icon.svg |
圖標 |
適用場景與注意¶
適合：長時間在 Harness Web 窗口裏工作、希望在同一界面內用番茄法切段、又不想計時器隨會話切換被卸掉的開發者。
注意：
- 社區目錄 SkillHub 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；安裝方式以 README 爲準，勿假設存在未文檔化的
dsh plugin add一鍵命令。 - 插件在瀏覽器中讀寫
localStorage併合成音頻，權限邊界與宿主頁面一致；敏感環境請先審閱源碼。
結尾¶
dsh-pomodoro-timer 把經典番茄節奏接到 Harness 的 shell.overlay 上，並在階段結束時用內置 WebAudio 提供可選輕音樂，狀態與主題、語言跟宿主對齊。需要詳情或提 issue 時，可打開 目錄頁 與 GitHub 倉庫。
