dsh-later

在 DSH 里给自己设提醒：用户自己设、当前对话收到、服务端驱动、跨设备——到点准时送达，即使你关掉了网页。

/later 延迟发送 —— 不开面板，在输入框敲一行就以你的身份稍后发出（演示：逐字输入 /later +5s / +3m / +1h20m，回车后进入倒计时；+5s 那条到点真实送达）：

---

使用方法

定时面板

点输入框右侧的 「定时发送」 打开面板。面板以输入框内容作为提醒内容，选好时间后点 「加入 · HH:MM 发送」（未选时间时该按钮不可点）即可；输入框上方随即出现倒计时条。

时间格式

以下写法都认（/schedule、/later 与面板自定义时间共用）：

只写时刻（如 1532）时，若今天已过会自动顺延到明天（最多 7 天）；写了 明天/后天 则按字面理解，该时刻已过会提示改用具体日期；只写月日（如 8月21日）时，今年已过则顺延到明年。

命令

/schedule 明天9点 提交周报
/later 1532 提醒团队同步进度

模型也可以直接调用用户工具为你创建/查询/修改提醒（user_schedule_create / user_schedule_list / user_schedule_delete / user_schedule_edit）。

待发送 dock

输入框上方的倒计时条，每行行尾三个按钮：编辑提醒（就地改内容）、删除提醒（取消该条）、插话发送（立即推给 agent，不等倒计时）。

⚠️ 「插话发送」不是「确认」，点了会马上把提醒内容发给 agent 并唤醒模型；只想取消请点删除。

侧栏状态标识

有活动提醒的会话，行内会出现像素时钟（与「进行中」orb 并存）：

鼠标悬停可见「下次 15:32 · 3 条任务」；已到期时显示「已到期 · 3 条任务（等待会话空闲发送）」。

---

界面展示

定时面板 —— 快捷时段 / 自定义时间 / 已设定任务列表：

待发送 dock —— 输入框上方倒计时条（行内编辑 / 取消；下方即输入框）：

到期真实触发 —— 到点后对话里出现「⏰ 定时提醒」消息（关网页也照常触发）：

动图演示：

/later 快捷命令 —— 不打面板，直接在输入框敲一行就以你的身份延迟发送：

---

特性一览

• 输入框定时按钮：一键打开定时面板——智能时段 / 自定义时间 / 发送预览 / 已设定任务列表 / 倒计时。
• 待发送 dock：输入框上方的提醒列表，每条可单独取消，或点击编辑图标行内修改内容。
• /later 延迟发送：把「你现在打的这句话」稍后以你的身份发出去（和定时提醒的区别见这里）。
• 侧栏状态标识：有活动提醒的会话，侧栏显示像素时钟（紫=定时中 · 琥珀=5 分钟内 · 红=已到期），悬停可见任务数与下次时间。
• 关网页也能触发：提醒保存在服务端，关网页、换设备都会准时到达。
• 不会冒充你本人：到点后显示为「定时提醒」消息，而不是假装是你自己发的。
• 多语言：跟随 DSH 界面语言（中文 / English），切换即时生效。
• 提醒不跨会话：由当前会话派生出的子会话，不会带上父会话的提醒。

---

定时提醒和延迟发送，有什么区别？

/schedule 不是「延迟发送」：输入框里那行 /schedule … 一按回车就会立刻发出去（作为一条用户消息），被推迟的只是提醒本身。如果你想要的是「把我现在打的这句话，过会儿当作我亲口发的」，请用 /later。

---

快速开始

安装到 DSH

npm 安装（推荐，预构建产物，无需授权）：

dsh plugin --profile web add dsh-later
# 重启 dsh web 后生效

或者从源码构建后装入 DSH Web profile：

cd dsh-later
npm install
npm run build

dsh plugin --profile web add "file:/path/to/dsh-later"
# 重启 dsh web 后生效

开发提示：npm run watch 监听 src/ 自动重建并跑形状回归测试，改动即时生效。

第一条提醒

1. 打开任意会话，输入框右侧出现「定时」按钮；
2. 点击按钮 → 选一个智能时段，或填自定义时间与内容；
3. 点确认 → 按钮旁出现倒计时芯片，输入框上方 dock 显示待发条目；
4. 到点后对话里收到「定时提醒」消息——关掉网页也会触发。

---

长文本提醒

提醒内容默认上限 1000 字符。需要更长时，在 DSH 设置 → 插件 → Session Scheduler 开启 allowLongPrompts 并设置 maxPromptChars。

• 适合：代码片段、会议纪要、长引文、跨设备日记/待办。
• 不建议：提醒内容里包含可能被当成「指令」的话（内容越长风险越大）；多人共享同一台设备的公共 profile（任何人都能调大）。

---

配置

默认开箱即用。可在 DSH 设置 → 插件 → Session Scheduler 调整（保存即时生效，无需重启）：

进阶：也可以用 cordis.patch.yml 在启动期覆盖默认值（如 maxSchedules），见 docs/ 与 schema。

---

给插件开发者：定时摘要 API（跨插件）

dsh-later 把「全会话定时任务摘要」作为公共数据面暴露出来 （issue #17），其它客户端插件 （如 dsh-group-status）据此在分组/侧栏聚合显示定时状态，无需自己解析 userSchedules 投影，也不会与行内 badge 漂移。

消费方先在 package.json 声明外部模块：

{ "dsh": { "client": { "platform": "web", "external": ["dsh-later"] } } }

然后在客户端 factory 里 require('dsh-later/client')：

const { getScheduleSummaryStore, summarizeScheduleGroup, useScheduleSummary } = require('dsh-later/client')

// 1) 直接读 store：会话 id → { count, pausedCount, nextAt, state }
const store = getScheduleSummaryStore() // dsh-later 未加载时为 undefined
const summary = store?.getSnapshot() ?? new Map()

// 2) 按分组聚合（折叠分组徽标直接用它）
const group = summarizeScheduleGroup(summary, groupSessionIds)
// → { sessions, count, pausedCount, nextAt?, state? }

// 3) React 组件内订阅（store 迟到也会自动重渲染）
const live = useScheduleSummary()

契约要点：

• 摘要只包含有任务的会话，无任务的会话不出现；消费方按自己的 sessionIds 查表即可。
• store 是唯一数据权威：dsh-later 侧栏 badge 也读它，因此两边必然同源；它内部负责 sessions.list 订阅、30s 状态 tick 与 60s session.list 读 RPC（仅页面可见时）。
• 消费方必须容忍 undefined（dsh-later 未安装/未启用时静默降级）。

技术文档

以下内容面向开发者与维护者，已移出本 README：

• 架构与数据流 — 宿主/客户端分层、事件流、目录结构、调度器原理
• 关键设计决策 — source 字段、slash 通道、fork 隔离、注入防护等取舍
• 验证状态与验收对照 — 测试、线上 E2E、跨内核代次兼容、AC 对照表

参考

• PRD 与设计文档：项目根目录 prd.md、docs/
• dsh-schedule 源码分析：../references/dsh-schedule-analysis.md
• dsh-sleep-send 源码分析：../references/dsh-sleep-send-analysis.md

许可

MIT

---