dsh-scheduled-send · 定时发送

EN: Scheduled send for DeepSeek Harness (DSH) Web — draft a message in the composer, tap ⏰, and it fires into the bound conversation as a normal user bubble at the set time. Runs host-side: close the browser, it still sends. 中文说明如下。

在 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   # 本地路径安装

🖼️ 使用演示

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

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

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

🧠 工作原理

• 宿主半（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 宿主进程停止期间任务不会发送，重启后自动补发

🔒 隐私

• 无遥测：不发起任何统计、上报或第三方网络请求
• 数据本地：任务仅持久化在本机 <dataDir>/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