Skip to content

Oratorio ​

Oratorio 是 DotCraft 内置的项目看板。本地任务、GitHub 的 issue 与 pull request、GitLab 的 issue 与 merge request 都汇总到同一块 Board 上。你在这里把工作交给 Agent、跟踪运行、审阅结果,批准之后直接交付回代码托管平台,全程不用离开 DotCraft Desktop。

DotCraft Desktop 中的 Oratorio 看板

从一个本地任务开始 ​

不接任何代码托管平台也能先跑起来:

  1. 在 DotCraft Desktop 中把一个 Git 仓库打开为项目。
  2. 在侧边栏选择 Oratorio。
  3. 选择 新建本地任务,填写要解决的问题,选择仓库与基础分支。
  4. 打开任务卡,在 Start Agent work 下选择一种运行方式。
  5. 在 Quick View 中跟踪运行,任务进入审阅状态后打开完整详情。

Agent 的工作发生在 Oratorio 单独创建的 Worktree 里,运行期间不会动你手上正在用的 checkout。从筛选任务到审阅、交付的完整流程见 Oratorio 工作流。

接入 GitHub 与 GitLab ​

在 Board 上选择 Connect GitHub 或 Connect GitLab,引导流程会带你从凭据一路走到首次同步。GitHub 用 GitHub App 接入,GitLab 用项目级 Token 接入。

Oratorio 默认不向代码托管平台写入任何内容,需要你显式启用。没有公网 Webhook endpoint 也不影响使用,手动同步和定时同步照常工作。项目与工作区的映射、Agent 执行策略和自动化都在配置 Oratorio里调整。

在会话中使用 Oratorio ​

把 Oratorio 接进会话,就能在对话里直接查看和推进任务。

  1. 安装 Oratorio,打开插件详情,选择 Connect 连接当前工作区。

    在插件详情中连接 Oratorio

  2. 新建一个会话,从第一条消息起就能用上 Oratorio。

插件详情中的 Disconnect 会把 Oratorio 从这个工作区的所有会话中移除。完整的连接与授权流程见应用连接。

本地运行与远程部署 ​

本地模式下,第一次打开 Oratorio 时 Desktop 会启动随包提供的 Oratorio Server,不需要额外安装。

需要远程部署时,把 Desktop 连接到 DotCraft Stack。Board 与任务操作完全一致,只是服务器管理设置在远程连接下是只读的。

相关文档 ​