Komorebi3x3/dsh-reminder

dsh-reminder

在 DSH（DeepSeek Harness）里创建定时提醒与重复任务。会话中说一句“25 分钟后提醒我开会”，后台调度器到点自动触发——无需离开对话、无需额外 App。

适配 DeepSeek Harness 的 DSH 插件（Cordis Bundle），兼容全系 DSH Web 生态。

功能

- 一句话设提醒：支持相对时间、每天、工作日、每周几、绝对时间
- 后台调度器：每 15 秒检查一次，到点把提醒写入到期队列并记录到控制台
- 重复任务：每天 / 每个工作日 / 每周某天自动滚动到下一次函数
- 完整管理：列出、取消、推迟（snooze）、查看已到期提醒
- 本地持久化：数据存于 $DSH_HOME/scheduler，重启不丢，全程不上传任何数据

安装

通过 DSH Launcher 的「插件市场」搜索 dsh-reminder，或使用 CLI：

从 npm / 市场安装
dsh plugin --profile web add dsh-reminder

或从源码仓库安装（把 main 换成你的默认分支）
dsh plugin --profile web add "github:你的用户名/dsh-reminder#main"

重启 web 并刷新页面使插件生效
dsh web

验证：

dsh --profile web --dump-config   # 应能看到 dsh-reminder 这一层
dsh plugin --profile web list

使用

在对话中直接说，DSH 会自动调用对应工具，例如：

- “25 分钟后提醒我喝水” → set_reminder(when:"in 25 minutes", message:"喝水")
- “每天早上 9 点提醒我站会” → set_reminder(when:"every day 9:00", message:"站会")
- “每周一 10 点生成周报” → set_reminder(when:"every monday 10:00", message:"生成周报")
- “列出我的提醒” → list_reminders
- “我有什么到期的提醒” → get_due_reminders

支持的 when 格式：

| 形式 | 示例 |
| --- | --- |
| 相对 | in 25 minutes / in 2 hours / in 3 days |
| 每天 | every day 21:00 |
| 工作日 | every weekday 9:30 |
| 每周几 | every monday 10:00 |
| 今天/明天 | tomorrow 9:00 / today 14:30 |
| 绝对 | 2026-09-01 10:00 |

工具一览

| 工具 | 说明 |
| --- | --- |
| set_reminder | 创建提醒，返回 id 与下次触发时间 |
| list_reminders | 列出所有未完成提醒 |
| cancel_reminder | 按 id 取消 |
| snooze_reminder | 推迟 N 分钟（推迟后变为一次性） |
| get_due_reminders | 取已到期未确认提醒（clear=true 清空） |

开发

git clone  && cd dsh-reminder
本地开发建议用独立 profile，避免影响 web 生产会话
dsh plugin --profile plugin-dev add ./dsh-reminder
dsh --profile plugin-dev --dump-config
dsh --profile plugin-dev

时间解析为纯函数，可单独测试：

node test-time.mjs

兼容性

DeepSeek Harness 处于开发者预览期，迭代极快。本插件基于 @deepseek-ai/dsh-tools 的 defineTool 与 Cordis ctx.tools / ctx.effect API 实现，已在 0.1.0-rc 系列验证。升级宿主版本后请重新验证；若宿主 API 发生变动，以官方文档为准。建议在插件文档中固定你验证过的 DSH 版本号。

许可证

MIT