DSH Automation Center

中文 | English

![CI](https://github.com/usersx/dsh-automation-center/actions/workflows/ci.yml) ![npm version](https://www.npmjs.com/package/dsh-automation-center) ![license](LICENSE)

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

!DeepSeek 鲸鱼娘编排自动化任务

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

当前版本同时支持两种原生界面，不注入 DOM，也不替换 Sidebar：

原版兼容模式：未修改的 DSH 0.1.0-rc.8 自动注册为 Session 内的“自动化”标签，普通用户可直接安装，不需要 Shell Page Patch。
全局中心模式：当 DSH 提供 sidebar.primary.action 与 shell.page 时，自动升级为“新会话”下方、“工作区”上方的全局入口，无需先打开 Session。

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

从 npm 安装（推荐）

Web Profile：

dsh plugin --profile web add dsh-automation-center@latest

Desktop Profile：

dsh plugin --profile desktop add dsh-automation-center@latest

需要可复现安装时固定版本：

dsh plugin --profile web add dsh-automation-center@0.1.0-alpha.5

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

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

为什么需要 Automation Center

Session 内标签能解决原版 DSH 的可安装性，却仍有信息架构冲突：用户需要先进入一个会话管理任务，而任务执行时又会创建另一个新 Session。全局中心模式进一步解决这个问题：

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

功能

全 Workspace 总览、Workspace 筛选、统计卡片与最近运行。
一次性、固定间隔、每日和每周计划；显式 IANA 时区与下次运行预览。
创建、编辑、暂停、恢复、删除、立即运行和取消。
每次 occurrence 创建新的根 Agent 和 Session，不复用聊天会话。
Result Session 使用自动化任务名作为标题，而不是 Workspace 或项目名。
“只读”和“Workspace 可写”两种无人值守权限。
创建幂等、防重叠、确定性 occurrence 领取、有限 misfire 补偿与 Host 重启恢复。
持久运行历史、摘要、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 rc.8: conversation.view
  └─ enhanced: sidebar.primary.action + shell.page
                         │
                         ▼
Automation Center ──RPC──▶ AutomationEngine ──▶ Definition / Run 存储
                                      │
                          计划、立即运行或恢复调度
                                      │
                                      ▼
                          Fresh Agent + Fresh Session
                                      │
                                      ▼
                          Result Session + 审计记录

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

兼容性

目标	安装	界面	状态
原版 DSH `0.1.0-rc.8` / Web	无需 Patch	Session 内“自动化”标签	隔离实机观察通过；详见验收记录
原版 DSH `0.1.0-rc.8` / Desktop	无需 Patch	Session 内“自动化”标签	待 rc.8 Desktop 重新实机验收
提供两个 Shell Slot 的 DSH / Web	无需插件改动	全局根入口和独立页面	已观察通过
Windows / Linux 原生 Desktop	—	随目标 DSH 能力自动选择	尚未实机验收

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

精确的通过、阻塞和未运行项见[验收结果](docs/acceptance-results-2026-08-20.md)。

配置

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

安全边界

管理 RPC 只接受可信 Loopback 连接。
UI 只能提交已注册的 Workspace ID，不能传任意宿主绝对路径。
Automation Agent 不能递归创建 Automation，也不能等待人工授权。
无人值守工具使用白名单，并拒绝后台进程逃逸。
Host 重启后不盲目重试可能已经产生副作用的中断 Run。
日志和 RPC 错误不得输出 Prompt、Token、环境变量或凭证。
取消只能终止后续执行，无法回滚已经完成的副作用。

开发与验证

pnpm install
pnpm check

CI 在 Linux、macOS 和 Windows 上执行类型检查、测试、构建与仓库检查，并把打包后的插件安装到未修改的 DSH rc.8 隔离 Profile。Release 工作流生成固定 tarball、SHA-256、SPDX SBOM、GitHub/Sigstore 制品证明，并通过 npm Trusted Publishing 发布 provenance。

文档

验收标准
验收结果
技术方案
发布流程
[更新日志](CHANGELOG.md)
[贡献指南](CONTRIBUTING.md)
[安全策略](SECURITY.md)
[实施路线](ROADMAP.md)
[第三方代码声明](THIRD_PARTY_NOTICES.md)

从源码安装

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.5.tgz

已知限制

原版 rc.8 只能提供 Session 内标签；真正的全局入口需要上游提供两个通用 Shell Slot。
第一版不提供分布式 Scheduler、远程执行节点或云端凭证托管。
取消不会撤销已经发生的文件修改或外部调用。
当前仍是 Alpha；稳定版发布条件以验收文档为准。

许可证

[MIT](LICENSE)

来源信息

安装

检查来源文件