前言¶
在 DeepSeek Harness（DSH）裏寫提示、跑會話時，時間往往被拆成一段段對話，很難在界面裏固定放一個倒計時。系統時鐘或獨立番茄鍾 App 可以計時，但要麼要切窗口，要麼和當前 Web 工作臺脫節。dsh-pomodoro 是維護者 atticuswx 發佈的客戶端類插件：把番茄工作法倒計時嵌進 DSH Web GUI，用可拖動的懸浮窗（以及可選的輸入框下方膠囊）在設置頁、空會話或任意麪板上保持可見，不依賴是否打開會話。計時與偏好全部在瀏覽器本地（localStorage），無服務端、無網絡請求；許可證爲 MIT。
這是什麼¶
插件包名 dsh-pomodoro，在 profile 裏顯示爲 pomodoro 一行。它面向已啓用 Web 客戶端 bundle 的 DSH 構建：安裝後 Client 半會註冊到 shell.overlay（常駐懸浮窗）和 conversation.composer.dock（可選計時條）。Host 半的 index.js 僅 apply() {}，計時邏輯全在 client.js。
核心功能¶
界面形態¶
收起時右下角是一顆小膠囊，顯示剩餘時間與進度符號；單擊展開、雙擊開始/暫停、可拖動。展開後爲可拖動懸浮卡片：標題欄拖動、⌄ 收回膠囊；中間是進度環（專注爲番茄紅、休息爲綠）與時間；下方顯示當前階段（專注 / 短休息 / 長休息）及本輪專注輪次的圓點（默認 4 輪專注後進入長休息）。
操作包括：開始/暫停、跳過（進入下一階段；若正在跑則繼續跑，若暫停則停在新階段起點）、重置（當前階段回到起點）、設置（⚙）。
設置項¶
在 ⚙ 面板可改：專注 / 短休息 / 長休息分鐘數、長休息前的專注輪數、「自動開始下一階段」「階段結束時提示音」「結束提醒動效」「同時顯示文字提示卡」「顯示懸浮窗」「輸入框下方也顯示一條」，以及「試播動效」「重置本階段」「恢復默認」。兩個顯示開關至少保留一個，避免把計時器完全關掉。輸入框下方計時條默認關閉；需要兩處或只留一條時可在設置裏切換。
窗口位置、展開/收起狀態寫入 localStorage 鍵 dsh:pomodoro:window:v1；尺寸變化時會夾回視口，拖出屏幕也不會丟。靠近視口邊緣 40px 內鬆手會貼邊吸附（留 12px 邊距）；中間區域則停在原地。
階段結束：提示音、通知與動效¶
階段自然結束時播放兩聲輕提示音（升調進入休息、降調回到專注）；首次點擊開始後會申請瀏覽器通知權限，之後階段切換會發通知。跳過、重置不觸發結束動效。
默認還有一套適合靜音環境的畫面動效（可在 ⚙ 選關 / 漣漪 / 邊緣光 / 組合，默認組合）：邊緣光、膠囊或卡片內漣漪、可選文字提示卡（約 4 秒淡出）。動效約 1.6–2.2 秒；系統開啓「減少動態效果」時退化爲靜態提示卡；標籤頁在後臺時，切回前臺會補播。設置裏「試播動效」可立即預覽。
狀態持久化¶
倒計時以單個 endsAt 時間戳驅動：刷新或關閉標籤再打開會繼續同一階段；後臺標籤被節流也不會算錯，回到前臺立即校準。若離開期間剛好結束一階段，回來時只結算該階段並停在新階段起點，不會連環跳階段。設置與計時狀態在 localStorage 的 dsh:pomodoro:v1；不同標籤頁各自獨立計時。
實現上只從 loader 模塊表取 react，顏色走 --dsw-alias-* 主題令牌；文案走 Client locale 的 pomodoro 命名空間（中/英）。
安裝與啓用¶
從 GitHub 安裝（推薦）：
dsh plugin --profile web add github:atticuswx/dsh-pomodoro
裝完後刷新頁面，右下角會出現膠囊。需要鎖定版本時可在地址後加 tag，例如：
dsh plugin --profile web add github:atticuswx/dsh-pomodoro#v0.3.1
包內無構建步驟，client.js 由瀏覽器直接加載；bundle 會寫入 profile 的 package.json 與 cordis.patch.yml，重啓後仍在。若改本地代碼後界面未更新，刷新頁面即可。
也可從本地目錄安裝（適合自行改代碼），或在 DSH 裏用 Plugin Manager 指定目錄絕對路徑安裝；具體命令見倉庫 README「安裝」一節。
典型用法¶
- 執行上述
dsh plugin --profile web add ...命令並刷新 Web 界面。 - 在右下角膠囊上雙擊開始第一輪專注；需要暫停再雙擊進度區或主按鈕。
- 單擊膠囊展開卡片，用 ⏭ 跳過、↺ 重置當前階段；在 ⚙ 裏按習慣改時長與是否顯示 dock 條、結束動效等。
- 拖動標題欄或膠囊到合適位置；貼邊鬆手可吸附。收起後仍可通過膠囊看剩餘時間並雙擊控制。
適用場景與注意¶
適合長期在 DSH Web GUI 裏工作、希望番茄鍾與界面同屏、且不把計時數據發到服務器的開發者。插件以當前 DSH 進程及瀏覽器上下文運行；安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境策略。
需要帶 Web client bundle 支持的 DSH 構建；社區目錄頁 skillhub.cn/plugins/atticuswx/dsh-pomodoro 與 GitHub 爲獨立信息來源，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-pomodoro 把共享的專注/休息倒計時、週期圓點、跳過與重置、提示音與可選動效收進一個可拖動的常駐懸浮窗，讓 DSH Web 工作臺自帶番茄工作法節奏。目錄頁：https://www.skillhub.cn/plugins/atticuswx/dsh-pomodoro；源碼與完整說明：https://github.com/atticuswx/dsh-pomodoro。
