定时任务调度GooDAnDReaDY/dsh-cron

📦 @goodandready/dsh-cron

面向 DeepSeek Harness 的定时 Cron 调度、后台自动化与智能体任务执行引擎

🇬🇧 English •
🇷🇺 Русский •
🇨🇳 中文说明

⭐ 如果您喜欢这个插件，请在 GitHub 上为它点亮 Star — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。

🐛 如果您发现 Bug 或希望增加功能，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。

⚡ 概述与问题

自主 AI 智能体经常需要执行周期性任务：生成每日晨报、整理缺陷跟踪、检查 API 健康状态、同步数据库或定期执行 Git 清理。如果 Harness 内没有专用调度器，用户只能依赖外部 crontab 封装、复杂的 webhook 方案或手动干预。

@goodandready/dsh-cron 是 DeepSeek Harness 的原生全栈调度与后台自动化插件。它将标准 cron 表达式、自然语言间隔语法与自主智能体执行连接起来：

1. 完善的可视化任务管理器 —— 侧边栏按钮带可折叠的活跃任务列表（下次运行时间或实时状态，行数有上限且状态可记忆），以及功能齐全的面板：按类型、模型、渠道筛选，暂停、立即运行、复制、导出/导入与创建任务。
2. 交互式“由 DSH 创建”流程 —— 与智能体对话，把高层需求转化为规范的定时任务。
3. 自主工具调用 —— 原生 cron_ 工具让智能体在会话中自行安排后续执行。
4. 健壮的调度器与原子存储 —— 基于 croner：间隔别名、一次性延时任务、原子写入、运行历史与成本追踪。
5. 六种执行运行时 —— shell、Node.js、Python、HTTP/webhook、远程 SSH 与 Docker，并支持按任务的环境变量、工作区绑定以及面向代码修改任务的隔离 git worktree。
6. 多渠道路由与模板 —— 一次运行可投递到 Telegram、dsh-kanban、Discord、Slack、ntfy、Bark、PushPlus、语音（dsh-tts）与 Gitea，支持 {变量} 消息模板与按 DSH 凭据名称引用的密钥。

🏗️ 架构

graph TD
subgraph Client ["Web 客户端 (DSH UI)"]
SidebarBtn["侧边栏时钟按钮(DSH 客户端插槽)"]
Overlay["任务管理面板(标签: 全部 / 活跃 / 暂停 / 已完成)"]
CreateWithDSH["“由 DSH 创建”对话框(自然语言任务)"]
ManualForm["手动任务表单(运行时、cron、超时、重叠策略、渠道)"]
SettingsCard["设置卡片(渠道、模板、凭据)"]
end

subgraph Server ["服务端 (Cordis 与 DSH 服务)"]
HttpRoutes["HTTP REST API(/dsh-cron/)"]
AgentTools["工具调用网关(cron_create_task, cron_list_tasks, ...)"]
Scheduler["TaskScheduler 引擎(Croner 实例 + one-shot 定时器)"]
Store["原子 TaskStore(tasks.json 原子写入)"]
AgentRunner["智能体会话调度器(以指定模型执行提示词)"]
Runtimes["执行运行时(shell、node、python、http、ssh、docker)"]
Notify["投递路由(模板 + 9 个渠道)"]
Secrets["凭据引用(DSH credentials / ENV)"]
end

SidebarBtn --> Overlay
Overlay --> CreateWithDSH
Overlay --> ManualForm
SettingsCard --> HttpRoutes
CreateWithDSH -->|POST /chat/start| HttpRoutes
ManualForm -->|POST /tasks| HttpRoutes
HttpRoutes --> Scheduler
AgentTools --> Scheduler
Scheduler --> Store
Scheduler -->|按间隔/一次性触发| AgentRunner
Scheduler --> Notify

✨ 功能与能力

