自动化中心 usersx/dsh-automation-center

DSH 自动化中心

CI
npm version
license

题图是“DeepSeek 鲸鱼娘与自动化”的项目插画，不是产品界面截图。功能截图均使用 DSH 0.1.0-rc.8 原版 DeepSeek 官方皮肤。

DeepSeek 鲸鱼娘编排自动化任务

DSH 自动化中心为 DeepSeek Harness 提供可计划、可审计的自动化任务。每次触发都会在指定 Workspace 中创建新的根 Agent 和 Result Session；任务定义、计划、权限与运行历史由自动化中心管理，完整结果和轨迹保存在 Result Session 中。

当前版本会按 DSH 能力选择原生界面，不注入 DOM，也不替换 Sidebar：

- 原版兼容模式：未修改的 DSH 0.1.0-rc.8 至最新 0.1.2-alpha.2 在“设置 → 自动化”提供全局管理页，无 Session 也能进入；Session 内的“自动化”标签作为快捷入口。普通用户可直接安装，不需要 Shell Page Patch。
- 全局中心模式：当 DSH 提供 sidebar.primary.action 与 shell.page 时，自动升级为“新会话”下方、“工作区”上方的全局入口，无需先打开 Session。

当前版本：0.1.0-alpha.8。兼容性通过不等于安全审计通过。

从 GitHub Release 安装 Alpha.8

先下载 dsh-automation-center-0.1.0-alpha.8.tgz，再从下载目录安装。

Web Profile：

dsh plugin --profile web add ./dsh-automation-center-0.1.0-alpha.8.tgz

Desktop Profile：

dsh plugin --profile desktop add ./dsh-automation-center-0.1.0-alpha.8.tgz

Release 同时提供 SHA-256、SPDX SBOM 和 GitHub/Sigstore 构建证明。npm 是否发布完成必须以 registry 的固定版本、integrity 与 provenance 回读为准，不能用 GitHub Release 或 workflow approval 代替。

安装后完整退出并重新打开 DSH，让 Host Bundle 在启动时挂载。不要只刷新网页。Node.js 需使用 DSH 支持的 ^22.19.0 或 >=24.0.0。

如果旧的 @dsh-external/dsh-automation 正在运行，请先停用或移除；新插件检测到双 Scheduler 时会报告 AUTOMATION_PLUGIN_CONFLICT，不会静默重复调度。

为什么需要自动化中心

Automation 不属于某个聊天 Session。alpha.6 因此把原版 DSH 的权威管理入口放进全局 Settings；增强 Shell 还可以把同一页面提升到左侧一级入口：

- 无需先打开 Session；
- 跨 Workspace 查看任务、计划、最近运行和失败项；
- 使用完整根页面，而不是弹窗；
- 每次运行都有独立、可审计、可直接打开的 Result Session；
- 入口外壳由 DSH Sidebar 渲染，与“新会话”保持同宽、同中心线和同皮肤。

功能

- 全 Workspace 总览、Workspace 筛选、统计卡片与最近运行。
- 一次性、固定间隔、每日和每周计划；显式 IANA 时区与下次运行预览。
- 创建、编辑、暂停、恢复、删除、立即运行和取消。
- 每次 occurrence 创建新的根 Agent 和 Session，不复用聊天会话。
- Result Session 使用自动化任务名作为标题，而不是 Workspace 或项目名。
- “只读”和“Workspace 可写”两种无人值守权限。
- 每个任务可选择“运行时继承 DSH 默认模型”，或固定 provider、model 和 reasoning effort；运行历史记录实际模型。
- 保存与运行前检查 Workspace、Preset 和模型；不可用目标显示为 blocked，不会先创建无效 Session。
- 创建幂等、防重叠、确定性 occurrence 领取、有限 misfire 补偿与保守的 Host 重启恢复。
- claim / setup / executing / settling / delivery 阶段、租约心跳与覆盖完整作业的超时。
- 派生 expected/admitted/claimed/queue/progress 健康，以及结构化 Outcome/Attention、attempt 与副作用不确定性。
- 可选 Git worktree 隔离审阅：干净 base、patch hash/stat、accept/keep/discard，源工作区漂移时 fail closed。
- 生命周期事件带 runId/revision/sequence；模型只看到无人值守策略实际允许的工具。
- Run 对外提供由 Definition revision、occurrence 与 Workspace scope 组成的稳定 identity；不按列表位置或动态同名节点恢复。
- Host、存储与 Git review cleanup 在异步 settle 前持续保有 owner；中断的 accept/discard 会在重启后对账。
- 所有写操作返回持久 Receipt（request ID、revision、committed / rejected / unknown），Client 随后读取权威状态。
- 持久运行历史、摘要、Result Session 入口、实际模型和结构化错误码。
- 只读导入旧 dsh_automation v1 数据，原存储域保持不变。

