dsh-schedule-send
English | 中文
给 DeepSeek Harness 的输入框加一个「定时发送」：现在写好内容、选一个时间，到点后这段文字会以普通用户消息的身份发进同一个会话——等同于你在那个时刻按下了发送，agent 会正常回复并继续对话。
功能
- 输入框工具栏（发送按钮左侧）出现一个时钟按钮。
- 快捷时间（30 分钟后、1 小时后、3 小时后、明天 09:00），也可选精确的本地日期时间。
- 确认后草稿立即清空；会话里出现一张持久卡片，显示发送时间、内容摘要，并带 取消 按钮。
- 队列落在工作区之外，支持补发：应用关闭期间到点的消息会在下次启动后送达。
- 送达的是真实用户消息（
source.kind = 'user'），不是提醒、也不是系统通知。 - 失败按退避重试；发送 id 同时是 prompt 的
requestId，崩溃后重试不会重复投递。 - 无需构建，浏览器端只依赖页面共享的
react/react-dom。
为什么不直接用内置提醒？
DSH 内置的 Schedule 子系统语义是"提醒"：它注入 [SCHEDULE REMINDER] 框架，要求模型把内容展示给用户，而不是把它当作指令执行。定时发送需要相反的语义——内容必须变成用户的消息并开启一轮回复。因此本插件维护自己的持久队列，通过公开的 ctx.sessionController.prompt(...) 投递：目标会话未打开时会自动 resume，并生成一条普通用户消息。
安装
这个包同时声明了宿主半（index.js，负责队列、命令与投递）和浏览器半（client.js）。没有构建脚本，所有安装方式拿到的都是可直接运行的成品文件。
方式 1：发布页的 tarball（推荐）
从 Releases 下载 dsh-schedule-send-0.1.0.tgz，然后：
dsh plugin --profile desktop add ./dsh-schedule-send-0.1.0.tgz
方式 2：直接从 GitHub 安装
dsh plugin --profile desktop add github:Zhiyi-Zhao/dsh-schedule-send
dsh web profile 用同样的 spec，把 profile 换成 web：
dsh plugin --profile web add github:Zhiyi-Zhao/dsh-schedule-send
方式 3：从本地目录安装
git clone https://github.com/Zhiyi-Zhao/dsh-schedule-send.git
dsh plugin --profile desktop add /absolute/path/to/dsh-schedule-send
方式 4：在 Web 界面里安装
打开侧边栏 Plugins 页面，选择安装 bundle，粘贴上面的 spec（github:Zhiyi-Zhao/dsh-schedule-send、tarball 地址或绝对路径）。从运行中的应用里安装需要 danger-full-access 权限或当次审批。
> --profile desktop 是桌面应用的 profile 名；dsh web 部署使用 --profile web。只要 profile 组合了 Web 客户端，这个 bundle 就能用。把下文命令里的 desktop 换成你的 profile 名即可。
安装到 desktop profile 后，新 bundle 可能通过 HMR 立刻生效；若没有出现，重启 DeepSeek Harness。卸载：
dsh plugin --profile desktop remove dsh-schedule-send
使用
- 在任意会话里输入消息（纯文本）。
- 点发送按钮左边的时钟按钮。
- 选一个快捷时间，或设置精确的本地日期时间。
- 点「定时发送」确认：草稿清空，会话里出现「定时发送」卡片。
- 到点后消息以普通用户消息进入该会话，agent 正常回复。到点前可以点卡片上的 取消。
卡片会作为历史留在对话里；投递后再点取消，会提示消息已经离开队列。
> 插件还注册了两个内部会话命令（schedule-send、schedule-send-cancel），因为浏览器插件只能通过会话命令通道调用自己的宿主半。它们会出现在斜杠菜单里，但不需要手动输入——真正的入口是时钟按钮。
工作原理
| 步骤 | 位置 | 发生了什么 |
|---|---|---|
| 创建 | 浏览器 | 输入框控件调用 ctx.remote.commands.execute('/schedule-send ')，携带正文、目标时间戳、发送 id 和浏览器 IANA 时区。 |
| 持久化 | 宿主 | 命令处理函数校验参数，把记录原子写入 $DSH_HOME/schedule-send/queue.json（临时文件 + rename）。 |
| 扫描 | 宿主 | 每 5 秒扫描到期记录，调用 ctx.sessionController.prompt({ requestId: id, sessionId, mode: 'queue', content, clientTimeZone })。 |
| 投递 | 宿主 | 该公开方法按需 resume 会话并提交普通用户消息；发送 id 就是去重键，重试幂等。 |
| 反馈 | 浏览器 | 命令生命周期通过按命令名分发的 conversation.chat.commandview 渲染成持久卡片。 |
实测记录
一次真实的定时发送，从宿主队列读回（本地时间，Europe/Copenhagen）：
| 字段 | 值 |
|---|---|
| 状态 | delivered |
| 创建 | 2026-10-19 12:22:16 |
| 目标 | 2026-10-19 12:24:00 |
| 投递 | 2026-10-19 12:24:03 |
| 延迟 | 3.2 秒（在 5 秒扫描周期内） |
送达的文字以普通用户消息出现在会话里，agent 正常回复。
限制
- 到点时应用必须在运行：DSH 没有后台调度器。应用关闭时会等到下次启动后补发；完全关闭的应用无法发送。
- 仅支持纯文本：草稿带附件时按钮禁用。
- 投递会 resume 目标会话并跑一轮回复，即使那个对话没有打开；会消耗 token、可能调用工具，审批仍按该会话的策略等待你确认。
- 精度约 ±5 秒（扫描间隔）。
- 只做一次性发送：不支持周期任务，也不支持原地改时间；取消后重新安排即可。
- 投递失败（会话已不存在、会话没有可路由的模型等）会退避重试，最多 60 次，然后以
failed和lastError记录在队列里，并在宿主日志里留一条警告。 - 队列文件损坏时会被改名为
queue.json.corrupt-<时间戳>，插件以空队列启动。
兼容性
已在桌面版 DeepSeek Harness 0.2.1-rc.2 上验证。
- 宿主半：
ctx.commands.register、ctx.sessionController.prompt、ctx.sessions.flush、ctx.agents，全部是公开服务。 - 浏览器半：slot API（
conversation.input.right、conversation.chat.commandview）、locale 服务和ctx.remote.commands.execute；只 importreact与react-dom，不依赖 DSH 的 UI primitives，因此 UI 包的小改动不会破坏它。 - 如果
ctx.sessionController不存在，定时消息会留在队列里并记一条警告，而不是让整个 profile 失败。
开发
index.js 宿主半：命令、持久队列、扫描、投递
client.js 浏览器半：输入框控件、卡片、本地化字典
cordis.patch.yml 安装时插入的 Loader 行
locale/{en,zh}.json 插件清单读取的显示元数据
icon.svg bundle 图标
scripts/verify.mjs `npm run verify` 与 CI 使用的静态检查
- 无构建、无安装步骤：浏览器产物是一个纯闭包工厂。
npm run verify校验 manifest、导出、locale 元数据、两个入口文件和工厂 id。- 本地试用：
dsh plugin --profile add /absolute/path/to/dsh-schedule-send。
许可
MIT © 2026 Zhiyi Zhao
