syncended/deepseek-harness-automations

DeepSeek Harness 自动化

一个用于持久、可配置 cron 任务的 DeepSeek Harness 插件。每次触发都会在选定的工作区中启动一个全新的持久化 Harness Agent，并带有明确的模型路由、Agent 预设和权限预设。

状态： MVP 兼容 @deepseek-ai/dsh 0.1.1-rc.2 和 0.1.2-rc.1。当前 worker 为单主机。Cron 准入和运行历史是持久化的；主机崩溃后，已启动的运行会被有意地不重试。

可用功能

- 标准的五字段 cron 表达式，支持 UTC 或 IANA 时区。
- 每个任务的独立工作区、provider/model、推理强度、Agent 预设、权限预设和超时。
- 启用/禁用、立即运行、编辑、删除、取消，以及最近运行历史，均可从主 Automations 侧边栏操作打开的中心工作区，或从 Settings → Automations 访问。
- 自动化创建的聊天使用自动化名称作为其持久会话标题，并在常规和历史搜索中显示紧凑的 Auto 徽章。
- 重叠策略：
- skip — 当任务已有排队/运行中的工作时，记录并跳过该次触发。
- queue — 将同一任务的触发串行化。
- allow — 允许并发触发，受全局并发限制约束。
- 错过触发策略：
- skip — 将逾期的触发记录为已跳过。
- run-once — 将错过的触发合并到最近的到期时间。
- 默认情况下，在 $DSH_HOME/automations/state.json 下使用原子性的所有者私有状态。
- 不可变的执行快照和触发键，用于可重放安全的准入。
- 可扩展的执行器注册表：MVP 附带 agent；未来的 workflow 和任务图执行器无需更改调度器。

内置的 @deepseek-ai/dsh-schedule 插件仍然是附加到单个活动 Session 的提醒的合适工具。本插件负责部署级任务，可以在没有打开任何聊天的情况下启动全新的工作区 Session。

安装

要求：

- Node.js 22 或更高版本。
- DeepSeek Harness 0.1.1-rc.2 或具有可用 dsh web 配置文件的兼容版本。
- 至少一个已配置的 provider/model 路由，以及可用的 Agent 和权限预设。
- 仅在从源码检出安装时，通过 Corepack 使用 pnpm 11。

从 npm 安装：

dsh plugin --profile web add @syncended/dsh-automations

或从此检出安装：

pnpm install
pnpm check

dsh plugin --profile web add .

该包声明了 DSH bundle，因此 dsh plugin 会自动将其追加到 Web 配置文件。安装或升级后，重启正在运行的 dsh web 进程，刷新现有页面，然后从主侧边栏或 Settings → Automations 打开 Automations。先创建一个小的已禁用任务，保存它，然后使用 Run now 验证所选的模型、工作区和权限预设。
浏览器客户端使用该 Host 暴露的同源 /api/automations 端点。无需单独的连接 URL、令牌或插件专属环境变量；DSH_HOME 仅控制常规的 Harness 状态位置。

要移除它：

dsh plugin --profile web remove @syncended/dsh-automations

配置作业

| 字段 | 含义 |
|---|---|
| Name | 人类可读的作业名称。 |
| Schedule | 选择 Minutes、Hourly、Daily、Weekdays 或 Weekly，并调整其简单控件。Custom 会暴露原始的五字段 cron（minute hour day-of-month month day-of-week），并附带内联字段指南。 |
| Time zone | 在选择器中按城市或地区搜索，或输入 UTC / IANA 名称，例如 Europe/Berlin。会显示当前 UTC 偏移量；夏令时由 cron-parser 处理。 |
| Workspace | 选择一个现有的 Harness 工作区，或手动输入绝对目录。其规范的文件系统标识将成为 Session cwd 和 workspace-write 根目录。 |
| Prompt | 发送给全新 Harness Agent 的用户消息。 |
| Model | 从按提供商标题分组的可搜索模型列表中选择，或输入未列出的 provider/model 路由。留空以在调度时解析当前 Harness 默认值。 |
| Reasoning effort | 选择 Default 或适配器公布的精确模型 effort。如果能力查询不可用，常见 ID 会作为参考性回退显示；自定义 ID 仍可编辑，并会在运行开始时进行验证。 |
| Agent preset | 留空以使用当前 Harness 默认值，或选择特定组合。 |
| Permission preset | 捆绑 DSH 沙箱和审批策略。默认：workspace-write。 |
| Timeout | 墙钟运行时限。取消通过 Agent 循环协作完成。 |
| Overlap / misfire | 上文所述的准入行为。 |