1. 可视化任务管理器
点击 DSH 侧边栏中的时钟图标（位于“新会话”按钮旁）打开管理面板：
* 状态过滤标签：全部、活跃、已暂停、已完成。
* 即时操作：立即运行（Run Now）、暂停/恢复调度、带确认的删除。
* 一键预设模板：每日摘要、每周回顾、待办监控。
* 运行历史：打开任务卡片查看历史运行 —— 时间、耗时、状态（成功 / 失败 / 超时 / 跳过 / 错过）、输出与错误。
* 汇总统计栏：活跃任务数、总运行次数、总 token 消耗与估算美元成本。

2. “由 DSH 创建”对话框
无需猜测 cron 语法，用自然语言即可创建任务：
1. 点击 Create ⌄ ➔ Create with DSH。
2. 描述要自动化的内容（例如：“每个工作日早上 9 点检查未处理的 PR 并起草评论”）。
3. 插件会创建一个注入了调度器指令的专属智能体会话。智能体会与你确认细节 —— LLM 还是 NO-LLM shell 任务、准确的 cron 表达式、在你的 DSH 安装中可用的经济型模型，以及是否启用“静默规则”（仅在新事件或故障时告警）—— 并在你确认后才通过 cron_create_task 工具注册任务。

3. 智能体工具（Tool Calling）

| 工具 | 说明 |
|:---|:---|
| cron_create_task | 创建任务：title、schedule、prompt、fallbackModel（失败时改用更强模型重试一次），可选 type（llm/script/node/python/http/ssh/docker/skill/workflow）、delivery、provider、model、channels、template、notifyTelegram、onlyOnFailure、timeoutSeconds、overlapPolicy、kanbanMode |
| cron_schedule_task | cron_create_task 的别名，保持与既有提示词兼容 |
| cron_list_tasks | 列出任务的状态、下次运行时间、token 总量与成本估算 |
| cron_pause_task | 暂停调度而不删除配置 |
| cron_resume_task | 恢复已暂停的调度 |
| cron_delete_task | 永久删除任务及其历史 |
| cron_run_task | 触发一次立即的带外运行 |
| cron_get_task | 读取单个任务的完整配置，包括列表中看不到的字段 |
| cron_update_task | 就地修改现有任务（白名单字段，校验与 HTTP 路由一致）；提示模型先与用户确认会执行代码的改动 |

会话中模型可进行的调用示例：

cron_create_task({
"title": "Morning digest",
"schedule": "0 8 * * 1-5",
"prompt": "Prepare a brief morning digest of active tasks and open tickets.",
"type": "llm",
"delivery": "isolated"
})

4. 调度表达式语法
基于 croner，支持标准 5 段 cron 表达式与友好的别名：

* 0 9 * * 1-5 —— 工作日 09:00
* /15  * *  —— 每 15 分钟
0 0 * * 0 —— 每周日午夜
* every 10m / every 2h / every 30s —— 自然语言间隔
* daily / hourly / weekdays 快捷方式，以及标准 @hourly / @daily / @weekly / @monthly / @yearly 与 @every 30m
* 任务级时区 —— 可为任务设置 IANA 时区（如 Europe/Berlin）；未设置时按服务器本地时间调度
* 一次性任务：at: 2026-09-05T15:00:00Z（精确 ISO 时间戳）或相对延时 in 20m / in 2h（也接受 через 15 минут 之类的俄语输入）。一次性任务在单次运行后自动转为 completed，显示在 已完成 标签下。

5. 执行可靠性
* 自动重试 —— 按任务设置 maxRetries 与基础 retryBackoffMs：失败（error/timeout）的运行按指数退避自动重试，成功后计数归零。
* Misfire 策略 —— 选择守护进程离线期间错过的运行如何处理：skip（默认 —— 记录缺口）、runOnce（迟执行一次）或 catchUpAll（迟执行并记录缺口）。skip 下错过的一次性任务直接转为 completed，不再过期触发。
* 并发上限 —— 插件设置 maxConcurrent 限制并行运行数；超出的运行记录为 skipped 并附原因。
* 实时执行指示 —— 任务列表中的脉冲状态图标与运行计时器。