原版 DeepSeek 界面截图

以下功能截图全部使用原版 DeepSeek 皮肤。

0. 原版 rc.8 兼容模式（深色）

未修改的 rc.8 将入口放在“对话 / 轨迹”旁；下图同时展示任务卡片、结构化失败记录，以及为会话输入框保留的底部净空。

原版 rc.8 深色皮肤中的 Session 自动化标签

以下三张截图展示提供两个 Shell Slot 后的 全局中心模式。

1. 与“新会话”同级且居中

2. 全局 Automation Center

原版 DeepSeek 皮肤中的 Automation Center

3. 创建自动化任务

原版 DeepSeek 皮肤中的自动化创建表单

使用方法

1. 原版兼容模式：打开“设置 → 自动化”，也可以从任一 Session 顶部的“自动化”快捷标签进入。全局中心模式：直接点击左侧栏“自动化”。
2. 点击“新建自动化”或“创建第一个自动化”。
3. 填写名称、任务指令、Workspace、计划、时区、Agent Preset、模型策略、权限和超时。
4. 检查下次运行预览并保存。
5. 等待计划触发，或点击“立即运行”。
6. 在“最近运行”查看摘要，并打开 Result Session 查看完整结果。

建议先用“只读”权限和无外部副作用的小任务验证配置，再逐步开放 Workspace 写权限。

工作原理

DSH Surface Adapter
├─ stock 0.1.0-rc.8 → 0.1.2-alpha.2: settings.section + conversation.view shortcut
└─ enhanced: sidebar.primary.action + shell.page
│
▼
Automation Center ──RPC──▶ AutomationEngine ──▶ Definition / Run 存储 │ 计划、立即运行或恢复调度 │ ▼ Fresh Agent + Fresh Session │ ▼ Result Session + 审计记录

复杂度集中在 Host 侧 AutomationEngine。两个 Client Surface Adapter、受认证 RPC、Scheduler 和 Agent Tools 都复用同一个 snapshot / dispatch 边界，不直接读写存储域。

兼容性

| 目标 | 安装 | 界面 | 状态 |
| 原版 DSH 0.1.0-rc.8 / Web | 无需 Patch | Settings 全局页 + Session 快捷标签 | Alpha.6 完整 Web 端到端通过 |
| 原版 DSH 0.1.1-rc.2 / Web | 无需 Patch | Settings 全局页 + Session 快捷标签 | npm 固定版本安装、Host/Client 激活、无 Workspace 空状态和浏览器 console 验收通过；完整 Agent Run 未重复执行 |
| 原版 DSH 0.1.2-alpha.1 / Web | 无需 Patch | Settings 全局页 + Session 快捷标签 | Alpha.7 本地 tarball 安装、Host/Client、创建/运行、失败终态、Result Session 与 Attention readback 通过；真实模型成功 Run 待最终验收 |
| 原版 DSH 0.1.2-alpha.2 / Web | 无需 Patch | Settings 全局页 + Session 快捷标签 | Alpha.8 候选包安装、Host/Client、Definition、direct/worktree 失败链路、Result Session、Attention 与幽灵 Session 负向通过；真实模型成功 Run 未运行 |
| macOS DSH Desktop 2.0.3（内置 DSH 0.1.1-rc.2） | 无需 Patch | Settings 全局页 + Session 快捷标签 | Alpha.7 最终 tgz 升级、真实模型成功 Run、结构化 Outcome、Result Session 与三次冷启动通过 |
| 提供两个 Shell Slot 的 DSH / Web | 无需插件改动 | 全局根入口和独立页面 | 已观察通过 |
| Windows / Linux 原生 Desktop | — | 随目标 DSH 能力自动选择 | 尚未实机验收 |

