前言¶
在 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