6. 执行运行时
每个任务可选择自己的运行时；非 LLM 运行时不需要模型，也不消耗 token：

* Shell（script）—— 通过 Harness shell 执行命令或脚本，支持 env 与 cwd。
* Node.js（node）与 Python（python）—— 指定解释器（nodePath、pythonPath）运行片段；Python 会自动识别项目虚拟环境。
* HTTP（http）—— 以自定义请求头与请求体访问 URL，状态码与响应写入运行历史。
* SSH（ssh）—— 通过 dsh-remote-workspace 配置（sshProfileId）或独立 host/key 字段在远程主机执行命令。
* Docker（docker）—— 在镜像容器（dockerImage）中执行命令。
* 环境变量 —— 按任务的 env 映射（界面中每行 KEY VALUE）应用于外部运行时；请勿在此存放密钥。
* 工作区与 worktree —— 将任务绑定到 Harness 工作区（workspaceId）；对会修改代码的智能体任务，可在隔离的 git worktree 中运行（worktree、keepWorktree）。

7. 成本控制：回退模型
任务可以默认使用便宜模型，失败时改用更强模型完成：设置 fallbackModel（可选 fallbackProvider），失败（error 或 timeout）的运行会在该模型上重试一次，之后才进入常规重试退避。历史记录会标明最终产出结果的模型以及是否使用了回退，两次尝试的用量与成本都会累计，模板变量 {model} 渲染完成运行的模型。回退仅适用于智能体类型（llm、skill、workflow）。

8. 会话集成与权限
* 按任务的权限预设 —— default、read-only、workspace-write 或 full 在提示词执行前应用于任务会话。
* 会话自动归档 —— 隔离的 cron 会话在运行后自动归档（尽力而为），不干扰聊天列表。
* 历史 → 会话 —— 每次 LLM 运行都会记录会话，可直接从历史记录打开对话。

9. 按规则保持安静
有输出的任务可以设置用自然语言描述的静默规则（例如“当没有分区使用率超过 80% 时保持安静”）。运行成功时，由便宜模型对照该规则判断输出，若结论为保持安静则跳过报告，并在运行历史中记录原因。遵循 fail-open：没有规则、没有模型、调用失败或答案无法解析时都会照常投递报告。插件设置 silentRuleModel 指定用于判断的模型。

10. 失败诊断
智能体任务可以请求诊断：设置 inspectOnFailure 后，失败（error 或 timeout）的运行会连同任务提示词与截断输出一起交给模型，运行历史中会保存简短诊断与具体的提示词修改建议。历史记录提供按钮把该建议载入编辑表单 —— 不会自动应用。模型由 inspectorModel 指定，消息模板中可使用 {diagnosis}。模型不可用或调用失败时，失败的运行保持原样。

11. 通知渠道与消息模板
运行完成后，报告会发送到该任务配置的所有渠道 —— Telegram、dsh-kanban、Discord、Slack、ntfy、Bark、PushPlus、语音（dsh-tts）以及 Gitea issue：

