前言¶
在使用 DeepSeek Harness(DSH)做日常智能体开发时,常见需求不只是手动发起一次会话:你可能希望每天固定时间生成进展摘要,或在设定时间执行巡检、生成报告,同时需要查看当前 DSH 进程的系统与 harness 状态。
csiroqa/dsh-schedule 是一个 DSH 插件,把这两件事合在一起:按 cron 时间表自动触发 Agent 执行任务,并通过 /status 命令与设置页仪表盘查看状态。
这是什么¶
csiroqa/dsh-schedule 是 DeepSeek Harness(DSH)的定时任务 + 状态监控插件,由 csiroqa 维护,许可证为 MIT。
它主要解决两类问题:
- 按 cron 时间表自动触发 Agent 执行任务,例如每日摘要、定时巡检、自动报告。
- 通过
/status命令和设置页仪表盘查看系统与 harness 的综合状态。
核心能力¶
定时任务¶
插件支持按 5 字段 cron 时间表触发任务,字段顺序为:
分 时 日 月 周
例如:
0 9 * * *
表示每天 9 点。触发为分钟精度,同一任务不会并发运行。
到点执行时,插件会:
- 创建一次性 Agent;
- 工作目录归入对应 workspace;
- 模型跟随设置页选择,或由 config 指定;
- 执行任务内容;
- 会话日志落盘;
- 将执行结果登记回任务记录。
任务记录持久化到:
$DSH_HOME/schedule.json
该文件采用原子写入,启动时更安全。
任务管理支持以下命令:
/schedule list
/schedule add
/schedule remove
/schedule pause
/schedule resume
/schedule run
设置页中的「定时任务」页签也提供同功能操作。
单次运行有超时保护,默认 30 分钟后自动强制停止,避免任务卡死。
状态监控¶
插件提供 /status 命令,可查看:
- 进程运行时长;
- CPU;
- 内存;
- 磁盘;
- 活跃会话;
- Agent;
- 插件;
- 模型。
设置页「状态」页签提供实时仪表盘,每 5 秒刷新,也可暂停刷新,并展示 CPU、内存、磁盘占用条。
安装与启用¶
前置要求¶
安装前需要满足以下条件:
- Node.js >= 22;
- pnpm;
- 本机
deepseek-harness源码检出; - 插件依赖以
link:指向../deepseek-harness。
支持平台:Windows / macOS / Linux(Node >= 22)。
安装命令¶
先克隆并构建插件:
git clone https://github.com/csiroqa/dsh-schedule.git
cd dsh-schedule
pnpm install
pnpm build
构建完成后,把当前目录安装进 web profile:
# POSIX
dsh plugin --profile web add link:$(pwd)
# Windows
dsh plugin --profile web add link:E:\path\to\dsh-schedule
安装完成后重启:
dsh web
然后在浏览器中执行硬刷新:
Ctrl+F5
典型用法¶
下面是几个常见入口。
在侧栏管理任务¶
查看任务:
/schedule list
添加一个每天 9 点执行的任务:
/schedule add 0 9 * * * 每天 9 点总结昨天的进展
在设置页管理任务¶
进入:
设置 > 插件 > 定时任务
可以进行:
- 可视化添加任务;
- 立即运行;
- 暂停;
- 恢复;
- 删除。
查看状态¶
会话内查看综合状态:
/status
在设置页查看实时仪表盘:
设置 > 插件 > 状态
适用场景与注意¶
适合以下场景:
- 需要每天自动总结进展;
- 需要定时执行巡检或检查;
- 需要自动生成报告;
- 需要在一个地方查看 DSH 的 CPU、内存、磁盘、会话、Agent、插件和模型状态。
使用前需要注意:
- 定时任务会在设定时间无人值守自动执行;
- 任务使用 DSH 当前账号权限,可读写文件、执行命令;
- 请只添加你信任的任务内容;
/dsh-schedule/*接口仅监听本机(DSH 默认回环绑定),不要把 DSH 端口暴露到公网;- 插件为 MIT License,使用、修改、引用或收录时应保留
LICENSE文件与版权声明,并标明出处(本仓库链接); - 针对 DSH
0.1.1-rc.2源码检出开发验证,并在@deepseek-ai/dsh@0.1.1-rc.2环境实测可用; - 安装前建议检查源码、许可证与依赖指向是否符合你的环境要求。
链接¶
仓库地址:
https://github.com/csiroqa/dsh-schedule
插件线索给出的目录页(以实际站点为准):
https://www.skillhub.cn/plugins/csiroqa/dsh-schedule