前言¶
DeepSeek Harness (DSH) 的插件生态允许扩展功能，但原版 DSH 缺乏原生的、全局的调度与审计机制。在现有做法中，自动化任务通常与特定的聊天 Session 绑定，导致会话复用、难以追踪跨 Workspace 的历史，以及缺乏统一的管理入口。
dsh-automation-center 是一个 Root-level automation center，它为 DeepSeek Harness 提供了可计划、可审计的自动化任务管理能力。每次触发都会在指定 Workspace 中创建新的根 Agent 和 Result Session；任务定义、计划、权限与运行历史由插件管理，完整结果和轨迹保存在独立的 Session 中。
核心能力¶
该插件主要解决调度、会话隔离和权限管理三个问题。
计划与会话隔离¶
- 计划支持：支持一次性、固定间隔、每日和每周计划。界面提供 IANA 时区配置与下次运行预览。
- 独立 Session：每次运行（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 与副作用不确定性。 - 持久化：所有写操作返回持久 Receipt（request ID、revision、committed/rejected/unknown），随后通过读取权威状态确认结果。
- Git 集成：可选 Git worktree 隔离审阅模式，支持 patch hash/stat 与 accept/keep/discard 操作，源工作区漂移时 fail closed。
安装与启用¶
当前版本为 0.1.0-alpha.8。安装前需确保 DSH 版本在 0.1.0-rc.8 至 0.1.2-alpha.2 之间，且 Node.js 版本为 ^22.19.0 或 >=24.0.0。
- 下载插件包
dsh-automation-center-0.1.0-alpha.8.tgz。 - 在终端执行以下命令安装：
dsh plugin --profile web add ./dsh-automation-center-0.1.0-alpha.8.tgz
dsh plugin --profile desktop add ./dsh-automation-center-0.1.0-alpha.8.tgz
安装后需要完全退出并重新打开 DSH，以使 Host Bundle 在启动时正确挂载。
使用流程¶
安装并重启 DSH 后，可以通过以下步骤创建和管理自动化任务：
- 打开“设置 → 自动化”，或在左侧栏找到“自动化”入口。
- 点击“新建自动化”或“创建第一个自动化”。
- 填写必要信息：名称、任务指令、目标 Workspace、计划（类型、频率、时区）、Agent Preset、模型策略、权限和超时设置。
- 检查“下次运行预览”并保存配置。
- 等待计划触发，或直接点击“立即运行”。
- 在“最近运行”列表中查看摘要，点击对应条目打开 Result Session 查看完整结果。
建议先用“只读”权限验证配置，确认无误后再开放 Workspace 写权限。
注意事项¶
- 冲突检测：如果旧的
@dsh-external/dsh_automation正在运行，新插件会报告AUTOMATION_PLUGIN_CONFLICT。请先停用或移除旧插件。 - 取消限制：取消操作只能终止后续执行，无法回滚已经完成的副作用。
- 安全边界：日志和 RPC 错误不得输出 Prompt、Token、环境变量或凭证。无人值守工具使用白名单，拒绝后台进程逃逸。
- 身份识别：Run 对外提供由 Definition revision、occurrence 与 Workspace scope 组成的稳定 identity，不按列表位置恢复。
