前言¶
在 DeepSeek Harness（DSH）里长时间盯屏写配置、调试智能体时，很容易忘记喝水。系统日历或手机闹钟能提醒，但它们和当前工作界面是割裂的，打断成本也高。下面介绍社区插件 dsh-water-reminder（维护者 zeng5630，分类：客户端）：在 DSH Web GUI 右下角常驻一颗水位悬浮球，按可选间隔在页面内弹卡片，并在 macOS / Windows 通知中心发系统通知，同时记录当日饮水量。数据只保存在本机浏览器，不上传。
这是什么¶
dsh-water-reminder 是面向 DSH Web 前端的客户端插件（dsh.client.platform: web），版本 0.1.0，MIT 许可证，要求 DSH >=0.2.2-rc.1。Host 端 lib/index.js 为空壳，供 Loader 发现包；实际逻辑在 lib/client.js（悬浮球与提醒卡片）。插件通过 cordis.patch.yml 向 Bundle 插入 ui-water-reminder 行，并声明 dsh.bundle.patch，与 DSH「一切皆插件」的扩展方式一致。生态目录见 SkillHub 插件页，源码与说明见 GitHub 仓库（与 DeepSeek / 幻方无官方从属关系，属社区独立索引）。
核心功能¶
经 README 核实，能力如下：
- 间隔提醒：15 / 30 / 45 / 60 / 90 分钟可选，默认 45 分钟。
- 双重提醒：页面内卡片 + 系统通知，附轻提示音；「稍后再说」推迟 5 分钟，不堆积多条提醒。
- 喝水记录：点「我喝水了」记一杯（250 ml），显示今日杯数、饮水量、上次喝水时间；悬浮球外圈为距下次提醒进度，角标为今日杯数。
- 暂停 / 继续：开关随时暂停，暂停期间不提醒。
- 状态持久化：设置与今日记录写入 localStorage 与 cookie，刷新或改端口后仍保留。
- 主题与语言：使用 DSH 的
--dsw-alias-*变量跟随明暗主题；按浏览器语言中英切换。
安装与启用¶
从插件市场安装（推荐）¶
- 在 DSH Plugins 页面打开 Experimental plugins，启用 Custom plugin indexes。
- 切到 Discover，点 Add index source，填入市场索引 URL：
https://raw.githubusercontent.com/zeng5630/dsh-water-reminder/main/market/index.json
- 搜索「喝水提醒 / Water Reminder」，点 Install。
- 安装完成后按提示重启一次 DeepSeek Harness。新包需在宿主启动时建立模块映射，HMR 无法把运行中的新包挂进当前会话。
手动安装到 desktop profile（开发用）¶
在插件目录的上级执行（路径按本机修改）：
dsh plugin --profile desktop add link:/Users/zengyanjun/Documents/deepseek-harness/default-workspace/dsh-water-reminder
在 ~/.dsh/profiles/desktop/cordis.patch.yml 末尾追加：
- id: ui-water-reminder
name: dsh-water-reminder
保存后重启 DSH。也可不写上述 patch 行，而将 dsh-water-reminder 加入 profile 的 package.json 的 dsh.profile.bundles；本包已声明 dsh.bundle.patch，Bundle 层会自动插入同一行。
卸载：
dsh plugin --profile desktop remove dsh-water-reminder
并从 cordis.patch.yml 移除对应条目。
典型用法¶
- 点右下角水滴球展开面板。
- 选择提醒间隔，保持开关为开启。
- 首次开启时浏览器会询问通知权限，允许后可收系统通知。
- 到时间后顶部出现提醒卡片，可点「我喝水了」或「稍后」。
- 面板底部可关闭提示音、开关系统通知或清空今日记录。
适用场景与注意¶
适合谁：长期在 DSH Web GUI（含桌面壳内嵌页面）工作的开发者，希望提醒与当前界面一体、且能记当日饮水量。
运行与权限：插件作为 DSH 客户端脚本在浏览器上下文执行，以当前 DSH 进程与用户环境为界；安装前宜浏览 GitHub 源码 与 MIT 许可证。
行为边界（README 说明）：
- 提醒计时以页面打开为前提；桌面应用窗口最小化时仍会计时并可通过系统通知提醒。
- 系统通知需用户授权；拒绝后页面内提醒仍有效。
- 数据仅存本机浏览器，不上传。
结尾¶
dsh-water-reminder 把间隔喝水提醒嵌进 DSH 界面：悬浮球、进度、记录与双重通知，适合长时间在 Harness 里干活的人。目录与索引：SkillHub · dsh-water-reminder；安装与用法细节：GitHub · zeng5630/dsh-water-reminder。
