MichengAI/dsh-automation

DSH Automation

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

English · 更新日志 · Apache-2.0

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

功能概览

把需要按时重复的工作交给 DSH。你可以在设置页安排任务，也可以在对话中说明执行时间和要求，再回看每次运行的结果。

• 安排一次或重复执行：支持间隔、每小时、每天、每周、每月和自定义间隔天数。
• 选择工作环境：设置工作目录、模型、技能和权限。
• 随时调整安排：创建、暂停、恢复、立即运行或删除任务。
• 查看执行结果：在侧栏「定时」中按任务和执行时间回看会话，在设置页筛选运行记录。
• 每次独立运行：使用已保存的任务说明，不继承创建任务时的整段对话。

界面预览

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

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

在对话里描述任务。DSH 会按所选权限模式处理授权：

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

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

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

插件	你可以用它做什么
Codex UI	整理项目与会话、搜索任务、跳转对话轮次
Agency Agents	按任务选择并召唤专业角色
Skills Manager	统一查找、启停、创建和导入本机技能
Archive Manager	搜索、恢复或清理已归档会话
IM Connect	从消息平台下任务、收回复
Automation	按计划执行任务，查看每次运行的结果
BTW	在当前上下文中临时旁问，不打断主任务
Simplify	用 /simplify 整理 Git 改动范围内的代码
PUA	引导 Agent 在失败时换方法、查原因，并在完成前验证结果
Code Review	用 /review 发起独立 Agent 代码审查，在当前会话接收报告
Codex Pet	通过桌面宠物查看会话提醒、处理工具审批和问题回答

前置条件

• 当前源码以 DSH 0.2.0-rc.2 为开发和真实宿主测试基线，并声明支持到 0.2.0-rc.2。升级宿主前备份 Profile 中的自动化存储和会话目录。0.1.7 和 0.2.0 写入 V4 会话，V4 会话不支持降级读取。
• 官方 DSH peerDependencies 精确限定为 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2。0.1.6 这条线不会再有候选版，所以不在名单里；仍停在 0.1.6-alpha.1、0.1.6-alpha.2 的宿主，安装下一版前需要升到 0.1.7-rc.1 或更新。@deepseek-ai/dsh-agent-presets 和 @deepseek-ai/dsh-agent-preset-registry 都不写入 peer：宿主安装门会拿每一个 @deepseek-ai/dsh-* peer 去对当前版本，并且不看 optional。旧包没有 0.1.7 或 0.2.0 发布版，改名后的包在旧宿主上也不存在。定时任务仍使用宿主的 agentPresets 服务。开发依赖固定为 0.2.0-rc.2。同一宿主中的官方包应使用一致版本。
• 其他版本不在声明兼容范围内；安装器可能提示 peer 警告，启用严格 peer 校验时会失败。支持新 rc 前需扩展版本矩阵并通过验证。
• Connection 补丁替换 Web bundle 的配置注入列表为 [webServer, webRuntime]，Loader 仍会合并插件源码声明的依赖。自定义宿主若增加了其他配置注入，需在后置 Profile 补丁中保留这两项并补齐自定义依赖；本补丁不自动合并其他 bundle 的列表。
• 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 dsh。
• 以下示例使用 web profile；请替换为实际目标 profile。
• 从源码安装或二次开发需要 Node.js 22.19+；仅从 npm 安装无需在任意目录执行 npm install。

安装

以下安装命令使用官方 npm 源。

让 Agent 帮你安装（推荐）

把下面这段话发给任意能够执行本机终端命令的 Agent。将 web 替换为实际使用的 profile；安装完成后，在 DSH 中使用本插件。

请将 DSH 插件 @michengai/dsh-automation 安装到本机 web profile，执行：dsh plugin --profile web add @michengai/dsh-automation@latest --registry=https://registry.npmjs.org/。安装后执行 dsh --profile web --dump-config，确认配置包含 dsh-automation，并告诉我如何重新加载 DSH 和开始使用。

从 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。

在线更新

设置标题会显示当前版本和“检查更新”按钮。发现新版后，只有检测到 DSH CLI 或 Desktop 更新服务时才可使用“自动更新”；其他环境会在弹窗中提供可复制、与当前 Profile 对应的手工更新命令。

使用

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

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

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

权限与安全边界

项目	行为
权限	列表和默认值直接来自 Host 官方 permissionPresets 服务；支持 Host 注册的自定义预设。
工具调用	遵循 Host 的工具可用性、权限和审批检查，不额外维护固定工具白名单或禁止后台 shell；后台进程由 Host 管理。
完全访问	选择官方 danger-full-access 时显示与 Chat 一致的风险确认和橙色提示。
审批	对话创建跟随当前会话策略。Full access（never）直接创建；Workspace Write / Read Only（ask）走官方授权卡。无人值守运行仍是 fail-closed 的 never。
重试	已经开始的运行不会自动重试。
Host 重启	遗留的 queued / running 会变成 failed(host_interrupted)。
并发	不同自动化任务不设插件级全局并发上限，同一目录下也可同时运行。旧插件级全局并发配置（插件 config 中的 maxConcurrentRuns）不再生效，与下方任务级字段不同。
最短间隔	自 0.1.40 起，间隔计划支持最短 1 分钟，仅接受整数分钟。恢复时仅处理补跑窗口内最近的到期点，不逐次补齐漏掉的触发。
单任务并发	自 0.1.40 起支持。在任务的新建/编辑页设置“并发数量”（正整数，默认 1）。同一任务的排队及运行记录共用此上限；满额时定时触发记为 skipped(overlap)，手动运行返回上限提示。调低上限不取消已有运行。Agent 创建/更新工具使用 max_concurrent_runs，Web RPC 使用 maxConcurrentRuns；旧任务默认 1。

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

二次开发

从源码安装

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

[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 文件。

当前源码在 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 会连续执行类型检查、单元测试、真实宿主兼容测试和构建。pnpm test:host 不加载宿主运行时桩，使用官方 AgentLoop、Session V3 和权限服务，模型响应由本地固定适配器提供，不调用外部模型。浏览器交互和真实模型调用需另行验收。

跨插件侧栏回归可运行 pnpm test:composition <dsh-im-connect 检出目录>。请先构建 IM 检出目录，脚本读取其中的 lib/client.js。它执行两仓库的接入逻辑和页签注册表，覆盖归档、IM、定时及 Codex UI 的注册顺序、延迟通知与卸载接管；插槽和计时器使用模拟环境，不替代 Desktop 渲染验收，也不安装插件。该检查需要外部检出目录，独立于 pnpm check；请固定 IM revision，以便复现结果。

pnpm test:matrix 先构建发布包，再联网为上述已声明版本分别建立临时 npm 环境，执行严格 peer 安装、整棵官方依赖树版本检查、发布入口加载、真实 AgentLoop 执行和服务回归。各声明版本均通过；服务回归中的持久化枚举使用内存夹具，覆盖新旧冷会话格式，不等同于真实 Profile 的磁盘迁移验收。脚本输出证据目录，保留各版安装锁文件、测试日志和 results.json。矩阵不修改开发依赖，也不连接用户 Profile。

许可证

补充说明见 NOTICE。

本项目采用 Apache License 2.0。