定时任务监控 csiroqa/dsh-schedule

dsh-schedule

CI

DeepSeek Harness（DSH）的定时任务 + 状态监控插件：按 cron 时间表自动触发 Agent 执行任务（每日摘要、定时巡检、自动报告），并通过 /status 命令与设置页仪表盘查看系统与 harness 综合状态。

English: README.en.md

功能

定时任务
- cron 时间表（5 字段：分 时 日 月 周，如 0 9 * * = 每天 9 点）：ticker 定期检查，命中即触发，分钟精度，同任务不并发
- 自动执行：到点创建一次性 Agent（工作目录归入对应 workspace，模型跟随设置页选择或由 config 指定），执行任务内容，会话日志落盘（侧栏可查），结果登记回任务记录
- 任务管理：/schedule list / add / remove / pause / resume / run，设置页「定时任务」页签同功能
- 超时保护：单次运行超时（默认 30 分钟）自动强制停止，避免任务卡死
- 持久化：任务记录存于 $DSH_HOME/schedule.json（原子写入，启动安全）

状态监控

- /status：进程运行时长 / CPU / 内存 / 磁盘 / 活跃会话 / Agent / 插件 / 模型
- 设置页「状态」页签：实时仪表盘（每 5 秒刷新，可暂停），CPU/内存/磁盘占用条

配置

插件行（cordis.patch.yml 的 schedule insert 行）支持以下可选 config：

| 键 | 默认 | 说明 |
| defaultCwd | DSH 进程启动目录 | 任务默认工作目录 |
| defaultProvider / defaultModel | 设置页的模型选择 | 任务默认模型服务商与模型 |
| tickSeconds | 30 | 定时检查任务的时间间隔（秒） |
| maxRunMs | 1800000（30 分钟） | 单次任务运行超时（毫秒）；0 = 不限时 |

安装

前置：Node.js >= 22、pnpm、本机 deepseek-harness 源码检出（依赖以 link: 指向 ../deepseek-harness）。

git clone https://github.com/csiroqa/dsh-schedule.git
cd dsh-schedule
pnpm install
pnpm build

安装进 web profile（link: 指向本目录）
dsh plugin --profile web add link:$(pwd) # POSIX
dsh plugin --profile web add link:E:\path\to\dsh-schedule # Windows

重启 dsh web，浏览器 Ctrl+F5 硬刷新。

使用

1. 侧栏输入 /schedule list 查看任务；/schedule add 0 9 * * 每天 9 点总结昨天的进展 添加任务
2. 设置 > 插件 > 定时任务：可视化添加 / 立即运行 / 暂停 / 恢复 / 删除
3. 设置 > 插件 > 状态：系统与 harness 实时仪表盘
4. /status：会话内查看综合状态

兼容性

- 平台：Windows / macOS / Linux（Node >= 22）—— 三平台构建与冒烟测试经 GitHub Actions CI 验证
- 磁盘统计：三平台经 node:fs statfs（Windows 走系统磁盘空间 API）；平台不支持时优雅降级（显示"不支持"）
- 针对 DSH 0.1.1-rc.2 源码检出开发验证，并在 @deepseek-ai/dsh@0.1.1-rc.2（npm 全局/npx 安装）环境实测可用
- 客户端仅依赖平台模块表（react 等），不随 DSH SDK 版本漂移
- 构建产物：tsdown（host 半区 lib/index.js + browser 半区 lib/client.js，标准 window.__ModuleLoader__.load 闭包工厂格式）

安全说明

- 定时任务会在设定时间无人值守自动执行（使用 DSH 当前账号权限，可读写你的文件、执行命令），请只添加你信任的任务内容
- /dsh-schedule/* 接口仅监听本机（DSH 默认回环绑定），请勿把 DSH 端口暴露到公网

许可与使用声明

MIT License（见 LICENSE）。

欢迎任何人使用、修改、引用、或把本项目收录进自己的插件合集，只需：

- 保留 LICENSE 文件与版权声明
- 标明出处（本仓库链接）

相关

- DeepSeek Harness
- 同系列插件：dsh-archive-viewer（归档增强：自动归档 / 文件夹 / 经验库 / 收藏便签）
- 插件形态参考 dsh-web-ui（dsh.bundle.patch + dsh.client 声明 + 槽位注册 + tsdown 双半区构建）