dsh-automation

DSH Automation

在独立 DSH Session 中按计划执行编码任务

English · Apache-2.0

DSH Automation 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。

功能概览

• 在「设置 → 定时任务」里管理计划任务。
• 支持 Web 设置页和 Agent 工具创建、暂停、恢复、立即运行和删除。
• 每次到期都启动全新 root Agent 和 Session，不继承来源对话。
• 计划类型包括不重复、间隔、每小时、每天、每周、每月和自定义间隔天数。
• 新建弹窗可选择工作目录、模型、技能，以及 Host 官方提供的权限预设。
• 在任意对话里描述定时任务即可创建；Full access 直接执行，其他权限走官方授权卡。
• 运行状态包含 queued、running、succeeded、failed、skipped、cancelled。
• 侧栏提供「定时」页签：文件夹是任务名称，子会话是执行时间。原生下只包裹官方任务树，不依赖 dsh-codex-ui。

界面预览

工作区左侧「任务 / 频道 / 定时」分列。定时任务只出现在「定时」：

打开「设置 → 定时任务」可搜索、新建、暂停和查看规则：

在对话里描述任务。Agent 会调用 automation_create，并弹出官方授权：

确认后规则会保存，并在对话里汇总：

执行记录留在设置页，可按天、周、月、任务或状态筛选：

DSH 产品生态

本产品既可以独立安装，也可以随桌面端或 Web 套件一起使用。它们共享同一个 DSH 核心，但面向不同的使用方式；在原生 DSH 下，本产品不依赖 Codex UI：

产品	与本产品的关系
DeepSeek Harness	本产品的运行宿主，提供模型、会话、工具和插件系统
DSH Codex Desktop	下载安装即用的桌面产品，已内置本产品和其他 5 个功能产品
DSH Codex Suite	面向已有 DSH Web 环境的一键套件，会安装本产品和其他 5 个功能产品
6 个功能产品	Codex UI · IM Connect · Automation · Skills Manager · Archive Manager · Agency Agents

前置条件

• 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 dsh。
• 以下示例使用 web profile；请替换为实际目标 profile。
• 从源码安装或二次开发需要 Node.js 22.19+；仅从 npm 安装无需在任意目录执行 npm install。

安装

dsh plugin add 会转发到 profile 目录里的 pnpm add。不写版本、不指定官方源时，本机镜像可能让你停在旧版。

从 npm 安装

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-automation@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config

安装后重启 DSH Web，并在浏览器硬刷新。需要钉死某一版时，把 @latest 换成 @0.1.5。

从源码安装

适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location D:\Repository\deepseek-harness-plugin
git clone https://github.com/MichengAI/dsh-automation.git
Set-Location .\dsh-automation
pnpm install
pnpm test
pnpm build
dsh plugin --profile web add .
dsh --profile web --dump-config

完成后重启 DSH Web 并硬刷新浏览器。dsh plugin ... add . 会自动读取并应用 cordis.patch.yml；不要手工复制 lib 文件。

使用

打开「设置 → 定时任务」，再按下表操作：

目标	操作	范围
创建规则	点击「新建定时任务」，填写名称、计划、任务说明、工作目录、模型、技能和权限。	当前 Host
通过对话创建	在任意对话描述定时任务，或点击「通过对话创建」。	当前对话
暂停或恢复	使用任务卡片上的开关。	单条规则
立即运行	打开卡片菜单，选择「立即执行」。	单条规则
删除	打开卡片菜单，选择「删除任务」。运行历史会保留。	仅定义
查看记录	打开「执行记录」，再按天、周、月、任务或状态筛选。	当前 Host

每次派发都使用保存的任务说明、工作区、模型和权限边界，不会复用来源对话中的批准。

权限与安全边界

项目	行为
权限	列表和默认值直接来自 Host 官方 permissionPresets 服务；支持 Host 注册的自定义预设。
完全访问	选择官方 danger-full-access 时显示与 Chat 一致的风险确认和橙色提示。
审批	对话创建跟随当前会话策略。Full access（never）直接创建；Workspace Write / Read Only（ask）走官方授权卡。无人值守运行仍是 fail-closed 的 never。
重试	已经开始的运行不会自动重试。
Host 重启	遗留的 queued / running 会变成 failed(host_interrupted)。
重叠	同一规则同时最多一个 active run。冲突 occurrence 记为 skipped(overlap)。

计划只表达未来意图，不是缓存下来的授权。

二次开发

当前源码在 src，构建产物在 lib：

• src\index.ts：Host 插件、工具和 RPC。
• src\service.ts：持久化定义、时钟和运行准入。
• src\client\index.ts：设置页和对话预填。
• tests\*.test.ts：领域、周期、服务、客户端和包契约测试。

修改后运行测试、重新构建，并以本地目录安装验证：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm check
dsh plugin --profile web add .

修改执行逻辑时必须保留 at-most-once 派发、Agent 工具的工作区边界，以及无人值守 fail-closed 审批。

验证

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm test
pnpm build

pnpm check 会连续执行类型检查、测试和构建。

项目文档与许可证

项目状态、使用边界、技术架构和迭代记录从文档交接入口开始。补充说明见 NOTICE。

本项目采用 Apache License 2.0。