mirror of
https://github.com/hansjone/dsh-ops-cron.git
synced 2026-10-08 22:00:46 +08:00
Document one-command GitHub install for web and desktop.
README is bilingual and lists github:Whale-Zhang/dsh-cron-tasks as the install spec.
This commit is contained in:
Whale-Zhang
parent
b0d0db1553
commit
feed587f5e
1 changed files with 100 additions and 16 deletions
116
README.md
116
README.md
|
|
@ -1,32 +1,116 @@
|
|||
# dsh-cron-tasks
|
||||
|
||||
DeepSeek Harness 插件：**定时任务**。
|
||||
[English](#english) · [中文](#zhongwen)
|
||||
|
||||
- 左侧侧边栏 **「新会话」按钮正下方** 的 **「定时任务」** 入口：查看、创建、暂停/恢复、删除、立即运行
|
||||
- **设置 → 插件 → 插件配置** 里的调度策略（启用、默认时区、历史保留、重叠/漏跑）
|
||||
- 到点后 **新开 root Session** 跑自包含提示词；运行会话 **不出现在工作区列表**，只留在 **定时任务历史**
|
||||
A DeepSeek Harness (`dsh`) plugin for **scheduled tasks**. Sidebar entry under **New Session**, plugin settings, isolated run history, and model-facing `cron_*` tools.
|
||||
|
||||
产品契约见 [docs/PRD.md](docs/PRD.md)。本轮实现经验见 [docs/NOTES.md](docs/NOTES.md)。
|
||||
|
||||
|
||||
|
||||
## 行为
|
||||
<a id="zhongwen"></a>
|
||||
|
||||
- 日程：一次性 `at`（ISO 8601）或循环 5 字段 cron，IANA 时区
|
||||
- 重叠：同一任务已有 `queued`/`running` 则记 `skipped`，不开第二场
|
||||
- 漏跑：Host 宕机期间错过的节拍 **不补跑**（不是 OS daemon）
|
||||
- 提示词按不可信内容包裹，消息来源是 `plugin`，不伪装成人手输入
|
||||
## 中文
|
||||
|
||||
## 安装
|
||||
到点后 **新开一条会话** 跑事先写好的提示词，记进侧栏「定时任务」历史。这类会话不会淹没日常工作区列表。
|
||||
|
||||
这不是官方同会话 reminder（`@deepseek-ai/dsh-schedule`），也不是系统 `crontab`。调度器住在 DSH Host 里：Host 没在跑就不会触发。
|
||||
|
||||
### 安装
|
||||
|
||||
需要已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。一条命令装进网页端和桌面端：
|
||||
|
||||
```sh
|
||||
# 拷到运行时目录后再 file: 安装（不要用 link:）
|
||||
dsh plugin --profile web add file:$HOME/.dsh/plugins/dsh-cron-tasks
|
||||
dsh plugin --profile desktop add file:$HOME/.dsh/plugins/dsh-cron-tasks
|
||||
dsh plugin --profile web add github:Whale-Zhang/dsh-cron-tasks
|
||||
dsh plugin --profile desktop add github:Whale-Zhang/dsh-cron-tasks
|
||||
```
|
||||
|
||||
改 bundle 后 **重启** 对应 profile。`dsh --profile web --dump-config` 应能看到 `id: 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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue