通过官方 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 或更高版本
安装步骤
- 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
- 02
重启 `dsh web`
$ dsh web
- 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 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 / 推送通知,也不保证外部副作用恰好一次。只实现了本地执行。
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 必须处于运行状态。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图,输出自包含 HTML,支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库,统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台:AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作,帮你快速构建 CRM、ERP 等业务系统,兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程,从 0 到 1 系统学习智能体工作流框架。
08数据与来源
Install the GitHub bundle into the DSH Web profile, then restart `dsh web`:
The implementation is native to DSH and Cordis; it does not copy Codex internals or patch DSH Core.
There is no separate bot, daemon UI, or third-party scheduler to operate.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-27。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
