DeepSeek Harness Plugin Hub

Publish and manage complete Harness Profiles. Discover Plugins for your next setup.

Explore

PluginsPresetsDocsNews

Community

Publish a pluginContactReport an issue

Resources

Plugin Hub on GitHubDeepSeek HarnessSystem statusPrivacy notice
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

Independent and unofficial. Not affiliated with, authorized by, or endorsed by DeepSeek.

DeepSeek Harness Plugin Hub
ProfilesPluginsCategoriesNewsDocsSign inManage Profiles
ProfilesPluginsCategoriesNewsDocsSign in
← Plugins

dsh-later

Later

Add scheduled sending to DSH: enter a message and it will automatically send it as you at the scheduled time, even if the webpage is closed. Scheduled sending / scheduled reminders / delayed sending.

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:dsh-plugin-collection/dsh-later#07a5a560977e22b835d6741773e41539fbc0cac3
READMECompatibilityVersions
/later 命令演示:输入 /later +5s 检查部署结果 → 回车 → dock 倒计时 → 到点以你的身份送达定时提醒面板待发送 dock 与输入框到期提醒消息创建定时提醒演示到期触发演示/later 命令演示:输入 /later +60m 内容 → 回车 → dock 出现倒计时

Compatibility and provenance

Later is published as dsh-later and currently resolves to version 1.11.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility
*
Runtime surfaces
web
Release source
github
Registry updated
11/5/2026

Versions

1.11.0stable
11/2/2026
1.10.0stable
10/30/2026
1.9.0stable
10/29/2026
Show 10 more versionsCollapse versions
1.8.0stable
10/26/2026
1.7.0stable
10/23/2026
1.6.0stable
10/22/2026
1.5.0stable
10/20/2026
1.4.0stable
10/17/2026
1.3.1stable
10/15/2026
1.3.0stable
10/14/2026
1.2.0stable
10/10/2026
1.1.0stable
10/9/2026
1.0.0stable
9/12/2026

Related plugins

Loading related plugins…

Latest
1.11.0
DSH
*
HMR
Process restart
Tree shaking
Safe tree shaking not declared
Unpacked size
Unavailable
Files
Unavailable
Surface
web
License
MIT
Source
github
GitHub
★ 5
Weekly downloads
1,062
Last push
11/2/2026
View source ↗Project homepage ↗
README badge

Click the badge to copy Markdown for your README.

Do you maintain this Plugin?Claim benefit · Priority security scan

Verify the GitHub repository declared in package.json to manage this listing. After you claim it, Hub will prioritize a security scan of the current version and publish the result when it passes.

Claim this Plugin →
Report an issue

Related plugins

More verified plugins in productivity-workflow.

Ds Harness Remoteds-harness-remoteEnd-to-end encrypted remote access to DeepSeek Harness and experimental Codex workspaces from desktop, web, and Android, with dsh-TUI Host support.Archive Manager@michengai/dsh-archive-manager归档、恢复、收藏和永久删除会话,并诊断损坏的会话日志。 · Archive, restore, favorite, and permanently delete sessions, and diagnose damaged session logs.Remotedsh-remoteRemote-work assistant for DeepSeek Harness: connect SSH (password/key/agent/keyboard-interactive, multi-hop ProxyJump), list hosts from ~/.ssh/config, pick a remote workspace, operate on it with 21 rw_* tools, conflict-aware mirror sync, an embedded PTY tDeepseek Ipptdeepseek-ipptiPolloWork PPT Studio and its curated slide templates as a native DeepSeek Harness conversation view.

README

scheduled urgent overdue

dsh-later — 会话内定时消息插件

中文 | English

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

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

/later 命令演示:输入 /later +5s 检查部署结果 → 回车 → dock 倒计时 → 到点以你的身份送达


使用方法

定时面板

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

能力说明
快捷芯片10分钟后 / 1小时后 / 工作时间 一键填充(智能时段可在设置里改)
自定义时间「自定义…」展开日期 + 时间输入框
任务列表本会话已设定的任务,可逐条删除

暂停、恢复、改内容、立即发送都不在面板里,在 待发送 dock 上逐条操作。

时间格式

以下写法都认(/schedule、/later 与面板自定义时间共用;标了「仅 /later /schedule」的写法面板不收):

