dsh-workbuddy 🐂

> 今天还有多久下班？

我来上班只为三件事，尿喝白，电充饱，等下班。

给 DeepSeek Harness 加一个不打扰工作的下班倒计时、有效工时进度条和久坐提醒。

        距离下班

        02:37:18

██████████████░░░░ 72%

> “现在出现的新需求原则上属于明天。”

---

四大誓言

这个插件可以不好玩，但不能违背以下四条。

1. Time Engine 必须准

• 倒计时与进度是两套计算：现实的 15:00 → 18:00 就是还有三小时，午休不从倒计时里扣；
• 进度只算有效工时：09:00-12:00 / 13:30-18:00，12:45 的进度是 40%，不是 50%；
• 每一秒都用 new Date() 绝对时间重算，绝不 remaining -= 1000：

17:40 合上电脑、18:10 打开，直接显示下班！，不许出现"还剩 20 分钟"；

• 时间逻辑全部是纯函数，60+ 个单元测试盯着：边界时刻（12:00/13:30/18:00）、

特殊节点（60/30/10/1 分钟）、周末、休眠唤醒，全部要过。

2. UI 必须不侵入

• 只用 DSH 官方 Slot，不 querySelector、不改官方 DOM：

侧栏底部 sidebar.footer.action 一个 chip，全局浮层 shell.overlay 一个面板， 设置页 settings.plugin.item 一张与官方同款的可折叠卡片（默认收起，不抢视线）；

• 浮层默认 click-through，不挡聊天、不抢焦点；
• 不占聊天区域，不弹模态框打断你干活；
• 通过 DSH 插件管理器安装和卸载，不修改官方页面 DOM。

3. 文案必须有梗

• 文案不写死在组件里：messages[风格][场景] 随机抽取；
• 三种风格：正常 / 牛马 / 发疯；
• 每个阶段都有专属阴阳怪气：

```text 👀 最后一个小时。不要在这个时候接大需求。

🚪 10 分钟。现在出现的新需求，原则上属于明天。

🎉 下班！你今天已经失去了继续工作的权限。 ```

• 欢迎社区贡献新文案（src/core/messages.ts，加一句话的事）。

4. 提醒必须不烦

• 久坐提醒按有效工时计时：午休自动暂停，不会在你吃饭时叫你起来走路；
• 同一次提醒绝不重复触发（去重 key 持久化，刷新页面也不补刀）；
• 提醒卡片只有一个 [知道了]——没有"稍后提醒"、没有"今天关闭"、没有"永久关闭"，

提醒间隔由你设置，最低 15 个有效工作分钟；

• 浏览器系统通知默认关闭，想要的人自己去设置里开。

---

功能一览

• 侧栏鱼进度：展开时鱼头沿灰色轨道游到当前进度，右侧跑马灯展示状态或提醒；侧栏收起后只保留可点击迷你鱼；
• 六种状态版式：上班前 / 上午 / 午休 / 下午 / 已下班 / 非工作日；
• 特殊阶段：剩余 60 / 30 / 10 / 1 分钟逐级切换文案，最后 1 分钟进入"准备跑路"版式，最后 10 秒巨型倒数；
• 下班庆祝：到点 🎉 动画 5 秒，纯 CSS，不用图片资源；
• 周末关怀：😎 今天不用上班。你为什么打开了 DSH？（绝不显示"距离周一还有 37 小时"，太折磨人）；
• 设置热生效：保存即写入 settings.yaml，倒计时立刻按新时间走，无需重启。

<details> <summary>查看设置界面</summary>


</details>

安装

前提：Node.js 22.19+，并已安装或可以通过 npx 运行 DSH。

从 GitHub 安装：

dsh plugin --profile web add github:heyxin-68/dsh-workbuddy

发布到 npm 后也可以直接按包名安装：

dsh plugin --profile web add dsh-workbuddy

本地开发时使用 link 安装：

dsh plugin --profile web add link:<本包绝对路径>

插件声明了标准 dsh.bundle，DSH 会自动合并 cordis.patch.yml，无需手工编辑 profile。安装后刷新一次页面，侧栏底部就会出现倒计时 chip。

设置

DSH Settings → 插件 → 插件配置：工作时间、工作日、久坐提醒间隔、文案风格、系统通知。 保存后立即生效（写入 $DSH_HOME/settings.yaml 的 xiaban: 段，热重载）。

默认：

workStart: "09:00"
lunchStart: "12:00"
lunchEnd: "13:30"
workEnd: "18:00"
workdays: [1, 2, 3, 4, 5]   # 周一到周五
reminderEnabled: true
reminderIntervalMinutes: 60
showSeconds: true
messageStyle: cow           # normal / cow / crazy
browserNotifications: false

开发

pnpm install
pnpm test     # 时间引擎/提醒/文案/保存/发布清单
pnpm typecheck
pnpm build    # 产出 lib/index.js（宿主）+ lib/client.js（浏览器 bundle）
pnpm pack --dry-run  # 检查最终发布文件

架构（实施方案 §21-§24）：

src/
├── index.ts            宿主入口：注册 xiaban 设置命名空间
├── namespace.ts        宿主/客户端共享常量
├── types.ts            核心类型
├── config/
│   ├── schema.ts       schemastery schema（宿主用）
│   ├── defaults.ts     默认配置
│   ├── validate.ts     保存前校验
│   └── wire.ts         settings.yaml 扁平字段 ↔ 内部配置
├── core/               纯函数，不依赖 React/DSH，全部可单测
│   ├── time.ts         状态机 / 倒计时 / 进度（绝对时间重算，防休眠漂移）
│   ├── reminder.ts     有效工时计时 / 触发判定 / 去重 key
│   ├── messages.ts     三种风格文案库
│   └── viewmodel.ts    Time Engine → ViewModel
└── client/
    ├── index.ts        apply(ctx)：注册三处 UI 槽位
    ├── controller.ts   定时器 / 设置同步 / 提醒 / 庆祝
    ├── useXiaban.ts    useSyncExternalStore 桥
    ├── XiabanChip.tsx      侧栏底部 chip
    ├── XiabanPanel.tsx     详细面板（六状态分支）
    ├── XiabanOverlay.tsx   面板 / 久坐提醒卡 / 下班庆祝
    ├── XiabanSettingsCard.tsx  Plugins 设置卡片
    └── styles.ts       全部 CSS（DSH 设计令牌）

原则：UI 只消费 ViewModel，不做任何时间判断。所有"现在几点算什么状态"的问题， 只允许问 core/。

不做的事

番茄钟、Todo、工时系统、打卡、云同步、数据分析、夜班跨日班次。 不要把一个下班倒计时做成企业 OA。

许可

[MIT](LICENSE)