前言¶
給 DeepSeek Harness（DSH）的 Web UI 做開發時，一個常見的問題是：工作區裏缺一個順手的小工具。番茄鍾、下班倒計時、專注統計這些日常要不停看的東西，要麼切到別的 App，要麼就得自己寫一個掛在頁面上的浮層。focus-alarm 就是這個方向上的一件社區插件，把幾件事合成一張卡片。下面介紹它的定位、功能和安裝方式。
這是什麼¶
renbooc/focus-alarm（包名 @local/offwork-countdown）是 DeepSeek Harness Web UI 的懸浮卡片插件，維護者是 renbooc。卡片把番茄鍾、下班倒計時和專注統計合成一處，可拖動、可收起。它屬於客戶端插件，界面和計時邏輯都跑在瀏覽器半，index.js 的 Host 半是空實現。
它解決的問題是：在 Harness 里長時間工作時，番茄鍾時長、還剩多久下班、今天完成了幾個番茄這些信息不用離開工作區就能看到。
核心功能¶
按 README 列出的能力，分三組看。
番茄鍾部分，專注 / 短休 / 長休三段循環，輪次可配，默認 4 輪一次長休；支持開始、暫停、跳過、重置、+5 分鐘。啓動即回到滿時長的專注時段，正在運行且未到點的計時按時間戳續上。階段自然結束時有提示音、卡片抖動、彩色粒子和文字氣泡，並尊重系統「減少動態效果」設置。
統計與倒計時部分，今日完成番茄數、累計專注分鐘、打斷次數、連續天數、近 7 天柱狀圖，跨天自動歸零但保留歷史。下班倒計時給出距下班 / 距上班 / 加班時長、今日工作進度條和週末提示。
提醒與同步部分，距下班 30 分鐘提醒收尾、下班點提醒、專注結束提醒護眼、加班時段提醒早點收工，同一天內只提醒一次。可選通過 Notification API 推送系統通知，權限未授予時靜默降級。計時運行時剩餘時間寫進瀏覽器標籤頁標題，暫停或卸載時還原原標題。界面中英文跟隨 Harness 語言設置，配色全部使用主題 token，淺色 / 深色自適應。偏好開關共 7 個，即時生效。
安裝與啓用¶
README 給出的安裝方式有兩種。在 Harness Web 裏打開 設置 → 插件 → 插件市場 / 插件廣場，搜索「專注鬧鐘」一鍵安裝；或者命令行：
dsh plugin --profile web add github:<owner>/focus-alarm#<commit-sha>
注意命令裏的 <owner> 和 <commit-sha> 需要替換爲實際值，README 沒有給出這兩者固定佔位之外的寫法。安裝後刷新頁面即可，不需要重啓，客戶端插件由 HMR 加載。
本地開發時用本地路徑安裝：
dsh plugin --profile web add /absolute/path/to/focus-alarm
插件目錄遵循 Cordis bundle 約定：package.json 聲明 dsh.bundle.patch 和 dsh.client，cordis.patch.yml 插入一行插件註冊，index.js 是 Host 半，client.js 是瀏覽器半（React 組件、樣式、狀態、計時邏輯），locale/*.json 是中英文文案，icon.svg 是圖標。數據保存在瀏覽器 localStorage，鍵名前綴 dsh.offwork-countdown.*，保留了舊前綴以兼容既有安裝。
典型用法¶
裝好並刷新頁面後，卡片會通過客戶端插件加載出來，可以拖動位置，也可以收起只留個入口。README 裏描述了幾個可復現的行爲：打開「自動開始下一階段」後，階段自然結束會自動進入下一段；四個番茄結束進入長休。打開「標題同步」後，計時運行時瀏覽器標籤頁標題顯示剩餘時間，暫停或卸載插件時精確還原原標題。把「系統通知」打開並授予權限後，階段結束時可以收到系統通知，權限沒授時不打擾。結束一天前看一眼卡片上的下班倒計時和今日工作進度條。
適用場景與注意事項¶
適合在 Harness Web 裏做長時間開發、希望番茄鍾和下班倒計時就近可見的開發者，也適合想在自己的客戶端插件裏參考「懸浮卡片 + 計時 + 本地統計」這套實現方式的同學。
有幾點需要注意。插件兼容 DeepSeek Harness Web，README 標註已驗證 0.2.1-rc.5，package.json 的 engines.dsh 也是 >=0.2.1-rc.5；客戶端模塊通過 window.__ModuleLoader__ 註冊，注入 shell.overlay 槽位，React 由瀏覽器模塊表提供，插件自己不重複安裝依賴。插件以當前 Harness 進程的權限運行，安裝前應先看一遍源碼和許可證（README 標註爲 MIT）。計時和統計數據都寫在瀏覽器 localStorage 裏，清理瀏覽器數據前要留意。
結尾¶
卡片把番茄鍾、下班倒計時、專注統計這三類工作時長管理能力收斂到一處，配置項夠用，實現路徑清晰。目錄頁在 https://www.skillhub.cn/plugins/renbooc/focus-alarm，源碼在 https://github.com/renbooc/focus-alarm。
