Introduction

DeepSeek Harness (DSH) uses a plugin-based architecture that allows developers to extend client features. In addition to workflow tools, daily reminders are also a common requirement. Below is an introduction to dsh-plugin-water-tracker, a client plugin for logging daily water intake and providing visual feedback.

What This Is

This is a client plugin maintained by YuanTutu. It uses a water-cup animation and a GitHub-style heatmap to help users log and visualize daily water data. The plugin supports light/dark theme synchronization and provides preset and custom water-intake amounts.

Core Features

  • Log daily water intake: Records how much water the user drinks each day.
  • Water-cup animation: The water level inside the cup decreases according to the ratio of “intake ÷ daily goal.”
  • Presets and custom amounts: Provides preset buttons for 100 / 300 / 500 ml and supports custom water-amount input.
  • Encouragement messages: When the water-intake target is met (the cup is emptied), positive encouragement messages such as “I’m full!” are displayed.
  • GitHub-style heatmap: Includes a heatmap where darker colors indicate more water consumed that day, and lets you view data from the past 52 weeks.
  • Data persistence: Data is stored in browser localStorage (key: water-tracker-v1), so it is not lost after page refresh.

Installation and Enablement

To install, enter the plugin directory and run the installation script.

pwsh -File .\install.ps1

The script copies the plugin into the profile’s node_modules and modifies cordis.patch.yml to insert it into the Loader.

Manual installation steps:
1. Copy the entire dsh-plugin-water-tracker folder into the profile’s node_modules.
2. Edit the profile’s cordis.patch.yml and add:

- insert:
    - id: water-tracker
      name: dsh-plugin-water-tracker
  1. Restart dsh.

Typical Usage

After installation and page refresh, a 💧 floating button appears in the bottom-right corner. Click it to open the panel:
* Today check-in: Set the daily target, click a preset button (100/300/500 ml) or the custom amount button to log water intake, and support undo and reset today’s data.
* Water heatmap: View the past 52 weeks of GitHub-style heatmap; hover over a cell to see the detailed water intake for that day.
* Standalone preview: Double-click preview.html in the root directory to experience the full functionality independently in the browser.

Use Cases and Notes

  • Use cases: Users who need to track water-drinking habits over the long term and want to view accumulated data visually.
  • Notes:
    • Data is saved only in browser localStorage and is not synchronized across devices.
    • The floating button is registered in the shell.overlay floating layer and may be obscured; check the pointer-events property.
    • It depends on @deepseek-ai/cordis, @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-ui-layout, and react.
  • As it is installed as a local plugin, it is recommended to check the source code and license (MIT) before installation.

Conclusion

This plugin helps users build a water-drinking habit through simple check-ins and visual feedback.