表单将常用设置分组为 Task、Schedule 和 Agent & access。作业 ID、超时、重叠和失火仍可在折叠的 Advanced 部分中使用。已暂停的作业仍可通过 Run now 启动。

插件配置

默认值适用于本地 Web 配置文件。需要时，编辑 $DSH_HOME/profiles/web/cordis.patch.yml 中现有的 automations 行；不要添加具有相同 id 的重复行。更改后重启 Host：

- id: automations
config:
maxConcurrentRuns: 2
historyLimit: 1000
misfireGraceMs: 60000
maxOutputChars: 65536
allowedProjectRoots:
- /home/me/projects
Optional alternate Harness home used only to derive the default state path.
dshHome: /absolute/private/dsh-home
Optional; otherwise /automations/state.json.
A leading ~ is expanded; the resulting path must be absolute.
statePath: /absolute/private/path/state.json
allowedProjectRoots: [] 表示该插件接受 Harness 主机账户能够解析的任何现有目录。当 Web 界面暴露在受信任的本地机器之外时，请配置一个或多个现有根目录。根目录和作业工作区会通过 realpath 进行规范化，因此已删除的路径和符号链接重定向会以失败关闭（fail closed）方式处理。

经过验证的服务范围：maxConcurrentRuns 为 1–32，historyLimit 为 10–10,000，misfireGraceMs 为 0–86,400,000，maxOutputChars 为 1,024–1,048,576。作业名称限制为 120 个字符，提示词限制为 131,072 个字符，ID 限制为 63 个小写字母/数字/连字符，超时限制为 1 秒–24 小时。空白的模型或预设选择会在调度时根据当前 Harness 默认值进行解析，因此未来的运行可以跟随之后的默认值变更。

持久化语义

1. 调度器在同一次原子状态变更中认领一次发生（occurrence）并推进其持久化的 nextRunAt 水位线。
2. 被接纳的运行会固定完整的作业版本，并获得一个唯一的发生键。
3. queued 状态的运行会在重启后被调度。
4. 在任何 Agent 工作开始之前，运行会被标记为 running。
5. 重启时，孤立的 running 记录会变为 interrupted，并且不会自动重试，从而避免静默的重复文件/网络副作用。
6. Harness Session 持久化仍然是 Agent 转录内容的唯一事实来源；自动化状态存储编排元数据和有界的最终文本摘要。

这并非精确一次（exactly-once）执行。精确一次的外部副作用需要任务本身或目标系统具备幂等性。

安全

- 状态文件以 0600 模式原子替换；创建的目录使用 0700。
- 工作区路径通过 realpath 解析；可选的允许根目录会依据该规范化身份进行检查。
- 后台工作使用普通的 DSH 权限预设。workspace-write 无法静默扩大自身权限；无人值守的审批失败会保持失败关闭（fail-closed）。
- danger-full-access 仅在作业作者选择授予该权限的已配置预设时才被有意提供。
- 管理 API 要求 JSON 以及自定义的同源变更标头。它继承 DSH Web 服务器的信任边界，而该服务器没有独立的身份验证层。
- 提示词、运行元数据、最终摘要和 Session 转录内容均为本地敏感数据。

威胁模型请参见 docs/security.md。

开发

pnpm typecheck
pnpm test
pnpm check

Host 插件是 src/ 中的 TypeScript。浏览器端则有意使用 lib/client.js 中的纯 JavaScript，以匹配外部 DSH Client Plugin 加载器格式，并避免依赖仅限 monorepo 的前端构建工具。

许可证

MIT