前言¶
在 DeepSeek Harness 裏寫提示、跟對話，時間常常被一段段長任務喫掉，卻又不值得單獨開系統計時器或手機 App。DSH 的插件機制允許把常用工具嵌進殼層界面；dsh-pomodoro-clock 就是在客戶端右側掛一個番茄鍾：可拖動的右邊緣把手、浮動卡片或停靠側欄頁籤，單次倒計時或經典番茄循環，結束時用瀏覽器內合成的提示音（含可選「機場播報」語音）。全程在本地運行，不依賴構建步驟與外部音頻文件。
這是什麼¶
dsh-pomodoro-clock 由維護者 new2023start 發佈，歸類爲客戶端插件。它在 Harness 右側邊欄及相關殼層席位上註冊計時界面：右緣把手顯示 mm:ss 與運行指示點，點開即浮動卡片；同一套狀態也可固定在右側欄頁籤，並在頁籤標題上顯示實時倒計時。中英文界面跟隨 Harness 語言設置。
核心功能¶
界面入口¶
插件通過以下席位掛載（資料摘自項目 README）：
| 表面 | 席位 | 作用 |
|---|---|---|
| 右緣把手 + 彈出層 | shell.overlay（id dsh-pomodoro） |
貼右緣的可拖動把手，展開浮動計時卡片；⌄ 可收起 |
| 右側欄頁籤 | sidebar.right.pane.tab（key dsh-pomodoro-clock） |
與把手相同的計時器，以頁籤形式停靠 |
| 頁籤標題 | sidebar.right.pane.tab.title |
頁簽上顯示 mm:ss |
| 右側欄引導 | guide pomodoro |
引導頁中的「Pomodoro timer」卡片，可打開頁籤 |
把手可上下拖動停靠；位置寫入 localStorage 鍵 dsh.pomodoro.anchor，刷新後仍保留且限制在視口內。卡片相對把手在窗口上半區向下、下半區向上展開。把手、彈出層與頁籤共用同一狀態存儲，摺疊或關閉界面不會重置正在進行的倒計時。
計時模式¶
- 單次（默認）：設置分鐘數後啓動，到零響鈴一次並停止，然後以相同時長重新待命；無休息段、無自動下一輪。
- 番茄循環：專注（默認 25 分鐘）/ 短休（5 分鐘）/ 長休（15 分鐘），可配置每輪循環次數（1–12）；可選 Auto-start 自動進入下一階段。
切換模式會重新待命並清空當前運行階段。進度保存在 localStorage 鍵 dsh.pomodoro.v1；日曆日變更時每日計數器會重置。
聲音與通知¶
提示音全部用 WebAudio 在瀏覽器合成（基頻加弱泛音，動機重複約 3–8 秒），不隨包分發音頻文件。可選：清脆三聲、機場播報、鐘聲、木魚、靜音；下拉旁有 ▶ 預覽。
「機場播報」在五音下行提示後通過 speechSynthesis 朗讀（中文：「本次專注時間已結束，請稍作休息。」；英文隨界面語言）。無可用語音引擎時仍播放音調，僅無語音播報。另可開啓桌面通知。
單次模式可調倒計時時長（1–120 分鐘）。循環模式可調各階段時長、輪數與自動開始。客戶端僅使用 --dsw-alias-* 主題令牌以適配當前主題；可見文案在 dshPomodoro 語言包（zh / en，其他語言回退到 en）。
安裝與啓用¶
市場安裝：Plugins → Market → dsh-pomodoro-clock → Install。
命令行任選其一（與 README 一致）：
dsh plugin add dsh-pomodoro-clock
或安裝發佈包（當前資料中的版本爲 v1.0.0）：
dsh plugin --profile web add "https://github.com/new2023start/dsh-pomodoro-clock/releases/download/v1.0.0/dsh-pomodoro-clock-1.0.0.tgz"
安裝會向 profile 增加席位，不替換已有發貨內容。package.json 標明客戶端面向 web 平臺，immediately: true，並注入右側欄、對話與 locale 相關客戶端模塊；無額外運行時依賴，提示音亦在瀏覽器合成。
典型用法¶
- 最快：點右緣把手，在浮動卡片裏設時長或切到循環模式，啓動計時；拖動把手到順手高度。
- 停靠側欄：在右側欄引導頁打開 Pomodoro timer 卡片，進入同名頁籤；頁籤標題會持續顯示剩餘時間。
- 配置：在設置裏選模式、時長、輪數、聲音（可先預覽）、是否桌面通知；循環模式按需打開 Auto-start。
開發側可用倉庫內煙霧測試（無需瀏覽器）：
node test/smoke.cjs
適用場景與注意¶
適合希望在 DSH Web 客戶端裏就地做專注分段、又不想離開對話界面的開發者。插件在當前 dsh 進程權限下作爲客戶端代碼運行；安裝前建議閱讀倉庫源碼與 MIT 許可證，確認席位注入範圍符合你的環境。
DSH 生態強調「一切皆插件」；社區目錄站 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係，不宜當作官方應用商店條目理解。
「機場播報」依賴系統 TTS；靜音或無聲環境請選其他音色或靜音。所有計時與錨點數據留在本機 localStorage，不外傳。
參考鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/new2023start/dsh-pomodoro-clock
- 源碼與說明：https://github.com/new2023start/dsh-pomodoro-clock
