前言¶
在 DeepSeek Harness（DSH）里長時間寫提示詞、看 Agent 輸出時，瀏覽器標籤頁往往只有對話區和工具欄，缺少一個「放在桌角、不搶焦點」的時間參考。系統任務欄可以看時間，但和 DSH 工作區不在同一視覺層級；單獨開系統時鐘窗口又會多佔一塊屏幕。DSH 生態裏有一類 Client 側插件，只往 Web GUI 的 overlay 槽位掛小組件，不替換宿主界面。下面介紹維護者 skyline66 發佈的 dsh-desktop-clock：在 DSH Web 右上角（安裝後）提供可拖動的浮動時鐘，帶錶盤樣式、專注計時和主題，位置與偏好保存在瀏覽器本地。
這是什麼¶
dsh-desktop-clock 是面向 DSH Web GUI 的純 Client 插件（Host 半部分爲空，無 Host 服務、無工具、無 Host 配置項）。一句話定位：可拖動的浮動桌面時鐘，提供指針/數字/組合錶盤、專注計時、四套主題，並記住窗口位置。
- 維護者：skyline66
- 社區分類：趣味換裝
- 許可證：MIT
- 當前 package 版本（資料來源
package.json）：1.0.2 - 目錄頁：https://www.skillhub.cn/plugins/skyline66/dsh-desktop-clock
- 源碼與說明：https://github.com/skyline66/dsh-desktop-clock
插件不發起網絡請求、不收集遙測；設置與計時狀態只寫入當前瀏覽器的 localStorage（鍵名見下文「隱私與數據」）。
核心功能¶
以下能力均來自項目 README，安裝前可對照 GitHub 文檔覈對。
錶盤與時間顯示¶
- 三種錶盤：數字、指針、組合；指針模式支持平滑走秒。
- 細節設置：12/24 小時制、是否顯示秒與日期、時區、三檔尺寸、不透明度、字體大小。
- 界面語言跟隨 DSH 當前 locale，支持中文與英文。
專注計時¶
- 預設時長：5 / 15 / 25 / 45 分鐘。
- 支持開始、暫停、繼續、重置；到點播放 Web Audio 合成的輕提示音（無外部音頻文件）。
- 刷新頁面後，進行中的計時會按真實截止時間繼續（狀態持久化在本地）。
桌面化交互¶
- 拖動標題欄移動時鐘，鬆開後記住位置；可鎖定位置。
- 雙擊標題欄摺疊爲「時間膠囊」，點擊膠囊再展開。
- 快捷鍵
Alt + Shift + D顯示或隱藏時鐘。 - 齒輪按鈕打開設置；眼睛按鈕隱藏時鐘（右側保留圓形入口）。
- 面板底部可在「時鐘 / 專注」之間切換。
主題¶
四套主題：極光、餘燼、亞麻、石墨；README 說明均帶明暗對比與玻璃質感。
架構與兼容¶
- 已在 DSH Web 0.2.1-rc.3 上安裝並驗證 Slot 註冊。
- 只使用公開的 Client
slots/locale與shell.overlay增量槽位，不覆蓋root、main等宿主槽位，不讀取其他插件 DOM。 - 不引入
@deepseek-ai/*運行時依賴；React 由宿主模塊表提供。 - 位置和尺寸限制在當前視口內，窗口縮放後會收回到可見區域。
安裝與啓用¶
從 GitHub 安裝（README 推薦方式）：
dsh plugin add github:skyline66/dsh-desktop-clock
安裝完成後，在 DSH Web 界面右上角應出現時鐘組件。若未立即出現，刷新一次頁面或重啓 DSH 後再看。
說明：插件倉庫已提交構建產物 client.js，從 GitHub 或壓縮包安裝時無需本地 npm run build。若你要改源碼再安裝，README 另有本地開發流程（含 git clone 與 dsh plugin add .），本文不展開。
典型用法¶
日常操作可對照 README 中的對照表：
| 操作 | 結果 |
|---|---|
| 拖動標題欄 | 移動時鐘，鬆開後記住位置 |
| 雙擊標題欄 | 摺疊爲時間膠囊 |
| 點擊膠囊 | 重新展開 |
Alt + Shift + D |
顯示 / 隱藏時鐘 |
| 齒輪按鈕 | 打開設置 |
| 眼睛按鈕 | 隱藏時鐘（右側出現圓形入口） |
| 底部「時鐘 / 專注」 | 切換錶盤與專注計時 |
需要番茄鍾式短專注時：切到「專注」，選 25 分鐘（或其他預設），開始計時；到點聽提示音即可。需要少佔界面時：雙擊標題欄摺疊，或 Alt + Shift + D 臨時隱藏。
適用場景與注意¶
適合誰
- 長期在 DSH Web 裏調試 Agent、寫 Skill 或盯日誌，希望時間始終落在工作區一角、又不改宿主佈局的開發者。
- 需要輕量專注計時、且不希望插件聯網或寫 Host 配置的 DSH 用戶。
- 喜歡通過「趣味換裝」類 Client 插件給界面加一點桌面感、又接受純 overlay 交互的人。
使用前請知悉
- 插件隨當前 DSH 進程與 Web 會話運行；安裝前建議瀏覽 GitHub 源碼與 MIT 許可證，確認符合你的環境策略。
- 純 Client 插件：沒有 Host 工具、沒有 Host 配置項；偏好只存在本機瀏覽器，換瀏覽器或清站點數據會丟失設置與計時狀態（除非同源下另有備份）。
- 兼容性以 README 記載的 DSH Web 0.2.1-rc.3 驗證爲準；升級 DSH 後若 Slot 行爲變化，以新版本文檔與 issue 爲準。
- SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令以插件 README 爲準，不要憑插件名自行拼接未在文檔出現的命令。
隱私與數據（localStorage）
dsh-desktop-clock:settings:v1：界面與顯示偏好dsh-desktop-clock:timer:v1：專注計時狀態
結尾¶
dsh-desktop-clock 把「桌角時鐘 + 短專注計時」收進 DSH Web 的一個 overlay 入口：可拖、可藏、可換主題，本地存偏好，不碰 Host。若要在 Harness 裏試裝，先用 README 給出的 dsh plugin add github:skyline66/dsh-desktop-clock，再到社區目錄頁或 GitHub 查更新與 issue。
- 目錄頁：https://www.skillhub.cn/plugins/skyline66/dsh-desktop-clock
- GitHub：https://github.com/skyline66/dsh-desktop-clock
