前言¶
在 DeepSeek Harness（DSH）里長時間對話或寫代碼時，很多人會在瀏覽器裏再開系統時鐘、番茄鍾應用，或單獨開一個任務看板頁。這些工具與 DSH 界面分離，切換成本高，番茄鍾也常因換標籤頁而停在前端計時邏輯上。
下面介紹維護者 Twi-ster 的客戶端插件 dsh-clock-radar（倉庫 Twi-ster/dsh-clock-radar）。它在 DSH Web 側欄增加一個「時鐘事務」入口，把秒級時鐘、番茄鍾和 Campus Radar 的 DDL 看板收進同一處；需要聊天時仍可回到對話行。插件由 dsh-wallpaper-clock 與 campus-radar-dsh 能力合併而來，並單獨實現了番茄鍾頁。
插件定位¶
- 名稱：dsh-clock-radar（README 標題：時鐘事務）
- 分類：客戶端（DSH 插件目錄歸類爲客戶端）
- 維護者：Twi-ster
- 許可：MIT（© 2026 Twi-ster）
- package.json 版本：1.0.0；
engines.dsh爲^0.2.0-rc.1，README 寫明在 DSH0.2.0-rc.2上驗證過
一句話：一個側欄 bundle，三個標籤頁——透明壁紙友好時鐘、可後臺運行的番茄鍾、以及可選的本地 Campus Radar 事務雷達。
核心功能¶
時鐘¶
秒級大字 HH:MM:SS，並帶指針錶盤。頁面背景透明；若已安裝壁紙類插件，壁紙可從鐘面後方透出。右上角齒輪可配置：
- 24 / 12 小時制
- 顯示日期
- 數字時間、指針錶盤
- 秒針平滑（掃秒）
- 玻璃底襯
設置寫入 localStorage 鍵 dsh-clock-radar/settings/v1。若該鍵不存在且本機曾使用老版 dsh-wallpaper-clock，會回讀其 settings/v1，開關無需重設。
番茄鍾¶
支持預設 15 / 25 / 45 / 60 分鐘，也可填 1–180 的任意分鐘數；提供開始、暫停、繼續、重置。到點會發系統通知並在頁面內橫幅提示，不響鈴。
計時邏輯在插件層而非單頁內：切換到對話或其他瀏覽器標籤時倒計時仍繼續。狀態按絕對結束時間保存在 dsh-clock-radar/pomodoro/v1，刷新頁面可續計。頁面關閉期間若已到點，重開顯示「已結束」，不補發過期通知。首次點「開始」會申請通知權限；拒絕則僅在頁面內提示。
事務（Campus Radar DDL）¶
展示今日 / 明日 / 逾期 / 7 天內 / 7 天外 / 未定等分組看板。依賴本機運行的 Campus Radar；未連接時顯示「沒連上」，不影響時鐘與番茄鍾兩頁。Campus Radar 爲另一本地項目，不開源、不隨本插件分發；不需要該頁時可不使用。
Host 側註冊只讀代理，瀏覽器側僅 GET，避免直連 CORS：
/clock-radar-api/tasks -> http://127.0.0.1:3000/api/tasks
/clock-radar-api/categories -> http://127.0.0.1:3000/api/categories
/clock-radar-api/sources -> http://127.0.0.1:3000/api/sources
/clock-radar-api/wechat/overview -> http://127.0.0.1:3000/api/wechat/overview
端口非 3000 時，在 Host 環境設置 CAMPUS_RADAR_URL。
安裝與啓用¶
環境要求：DeepSeek Harness 0.2 內核、Node.js >= 22.12.0。
Web 端可在 DSH 插件頁點「添加插件」，輸入本倉庫的絕對路徑；或在命令行按 README 原文：
git clone https://github.com/Twi-ster/dsh-clock-radar.git
dsh plugin --profile web add ./dsh-clock-radar
裝好後刷新頁面。側欄未出現「時鐘事務」時，重啓一次 dsh web 或 DSH Desktop。
桌面端：應用內 設置 → 插件，安裝本地 bundle 目錄，無需上述命令行步驟。
DSH 生態上插件以當前 dsh 進程權限運行；安裝前建議瀏覽倉庫源碼與 LICENSE，確認只讀代理與本地 API 行爲符合你的環境策略。
典型用法¶
- 左側導航點「時鐘事務」，頂部在「時鐘 / 番茄鍾 / 事務」三個標籤間切換；旁邊對話入口仍可回到聊天。
- 時鐘：按需打開齒輪項，與壁紙插件聯用時保持透明底即可。
- 番茄鍾：選預設或輸入分鐘 → 開始；允許通知以便到點收到系統提示。
- 事務：先確保 Campus Radar 在本地監聽（默認
127.0.0.1:3000），再在事務頁查看 DDL；代理失敗時僅該頁提示未連接。
開發與自檢（維護者文檔）：
node --check index.js
node --check client.js
本地調試可將倉庫目錄交給插件管理器的 install_bundle，或通過應用內插件頁的本地安裝。
兼容與實現要點¶
| 項 | 說明 |
|---|---|
| 壁紙插件 | 時鐘頁透明，壁紙正常顯示；無壁紙時使用主題底色。 |
| 深淺主題 | 只讀 --dsw-alias-* 主題令牌，跟隨宿主。 |
| 其他插件 | 不讀寫第三方 DOM / 樣式，不改寫他人節點。 |
| 權限與網絡 | Host 僅註冊一條只讀代理；無 npm 依賴；除上述四個 GET 代理外不聯網。 |
主要文件：client.js（三標籤 UI 與番茄鍾引擎等）、index.js（/clock-radar-api 代理）、cordis.patch.yml（組合樹插入）、locale/*.json（管理器中中英文標題與簡介）。
結尾¶
dsh-clock-radar 把 DSH 側欄當成一塊固定的工作區：要看時間就留在透明時鐘頁，要專注就用後臺番茄鍾，要看 DDL 再在本地 Campus Radar 就緒時打開事務頁。社區插件目錄與 DeepSeek / 幻方無官方從屬關係，安裝來源以維護者倉庫爲準。
- 目錄頁：https://www.skillhub.cn/plugins/Twi-ster/dsh-clock-radar
- GitHub：https://github.com/Twi-ster/dsh-clock-radar
