mirror of
https://github.com/hansjone/dsh-ops-cron.git
synced 2026-10-09 03:03:18 +08:00
116 lines
4 KiB
Markdown
116 lines
4 KiB
Markdown
# dsh-cron-tasks
|
||
|
||
[English](#english) · [中文](#zhongwen)
|
||
|
||
A DeepSeek Harness (`dsh`) plugin for **scheduled tasks**. Sidebar entry under **New Session**, plugin settings, isolated run history, and model-facing `cron_*` tools.
|
||
|
||
|
||
|
||
|
||
<a id="zhongwen"></a>
|
||
|
||
## 中文
|
||
|
||
到点后 **新开一条会话** 跑事先写好的提示词，记进侧栏「定时任务」历史。这类会话不会淹没日常工作区列表。
|
||
|
||
这不是官方同会话 reminder（`@deepseek-ai/dsh-schedule`），也不是系统 `crontab`。调度器住在 DSH Host 里：Host 没在跑就不会触发。
|
||
|
||
### 安装
|
||
|
||
需要已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。一条命令装进网页端和桌面端：
|
||
|
||
```sh
|
||
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`：
|
||
|
||
```sh
|
||
dsh --profile web --dump-config
|
||
```
|
||
|
||
### 卸载
|
||
|
||
```sh
|
||
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 宕机期间错过的节拍 **不补跑**
|
||
|
||
### 开发
|
||
|
||
```sh
|
||
node --test test/*.test.js
|
||
```
|
||
|
||
本地 `file:` 安装（开发用，不要用 `link:`）：
|
||
|
||
```sh
|
||
dsh plugin --profile web add file:$HOME/.dsh/plugins/dsh-cron-tasks
|
||
```
|
||
|
||
产品契约见 [docs/PRD.md](docs/PRD.md)。实现经验见 [docs/NOTES.md](docs/NOTES.md)。
|
||
|
||
---
|
||
|
||
<a id="english"></a>
|
||
|
||
## 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](https://github.com/deepseek-ai/deepseek-harness).
|
||
|
||
```sh
|
||
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
|
||
|
||
```sh
|
||
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
|