* 任务迁移 —— 将全部配置导出为版本化 JSON，并在别处导入（含预览摘要）；导入的任务处于暂停状态。
* 按任务选择渠道 —— 在任务表单中勾选渠道；显式选择会覆盖旧版 notifyTelegram/kanbanMode 开关，留空则回退到它们。
* 故障隔离 —— 某个渠道不可用会记录在调度器日志中，其余渠道仍会收到报告；失效的 webhook 不会吞掉整份报告。
* 消息模板 —— 支持全局模板、按渠道覆盖或按任务模板，变量为 {title} {id} {status} {output} {error} {duration} {schedule} {time} {tokens} {cost}。未知占位符保持原样，失败运行默认使用失败模板。
* onlyOnFailure —— 全局或按任务生效：成功运行静默，仅发送 error/timeout。
* 凭据按名称引用 —— webhook token 与 Telegram bot token 填写 DSH 凭据的名称（botTokenRef、ntfyTokenRef、pushplusTokenRef、giteaTokenRef），发送时通过 DSH credentials 服务解析，并可回退到环境变量，且绝不会经过插件设置。webhook URL 与 Bark 设备键本身内嵌密钥，因此保存在插件设置文件中，但返回浏览器时始终为掩码，界面回传的掩码值也不会覆盖已保存的值。
* 投递超时 —— 每个渠道请求都有上限（deliveryTimeoutMs，默认 15000 毫秒，可在设置面板或 settings.yaml 中调整），且各渠道并发发送：无响应的端点只记录为失败，不会拖慢其他渠道或下一次调度。限制作用于整个渠道处理过程，也覆盖凭据解析——它不支持 abort 信号。
* Telegram —— 带状态徽标（✅ / ❌）、耗时、调度描述与等宽输出块的 Markdown 报告；动态值会被转义。凭据可直接填写，或从 DSH settings.yaml 的 dsh-messenger-gateway 段继承（尽力而为）。
* Discord / Slack —— 通过 webhook 投递：Discord 使用按运行状态着色的 embed，Slack 使用纯文本正文。
* ntfy / Bark / PushPlus —— 移动推送，支持主题/设备键与可选 bearer token；Bark 的标题与正文放在请求路径中，PushPlus 端点可指向自建代理。
* 语音 —— dsh-tts 通过其 HTTP 路由朗读报告（ttsBaseUrl，默认 http://127.0.0.1:3080）。
* Gitea —— 创建包含运行报告的 issue（giteaBaseUrl、giteaRepo、token 凭据）；失败运行标记为 cron、bug、alert。
* 测试发送按钮 —— 在安排关键任务前现场验证 Telegram 连通性。

12. Kanban 集成与成本统计
* 自动创建 Kanban 卡片 —— 当 kanbanMode 为 on_failure 或 always 时，插件在 dsh-kanban 中创建卡片（on_failure → error/timeout 时进入 Backlog；always → 完成后进入 Done/Backlog）。
* Token 与执行成本计量 —— 按运行与任务统计 token 消耗（输入、输出、缓存读取），基于内置价格表估算美元成本，并提供汇总分析栏。

13. 重叠策略与执行超时

* 执行超时（timeoutSeconds） —— 达到限制后，shell 子进程通过 abort 信号立即终止，智能体会话被释放以停止消耗 token。默认 1800（30 分钟）。
* 重叠策略（overlapPolicy） —— 上一次运行尚未结束时再次触发调度时的行为：
* skip（默认）：丢弃重叠的运行，在历史中记录 skipped；
* queue：将下一次运行排队，当前任务完成后自动开始；
* replace：通过 AbortController 中止当前运行并启动新的执行。

如果守护进程在计划时刻处于离线状态，启动时该次运行会被记录为 missed，历史空档始终可见。

14. 心跳监控（Dead man's switch）
* 在插件设置中配置 heartbeatUrl 与 heartbeatIntervalSec，调度器会按间隔 GET 该地址 —— 外部监控可在心跳停止时告警。
* 内置 GET /dsh-cron/heartbeat 端点返回存活状态、活跃任务数与最近运行时间，便于自建看门狗。

15. 来自配置的声明式任务（#50）
长期运行的任务可以直接声明在配置文件里，而无需在界面中手工重建。配置文件拥有这些任务：每次插件启动时会创建或更新它们，从文件中消失的任务会被删除。

在配置文件（cordis.patch.yml）的插件段加入 jobs 列表：