类型示例
相对时长+30m · +1h30m · +90s · +1w · 30分钟后 · 半小时后
当天时刻15:32 · 9点 · 9点半 · 1532
相对日 + 时刻明天9点 · 后天 10:00
日期 + 时刻8月21日 15:32 · 2026-08-21 15:32 · 0821-1532
重复 · 等间隔(仅 /later /schedule)+1h*3 喝水 · +30m×2 看构建 · 两小时后×3次
重复 · 链式序列(仅 /later /schedule)+1h+1h+0.5h 盯发布 · +1h +30m 交周报
锚点序列(仅 /later /schedule)15:32+16:32+17:32 三会 · 9:00+1d+1d 打卡 · 明天9点+1h

上表三行加粗的都属于 高级语法(实验性),可在设置里一键关闭;其余写法不受开关影响。

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

多次写法的规则(首次落在第一个间隔之后):

写法展开成
+1h*3t+1h、t+2h、t+3h
+1h+1h+0.5ht+1h、t+2h、t+2.5h(链式累加,用来写「提前 2h→1h→30m」这类梯度催办)
15:32+16:32+17:32今天 15:32、16:32、17:32(三个挂钟时刻)
23:00+01:00今天 23:00、次日 01:00(后一个时刻更早则自动顺延,规则同单条)
9:00+1d+1d连续三天都是 9:00

一次最多 10 条,多次写法的间隔不低于 60 秒(单条不受此限,/later +5s 照旧)。* × x 都认,可跟中文量词(*3次),次数后面要留空格。每条都是独立任务:可单独取消、编辑、插话发送(暂停见下表)。

序列里只允许**「绝对时刻开头,往后累加」**这一个方向:+1h+15:32 会明确报错,不会猜。

锚点序列与相对序列的一处差别(有意为之,不是 bug):

写法落库类型能暂停跨夏令时
+1h*3 / +1h+30m(相对)after✅——
15:32+16:32 / 9:00+1d(锚点)at❌(按钮置灰并说明原因)✅ 墙钟不变:9:00+1d 在回拨日相隔 25 小时仍是 9:00,按 86400 秒累加会漂成 8:00

9:00+1d 里的「一天」按日历日推进(不是 86400 秒),所以 +1d*3 与 9:00+1d+1d 在有夏令时的时区结果不同——前者按真实秒数、后者按墙钟。落到不存在的墙钟(前拨跳过的那一小时)会报错而不是悄悄挪时刻。绝对时刻(15:32、明天9点)不支持 *次数,会明确报错而不是悄悄变成一条。

命令

命令作用
/schedule <时间> <内容>创建一条定时提醒(到点出现在对话里)
/later <时间> <内容>延迟发送:到点以你的身份发出该内容
/later <时间>*<次数> <内容>同上,展开成 N 条代发(+1h*3)
/schedule <时间>+<时间> <内容>同上,链式序列展开成 N 条提醒(+1h+30m)
/later <时刻>+<时刻> <内容>锚点序列:按挂钟时刻展开(15:32+16:32、9:00+1d+1d)
/schedule 明天9点 提交周报
/later 1532 提醒团队同步进度
/later +1h*3 起来喝水
/later +2h+1h+30m 催我交周报

dock 上的按钮不是私有通道,它们就是 /user-schedule-create -list -delete -edit -pause -resume -steer-now 这几条命令(参数是一段 JSON),手动敲也能用;只是它们按"被点"设计,不面向手打。

带图片 / 文件

/later 可以带附件:先在输入框贴图或拖文件,再敲 /later +10m 看下这张图 回车。到点会连同附件以你的身份发出,消息形状和你手动发「文字 + 图」完全一致。

  • 只有 /later 带附件。/schedule、面板、以及模型调用工具创建的提醒都不带——这是一条安全边界:附件块只能经「你亲手输入」这条可信通道进入代发内容,模型在工具参数里夹带 attachments 一律无效。
  • 多次写法(+1h*3)把同一份附件逐条带到每条任务上,各条仍可单独取消/编辑/插话。
  • dock 行显示的是真缩略图。发出之前,宿主那条「按会话日志授权」的图片通道读不到它(附件还没进日志,这是预期状态),于是走宿主的本地文件路由 GET /api/file 出图;发出之后两条通道都通。若这台宿主的附件后端不落盘,缩略图退化成「发送后可见 + 大小」的标记——那不代表附件丢了,到点照样随消息发出。
  • 每条任务在 dock 上最多渲染 8 个缩略图,超出显示 +N;非图片附件显示成「文件名 + 大小」的 chip。
  • 内核 0.1.2 的内容块里没有 file 变体,非图片附件到点会退成一条 [附件] 文件名 文本(图片块各代次都原样透传)。见支持的 DSH 内核。

