dsh-cron-tasks

English · 中文

A DeepSeek Harness (dsh) plugin for scheduled tasks. Sidebar entry under New Session, plugin settings, isolated run history, and model-facing cron_* tools.

中文

到点后 新开一条会话 跑事先写好的提示词，记进侧栏「定时任务」历史。这类会话不会淹没日常工作区列表。

这不是官方同会话 reminder（@deepseek-ai/dsh-schedule），也不是系统 crontab。调度器住在 DSH Host 里：Host 没在跑就不会触发。

安装

需要已安装 DeepSeek Harness。一条命令装进网页端和桌面端：

dsh plugin --profile web add github:Whale-Zhang/dsh-cron-tasks
dsh plugin --profile desktop add github:Whale-Zhang/dsh-cron-tasks

装完后重启对应 profile（dsh web 或 Desktop）。用下面命令应能看到 dsh-cron-tasks：

dsh --profile web --dump-config

卸载

dsh plugin --profile web remove @dsh-external/dsh-cron-tasks
dsh plugin --profile desktop remove @dsh-external/dsh-cron-tasks

做什么

• 左侧 「新会话」正下方 的 「定时任务」 入口：创建、暂停/恢复、删除、立即运行、搜索
• 设置 → 插件 → 插件配置 里的调度策略（启用、默认时区、历史保留、重叠/漏跑）
• 每次触发新开 root Session；点历史记录打开原生对话，可以继续聊
• 每个任务可指定 模型（钉死后不跟着聊天模型变，额度可预期）
• 工作目录可下拉已有工作区，或自定义路径
• 也可在对话里对 AI 说「帮我建一个定时任务」（skill scheduled-tasks + cron_create）

日程

• 一次性 at，或循环 5 字段 cron，IANA 时区（默认 Asia/Shanghai）
• 「一分钟后」用 after_minutes，不要叠 at / hour / expr
• 重叠：同一任务已有进行中的运行则跳过
• 漏跑：Host 宕机期间错过的节拍 不补跑

开发

node --test test/*.test.js

本地 file: 安装（开发用，不要用 link:）：

dsh plugin --profile web add file:$HOME/.dsh/plugins/dsh-cron-tasks

产品契约见 docs/PRD.md。实现经验见 docs/NOTES.md。

---

English

At the scheduled time, Harness opens a fresh root session, runs a self-contained prompt, and records the run in the Scheduled tasks sidebar. Those sessions stay out of the ordinary workspace list.

This is not the official same-chat reminder (@deepseek-ai/dsh-schedule) and not OS crontab. The scheduler lives in the DSH Host process; nothing fires while Host is down.

Install

Requires DeepSeek Harness.

dsh plugin --profile web add github:Whale-Zhang/dsh-cron-tasks
dsh plugin --profile desktop add github:Whale-Zhang/dsh-cron-tasks

Restart the profile after installing. dsh --profile web --dump-config should list dsh-cron-tasks.

Uninstall

dsh plugin --profile web remove @dsh-external/dsh-cron-tasks
dsh plugin --profile desktop remove @dsh-external/dsh-cron-tasks

What it does

• Sidebar entry under New Session: create, pause/resume, delete, run now, search
• Scheduler policy in Settings → Plugins → Plugin configuration
• Each fire is a new root session; open a history row to continue in the native chat
• Each job can pin a model so quota does not follow the chat selector
• Working directory: existing workspace or a custom path
• Ask the agent to create a job (scheduled-tasks skill + cron_create)

Schedule

• One-shot at or 5-field cron, IANA time zone (default Asia/Shanghai)
• “In N minutes” → after_minutes
• Overlap: skip if the same job is already running
• Misfire: missed beats while Host was down are not replayed

License

MIT