dsh-cron:
jobs:
- id: nightly-backup
title: Nightly backup
schedule: "0 3 * * "
type: script
prompt: "bash /path/to/backup.sh"
channels: ["telegram"]
timeoutSeconds: 3600
- id: morning-digest
title: Morning digest
schedule: "0 8  * 1-5"
type: llm
prompt: "Prepare a brief morning digest of active tasks."
provider: my-provider
model: provider-id/model-id

* 每条必填：id、title、schedule；以提示词承载有效载荷的类型（script、node、python、ssh、docker、llm、skill、workflow）还需非空 prompt。http 例外：目标由 httpUrl（或 prompt）给出。
* 其余任务字段按原样透传，校验与 API 一致：channels、model、provider、fallbackModel、silentRule、inspectOnFailure、timezone、timeoutSeconds、template、env、cwd，以及运行时字段（nodePath、pythonPath、httpUrl、httpMethod、httpHeaders、httpBody、sshProfileId、sshTarget、dockerImage、workspaceId、worktree、keepWorktree、skillName、workflowName）。
* 声明式任务标记为由配置管理；面板中显示来源标签而不是编辑/删除按钮。
* 对配置任务的编辑、暂停、恢复、切换与删除在面板和 API 上返回 409，携带配置任务现有 id 的创建或更新请求 POST /dsh-cron/tasks 同样被拒绝 —— 配置文件的来源为唯一真值。立即运行仍然可用。
* 通过 UI、API 或智能体工具创建的、id 相同的任务绝不会被覆盖：该条目会被跳过，冲突写入日志。
* 会执行代码的类型照常激活，但启动时插件会向日志写警告，使通过配置引入的代码路径可见。
* 条目逐条校验并带下标（config.jobs[i]: …）；一条坏条目会被跳过，不会阻止其余任务或整个配置。

16. 外部 REST API（/dsh-cron/api/，#54）
外部系统（CI、宿主机 cron、curl）无需打开面板即可驱动调度器。这是唯一由 bearer 令牌保护的接口；面板路由保持本地且防跨站。

令牌是插件设置 apiToken（与所有密钥一样掩码显示）。认证与错误：
未配置令牌 → 整个接口返回 503；
* 缺少或错误的 Authorization: Bearer  → 401，比较为常量时间。

| 方法 | 路径 | 说明 |
|:---|:---|:---|
| GET | /dsh-cron/api/tasks | 任务列表（status / query 过滤，同面板） |
| GET | /dsh-cron/api/tasks/:id | 读取单个任务 |
| POST | /dsh-cron/api/tasks | 创建任务；带 id 时更新现有任务 |
| DELETE | /dsh-cron/api/tasks/:id | 删除任务 |
| POST | /dsh-cron/api/tasks/:id/run | 强制执行一次 |

这些操作复用面板处理器，因此对会执行代码类型的 x-dsh-cron-confirm: script 门禁以及对配置任务的 409 拒绝与 UI 完全一致。

BASE="http://127.0.0.1:3080"
TOKEN=""

列表
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/dsh-cron/api/tasks"

创建；请求体带 id 时为更新
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"id":"cleanup","title":"Cleanup","schedule":"0 4 * * ","prompt":"Remove stale temporary files."}' \
"$BASE/dsh-cron/api/tasks"

强制执行
curl -s -X POST -H "Authorization: Bearer $TOKEN" "$BASE/dsh-cron/api/tasks/cleanup/run"

删除
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" "$BASE/dsh-cron/api/tasks/cleanup"

会执行代码的任务还需确认头
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "x-dsh-cron-confirm: script" \
-H "Content-Type: application/json" \
-d '{"title":"Disk check","schedule":"0  * * ","type":"script","prompt":"df -h"}' \
"$BASE/dsh-cron/api/tasks"

17. Prometheus 指标（#53）
GET /dsh-cron/metrics 返回 Prometheus 文本格式，无需新增依赖即可被抓取：

