The philosophy of DeepSeek Harness is “everything is a plugin.” In the existing plugin ecosystem, the health/habit category is empty, and no plugin can help an Agent calculate periodic habit schedules. The dsh-wash-calendar plugin fills this gap. It turns date calculations based on “last time + interval days” into four tools that can be directly invoked by Agents, answering questions such as “when is the next occurrence, which days fall within this range, whether a particular day is scheduled, and what should I do now.”

Core Features

The plugin provides four tool functions, requiring no frontend page, so periodic health habits can be managed directly in conversation:

  • habit_next: Calculates the next habit day after today and returns { nextDate, daysUntil }.
  • habit_schedule: Enumerates all scheduled habit days within a date range (inclusive of both endpoints).
  • habit_check: Validates whether a given day is a scheduled day and returns the number of days since the last occurrence: { scheduled, daysSince }.
  • habit_advice: Returns advice in Chinese, such as “washing/care today,” “N days until the next washing/care,” or “overdue by N days, act as soon as possible.”

Installation and Enablement

Installing the plugin requires specifying a profile. It is recommended to install from GitHub and lock the commit (SHA) to maintain supply-chain hygiene.

# 从 npm 安装
dsh plugin --profile myprofile add dsh-wash-calendar

# 从 GitHub 安装（锁定 commit）
dsh plugin --profile myprofile add github:zimai233/dsh-wash-calendar#<sha>

Typical Usage

Users can describe their requirements directly in natural language, and the Agent will invoke the tools above in sequence.

User input example:

“My last washing/care was 2026-08-01, once every 4 days. Should I do washing/care today? What is the next date? Help list the remaining schedule in August.”

Agent invocation example:

// habit_check
{ "dateISO": "2026-08-14", "lastDate": "2026-08-01", "interval": 4 }
// -> {"scheduled":false,"daysSince":13}

// habit_next
{ "lastDate": "2026-08-01", "interval": 4, "today": "2026-08-14" }
// -> {"nextDate":"2026-08-17","daysUntil":3}

// habit_schedule
{ "lastDate": "2026-08-01", "interval": 4, "startISO": "2026-08-14", "endISO": "2026-08-31" }
// -> ["2026-08-17","2026-08-21","2026-08-25","2026-08-29"]

// habit_advice
{ "lastDate": "2026-08-01", "interval": 4, "today": "2026-08-14" }
// -> "已逾期 9 天，建议尽快"

Applicable Scenarios and Notes

This plugin applies to any periodic task based on “last time + fixed interval,” such as washing/care, watering plants, feeding fish, medication changes, exercise, deep cleaning, and so on.

Before use, pay attention to the following technical details:

  • Date format: All date parameters must use the YYYY-MM-DD ISO format.
  • Interval range: The interval parameter represents the number of days between adjacent occurrences and must be in the range 1-7.
  • Dependencies: The plugin depends on @deepseek-ai/dsh-tools and @deepseek-ai/cordis.
  • Development style: No build step, pure ESM; the published package is the runtime code.

The plugin runs with the permissions of the current DSH process. Before installation, it is recommended to review the source code and license (MIT).

Summary

dsh-wash-calendar complements the DeepSeek Harness ecosystem with a toolchain for health and habit management. By encapsulating complex date calculations as standard tools, developers can enable Agents to handle various periodic tasks without writing their own date helper functions.