截至 0.1.2-alpha.2，原版 DSH 仍没有 sidebar.primary.action 和 shell.page，所以插件无法只靠公开 API 在“新会话”下方增加根入口。为了保证可卸载、可维护和主题兼容，本项目不使用 DOM 注入模拟该入口。两个 Slot 一旦进入 DSH 上游，同一个 npm 包会自动启用全局中心模式。

精确的通过、阻塞和未运行项见 Alpha.8 验收结果；Alpha.7、Alpha.6 与 Alpha.5 历史记录仍保留作为既有实机基线。

配置

| 配置项 | 默认值 | 说明 |
| maxConcurrentRuns | 2 | 全局同时运行的最大 Run 数，范围 1–32 |
| runTimeoutMinutes | 60 | 默认单次运行超时，范围 1–1440 分钟 |
| misfireGraceMinutes | 15 | Host 暂停后的有限补偿窗口 |
| historyLimit | 200 | 每个 Automation 保留的 Run 上限 |
| archiveRunSessions | false | 完成后是否归档 Result Session；Run 审计行仍保留 |

安全边界

- 管理 RPC 在 rc.8/rc.2 使用 Loopback authority，在 alpha.1/alpha.2 使用一次性 Token 认证通道；所有写入仍校验 Workspace/Profile scope。
- UI 只能提交已注册的 Workspace ID，不能传任意宿主绝对路径。
- Automation Agent 不能递归创建 Automation，也不能等待人工授权。
- 无人值守工具使用白名单，并拒绝后台进程逃逸。
- Host 重启后不盲目重试可能已经产生副作用的中断 Run。
- 日志和 RPC 错误不得输出 Prompt、Token、环境变量或凭证。
- 取消只能终止后续执行，无法回滚已经完成的副作用。

开发与验证

pnpm install
pnpm check

CI 在 Linux、macOS 和 Windows 上执行类型检查、测试、构建与仓库检查，并把打包后的插件分别安装到未修改的 DSH 0.1.0-rc.8、0.1.1-rc.2、0.1.2-alpha.1 与 0.1.2-alpha.2 隔离 Profile。Release workflow 会生成固定 tarball、SHA-256、SPDX SBOM 与 GitHub/Sigstore 制品证明；npm 发布只在 workflow 与 registry 回读成功后才算完成。

文档

- 验收标准
- Alpha.8 验收结果
- 技术方案
- 发布流程
- 更新日志
- 贡献指南
- 安全策略
- 实施路线
- 第三方代码声明

从源码安装

git clone https://github.com/usersx/dsh-automation-center.git
cd dsh-automation-center
pnpm install
pnpm check
npm pack
dsh plugin --profile web add ./dsh-automation-center-0.1.0-alpha.8.tgz

已知限制

- 原版 DSH 0.1.2-alpha.2 可在 Settings 提供全局管理页，但左侧栏一级入口仍需要上游提供两个通用 Shell Slot。
- 0.1.2-alpha.2 Web 已完成 Alpha.8 候选包的安装、激活、RPC、direct/worktree 失败链路、Result Session 与幽灵 Session 负向验收；真实模型成功 Run 未运行。macOS Desktop 2.0.3 的 Alpha.7 真实模型成功 Run 与三次冷启动仍是历史基线。
- 第一版不提供分布式 Scheduler、远程执行节点或云端凭证托管。
- 取消不会撤销已经发生的文件修改或外部调用。
- 当前仍是 Alpha；稳定版发布条件以验收文档为准。
- DSH 0.1.2-alpha.2 自身尚不能证明复杂 secret-bearing Settings schema 的 wire 脱敏安全；本插件 Config 不声明 secret 字段并隐藏内部错误文本，但共存插件的复杂 schema 仍需上游 fail-closed 修复后复验。

许可证

MIT