工作流与自动化

dsh-routines

Jesse-njx/dsh-routines · ★ 0

Jesse-njx精选

定时 Agent:按 cron 计划运行 prompt,把摘要送到你已有的地方,内置重叠/漏跑/超时安全策略。

许可证
MIT
收录
2026-08-14
维护状态
active
安装方式
github
查看 manifest 检查详情
manifest 状态
已声明
manifest 路径
package.json#dsh
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:Jesse-njx/dsh-routines

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 旗舰示例 —— 夜间测试分诊
  2. 安装
  3. 调度宿主
  4. 例程文件
  5. CLI
  6. 安全默认值
  7. 投递
  8. 架构
  9. 开发
  10. 非目标
  11. License

DSH 的定时 Agent —— 按 cron 跑一个 prompt,把摘要送到你已经在的地方。

dsh-routines 是 DeepSeek Harness 的插件 bundle。routine(例程) 是一个「命名 prompt + 调度 + 投递」,以纯 YAML 文件存放 —— 可人工 diff、可 git 提交。调度器把每个到期例程通过 headless runner 作为独立的一次性会话启动(完整会话日志 = 免费审计,之后可用 dsh-replay 回放),然后投递摘要:最后一条 assistant 消息较短时直接用它,否则对会话日志做一次性摘要调用。

┌──────────────────────┐   每日 02:00   ┌──────────────────────────────┐
│  dsh --profile ops   │ ─────────────▶ │ dsh --profile headless        │
│  调度器 tick          │   独立会话,cwd  │  "跑测试套件,……"             │
│  读取 .dsh/routines  │   = 例程 cwd,   │  审批策略: never              │
│  /*.yaml             │   审批: never)   └──────────────┬───────────────┘
└──────────────────────┘                                │ 运行记录: 状态、
       │ 摘要 + 运行记录                                  │ 摘要、会话 id、
       ▼                                                │ 被拒绝的权限
  .dsh/routines/runs/<runId>.json  (+ .md)  ──►  file 投递(始终开启)
  ctx.chatnode(可选)              ──►  chatnode 投递(软依赖)

旗舰示例 —— 夜间测试分诊

凌晨 2 点跑测试套件、诊断最高优先级失败、在项目里留下摘要的例程;装了会话节点后,摘要还会发到微信,你回复即可批准后续操作(v0.2;v0.1 投递到文件,装了节点也可投递 chatnode)。

# ~/work/projectx/.dsh/routines/nightly-tests.yaml
name: nightly-tests
schedule: "0 2 * * *"        # 5 段 cron;也支持 "@daily"、"every 4h"
timezone: Asia/Shanghai       # 显式指定,不静默使用宿主机时区
prompt: |
  Run the test suite. If anything fails, diagnose the top failure
  and draft a fix on a branch. Summarize in <10 lines.
cwd: ~/work/projectx
profile: headless              # 本次运行使用的 DSH profile / 插件集
overlap: skip                  # skip | queue | cancel-previous
timeoutMin: 45
deliver:
  - type: file                 # 始终开启:摘要写入 .dsh/routines/runs/
  - type: chatnode             # 可选:任意已安装的会话节点(wechat…)
$ dsh --profile ops routines list
nightly-tests          active   0 2 * * *           tz=Asia/Shanghai next=2026-08-15T02:00:00.000Z

第二天早上,摘要已在等待:

$ dsh --profile ops routines logs nightly-tests --limit 3
[completed] 2026-08-14T18:00:01.000Z 41213 ms session=session-2f7d…
  tests: 3 failed of 412; top failure: flaky wait in auth.spec.ts — drafted fix on branch fix/auth-wait

安装

# 1. 创建承载调度器 + CLI 的 profile(安装本 bundle)。
#    发布到 npm 后用 npm 形式;也可以直接从本仓库安装:
dsh plugin --profile ops add @dsh-routines/bundle          # npm(发布后)
dsh plugin --profile ops add github:Jesse-njx/dsh-routines  # 或:直接从 GitHub

# 2. 保持进程存活,调度才会触发(守护模式;Ctrl-C 停止)。
dsh --profile ops

例程运行默认启动 headless profile(DSH 自带)——无需额外配置。需要其他插件集的例程设置 profile: <name>;该 profile 必须支持一次性运行(包含 headless bundle,或同样安装本 bundle —— 运行 overlay 无论如何都会禁用嵌套的调度器)。

调度宿主

调度器在安装了本 bundle 的 profile 内 tick,所以也可以把 bundle 加进你的 web profile,web 应用运行期间例程就会触发:

dsh plugin --profile web add @dsh-routines/bundle

保持进程存活即可触发调度;dsh --profile ops(无内参)即守护模式(CLI 保持安静,调度器掌管进程生命周期)。

例程文件

例程位于两个被监听的目录(改动热重载;非法文件会被报告,不会让 store 崩溃):

目录 作用域
<cwd>/.dsh/routines/*.yaml 项目例程(同名覆盖全局)
~/.dsh/routines/*.yaml 全局例程
字段 默认 含义
name —(必填) [a-z0-9][a-z0-9-]*,≤ 64 字符
schedule —(必填) 0 2 * * *、@daily、@hourly、@weekly、@monthly、@yearly、every 4h、every 30m
timezone UTC 调度计算的 IANA 时区(绝不使用宿主机时区)
prompt —(必填) headless 运行要执行的任务
cwd 操作者 cwd 运行的 working directory;摘要也落在其下
profile headless 运行启动的 DSH profile
overlap skip skip(绝不在同一仓库叠加两个 agent)、queue(当前结束后运行)、cancel-previous
timeoutMin 45 硬超时;卡死的凌晨 2 点 agent 不能占用仓库到早上 9 点
deliver [{type: file}] 摘要投递渠道

cron 字段支持 *、步进后缀(*/15)、区间(9-17)、列表(0,30)、?、月份/星期名称。当月内日期与星期同时受限时,任一天匹配即命中(Vixie cron 语义)。

