前言¶

用 DeepSeek Harness（DSH）做智能體開發時，常見入口是 dsh web 打開的 Web GUI：會話、工具、插件都擠在同一塊界面裏。長時間盯着屏幕改 prompt、跑任務，很容易忽略「今天還剩多少班可上」。系統日曆或手機鬧鐘可以提醒，但和 Harness 不在同一窗口，切來切去也打斷思路。

下面介紹社區插件 dsh-offwork-countdown（維護者 konwait12）：在 DSH Web 頁面右上角掛一張下班倒計時小卡片，顯示距離下班的 HH:MM:SS、今日進度條，並可在卡片內改上下班時間；卡片可拖動、可收成小膠囊，設置與位置只存在本機瀏覽器。它是 客戶端（web profile） 插件，不跑服務端邏輯，適合已經在用 DSH Web 界面的開發者順手裝上。

這是什麼¶

dsh-offwork-countdown 是掛在 DeepSeek Harness Web GUI 上的界面掛件：在頁面右上角顯示下班倒計時，支持拖動與內聯配置上下班時間、是否僅工作日。數據不上傳，全部寫入本機 localStorage。

倉庫：https://github.com/konwait12/dsh-offwork-countdown
社區目錄頁：https://www.skillhub.cn/plugins/konwait12/dsh-offwork-countdown（獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）

卡片界面與狀態¶

README 中用 ASCII 示意了展開與收起兩種形態：

┌──────────────────────────────────────┐
│ ◔  距離下班              03:12:45 – ⚙ │
│ 09:00 – 18:00 · 週三            62%  │
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░                 │
└──────────────────────────────────────┘

小膠囊（收起的形態）：  ◔ 03:12:45 ▬▬▬

已覈實的能力包括：

• 大號等寬倒計時每秒更新；今日進度條與百分比。
• 狀態自動切換：上班前、工作中、已下班（變綠並顯示已下班時長）、休息日（提示下個工作日）。
• 點右上角滑桿圖標，在卡片內改「上班時間 / 下班時間 / 僅工作日」，保存後立即生效；默認 09:00 – 18:00，僅統計週一到週五。
• 大小兩檔：點「收起」縮成小膠囊；單擊膠囊（非拖動）展開，選擇會被記住。
• 右側面板聯動：打開右側面板時卡片自動變膠囊並移到面板左側；右側面板全屏時卡片暫時隱藏；關閉面板後恢復原先大小。
• 按住卡片或小膠囊拖動，位置限制在窗口內並記住；未拖動過則默認吸附右上角偏下（避讓頂部工具欄）。
• 文案走宿主 locale 服務，中英文隨 DSH 界面切換；樣式使用宿主 --dsw-* 主題 token，跟隨明/暗主題。

安裝與啓用¶

前提：已安裝 DeepSeek Harness，並通過 Web 界面使用（dsh web 啓動後打開的頁面）。

從 GitHub 安裝（推薦）¶

dsh plugin --profile web add github:konwait12/dsh-offwork-countdown

安裝後重啓 dsh web（或重新打開 Harness）。若「設置 → 插件」裏尚未啓用，手動打開一次即可。

本地目錄開發安裝¶

若需改 client.js 並走宿主熱更新，可用鏈接安裝（需自行 clone 到本機絕對路徑）：

dsh plugin --profile web add link:/absolute/path/to/dsh-offwork-countdown

鏈接安裝後修改 client.js 通常會被熱更新拾取，個別情況需刷新頁面。

停用方式：設置 → 插件裏關閉「下班倒計時」，或執行：

dsh plugin --profile web remove dsh-offwork-countdown

典型用法¶

1. 改時間：點卡片右上角滑桿圖標 → 填上下班時間 → 保存。設置面板裏可「恢復默認」。
2. 收起 / 展開：點「收起」變膠囊；單擊膠囊展開。
3. 移動：按住拖動；鬆手後位置保存在本機。窗口縮小時會自動拉回可見區域。
4. 右側面板：打開面板時卡片自動變膠囊並避讓；全屏面板時暫時隱藏。

數據存儲與實現要點¶

所有數據僅保存在本機瀏覽器 localStorage：

倉庫爲可直接安裝的 DSH bundle，無構建步驟：index.js 提供 Host 側空 apply() 以便管理；client.js 通過 window.__ModuleLoader__ 向 shell.overlay 槽位註冊卡片；cordis.patch.yml 寫入 profile；locale/zh.json、locale/en.json 供插件列表展示。純 JavaScript + 宿主提供的 React，不引入額外依賴，也不 require 宿主內部模塊。

適用場景與注意¶

適合誰：日常用 dsh web 長時間調試智能體、希望在同窗口看到下班進度、又不想把工時配置傳到服務器的開發者。

兼容性：在 DSH 0.2.1-rc.2 的 web profile 上開發與驗證。依賴宿主 shell.overlay 槽位與客戶端 locale 服務；若未來宿主重命名或移除該槽位，卡片可能不再出現，需等待插件或宿主更新。

安全與權限：客戶端插件在瀏覽器中運行，讀寫的是本頁 localStorage；安裝前仍建議瀏覽 源碼與 MIT 許可證，確認符合你的使用習慣。DSH 生態理念是「一切皆插件」，社區目錄是獨立站點，安裝命令與行爲以倉庫 README 爲準。

結尾¶

dsh-offwork-countdown 把下班倒計時做成 DSH Web 右上角可配置、可拖動的小卡片，不打斷你在 Harness 裏的工作流。需要安裝說明與字段細節時，以 GitHub README 爲準：

• 目錄頁：https://www.skillhub.cn/plugins/konwait12/dsh-offwork-countdown
• 倉庫：https://github.com/konwait12/dsh-offwork-countdown