返回目录

dsh-automation

编辑精选维护状态: 活跃

titanwings/dsh-automation

DSH 自动化插件:让 Coding 任务按计划在全新 Agent Session 中运行,并由用户或 Agent 创建和管理定时任务。 / Run coding tasks in fresh Agent sessions and manage schedules from DSH Web or an Agent.

前往 GitHub
$ dsh plugin --profile web add github:titanwings/dsh-automation#v0.1.7

100

星标

12

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-09-08

最近推送

通过官方 dsh CLI 安装的原生 DSH 插件:让一次性或周期性的编码任务在全新 root Agent Session 中运行,可从 DSH Web 或任意合格 root Agent 创建与管理自动化,带持久化运行历史、每个自动化独立的模型目标与显式的 `read-only` / `workspace-write` 权限边界。MIT 协议。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-27

许可证

MIT

01它能帮你完成什么?

  • 在 DeepSeek Harness 里让保存好的、自包含的编码任务按计划运行——一次性、固定间隔、每天或每周

    每次触发都会启动全新的 root Agent 与 Session(使用保存的提示词、捕获的工作区 / cwd / Agent 预设 / 权限预设、持久的模型目标),并产出带结果 Session ID、有界摘要与结构化错误的最终运行记录

    使用 DeepSeek Harness(dsh)的开发者,需要让重复性或一次性的编码工作脱离旧聊天在稍后运行

  • 检查每次无人值守运行执行了什么、用了哪个修订与模型目标、以及如何结束

    持久化的运行历史:queued / running / succeeded / failed / skipped / cancelled 状态、定义修订、提示词与目标快照、计划时间、结果 Session ID、摘要与结构化错误;可选归档终态运行 Session

    需要无人值守编码运行保持可检查、可审计的团队

02如何接入 DeepSeek Harness?

前置条件

  • 需要 DSH Web profile——GitHub bundle 安装进 DSH Web profile 后重启 `dsh web`
  • 任务启动时 DSH Host 必须处于运行状态
  • 本地 checkout 安装方式需要 Node.js 22.19 或更高版本

安装步骤

  1. 01

    运行 `dsh plugin --profile web add github:titanwings/dsh-automation#v0.1.7` 把 GitHub bundle 安装进 DSH Web profile(版本标签让安装可复现,reviewed commit SHA 同样有效)

    $ dsh plugin --profile web add github:titanwings/dsh-automation#v0.1.7

  2. 02

    重启 `dsh web`

    $ dsh web

  3. 03

    如果你从源码运行 DSH,用 `pnpm dsh` 代替 `dsh`;本地 checkout 安装则依次运行 `git clone https://github.com/titanwings/dsh-automation.git`、`cd dsh-automation && pnpm install && pnpm check`,最后执行 `pnpm dsh plugin --profile web add /absolute/path/to/dsh-automation`

    $ dsh

验证接入成功

  • 在依赖计划之前先用 **Run now** 跑一次,并检查生成的 Session 与运行记录

03DSH 适配与能力边界

DSH 适配原生运行时

通过官方 dsh CLI 安装进 DSH Web profile 的原生 DSH/Cordis 插件(`dsh plugin --profile web add …`);任务在 DSH 内的全新 root Agent Session 中执行,无需独立的机器人、守护进程 UI 或第三方调度器。

  • 人类可读的排程(一次性 / 间隔 / 每天 / 每周)

    自包含任务、排程、IANA 时区、模型目标与权限边界→友好表单被规范化为经过校验的 RFC 5545 RRULE,便于持久化与检查

  • 统一控制面、两种入口(DSH Web + 任意合格 root Agent)

    DSH Web 的 Automations 面板,或向合格 root Agent 用自然语言下达指令→创建 / 暂停 / 恢复 / 立即运行 / 删除规则并查看近期运行;Agent 侧提供六个作用域工具(automation_create、automation_list、automation_update、automation_run_now、automation_runs、automation_delete)

  • 每个自动化独立的模型目标

    跟随实时全局模型,或固定一个 provider/model 组合并可附带推理努力级别→每次运行都在其不可变快照中保留相同的模型目标

  • 带保留策略的持久化运行历史

    终态运行记录(succeeded / failed / skipped / cancelled)→每个自动化保留 historyLimit(默认 200)条终态运行记录;queued 与 running 记录永不清除

    开启 archiveRunSessions 后,终态运行 Session 会从普通 DSH 对话列表中归档