模型可以直接调用三个用户工具为你创建 / 查询 / 删除提醒(user_schedule_create / user_schedule_list / user_schedule_delete)。改内容、暂停、恢复、立即发送不暴露给模型,它们是 dock 行上的按钮(底层走 /user-schedule-* 命令,只由你亲手点)。无限周期提醒(每 1 小时一直发下去)只有模型这条路:让模型说「每小时提醒我喝水」,它会用 every_seconds 建一条周期任务;周期任务没有结束条件,需要你手动删。

模型还有一份随插件分发的 SKILL.md(技能名 later-reminders)。它常驻在模型的 skill catalog 里,管的是「什么时候该主动给你排一条提醒」和「与内核官方 schedule_create 怎么选」;工具参数规则不写在这里,避免与 schema 两处漂移。这个位点是可选的:宿主的装配里没有 skills 服务时它就不出现,插件其余功能照常。

待发送 dock

输入框上方的倒计时条,每行行尾四个按钮:编辑提醒(就地改内容)、暂停 / 恢复提醒、删除提醒(取消该条)、插话发送(立即推给 agent,不等倒计时;周期任务那一行没有这个按钮)。

暂停只对「再等 N 分钟」这一类(after)且还没到点的提醒开放:按挂钟时刻排的 at 与周期 every 会把按钮置灰,悬停说明原因(已到点的也只能删或发,不能再暂停)。暂停时倒计时与进度条冻结、附件留在条目上;恢复后按剩余时长从恢复那一刻重新排期,触发时刻随之顺延。

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

侧栏状态标识

有活动提醒的会话,行内会出现像素时钟(与「进行中」orb 并存):

图标含义
scheduled紫 · 有定时中提醒
urgent琥珀 · 下次触发 ≤ 5 分钟
overdue红 · 已到期(等待会话空闲派发)

鼠标悬停可见「下次 15:32 · 3 条任务」;已到期时显示「已到期 · 3 条任务(等待会话空闲发送)」;全部提醒都暂停时图标仍是紫色,悬停显示「已暂停 · 3 条任务」(暂停项没有排定时刻,所以不报「下次」)。

侧栏行的悬浮卡片里会追加一行状态(「有 3 条定时提醒,下次 15:32」),与宿主自己的 空闲 / 进行中 同构、不改写它们;已到期与已暂停各有一句对应文案。


界面展示

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

定时提醒面板

待发送 dock —— 输入框上方倒计时条(行内编辑 / 取消;下方即输入框):

待发送 dock 与输入框

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

到期提醒消息

动图演示:

创建定时提醒(输入 → 面板 → 加入 → dock)到期触发(倒计时 → 收到消息)
创建定时提醒演示到期触发演示

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

/later 命令演示:输入 /later +60m 内容 → 回车 → dock 出现倒计时

特性一览

  • 输入框定时按钮:一键打开定时面板,含智能时段 / 自定义时间 / 本会话已设定任务列表 / 倒计时。
  • 待发送 dock:输入框上方的提醒列表,每条可单独取消、行内改内容、暂停与恢复(after 类),或直接插话发送。
  • /later 延迟发送:把「你现在打的这句话」稍后以你的身份发出去(和定时提醒的区别见这里)。
  • 侧栏状态标识:有活动提醒的会话,侧栏显示像素时钟(紫=定时中 · 琥珀=5 分钟内 · 红=已到期),悬停可见任务数与下次时间;全部暂停时改为「已暂停」。
  • 跨内核代次可用:从 0.1.2-rc.1 到 0.2.2-alpha.2 共九个代次逐代表过,含真 GUI 截图矩阵,见支持的 DSH 内核。
  • 关网页也能触发:提醒保存在服务端,关网页、换设备都会准时到达。
  • 不会冒充你本人:到点后显示为「定时提醒」消息,而不是假装是你自己发的。
  • 模型会主动替你排:随包分发的 SKILL.md(技能名 later-reminders)常驻模型的 skill catalog,用户没说「设个提醒」也会主动排程,并分清本插件与内核官方 schedule_create 的用途;宿主装配里没有 skills 服务时这一项自动缺席,不影响其余功能。
  • 多语言:跟随 DSH 界面语言(中文 / English),切换即时生效。
  • 提醒不跨会话:由当前会话派生出的子会话,不会带上父会话的提醒。