dsh_cron_tasks_total{status} —— 按状态统计的任务数（gauge）。
* dsh_cron_task_last_duration_seconds{task} —— 任务最近一次完成运行的耗时（秒，gauge）。
* dsh_cron_runs_total{status} —— 自插件进程启动以来完成的运行数（counter）；状态为 success、error、timeout、skipped、missed。
* dsh_cron_run_records —— 当前保存在内存中的运行记录数（gauge）。

导出内容只有计数、状态和耗时；提示词、运行输出与任务配置不会出现在其中。

scrape_configs:
- job_name: dsh-cron
static_configs:
- targets: ["127.0.0.1:3080"]
metrics_path: /dsh-cron/metrics

18. 严格的渠道校验（#121）
创建或更新任务时若包含未知的投递渠道 id，现在会返回 400 并列出违规项：

{ "ok": false, "error": "Unknown channel ids: email_ping", "unknownChannels": ["email_ping"] }

Changed in v0.2.7：此前未知 id 会被静默丢弃，客户端即使有拼写错误也会得到 ok: true，最终得到一个不投递任何地方的任务。

导入有意保持宽容（文件可能来自旧版本）：未知 id 会从导入的任务中丢弃，但会在响应（unknownChannels）中列出并写入调度器日志，而不是无声消失。

19. 安装后校验（#126）
deploy.sh 新增仅校验模式，用于检查已安装的配置而不安装任何东西：

bash deploy.sh verify [exact-version]

它确认配置报告了指定版本（默认取 package.json 的版本），登录 Web UI，然后下载客户端 bundle 并确认其中包含包名。

为什么需要它：Web 配置可能位于认证插件之后并对匿名请求返回 401，而插件客户端 bundle 只能通过认证后索引中打印的精确组合 ?? URL 获取 —— 裸的 /plugins//client.js 会返回 404。因此校验需要先建立已认证会话。

校验使用的环境变量：DSH_WEB_BASE（默认 http://127.0.0.1:3080）、DSH_WEB_TOKEN（令牌；未设置时脚本从单元日志读取最后一个）、DSH_WEB_UNIT（默认 dsh-web.service）。脚本中不含任何密钥。

20. 内部重构：调度解析与排程（#97）
面向开发者，行为不变。parseScheduleExpression 被拆分为保持相同分支顺序的小函数 —— parseAtExpression、parseRelativeOneShot、parseIntervalExpression、parseAliasExpression、parseCronExpression，scheduleTask 拆分为 clearScheduled、scheduleOneShot、scheduleCron。原有测试全部通过，并新增了针对分支优先级与错误的测试。

