前言¶
在 DeepSeek Harness（DSH）里長時間對話、寫代碼或跑任務時，很多人會順手在心裏估「還剩多久下班」或「這一段專注要坐到幾點」。普通倒計時只有數字，和真實工作時段（上午、午休、下午、跨零點）也對不齊。下面介紹社區插件 DSH 倒計時（HelmsmanOfDesire/dsh-countdown）：在 DSH 任意頁面常駐一塊麪板，用幾何精確的沙漏動畫映射當前時段進度，時段可在插件配置頁增刪改，改完立即生效。
這是什麼¶
DSH 倒計時 是維護者 HelmsmanOfDesire 發佈的 客戶端 類 DSH 插件（npm 包名 @HelmsmanOfDesire/dsh-countdown，當前資料中版本 1.0.0，許可證 MIT）。它解決的是：在 DSH Desktop 內統一查看當前工作時段的正計時、倒計時與進度，並用沙漏視覺表達「時間漏走」的比例，而不是整頁懸浮一個簡單倒數器。
插件依賴 DSH 0.2.1 或更高，運行在 DSH Desktop（Electron）內；社區目錄見 skillhub 插件頁，源碼與說明見 GitHub 倉庫。
與普通倒計時的差異¶
README 中強調的實現方式包括：
- 沙漏上、下球沙量按球體積分與二分求液麪計算，沙面移動對應真實時間，資料稱誤差 < 0.001%。
- 流動效果由 CSS 動畫 驅動，資料說明不佔額外 CPU；心跳約 1 秒一次，標籤頁隱藏時停表。
若你只需要一個全局固定分鐘數倒數，功能上會顯得偏重；若你要的是多段工作日程 + 常駐可視化，這個插件的定位更清晰。
核心功能¶
沙漏與進度線¶
- 上球沙持續漏向下球，落點堆成圓錐形沙丘；資料說明沙子總量對應「半個球」，上班過程中上球變空、下球變滿。
- 面板底部進度線：左側綠色爲已過百分比，右側紅色爲剩餘百分比，兩端標兩位小數。
多段獨立計時¶
工作時段由用戶配置，每段獨立計算進度、正計時與倒計時；跨段時歸零重來。不要求覆蓋全天，只配置關心的時段即可。
資料中的示例：
上午班 08:30 → 12:00
午休 12:00 → 13:30
下午班 13:30 → 17:30
安裝後默認四段（含跨零點的「下班」段）見下文「典型用法」。
面板位置與交互¶
- 默認在頁面右側居中；可拖動、縮放（右下角手柄或
Ctrl + 滾輪）。 - 支持一鍵全屏放大、恢復默認大小與默認位置；位置與尺寸會記憶。
- 點面板齒輪可跳到：
插件 → DSH 倒計時 → 時段設置。
配置與告警行爲¶
- 時段名稱、起止時間在配置頁編輯；時間選擇器 5 分鐘步進。
- 跨零點：結束時間早於開始時間即可，例如
22:00 → 02:00。 - 添加時段時新段接在最後一段之後，默認 1 小時；至少保留一個時段。
- 時段重疊會黃色提示（不阻止保存），面板優先顯示排序靠前的一段。
- 當前時間不在任何時段內，或某段被刪掉：面板顯示「該時間段未配置」，屬預期行爲。
安裝與啓用¶
安裝前請自行查看倉庫源碼與 MIT 許可證；插件在當前 DSH 進程權限下運行，與其他社區插件一樣，不要盲目安裝未審閱的第三方包。
方式一：從 GitHub 安裝（README 推薦）¶
dsh plugin --profile web add github:HelmsmanOfDesire/dsh-countdown
桌面版也可在 設置 → 插件 → 添加插件 中粘貼倉庫地址。安裝走預編譯 tarball，資料說明無需本地 Node 構建環境。
方式二：插件市場¶
在 DSH 插件 → 發現 中搜索「下班倒計時」，或從市場頁安裝（與 GitHub 安裝二選一即可）。
裝好後面板會自動出現在任意頁面右側，一般無需額外啓用步驟。
典型用法¶
默認時段¶
資料中的默認表格：
| 時段 | 時間 |
|---|---|
| 上午班 | 08:30 → 12:00 |
| 午休 | 12:00 → 13:30 |
| 下午班 | 13:30 → 17:30 |
| 下班 | 17:30 → 次日 08:30（跨零點） |
修改方式：點面板齒輪 → 編輯表格 → 改完自動保存，無需刷新頁面。配置頁提供恢復默認一鍵回到上述分段。
收起與設置按鈕¶
收起態面板高度約 30px，資料說明此時不顯示設置按鈕，避免擠掉進度條；展開後纔有齒輪進入配置。
卸載¶
dsh plugin --profile web remove @HelmsmanOfDesire/dsh-countdown
或在 設置 → 插件 → DSH 倒計時 → 卸載。
適用場景與注意¶
適合誰
- 主要在 DSH Desktop（Windows / macOS / Linux）工作，希望任意對話頁都能看到當前班次進度的人。
- 需要多段日程（含午休、跨零點下班到次日上班）且要隨時改表、立刻生效的人。
兼容性（來自 README）
| 項 | 要求 |
|---|---|
| 宿主 | DeepSeek Harness ≥ 0.2.1 |
| 平臺 | DSH Desktop 支持的平臺 |
| 運行時 | DSH 內置 Node + Electron，無需自裝 Node.js |
插件依賴 DSH 的 shell.overlay 與 plugins.bundle.config 等能力；若 DSH 大版本升級導致失效，維護者建議在 GitHub 提 issue。
其他說明
- 不區分週末：時段每天循環；週末不上班可刪對應時段，未覆蓋時間會顯示「未配置」。
- 長時段（如 4 小時）沙面每分鐘移動約 0.4%，視覺上變化慢，資料說明屬正常現象。
- SkillHub 等社區目錄是獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；本插件在 GitHub 上公開源碼，星標等統計以倉庫頁面爲準。
結尾¶
經過上面的步驟，你可以在 DSH 裏用沙漏和進度線對齊自己的上班、午休與下班段落，而不用在瀏覽器和聊天窗口之間來回切換。進一步細節、截圖與 FAQ 以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/HelmsmanOfDesire/dsh-countdown
- GitHub：https://github.com/HelmsmanOfDesire/dsh-countdown