定时提醒和延迟发送,有什么区别?

动作什么时候生效谁发出你看到
输入框 Enter 直接发立即你普通用户气泡
定时面板 / /schedule <时间> <内容>到点定时提醒定时提醒 · HH:MM · 内容 提醒行
/later <时间> <内容>到点以你的身份普通用户气泡(可开「定时消息标记」)

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


快速开始

支持的 DSH 内核

内核代次状态
0.1.2-rc.1支持
0.1.5-rc.3支持
0.1.7-rc.1 / 0.1.7-rc.2支持
0.2.0-rc.2 / 0.2.1-rc.2支持
0.2.1-rc.3 / 0.2.1-rc.4支持
0.2.2-alpha.2支持

声明在 package.json 的 engines.dsh:>=0.1.2-rc.1 <0.1.3-0 || >=0.1.5-rc.3 <0.1.6-0 || >=0.1.7-rc.1 <0.1.8-0 || >=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-alpha.2 <0.2.3-0;Node 需要 ^22.19 || >=24。

这行声明与 peerDependencies 都由代次表推导(node scripts/sync-peer-matrix.mjs),形状是按版本段收口的范围,不是白名单:同一版本段内更晚的 rc 与该段正式版会一并放行(range 语法写不出「只认已验证的那几个」)。两侧都必须收,因为执行者不同:0.2.1 起内核只看 engines.dsh,而 0.1.7-rc.1~0.2.0-rc.2 只看 dsh-* peer,0.1.2-rc.1 与 0.1.5-rc.3 两代根本没有兼容门禁(那两代上这两行是说明,不是拦截)。

两处此前各漏过一次,都是实测出来的:engines.dsh 曾是手写宽串(>=0.1.2-rc.1 <0.2.0-0 放行 0.1.3-alpha.2、0.1.6-alpha.1、0.1.7-alpha.1、0.2.2-alpha.2;最后这个后来是作为新代次正式入表的,见下文);而 peer 那侧当时仍是逐代 caret,^0.1.2-rc.1 展开为 >=0.1.2-rc.1 <0.2.0-0、整条 minor 都命中,所以只改 engines 等于把门修在了没人走的那一侧。现在两侧都是逐段收口。

0.2.1-rc.3 / 0.2.1-rc.4 于本轮补齐四个面并正式入表:装配与真投递各自起独立进程实测 GREEN 且通过同源守卫(该守卫要求插件解析到的内核模块与被测树同源,否则结论不作数),跨代 tsc 两项目通过,门禁用各代自己的评估器判 pass。本地开发固定的代次仍停在 0.2.1-rc.2(devDependencies 由一条显式常量记录,升级时要同步改它),更新的代次靠 --steps type 逐代覆盖。

0.2.2-alpha.2 是新加的一代,它带来两条契约变更(不是外观差异):SessionProjectionStateMap 从上游移除,以及 register() 的返回从同步 disposer 变成 Promise<ProjectionHandle> 并附带「注册完成前不得对外发布消费方」的 await 时序。落点与实测口径见 docs/verification.md 的「0.2.2-alpha.2:投影注册契约变更」。这一代是四面都实测过才写「支持」的:9 个代次各自独立进程跑 mount + function(同源=same、spliced=1 dispatch=Y、at 形状 5/5)、跨代 tsc 两个项目 0 错误、门禁用各代自己的评估器判 pass(0.1.2-rc.1 / 0.1.5-rc.3 两代的 app-boot 不导出该函数,属结构性未判定,没记成绿),本代另有真 GUI 截图(docs/media/ui-matrix-2026-10-30-realgui/)。逐条证据见 docs/verification.md 的「0.2.2-alpha.2」小节 —— 只有四面全绿之后这一行才会写「支持」,在那之前一律写「待验证」,因为预支一个 GREEN 等于让用户按没跑过的结论装插件。同样地,devDependencies 不为它挪动(alpha 不进本地编译基线),新代次靠 --steps type 与真内核四面覆盖。

