前言¶

DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展客户端功能。除了工作流工具，日常提醒也是常见的需求。下面介绍 dsh-plugin-water-tracker，一个用于记录每日饮水情况并提供可视化反馈的客户端插件。

这是什么¶

这是一个由 YuanTutu 维护的客户端插件。它通过水杯动画和 GitHub 风格的热力图，帮助用户记录并可视化每日的饮水数据。插件支持深浅色主题同步，并提供预设及自定义饮水量功能。

核心功能¶

• 记录每日饮水：记录用户每天喝水的情况。
• 水杯动画：水杯内的水面会根据「饮水量 ÷ 每日目标」的比例下降。
• 预设与自定义：提供 100 / 300 / 500 ml 三个预设按钮，并支持自定义输入饮水量。
• 鼓励语：当饮水量达标（喝空）时，显示“喝饱了！”等正面鼓励语。
• GitHub 风格热力图：内置热力图，颜色越深表示当天喝水越多，查看过去 52 周数据。
• 数据持久化：数据保存在浏览器 localStorage（key：water-tracker-v1），刷新页面后数据不丢失。

安装与启用¶

安装需进入插件目录运行安装脚本。

pwsh -File .\install.ps1

脚本会将插件复制到 profile 的 node_modules，并修改 cordis.patch.yml 将其插入 Loader。

手动安装步骤：
1. 复制整个 dsh-plugin-water-tracker 文件夹到 profile 的 node_modules。
2. 编辑 profile 的 cordis.patch.yml，加入：

- insert:
    - id: water-tracker
      name: dsh-plugin-water-tracker

3. 重启 dsh。

典型用法¶

安装并刷新页面后，右下角会出现 💧 悬浮按钮。点击打开面板：
* 今日打卡：设置每日目标，点击预设按钮（100/300/500 ml）或自定义量按钮喝水，支持撤销和重置今日数据。
* 饮水热力图：查看过去 52 周的 GitHub 风格热力图，悬停单元格可查看当天喝水明细。
* 独立预览：双击根目录 preview.html 可在浏览器中独立体验完整功能。

适用场景与注意¶

• 适用场景：需要长期记录饮水习惯，并希望以可视化的方式查看数据积累的用户。
• 注意事项：
  • 数据仅保存在浏览器 localStorage，不跨设备。
  • 悬浮按钮注册在 shell.overlay 浮动层，可能被遮挡，需检查 pointer-events 属性。
  • 依赖 @deepseek-ai/cordis、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-layout 和 react。
• 作为本地插件安装，安装前建议检查源码与许可证（MIT）。

结尾¶

该插件通过简单的打卡和可视化反馈，帮助用户养成喝水习惯。

• GitHub 仓库
• 技能目录页