前言¶

用 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