前言¶
在 DSH 里写智能体、调工作流，常常一坐就是一下午。系统闹钟和手机通知容易打断思路，又和编辑器不在同一视线里；纯靠意志力也很难稳定做到「每半小时起身、按计划补水」。BigWater4Workers 是 maintainer zjhWater 发布在工作流分类下的一款 DSH 桌面挂件：右下角像素风小人在工位上打字，用页内定时器提醒你起身伸展并喝水，不发消息、不唤醒 Agent、不占 token、也不走网络。
这是什么¶
仓库 zjhWater/BigWater4Workers 在 npm 上发布的包名为 dsh-stand-reminder（当前资料中版本为 1.0.1，MIT 许可证）。它通过 Cordis bundle 向 Harness 页面注入前端脚本，在桌面一角渲染像素场景：显示器、工位、桌上的水杯，以及可交互的小人。提醒逻辑完全在浏览器页面内完成，适合需要长时间开着 DSH 的开发者。
核心功能¶
起身提醒¶
默认每 30 分钟触发一次；设置面板可调 5–180 分钟。到点小人站起伸展，浮出提醒卡片，并播放两声短促提示音（浏览器在未与页面交互前可能静音）。卡片按钮：我站起来了 重启计时；再过 5 分钟 延后 5 分钟；不再提醒 则暂停至下一工作日 09:00。按 Esc 可关闭卡片或设置面板。
工作时间与休息¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 工作时段 | 09:00–18:00 | 时段外小人显示 休息，不触发提醒 |
| 午休 | 12:00–13:30 | 可关闭；午休内到期的提醒顺延至午休结束后 |
| 下班前 | — | 工作时段结束前 10 分钟内不再弹起身提醒 |
喝水轨道¶
与起身计时独立：桌上玻璃杯按「每日杯数目标」缓慢注水（默认 8 杯，面板显示「已喝 X / 目标 N」；有效工作分钟除以目标约每 56 分钟注满一杯）。注满即该喝一口；点击杯子清空并重计一杯。依据资料中的说明，参考 2022 版中国居民膳食指南（男性约 1700 ml/日、女性约 1500 ml/日）。只要你在电脑前，不论是否在工作窗口内，玻璃杯都会继续填充。
日常交互¶
- 打开 DSH：小人跷脚坐桌，
收工状态，显示器黑屏带红色电源键。 - 点击显示器开机：计时开始，小人打字，并开始起身与喝水相关逻辑。
- 点击小人：离开工位走出画面，空椅子保留；点击椅子返回并重开计时。
- 再次点击显示器关机：进入收工，当日工作分钟、杯数、玻璃杯进度会保留，下次开机时清零，每日从干净状态开始。
显示器负责开关机；悬停出现的三横线按钮打开设置面板（风格与 whale 挂件类似）；可拖拽小人，贴近左右约 10%、底部约 15% 时吸附，靠左时水平镜像；悬停滚轮以约 5% 为一档缩放场景（徽章、卡片、面板字号不变）。界面语言默认跟随 DSH/浏览器（zh* 为中文，否则英文），面板首行可切换跟随系统 / 中文 / English。
Mini 模式¶
点击 — 可将整个挂件收成 Composer 底部一排杯子：每杯对应每日目标中的一杯；灰色表示未完成，蓝水自底上升表示当前杯填充中；满杯在约 5 分钟内由 1× 长到 2× 并轻鸣。点击某杯即记一杯并清空该杯动画。Mini 模式下关闭起身提醒，仅保留喝水轨道；悬停右侧可出现设置与 +（回到完整挂件）。
数据与隐私¶
状态存于 localStorage 键 dsh-stand-reminder:v1，以及宿主机 ~/.dsh/dsh-stand-reminder.json（经插件路由 /dsh-stand-reminder/state 读写）。因 DSH 每次启动端口可能变化，仅靠 localStorage 会导致配置与位置丢失，故宿主机侧有一份副本。资料写明数据仅本地保存、不上传；多标签通过 localStorage 事件同步。
边缘行为摘要：卡片 60 秒无操作会收起且小人坐回；若仍无反应，约 10 分钟后重试一次再回归正常间隔。机器休眠或关页导致错过超过 5 分钟时，不会补播提醒，仅静默前移下次时间。新一天首次打开默认为 未开机，玻璃杯与工作日誌清零。
安装与启用¶
在 DSH 插件页搜索 dsh-stand-reminder，或在会话里让 plugin_manager 安装 bundle（命令须与 README 一致）：
plugin_manager install_bundle target = dsh-stand-reminder
安装后完全退出 DSH 客户端再重新打开，小人会出现在右下角。package.json 要求 dsh 引擎版本 >=0.2.0。
本地开发可将 link: 指向源码目录：
plugin_manager install_bundle target = link:D:\path\to\dsh-stand-reminder
卸载：在插件管理器中移除对应 bundle。安装前建议你自行阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限在宿主机读写 ~/.dsh/dsh-stand-reminder.json，并向你使用的 Harness 页面注入脚本。
典型用法¶
下面是一条与 README「A day with it」一致的可复现路径。
- 安装 bundle 并重启客户端后，确认右下角为收工态（
收工、黑屏电源键）。 - 点击显示器开机，观察徽章变为
工作，在设置面板核对间隔（默认 30 分钟）、工作窗口与喝水目标（默认 8 杯）。 - 长时间编码时等待到点提醒，点
我站起来了或再过 5 分钟；需要离座时点小人，回来点椅子。 - 玻璃杯注满时点击桌面上的杯子记一杯；若只想盯补水，可切 Mini 模式，在 Composer 底栏点杯操作。
- 下班点显示器关机；次日再开机时计数按资料说明重置。
声音默认开启、音量默认 70%，可在面板滑条调整并试听；挂件缩放默认 100%，基准尺寸为 clamp(160px, min(viewport width, height) × 26%, 320px)，滑条/滚轮可在 50%–300% 间缩放像素场景。
适用场景与注意¶
适合长时间在 DSH 里写配置、看日志、与 Agent 对话的开发者，希望提醒留在同一页面、且不希望触发 Agent 或外网请求。它不是消息通道或自动化工作流节点，也不会替你记录到外部健康 App。
使用前注意：浏览器对自动播放声音的限制，需先与页面有一次交互；插件逻辑依赖本地时钟与页面是否在前台，休眠/关页行为见上文边缘说明。社区目录 SkillHub 上的 BigWater4Workers 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态奉行「一切皆插件」，请以目录页与仓库 README 为准。
结尾¶
BigWater4Workers 把「起身 + 喝水」做成 DSH 页面内的像素挂件：计时、动画、设置在本地完成，与 Agent 和资源消耗解耦。若你需要在写 Harness 时多一层可配置的久坐与补水节奏，可按上述命令安装 dsh-stand-reminder，重启客户端后从点击显示器开机开始用起。
