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 <repo> && 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