两条边界说明白,免得被当成「漏支持」:

  • 0.1.1-rc.2 不支持。 不是代码跑不通,而是它那条依赖线在 registry 里装不出来(@deepseek-ai/dsh-util-workspace-path@0.1.1-rc.2 未发布),任何工具都给不出结论;上游补发之前谈不上支持。
  • 0.1.5 按 rc.3 验证,不覆盖 rc.1。 dsh@0.1.5-rc.1 的内部依赖写的是 ^0.1.5-rc.1,默认安装会把整条插件线解析到 rc.3(实测 238 个 @deepseek-ai/dsh* 里 237 个不是 rc.1),所以你实际拿到的就是统一的 rc.3,我们只按它验证。 早先这里写过「rc.1 启动器 + rc.3 组件根本起不来」——那是误判并已撤回:同一棵混装树在补齐 peer 之后能正常装配并投递;当时的失败来自验证脚本自己的两处装配口径(写死启动器位置、跳过 peer 安装),不是内核限制。把 rc.1 排除在支持范围外,理由始终是「未按该形态验证」,不是「它不能用」。

六代逐代验过四个面(基线 main@28ca1dc,即 1.8.0,2026-10-26 实测):装配(真内核冷启动挂上插件)、功能(到点真实投递的事件形状)、类型(整条 @deepseek-ai/dsh* 依赖线换成该代次后两个 tsconfig 零错误)、UI(真 GUI 里定时按钮 / dock / 面板逐代截图留档)。前三个面复跑 npm run verify:kernels:all,UI 面复跑 npm run verify:ui。实测口径、逐代结论与方法归 docs/verification.md 和 docs/notes/ui-matrix.md,本表只报结论。

上一段是 1.8.0 那轮的基线记录,「六代」就是当时实际跑过的数量,不随后来加代次改写(历史即证据)。本轮另为 0.2.2-alpha.2 补测四面,代次表因此从 8 条变 9 条;结论已回填进 docs/verification.md 的 §0.2.2-alpha.2(9 代次 × 四面全绿,UI 面逐代结论见 docs/notes/ui-matrix.md),所以上面那张表现在给它写的是「支持」,不是预支。

随包分发的 SKILL.md 那个曝光位不在这份基线里。它按装配而非代次决定有无(宿主装配里没有 skills 服务时静默缺席,见上文),跨代证据在 tests/skill-provider.test.mjs:真 SkillRegistry 的用例默认只跑 0.2.1-rc.2,其它代次要用 DSH_LATER_SKILL_PKG 指认该代的 dsh-skill/lib/index.js。

版本门禁在哪一侧生效也随代次不同:0.2.0 及更早的内核不读 engines.dsh,只看 @deepseek-ai/dsh-* 的逐代 peer 枚举;0.2.1 起才由 engines.dsh 单独决定。所以「在这台老内核上被装进来了」不等于「这代内核认了你声明的范围」。

老内核上有四处可见降级:功能不丢,外观与措辞会变。

代次表现
0.1.2非图片附件到点退成 [附件] 文件名 文本块(该代 ContentBlock 没有 file 变体);图片块各代次都原样透传
0.1.2附件图标统一画回形针,文件大小文案由本插件本地计算(1024 进制、一位小数),不保证与宿主逐字一致
0.1.5 及更早Tooltip 没有 portal,长提示可能被可滚动的祖先元素裁掉
0.1.5 线设置项会被持久化进 profile(那代 schemastery 没有 Schema.volatile());受影响的是布尔开关,写进去无害

安装到 DSH

npm 安装(推荐,预构建产物,无需授权):

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

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

cd dsh-later
pnpm install                # 仓库是 pnpm workspace(pnpm-lock.yaml + pnpm-workspace.yaml)
pnpm run build

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

开发提示:npm run watch 监听 src/ 自动重建并跑形状回归测试。

