前言¶

DSH 的理念是「一切皆插件」，很多工作流的自動化做在了 Agent 一側，但「該幾點走」這件事仍靠人自己記。等到下班時間被別的事打斷，想起來時常常已經過了打卡窗口；反過來，想看到還有多久下班，又不想額外開一個看時間的窗口。

wungjyan/dsh-offwork-countdown 把這件事塞進界面裏：一個浮在 Web UI 角落的小膠囊，按你設的班次走完一天——到點提醒打卡、打卡後安靜倒計時、臨近下班變色、到點填滿呼吸抖動提醒。它不替你決策，只負責把「時間到了」這件事持續擺在看得見的地方。

這個插件由 wungjyan 維護，支持 MIT 協議。下面按「是什麼 → 功能 → 安裝 → 用法 → 場景與注意」的順序介紹。

它是什麼¶

一句話定位：面向 DeepSeek Harness Web UI 的工作日流程掛件，提供上班打卡、下班倒計時、到點提醒三件事。

它解決的具體問題是：打卡動作依賴人的自覺，而自覺最容易在「沒看到時間」時失效。插件把一個可交互的小膠囊常駐在界面角落，班次之內是倒計時，班次之外是一條淡色提示（寫清下一次上班時間），只有在你明確關掉「顯示浮窗」時才隱藏。

核心功能¶

1、上班打卡。到設定的上班時間，掛件顯示「打卡」按鈕，按鈕本身即提醒。點一次記一整天，刷新、重開都記得。改了上下班時間相當於換了一個班次，需要重新打卡，設置頁會當場提示。

2、下班倒計時。打卡後開始倒計時，安靜地待在角落。

3、臨近下班提醒。進入提前提醒窗口（默認 15 分鐘）時，邊框和底色換成你設的提醒色（淺色一檔），到點才填滿爲深色。

4、下班提醒。到點後整張卡片填滿提醒色、呼吸、抖動，並提供「知道了」按鈕，點一下當天收起。這一提醒不依賴打卡——即使白天忘了打卡，到點照樣提醒。

5、提醒有效期。下班後最多提醒一段時間（默認 4 小時），超時自動安靜。

6、班次之外。浮窗變爲淡色一條，寫明下一次上班時間：上班前顯示「今天 09:00 上班」，下班後顯示「明天 09:00 上班」，週末顯示「週一 09:00 上班」。

7、夜班支持。上班時間晚於下班時間即視爲跨零點班次；凌晨 1 點時，掛件會正確識別這是昨晚 22:00 開始的那個班。

8、顏色自定義。提供 9 個內置色 + 任意自定義色，按淺色/深色主題自動調整明暗，文字顏色自動推導以保證可讀。

9、自由拖拽。浮窗可拖到任意位置，鬆開即記住；窗口縮放後仍停在原來的相對位置。

10、兩處設置。點擊膠囊邊上的齒輪，或到「插件」頁找到本插件（設置就在標題下方），兩邊改的效果一致。

安裝¶

安裝方式有兩種，取決於你用的是桌面版還是命令行。

桌面版（DeepSeek Harness App）：進入插件頁 → 添加插件 → 安裝第三方插件，包名填 dsh-offwork-countdown。桌面版的 profile 由 App 獨佔管理，命令行裝不進去，只能走這條路。

命令行：--profile 是必填的，換成你自己的 profile 名，常見是 web。

dsh plugin --profile web add dsh-offwork-countdown

兩種方式裝完立即生效；替換已安裝的同名包需要重啓 Harness 纔會加載新代碼。

使用¶

1、到上班時間，角落出現「打卡」按鈕，點一下開始倒計時。

2、拖動膠囊到順手的位置，位置會記住。

3、點擊齒輪調整參數：上班/下班時間、提前提醒分鐘數、呼吸節奏（1.2 / 1.8 / 3 秒）、提醒有效期、提醒日、顏色、位置、是否顯示浮窗。

配置保存在 ~/.dsh/offwork-countdown/state.json（尊重 DSH_HOME 環境變量）。

界面文案有中英兩套，跟隨 DSH 的「設置 → 通用 → 語言」。若頁面拿不到 locale 服務（插件未激活或服務異常），回退順序是先看系統語言（桌面版即 Electron 的系統語言）：中文系統給中文，其餘給英文。

一個小提示：下班提醒不依賴打卡——忘了打卡的人到點照樣會被提醒，但白天看不到倒計時。

適用場景與注意¶

適合誰：日常有固定班次、需要在 DSH Web 界面里長時間工作，且希望「到點」被主動提醒而不是自己盯着時間的人。

注意事項：

1、插件以當前 DSH 進程的權限運行，能讀到的目錄和環境與你啓動 Harness 時一致。安裝前建議先檢查源碼與許可證（README 聲明爲 MIT），確認沒有引入你不想要的行爲。

2、它只負責提醒與記錄打卡動作，不自動提交打卡；實際打卡仍需你在界面裏點擊。

3、該插件出現在社區目錄，目錄站是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應視爲官方應用商店條目。

小結¶

這個插件的價值不在於多複雜，而在於把「下班時間快到了」這件事從「想起來纔看」變成「擺在角落持續可見」。上班打卡、下班倒計時、到點變色呼吸，流程完整且可配置。

目錄頁：https://www.skillhub.cn/plugins/wungjyan/dsh-offwork-countdown

GitHub：https://github.com/wungjyan/dsh-offwork-countdown