跳转到内容

拉取请求与CI

Pipelines → Connect GitHub或Connect GitLab会通过浏览器登录:ffgit显示一个代码,打开托管平台的页面并等待你批准。也可以使用个人访问令牌。GitLab连接默认请求api权限范围,以便作业操作、审查和合并都能正常使用;GitLab登录会自动续期。

托管平台账号配置按工作空间保存;其令牌以加密文件形式保存在本地。工作空间和项目可以选择各自使用的配置,配置还可以携带SSH密钥,或已保存的、用于通过HTTPS访问Git的令牌。

**Clone repository…**可以列出已验证的GitHub或GitLab账号的仓库,每页30个,可按名称搜索,并根据你选中的仓库填入URL和文件夹。

  • 项目的拉取请求(GitHub)和合并请求(GitLab)列表。
  • 差异和图片,使用与本地改动相同的图片查看器。
  • 行内评论草稿、讨论和回复;批准或请求修改。
  • 在文件上标记Viewed(已查看)会将其折叠,标题栏会统计已查看的文件数。如果之后的推送改动了某个文件,它会显示Changed since viewed。在GitHub上,这就是GitHub自己的标记,因此会与github.com双向同步;在GitLab上,ffgit会将其与审查草稿一起保存。
  • Merge只提供项目允许的合并方式;当提交看起来像wip或fix时会建议使用squash,并会请求确认。

草稿会随窗口一起恢复;针对过期差异和不确定写入的防护机制可避免同一审查被发送两次。

仓库操作中,或对话的请求卡片上的Create pull / merge request…,会从已检出的分支打开一个GitHub拉取请求或GitLab合并请求:源仓库和目标仓库(默认为复刻的upstream)、基础分支、它带来的内容、可编辑的标题和描述,以及Open as a draft。你的智能体可以根据分支的改动起草标题和描述。在发送任何内容之前,都会先确认请求的去向。

推送仍在Git操作中进行:托管平台上的分支必须是你审查过的那个提交。如果该分支已有打开的请求,会打开它而不是新建一个;请求会与工作树及其对话关联。

仓库操作中的**Start chat from issue…**会按编号或链接读取GitHub或GitLab的议题,显示你的账号在那里可以做什么,并把议题作为任务放入New chat的消息框。在你发送之前什么都不会启动,也不会向托管平台写入任何内容。

在打开的请求上点击Review guide…,你的智能体(在Coding agents设置中选择的Claude Code或Codex)会在临时检出中阅读该请求,并按阅读顺序写出导览:只有维护者才能决定的地方标为Look closely,机械性改动放在最后,每个文件都会被提到。临时检出是系统临时文件夹中的分离工作树,指南写完后即被删除。指南中的每个文件都可在审查中打开,在某一站点点击*Comment…*会把内容加入审查的总结草稿,指南本身会与审查草稿一起保存。

Pipelines显示CI运行,可按工作流、事件、触发者、来源和名称筛选。当主机名能表明托管平台时,ffgit会替你选好。

  • 运行的标题栏中有一条阶段条,每个阶段都标出其作业最近一次尝试的汇总结果;点击即可在Jobs中打开该阶段。
  • 作业按流水线中的顺序按阶段分组。All | Failed N只列出最近一次尝试失败的作业。在允许失败的情况下通过的流水线显示为Warning。
  • 作业日志会保留作业的颜色,按GitLab的section和GitHub的group折叠,并支持搜索。
  • 可以运行、重试或停止作业,也可以重试失败运行中失败的作业。正在运行的流水线可以从其标题栏停止;▶可以在某个引用上带变量运行新的GitLab流水线,或带输入运行声明了workflow_dispatch的GitHub工作流。每次写入操作都会先显示项目、引用、每个值以及所需的权限。
  • 窗口可见时,正在运行的流水线会原地刷新。
  • 拉取请求或合并请求会把合并所需的检查与head的CI分开显示:GitHub的规则集和分支保护,GitLab的Pipelines must succeed和状态检查。
  • 下载制品ZIP,以字节为单位显示进度;下载内容会经过校验。
  • 预览制品中的文件和图片、保存制品,或将其与之前保存的制品ZIP进行对比。
  • 黄金测试失败会被归组,并提供Expected/Actual、隔离差异和遮罩差异视图——参见图片审查。