注意它不再自动改 GUI 里跑的那份(issue #46:旧行为会把未合并代码静默部署到所有 profile,多 worktree 并发时还会互相覆盖)。要在界面上看到效果,二选一:

npm run deploy                     # 手动同步一次
DSH_LATER_RELINK=1 npm run watch   # 恢复「每次改动即部署」的旧行为

第一条提醒

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

长文本提醒

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

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

配置

默认开箱即用。可在 DSH 设置 → 插件 → Session Scheduler 调整(保存即时生效,无需重启):

字段说明默认
显示定时按钮输入框右侧是否显示定时按钮(隐藏不影响已创建的提醒触发与 dock 显示)显示
在分组徽标中显示定时任务折叠分组徽标(dsh-group-status)里是否出现「定时任务」这一格;关闭 = 不向对端登记 facet,提醒本身照常触发显示
单会话任务上限一个会话内最多允许的提醒数100
允许长文本解除 1000 字符默认上限关闭
自定义上限allowLongPrompts 开启时的字符上限1000
工作时间 / 午休 / 晚间静默智能时段 5 个 HH:mm 字段,决定快捷芯片与智能排期见设置页
插话投递方式「插话发送」进哪个队列:独立成一轮(默认,安全)/ 当前轮(更快,极端情况下会丢)独立成一轮
投递确认 / 未确认处理是否核对提醒真的送达,以及未确认时保留还是丢弃开 / 保留
时钟图标风格auto(按内核版本)/ modern / classicauto
高级语法 实验性多次写法总开关:+1h*3、+1h+1h+0.5h、15:32+16:32、9:00+1d。关闭后这些写法被明确拒绝并提示回设置开启开启

「高级语法」标实验性的原因不是没测(文法与展开由 tests/occurrences.test.mjs 逐条覆盖,逐代实测见 docs/verification.md),而是展开后的观感仍需观察:一次命令写 10 条会不会刷屏、60 秒地板与 10 条上限是否合适。 关闭它不会退回旧版的静默误解析(+1h*3 x 建成一条内容为 *3 x 的任务)——那是 bug,不在可回退的功能面里;残片守卫与本开关无关,始终生效。

进阶:也可以用 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()
字段含义
count任务数(含暂停项)
pausedCount暂停项数量(暂停项计入 count,但不参与 nextAt)
nextAt最早触发时刻(epoch ms);全部暂停时为 undefined
statescheduled / urgent(≤5 分钟)/ overdue(已到期未派发),按快照时刻判定

契约要点:

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

折叠分组徽标:由我们自己注册 facet(issue #36)

「组内有几个会话挂着定时任务」这一格,语义与实现现在同侧:本插件按 dsh-group-status 的 facet 协议 v1 在自己 client 的 apply 里登记 dsh-later.schedule,交出 fold / merge / label / renderIcon。 徽标数字的口径(组内有任务的会话数)、色档(scheduled 紫 / urgent 橙 / overdue 红)、 脉冲(只有 overdue 与 urgent 闪)、文案(N 定时任务 / N Scheduled)与图标(官方描边时钟 14px)都由本插件判定,对方只认协议形状、不再逐家适配。

  • dsh-group-status 是可选搭档:它未安装 / 未启用时 require('dsh-group-status/client') 会抛, 本插件兜住并跳过登记。因此它既不进 dsh.client.external,也不进 client 的模块级 inject ——顶层 inject 是激活门控,写成硬依赖会让本插件在对方缺席时永不激活(issue #34 那次 P0)。
  • 对端协议版本对不上时可见地跳过(一条 console.warn):「我注册了为什么没显示」必须查得出原因。
  • 显隐开关在本插件(issue #83):showInGroupBadge,默认开。对端 #37 把协议里的 settingKey 废弃了(v1 仍接受,但不再读取),规则收敛成一条——登记即显示,不注册即不显示。 于是「关掉定时任务提示」只能由本插件执行:关掉就是不登记。设置页保存即时生效,不必刷新页面 (登记跟着订阅走);未安装 dsh-group-status 时这一项没有可见效果。
  • 数字 / 色档 / 脉冲 / 文案 / 图标与它此前的过渡适配器逐项一致,并由 tests/group-status-facet.test.mjs 把那份适配器算法照抄成 oracle 做对拍——以后谁想改口径, 得先过这条基线,改动不再能静默生效。

上面的摘要 API 仍然保留:侧栏行、悬浮卡片这类直接读数的消费方照旧用 getScheduleSummaryStore() 与 summarizeScheduleGroup(),两条路读同一份 store。

技术文档

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

  • 架构与数据流 — 宿主/客户端分层、事件流、目录结构、调度器原理
  • 关键设计决策 — source 字段、slash 通道、fork 隔离、注入防护等取舍
  • 验证状态与验收对照 — 测试、线上 E2E、跨内核代次兼容、AC 对照表
  • UI 面跨代次截图矩阵(每代怎么起真 GUI、判什么、历次结论)

参考

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

许可

MIT


scheduled urgent overdue