调度器记账(暂停集合、上次运行锚点)存放在 <cwd>/.dsh/routines/state.json。

CLI

dsh --profile ops routines <command>

命令 说明
list 例程列表:调度、暂停状态、下次运行
run <name> 手动触发(立即运行;打印摘要后退出)
pause <name> / resume <name> 停止 / 恢复定时运行
logs <name> [--limit n] 最近运行记录:状态、耗时、摘要、会话 id

运行记录是 <routine.cwd>/.dsh/routines/runs/<runId>.json,旁边还有人类可读的 <runId>.md 摘要。run 也是在信任调度前测试例程的手动触发方式。

安全默认值

定时 agent 无人值守运行,因此每个运行子进程都会被 patch 为:

  • 一切需要提示的都自动拒绝 —— 运行 overlay 把审批策略强制为 never(sandbox 模式保持 profile 继承值,通常为 workspace-write)。被拒绝的请求会被收集进运行记录(denied)并体现在摘要里。
  • 绝不调度嵌套运行 —— 运行 overlay 会在运行 profile 内禁用调度器行。
  • 绝不让调度器崩溃 —— 投递失败、摘要失败、spawn 失败都记录在运行记录上,不抛出。

错过的运行(笔记本休眠):唤醒后最多补跑一次,绝不重放积压。

投递

  • file(始终开启):<routine.cwd>/.dsh/routines/runs/ 下的运行记录 + 摘要 markdown。
  • chatnode(可选):装了 ctx.chatnode 服务({ send(input: { text, title? }): Promise<void> })时把摘要发过去;没有则记录为 not-installed,运行照常完成。未来的 @dsh-cowork/chatnode-wechat 暴露该服务后会自动点亮。

架构

一个 bundle,三个插件(+ 一个运行驱动),均可作为子路径安装:

模块 职责
@dsh-routines/bundle/store 监听 .dsh/routines/*.yaml(项目 + 全局)、校验、热重载、管理持久化状态
@dsh-routines/bundle/scheduler 在 ctx.jobs 上注册到期例程(kind routine);负责 overlap、错过运行、超时语义
@dsh-routines/bundle/cli dsh routines ... 命令行
@dsh-routines/bundle/run 子进程侧驱动,通过生成的 --patch overlay 注入每次一次性运行;写运行记录与摘要

运行启动 dsh --profile <routine.profile> --patch <生成的 overlay> -- "<prompt>",工作目录为例程 cwd。overlay 禁用内置 headless runner、在同一 task 服务上挂载 run 驱动、并强制无人值守审批策略 —— 既保留完整的 headless 体验(全新持久化会话、provider 选择),又写出只有 dsh-routines 知道怎么读的审计记录。

开发

pnpm install
pnpm build      # tsc -> lib/
pnpm test       # node --test(46 个测试:cron、调度矩阵、store、run、cli、e2e)

e2e 测试会在临时 DSH_HOME 里用脚本化 mock LLM adapter(离线、无需凭证)启动真实的 dsh 子进程,完整走通 store → 调度器 → jobs → 子进程 → 运行驱动 → 摘要 → 记录。

非目标

云端执行(仅本机;错过运行策略如实处理休眠笔记本)、例程市场、亚分钟级调度。

License

MIT