dsh-schedule:DSH 的定时任务与状态监控插件

前言

在使用 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