21. 性能与进程隔离增强包（v0.2.9，#134）
- 进程树终止隔离：Shell 和 Script 任务在独立进程组启动（POSIX 下 detached: true）；中止或超时向整组发送 -child.pid SIGTERM -> SIGKILL，杜绝孤儿进程与僵尸进程。
- 并发控制限流：默认安全阈值 maxConcurrent = 2，避免定时重叠引发 CPU 和内存峰值。
- 瞬态错误重试：针对网络抖动和模型速率限制（429、502、503、504、ECONNRESET）提供指数退避重试（最多3次）。
- 网络与前端优化：GET /dsh-cron/tasks 支持 ETag 与 304 Not Modified；前端页面根据 visibilityState 自适应轮询（前台 8s，后台 30s）。
- 历史记录轮换与归档：活动任务仅保留最新 100 次运行，超出部分自动归档至 tasks-history-archive.json。
- 自主 PR 审查配方 (#33)：Template Hub 预置配方与 prReviewerEnabled 设置项。

22. 自动化、任务链与可观测性包（v0.2.10，#137）
- Telegram 双向交互控制：任务通知附带内嵌操作按钮（🚀 立即运行、⏸️ 暂停/恢复、📋 最新日志）。由 POST /dsh-cron/telegram/webhook 处理，严格鉴权 Chat ID 并调用 answerCallbackQuery 反馈。
- 任务管道与级联触发：配置 onSuccess 与 onFailure 下游触发器。上游输出自动注入子任务环境变量 $DSH_PREV_OUTPUT，LLM 任务支持 {{prevOutput}} 插值。内置最大 5 级深度递归防护，杜绝死循环。
- 模型结构化动作指令：自主分析任务可输出 JSON 指令触发级联任务（trigger_task）、定向告警（notify）或创建 Issue。受 llmActionsEnabled: false 严格保护。
- 历史归档与延迟洞察：REST 接口 GET /dsh-cron/tasks/:id/archive（支持分页）与 GET /dsh-cron/tasks/:id/stats；UI 任务卡片展示耗时彩色徽章（-YYYY-MM-DD）。
- weekly：每周自动开启全新子会话（后缀 -YYYY-Www）。
- 日期变量插值：targetSessionId 中支持 {{date}} 占位符，自动注入当前日期 YYYY-MM-DD。
- 主界面原生可见交互：持久会话不会被标记为 ephemeral/internal，且在执行后跳过自动归档（sessions.archive()），用户可在 DSH 聊天列表中直接查看并继续手动对话。
- 预设工具链无缝适配：恢复会话时同样完整挂载 agentPresets，保障文件读写、代码编辑与终端工具持续可用。
- 致谢：功能灵感源自社区开发者 @RaulLazaro。

26. 系统稳定性、硬化与自愈维护包 (v0.2.14, #145)
- 重试预算自动重置：彻底修复重试耗尽后的计数残留问题。当任务耗尽配置的重试次数（maxRetries）后，attempts 计数器自动清零，确保后续周期的定时调度享有完整的重试预算。常规计划执行或手动触发也均保证以干净的重试预算启动。
- 清除队列僵尸任务：通过界面/API 暂停或删除任务时，调度器会立即将其从并发等待队列（this.queue）中剔除；并发槽位释放出队时，非激活或已删除的任务也会被自动安全跳过。
- 历史归档容量上限保护：针对长期运行和高频调度的生产环境，tasks-history-archive.json 针对每个任务安全限制保留最新的 1,000 条运行记录，消除无限制磁盘占用与同步 JSON 序列化卡顿。
- 灾难恢复与存储自动备份：TaskStore 在每次成功持久化时自动维护原子的 tasks.json.bak 备份副本。若发生进程异常导致数据损坏，存储引擎会自动保存现场切片 tasks.json.corrupted. 供故障分析，并无缝从备份中自愈恢复。
- 上下文超限自愈与平滑轮转：在常驻持久会话（targetSessionId）中，若智能体因模型上下文窗口溢出（context_length_exceeded）失败，运行器将精准捕获超限错误，归档已满会话，自动轮转至全新子会话并平滑重试，避免任务中断。
- Windows 进程树彻底终止：在 Windows 系统上，外部进程任务被取消或超时终止时，改为执行 taskkill /pid  /T /F，杜绝孤儿进程和后台残留外壳。

27. 弹窗视口高度自适应与包体积精简 (v0.2.15, #153, #148, #151, #152)
- 视口高度约束与粘性底部操作栏：所有弹窗（包括任务编辑、新建及推荐模板预设）现已严格受控于视口尺寸 max-height: min(90vh, calc(100vh - 36px))，并内置平滑纵向滚动条。弹窗操作栏（“取消”、“保存”、“创建”）采用 position: sticky 底部悬浮固定，确保无论表单项多长或屏幕分辨率高低，操作按钮始终清晰可见且可随时点击。
- 遮罩层滚动溢出保护：弹窗遮罩层增加了安全边距与 overflow-y: auto，防止小屏设备在 Flex 居中时发生头部或底部截断。
- npm 包体积深度精简：从 npm 分发清单中剔除了多余的重复文档副本，使 tarball 体积立减 32 kB 以上，解压后体积减少约 102 kB。
- Cordis 客户端注入依赖规范化：在 package.json 的 dsh.client.inject 中完整声明了 locale 和 slots 服务依赖。

31. 质量加固与 CI 预检标准包 (v0.2.19, #149, #152, #155, #156, #162)
- 彻底消除空 catch 块 (#156)：引入符合标准规范的 lib/best-effort.js 模块，全面支持同步/异步安全调用、回退返回值和可选日志记录，清除了 runner、scheduler、store 及客户端中的所有 63 处空 catch 块。
- CI 工作流与本地预检门禁 (#162)：新增自动化 CI 工作流（.gitea/workflows/ci.yml 与 .github/workflows/ci.yml），集成本地预检门禁脚本 scripts/ci-preflight.mjs，在出现语法错误、空 catch、颜色硬编码或信息泄露时自动阻断。
- 主题设计令牌现代化 (#149)：将模态对话框与设置卡片中遗留的 rgba(...) 全部重构为原生的 color-mix(in srgb, var(--token) N%, transparent)。
- 插件清单注入声明规范化 (#152)：在 package.json 的 dsh.client.inject 中统一声明完整的 Cordis 包名（@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-slots）。
- 生产管线导出连接 (#155)：将此前仅在测试中调用的导出（findDestructiveRecipe、shouldNotifyTask 和 TEMPLATE_VARIABLES）全面接入配方过滤、通知分发及模板生成核心逻辑。

30. 自更新模块英文与中文多语言支持 (v0.2.18, #160)
- 设置面板自更新多语言 (#160)：在 lib/client-src/10-locales.js 的英文 (en) 与中文 (zh) 字典中补全了全部 10 个自更新键值 (updater.title, updater.btnCheck, updater.checking, updater.btnUpdate, updater.updating, updater.desc, updater.current, updater.available, updater.upToDate, updater.success)。遵循 DSH 插件规范，插件核心内置英文与中文，俄语多语言由 dsh-russian-lang 统一扩展。

29. 客户端模块化解耦与原生主题标准化 (v0.2.17, #149, #150)
- 客户端模块化架构 (#150): 将庞大的单文件 lib/client.js (约 3950 行) 拆分为 lib/client-src/ 下的 14 个高内聚模块文件 (各模块严格  列出模型 |
| POST | /dsh-cron/chat/start | 启动带任务配置指令的“由 DSH 创建”智能体会话 |
| GET | /dsh-cron/settings | 客户端安全设置（令牌掩码显示） |
| POST | /dsh-cron/settings | 更新集成设置（通过设置服务应用） |
| GET | /dsh-cron/heartbeat | 存活探针：活跃任务数与最近运行时间 |
| POST | /dsh-cron/telegram/test | 发送 Telegram 测试消息 |
| POST | /dsh-cron/kanban/test | 创建 Kanban 连通性测试卡片 |
| * | /dsh-cron/action/:id/:action | 任务操作路由的兼容别名（run、toggle、delete、history） |
| GET | /dsh-cron/metrics | Prometheus 文本格式的任务与运行计数 —— 不含提示词与输出（#53） |
| GET / POST | /api/dsh-cron/update | 插件一键自更新：查询仓库最新版本并就地平滑升级 (#147) |
| GET / POST | /dsh-cron/api/tasks | 令牌保护的外部接口：列表 / 创建或更新（#54） |
| GET / DELETE | /dsh-cron/api/tasks/:id | 令牌保护的外部接口：读取 / 删除（#54） |
| POST | /dsh-cron/api/tasks/:id/run | 令牌保护的外部接口：强制执行（#54） |

🧪 测试与预检门禁 (Preflight)

运行全套自动化测试（调度表达式解析、调度器引擎、原子存储、HTTP 辅助函数、通知与工具契约）：

npm test

本地执行质量预检门禁（语法检查、零空 catch 块、主题设计规范、npm 发布归档合规性及防泄漏检查）：

node scripts/ci-preflight.mjs

📄 许可证

MIT © GooDAnDReaDY