Skip to content

托管审查、Issue 与 Actions ​

托管代码评审是 worktree 的一等公民。DevAgent 会把 worktree 关联到它们的 pull request 或 merge request,在行内展示评审状态,并让你无需离开应用就能分诊 issue。

连接一个 provider ​

从 设置 → 集成 连接你的仓库所使用的 provider。GitHub 对 Actions 和 issue 的支持最深入;GitLab 的 merge request 和 issue 使用相同的 worktree 评审流程。

Bitbucket Cloud 从同一个面板在应用内连接——用 Email & API token 或 Access token 点击 Connect。DevAgent 会在保存前验证凭据,并且可以从 Source Control 创建 pull request。Bitbucket Cloud 没有 draft PR,因此撰写器会隐藏 Draft 开关。ORCA_BITBUCKET_* 环境变量仍然优先于已保存的凭据。Azure DevOps 和 Gitea 的 pull request 会与 GitHub、GitLab、Bitbucket 一起出现在 worktree 侧边栏和 Checks 面板中——worktree 创建流程会在推送前检查它们是否有远程冲突。

评审 ​

  • 一旦 worktree 被推送,就可以从 Source Control 面板打开托管评审——在创建之前确认 base 分支、标题、描述和 draft 状态。
  • 在你创建或打开托管评审时,Source Control 会在分支上下文行中保持当前分支可见,因此 Create PR 操作永远不会替换掉分支标签。
  • 已关联的评审会带着状态出现在侧边栏里,让你能分辨该分支是仍然打开、已合并还是已关闭。
  • 当 DevAgent 拥有已关联 PR / MR 的 URL 时,分支上下文行会显示一个紧凑的 Open review page in browser 链接——一键即可跳转到 GitHub、GitLab、Bitbucket、Azure DevOps 或 Gitea 上的评审,而无需打开内部的 PR 视图。
  • 对于 GitHub pull request,可使用侧边栏中的 PR 操作菜单来复制评审链接、关闭评审,或在确认状态变更后重新打开它。
  • GitHub 的 check、review 和评论会在一个 PR 标签页 中行内打开;GitLab 的 merge request 和 issue 在同一个评审界面中打开。
  • 对于 GitLab 流水线,Checks 侧边面板会包含 bridge 和 child 流水线的 job(而不仅是顶层 job)。展开某个 job 会在可用时加载该 job 的 trace(日志)——与 GitHub check 详情打开的位置相同——因此失败的 job 不会沦为一个“无行内详情”的死胡同占位符。
  • 在 Checks 面板中,你可以回复评审线程中的任意评论,而不仅是根评论。
  • GitHub 的 PR 会话评论和行内评审线程评论都有一个表情反应选择器,与 GitHub 的八种反应一致(👍 👎 😄 😕 ❤️ 🎉 🚀 👀)。已有的表情标签是可切换的。GitLab 评论保持不变。
  • 分组后的 PR 评论区块按最新在前排序,这样一条新回复会把它所在的线程顶到最上面。Timeline 标签页 则保持最旧在前。
  • 当某个 GitHub pull request 有失败的 check 时,可以从 PR 视图使用 Fix broken checks,把失败的 check 名称和链接交给 agent。

自动合并 ​

对于打开的 GitHub PR,PR 视图的合并按钮会提供 Enable auto-merge,让 GitHub 在其各项要求(check、必需的评审)通过后自动合并该分支。合并方式遵循仓库的默认设置,是 Squash and merge、Create merge commit 或 Rebase and merge 之一——仓库不允许的方式不会显示。可以从同一个控件使用 Disable auto-merge 来取消一个待生效的自动合并。当 base 分支使用 GitHub 的 merge queue 时,同一个控件会显示为 Merge when ready,并将该 PR 加入队列。对于 GitHub 报告为 draft、closed、conflicting 或 unstable 的 PR,以及不允许自动合并的仓库,自动合并控件会被隐藏——在这些情况下你只会看到手动合并操作。

堆叠式 pull request ​

当你创建的 GitHub pull request,其所选的 base 上已经有一个打开的 PR 时,撰写器会提供 Stack this PR above #N。勾选它会创建一个 GitHub Stack(或扩展父级已有的 stack),并把提交标签改为 Create PR in stack(或 Create draft PR in stack / Push & Create PR in stack)。一个小预览会显示父 PR 和新分支。该选项仅限 GitHub,且只在执行主机支持堆叠创建时才出现。GitLab 的 merge request 和 Bitbucket 的 pull request 仍为单 PR 创建。

当 GitHub 把一个 pull request 登记为某个 stack 的一部分时,PR 侧边栏会显示一个可折叠的 Stack #N 图:你在 stack 中的位置、stack 大小以及 stack 的 base 分支。展开它可以看到按顺序排列的各层及其状态(open、draft、check pending/failed、需要评审、conflicts、merged、closed)。点击某一层即可在 DevAgent 中打开那个 PR。

stack 感知的合并会把单 PR 的合并标签替换为 Merge through #N · M PRs(当仓库使用 merge queue 时则为 Queue through #N · M PRs)。该操作会覆盖当前 PR 以及 stack 中它下面的每一个 PR。当 stack 元数据完整时,确认框会列出所包含的编号。原子式 stack 合并采取失败即中止(fail closed)策略——如果任何一层无法合并,则全部都不合并。没有 GitHub 登记 stack 元数据的普通依赖式 PR 链,仍保持常规的单 PR 合并流程。GitLab 的 merge request 不受影响。

Issue ​

issue 抽屉让你可以在 DevAgent 内部浏览、筛选和编辑 GitHub 与 GitLab 的 issue。从一个 GitHub issue 或 PR 创建 worktree 会打开交互式的 workspace 撰写器(而不是无声的后台创建),这样 issue-command 自动化、SSH 目标和文件夹 workspace 就与其他创建路径一样工作。撰写器会预填任务名并关联该 issue,从而让评审始终附着在任务上。

对于 GitHub issue,详情对话框有一个 Activity 区块,把评论与时间线事件穿插在一起——分派、提及、交叉引用、状态变更以及项目列移动——这样你无需离开 DevAgent 就能看到完整的历史。

使用 workspace 侧边栏中的“已关联 issue”菜单,无需打开抽屉即可复制一个 issue 链接。

对于 GitLab 仓库,抽屉会列出所选项目中打开的 issue,并可以把列表收窄到分派给你的 issue。

Actions ​

失败的 GitHub Actions check 会作为一个红色小标签出现在 worktree 上。点击进去可以行内查看失败 job 的日志。

任务(Tasks) ​

DevAgent 在 Tasks 侧边栏条目下提供了一个完整的 GitHub Projects 视图——跨多个仓库浏览项目卡片、按来源仓库筛选、查看 draft pull request 状态,并从任意卡片创建 worktree。

疑难解答 ​

如果 PR 状态、check 或 Tasks 无法刷新——限流、gh 认证、权限或网络问题——请参阅 GitHub 错误疑难解答。

下一步 ​

DevAgent 桌面客户端文档