周期习惯排期日历 zimai233/dsh-wash-calendar

dsh-wash-calendar

用于 DeepSeek Harness 的周期性习惯打卡日历。

把「上次洗护日期 + 间隔天数」变成四个可被 Agent 直接调用的工具：下一次提醒、区间排期、单日校验、文字建议。无需任何前端页面，直接在对话中管理所有周期性健康习惯。

为什么

DSH 插件生态中 health/habit（健康/习惯）分类是空的——没有任何插件能帮 Agent 计算周期性的习惯排期。本插件填补了这个空缺：它把洗护日历的日期数学（ISO 日期辅助、间隔推算、排期枚举）提炼为四个工具，覆盖「下次啥时候、这段区间内有哪些天、某天是不是、现在该怎么办」四个问题。

功能

- habit_next — 计算今天之后的下一次习惯日，返回 { nextDate, daysUntil }。
- habit_schedule — 枚举某段日期区间内所有计划中的习惯日（含首尾）。
- habit_check — 校验某一天是否是排期日，并给出距上次的天数 { scheduled, daysSince }。
- habit_advice — 直接返回一句中文建议：「今日洗护」「距下次洗护还有 N 天」「已逾期 N 天，建议尽快」。
- 零构建步骤——纯 ESM，发布的包就是运行时代码。无 prepare 脚本、无需构建权限。

安装

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

从 GitHub 安装（锁定 commit，保障供应链卫生）
dsh plugin --profile myprofile add github:zimai233/dsh-wash-calendar#

用法

用自然语言告诉 Agent：

「我上次洗护是 2026-08-01，每 4 天一次。今天该不该洗？下次是哪天？帮我列出 8 月剩下的排期。」

Agent 会依次调用：

// 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 天，建议尽快"

洗护之外的场景同样适用：浇花、喂鱼、换药、锻炼、大扫除……任何「上次时间 + 固定间隔」的周期性习惯。

工具参考

| 工具 | 参数 | 返回 |
| habit_next | lastDate (string, 必填), interval (number, 必填, 1-7), today? (string, 默认今天) | { nextDate, daysUntil } |
| habit_schedule | lastDate, interval, startISO, endISO (均必填) | 排期 ISO 日期数组 |
| habit_check | dateISO, lastDate, interval (均必填) | { scheduled, daysSince } |
| habit_advice | lastDate, interval, today? (默认今天) | 纯文本建议 |

日期一律使用 YYYY-MM-DD ISO 格式；interval 表示相邻两次之间的天数（1-7）。

开发

npm install
npm test # 对纯函数核心运行 node:test 测试
npm run pack # 预演发布（等价于 pnpm pack）

License

MIT

dsh-wash-calendar

用于 DeepSeek Harness 的周期性习惯排期日历。

把「上次发生时间 + 间隔」这一对信息变成四个可被 Agent 调用的工具：下一次提醒、区间排期、单日校验、纯文本建议——适用于任何周期性健康/习惯例程，直接在对话中完成。

为什么

DSH 插件生态中 health/habit（健康/习惯）分类是空的——没有任何插件能帮 Agent 计算周期性的习惯排期。本插件填补了这个空缺：它把洗护日历的日期数学（ISO 日期辅助、间隔推算、排期枚举）提炼为四个工具，回答「下次是何时」「这段区间内有哪些天」「某天是不是」「现在该做什么」。

功能
- habit_next — 严格在今天之后的下一次发生，返回 { nextDate, daysUntil }。
- habit_schedule — 包含端点的范围内所有计划日期。
- habit_check — 给定日期是否为计划发生日，以及距锚点的天数。
- habit_advice — 一段简短文本建议："今日洗护"（今天洗护）、"距下次洗护还有 N 天"（还有 N 天），或"已逾期 N 天，建议尽快"（逾期 N 天）。
- 零构建步骤 — 纯 ESM，发布的包就是运行时代码。无需 prepare 脚本，无需构建权限。

安装

from npm
dsh plugin --profile myprofile add dsh-wash-calendar

from GitHub (lock the commit for supply-chain hygiene)
dsh plugin --profile myprofile add github:zimai233/dsh-wash-calendar#

用法

用自然语言向 agent 提问：

"我上次洗护是 2026-08-01，每 4 天一次。今天该洗护吗？下次是什么时候？列出八月剩余的计划。"

agent 会调用：

// 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 天，建议尽快"

远不止适用于洗护：浇花、喂鱼、补药、锻炼、清洁 — 任何"上次时间 + 固定间隔"的重复习惯。

工具参考

| 工具 | 参数 | 返回 |
| habit_next | lastDate（字符串，必填），interval（数字，必填，1-7），today?（字符串，默认今天） | { nextDate, daysUntil } |
| habit_schedule | lastDate，interval，startISO，endISO（均必填） | 计划 ISO 日期数组 |
| habit_check | dateISO，lastDate，interval（均必填） | { scheduled, daysSince } |
| habit_advice | lastDate，interval，today?（默认今天） | 纯文本建议 |

所有日期使用 YYYY-MM-DD ISO 格式；interval 是连续发生之间的天数（1-7）。

开发

npm install
npm test # runs node:test against the pure core
npm run pack # dry-run publish (pnpm pack equivalent)

许可证

MIT