前言¶
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
- 重啓 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）。
結尾¶
該插件通過簡單的打卡和可視化反饋，幫助用戶養成喝水習慣。
