定时发送OTTTTTO/dsh-scheduled-send

dsh-scheduled-send · 定时发送

EN：DeepSeek Harness（DSH）Web 的定时发送——在输入框打好草稿，点 ⏰，到设定时间后它会以正常用户气泡的形式发送到绑定的会话中。运行在宿主侧：关闭浏览器，它仍会发送。中文说明如下。

npm version
npm downloads
License: MIT
GitHub stars
tests

在 DSH Web 输入框打好草稿，点 ⏰ 选个时间——到点后消息以正常用户气泡出现在原会话中并自动触发模型响应。定好就可以关掉浏览器睡觉，调度在服务端照常执行。

📑 目录

- ✨ 功能一览
- 🚀 安装（含更新 / 源码安装 / 常见问题）
- 🖼️ 使用演示
- 🧠 工作原理
- 🔒 隐私
- ⚠️ 已知限制
- 🛠️ 开发
- ⭐ Star History

✨ 功能一览

- ⏰ 输入框定时按钮：挂在输入框工具行（与发送按钮同行）——正常打字 → 点「⏰ 定时」→ 时间确认浮层（datetime-local，默认当前 +5 分钟，可改任意未来时刻）→ 确认后内容转为定时任务、输入框清空、不立即发送；支持多行 / Markdown 源码原样保存
- ✉️ 以你的身份发送：到点投递走与真实发送一致的路径（role: 'user' 气泡 + followup），渲染为正常用户消息并触发模型响应
- 🖥️ 服务端调度，关浏览器不影响：定时调度与消息注入都在 dsh 宿主进程执行，浏览器只是展示层——这是与浏览器侧定时插件的本质区别
- 🔒 会话隔离：任务绑定创建时的会话（conversationId）；切换会话只看到该会话的任务，互不串扰
- 🗂️ 侧边栏「定时任务」面板（v0.3.0+）：侧边栏底部入口（含全库未发送任务数气泡角标）→ 独立面板列出所有会话的未发送任务（sendAt 升序、内容摘要等宽展示、计划时间、倒计时、会话名）；点击条目跳转到对应会话；支持跨会话取消；会话已删除的条目置灰标注仍可取消
- 📋 会话内折叠列表：输入框上方显示本会话任务；多条时常显最先到期 1 条 + 「其余 N 条 ⌄」可展开/收起；任意条数均可手动折叠
- ♻️ 断电补发：任务持久化在本地（~/.dsh/dsh-scheduled-send/tasks.json），重启 DSH 后恢复队列并向原会话补发；会话不在线时保留任务，恢复即补发
- 📱 移动端适配：≤480px 近全宽弹窗、≥40px 触控高度、面板默认收起、防横向溢出

🚀 安装

前置：已装好 DSH（dsh web 可正常运行）。

dsh plugin --profile web add @ottttto/dsh-scheduled-send

装完重启 dsh web 并硬刷新浏览器（Cmd/Ctrl+Shift+R）——输入框工具排出现「⏰ 定时」按钮，侧边栏底部出现「⏰ 定时任务」入口。

更新 / 指定版本

dsh plugin --profile web update @ottttto/dsh-scheduled-send        # 升到最新
dsh plugin --profile web add @ottttto/dsh-scheduled-send@0.3.9     # 锁定版本

从源码安装（开发调试）

git clone https://github.com/OTTTTTO/dsh-scheduled-send.git
dsh plugin --profile web add /path/to/dsh-scheduled-send   # 本地路径安装

常见问题

| 现象 | 原因与解决 |
|---|---|
| 启动报 Cannot find package 'dsh-scheduled-send' | 旧版（≤0.2.1）挂载条目用了裸名。先 dsh plugin --profile web remove dsh-scheduled-send，再重装 scoped 包 |
| 到点没发送 | 确认 dsh 宿主进程在运行（浏览器可关，进程不能停）；查启动日志中 [dsh-scheduled-send] 告警 |
| 到点后消息没显示成气泡 | 升级到 ≥0.2.3（旧版 source.kind:'plugin' 会渲染为注入行） |
| 插件 UI 不出现 | 硬刷新浏览器（Cmd/Ctrl+Shift+R）加载新 bundle |

🖼️ 使用演示

① 输入内容，点「⏰ 定时」设置时间

② 会话内已排程 / 侧边栏全库任务面板

③ 到点后以正常用户气泡出现在会话中

🧠 工作原理

- 宿主半（src/index.js）：调度器持久化任务队列；到点经 runMaintenance + followup 把消息（source.kind: "user"，与官方发送路径一致）注入目标会话的 agent——这正是消息能以正常用户气泡渲染、且无需浏览器在线的原因
- 客户端半（lib/client.js）：⏰ 按钮与任务列表挂 conversation.input.right / conversation.input.dock 槽位；侧边栏面板挂 sidebar.footer.action（与 usage-stats 同型）；会话跳转用 sessions.open(sessionId)；经只读状态路由 GET /plugin-data/dsh-scheduled-send/state 轮询宿主状态
- 边界诚实声明：dsh 宿主进程停止期间任务不会发送，重启后自动补发

🔒 隐私

- 无遥测：不发起任何统计、上报或第三方网络请求
- 数据本地：任务仅持久化在本机 /tasks.json，不上传任何内容；状态路由响应不携带任何凭据

⚠️ 已知限制

- 不支持重复规则（每日/每周）——单个任务一次性触发
- 不支持指定模型发送（曾实现，因切换可靠性问题移除；计划以更可靠的宿主 API 重做）；旧任务的 model 字段被忽略，照常投递
- 到点投递要求创建时的会话在 DSH 宿主中存在；不活跃则保留任务，恢复即补发

🛠️ 开发

npm install
npm test            # 63 项测试全绿（node --test，红绿 TDD 全程）
npm run build       # 重建客户端 bundle（改 src/client-*.js 后必须执行）

纯 JS、零运行时依赖（DSH 能力全部内联实现，无需 peerDependencies）。结构：src/scheduler.js（持久化队列/补发/退避）、src/delivery.js（kind:'user' 气泡注入）、src/host-routes.js（state/schedule 路由）、src/client-core.js（纯逻辑）、src/client-view.js（⏰ 按钮 + dock + 侧边栏面板）、lib/client.js（构建产物）。

已收录 awesome-dsh-plugin 列表（workflow 分类）。功能建议 / 缺陷欢迎到 Issues。

⭐ Star History

MIT License · Built for the DeepSeek Harness ecosystem