💧 dsh-plugin-water-tracker（喝水打卡插件）

一个 DeepSeek Harness（dsh）客户端插件，用来记录每天喝水的情况。

• 打开后显示一只满杯水，每喝一次水点击对应按钮，水面按「饮水量 ÷ 每日目标」的比例下降；
• 预设 100 / 300 / 500 ml 三个按钮，支持自定义饮水量（输入数字后会在预设按钮旁出现该自定义量按钮）；
• 达标（杯子喝空）时显示 “喝饱了！” 等正面鼓励语；
• 内置 GitHub 风格热力图，颜色越深表示当天喝水越多（配色、布局完全遵照 GitHub 贡献图）。

数据保存在浏览器 localStorage（key：water-tracker-v1），跨刷新持久。

目录结构

dsh-plugin-water-tracker/
├── package.json        # dsh.client + dsh.bundle 声明、peer 依赖
├── cordis.patch.yml    # 将插件插入 Loader 的 insert 配置
├── install.ps1         # 一键安装脚本
├── preview.html        # 独立预览版（浏览器直接打开）
├── lib/
│   ├── index.js        # Host 侧插件主体（纯 UI 插件，空 apply）
│   └── client.js       # 客户端 bundle（window.__ModuleLoader__ 惰性 CJS 工厂格式）
└── README.md

安装到 dsh profile

> 🚀 一键安装：解压后进入 dsh-plugin-water-tracker 目录，运行 > pwsh -File .\install.ps1，脚本会自动完成下面「方式一」的复制与 patch 修改。

插件包需要放进 profile 的 node_modules，并把它插入 profile 的 Loader 配置树。

方式一（推荐）：直接改 profile 的 patch

1. 把整个 dsh-plugin-water-tracker 文件夹复制到 profile 的 node_modules：

``powershell # 本机示例（以桌面 profile 为例，实际路径见 $env:DSH_HOME） Copy-Item -Recurse dsh-plugin-water-tracker "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-plugin-water-tracker" ``

2. 编辑 profile 的 cordis.patch.yml（例如 ~\.dsh\profiles\desktop\cordis.patch.yml），加入：

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

> 若你同时用 web profile，~\.dsh\profiles\web\cordis.patch.yml 做同样修改。

3. 重启 dsh（桌面版重新打开，或重启 dsh web）。

方式二：作为 bundle 加入

编辑 profile 的 package.json，把插件加入 dsh.profile.bundles：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-plugin-water-tracker"   // ← 新增
      ]
    }
  }
}

同时仍需把插件复制到 profiles\node_modules\dsh-plugin-water-tracker。本插件自带的 cordis.patch.yml（dsh.bundle.patch）会负责把它 insert 进 Loader。

使用

安装并刷新页面后，右下角会出现一个 💧 悬浮按钮：

• 点击 💧 → 打开喝水打卡面板；
• 「今日打卡」页：设置每日目标、点击 100/300/500 ml 或自定义量按钮喝水、撤销/重置今日；
• 「饮水热力图」页：查看过去 52 周的 GitHub 风格喝水热力图，悬停单元格可看当天明细。

快速体验（无需安装）

仓库根目录的 preview.html 是一个完全独立、双击即可在浏览器打开的版本——功能与本插件一致（含水杯动画、GitHub 风格热力图，数据同样存 localStorage），可以先体验再决定是否安装。

明暗主题

插件自动跟随 DeepSeek Harness 的浅色/深色模式（body[data-ds-dark-theme]），热力图在深色模式下采用 GitHub 暗色绿配色（#0e4429 → #39d353）。

常见问题

• 看不到 💧 按钮：确认插件确实被 Loader 加载（Settings → Plugins 里应能看到 dsh-plugin-water-tracker），并刷新页面。
• 悬浮按钮被遮挡 / 点不到：本插件注册在 shell.overlay 浮动层，已显式 pointer-events: auto；如仍异常，检查是否有其它 overlay 项覆盖。
• 数据不跨设备：数据存在浏览器 localStorage，仅本机、本浏览器可见。