前言¶

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