04适合谁?何时不该用?

适合

  • 使用 DeepSeek Harness(dsh)的开发者,需要让重复性或一次性的编码工作脱离旧聊天在稍后运行
  • 需要无人值守编码运行保持可检查、可审计的团队

不适合

  • 无人值守运行不继承任何权限,只接受 `read-only` 与 `workspace-write` 两种权限模式;无人值守的 `danger-full-access` 不会被接受。每个全新 Session 使用 approval policy `never`(失败即关闭),Agent 工具只绑定到调用者的规范工作区。
  • v0.1 不提供同对话心跳、raw cron 或任意 shell 动作、无人值守全权限、自动重试、Git worktree 创建 / 清理、多工作区目标 / DAG / 隐藏的跨运行记忆、外部邮件 / SMS / 推送通知,也不保证外部副作用恰好一次。只实现了本地执行。

05兼容性、维护与安全提示

  • 无人值守运行不继承任何权限,只接受 `read-only` 与 `workspace-write` 两种权限模式;无人值守的 `danger-full-access` 不会被接受。每个全新 Session 使用 approval policy `never`(失败即关闭),Agent 工具只绑定到调用者的规范工作区。
  • 最小间隔为五分钟,第一次运行发生在一个完整间隔之后;每天 / 每周按显式 IANA 时区的本地时间计算,不存在的 DST 墙钟时间会被跳过;默认 60 分钟后取消运行;调度是 at-most-once(至多一次),而非恰好一次。
  • 任务启动时 DSH Host 必须处于运行状态;v0.1 不是操作系统级守护进程,也不在一个存储目录上协调多个 Host。
  • v0.1 不提供同对话心跳、raw cron 或任意 shell 动作、无人值守全权限、自动重试、Git worktree 创建 / 清理、多工作区目标 / DAG / 隐藏的跨运行记忆、外部邮件 / SMS / 推送通知,也不保证外部副作用恰好一次。只实现了本地执行。
2026-08-132026-08-23v0.1.7

MIT · 活跃维护中(最新发布 v0.1.7,2026-08-23)

06常见问题

如何安装 dsh-automation?

把 GitHub bundle 安装进 DSH Web profile,然后重启 `dsh web`。命令是 `dsh plugin --profile web add github:titanwings/dsh-automation#v0.1.7`;版本标签让安装可复现,reviewed commit SHA 同样有效。如果你从源码运行 DSH,用 `pnpm dsh` 代替 `dsh`。

它和 DSH Core Schedule 有什么区别?

DSH Core Schedule 用于当前对话中的提醒,会回到同一个 live Agent;dsh-automation 用保存的、自包含的任务启动全新的 root Agent 与 Session,限定在单一的规范 DSH 工作区内,并留下持久的运行记录——更适合重复性或一次性的独立编码工作。

能在 Agent 对话里创建自动化吗?

可以。安装后,合格 root Agent 会收到六个作用域工具——automation_create、automation_list、automation_update、automation_run_now、automation_runs、automation_delete——只能管理该 Agent 精确工作区内的自动化。当 Agent 创建或扩展无人值守的未来任务时,插件级审批会要求人工确认。

支持无人值守的全权限(full access)吗?

不支持。规则只能使用 `read-only` 或 `workspace-write`;无人值守的 `danger-full-access` 不会被接受。每个全新 Session 使用 approval policy `never`(失败即关闭),运行不继承任何权限,一旦可能产生副作用就不会自动重试。

v0.1 当前有哪些限制?

v0.1 不提供同对话心跳、raw cron 或任意 shell 动作、Git worktree 创建 / 清理、多工作区目标或 DAG、外部邮件 / SMS / 推送通知,也不保证外部副作用恰好一次。只实现了本地执行,且任务启动时 DSH Host 必须处于运行状态。

08数据与来源

  • 作者声明github.com5ae28f209c02…

    Install the GitHub bundle into the DSH Web profile, then restart `dsh web`:

  • 作者声明github.com5ae28f209c02…

    The implementation is native to DSH and Cordis; it does not copy Codex internals or patch DSH Core.

  • 作者声明github.com5ae28f209c02…

    There is no separate bot, daemon UI, or third-party scheduler to operate.

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-27。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。