Skip to Content
文档代码托管平台

代码托管平台

在应用里浏览、创建、审阅和合并拉取请求(PR)与合并请求(MR),支持四家平台:

平台说明
GitHub完整支持,含草稿、rebase 合并
GitLab完整支持,嵌套分组按 owner 路径处理
Gitea完整支持,含草稿、rebase 合并
Bitbucket Cloud支持,但不支持草稿与 rebase 合并

令牌

访问令牌按主机保存在系统凭据库(macOS 钥匙串 / Windows 凭据管理器 / Linux Secret Service),不写入设置文件,也不进日志。

在「设置 → Git → Forge 令牌」里为某个远端主机添加、替换或删除令牌。令牌被拒绝、权限不足或触发速率限制时,应用会给出对应的提示,而不是笼统的网络错误。

服务商默认按主机名推断,bitbucket.org 归到 Bitbucket Cloud;未知主机不会被猜测,而是提示不支持。自建实例可以在同一处按主机指定服务商。

列表

从 ⌘K 命令面板打开「拉取请求」面板,这一步会发起第一次网络请求。列表每次取 30 条,最多显示 100 条,底部会说明上限。

每条显示编号、标题、作者、源分支 → 目标分支、草稿标记与检查摘要(通过 / 失败 / 进行中)。检查查询失败时该条标为未知,不影响其他条目。

创建

从当前分支创建:

  • 目标默认是主机的默认分支;
  • 标题默认取最后一次提交的标题,可修改;
  • 草稿选项在 Bitbucket Cloud 上会隐藏,并说明该平台不支持。

仓库没有远程地址时不会进入创建流程,而是提示先添加远程。

详情

点开一条请求,看到:

  • 描述(超长会截断);
  • 提交列表(最多 100 条);
  • 检查项与浏览器链接;
  • 评审评论(最多 50 条)。

详情、提交、检查与评论在同一次请求里加载;某一部分失败只会加一条警告,不会让整个面板变成错误。

审阅

可以发表评论、批准或请求修改。

  • 评论与「请求修改」必须填写内容,长度上限 8000 字符;
  • 批准时内容可选;
  • GitHub 与 Gitea 走各自的 reviews API;GitLab 与 Bitbucket Cloud 发布评论加批准,并明确拒绝「请求修改」,而不是降级成别的动作;
  • 已关闭或已合并的请求在写入前就会被拒绝;
  • 请求只发送一次,失败不会自动重试。

审阅动作会离开本机并出现在服务端,确认框里会写清目标请求与动作。

合并

  • 合并方式:合并提交、压缩合并、变基合并;变基仅 GitHub 与 Gitea 支持;
  • 可以选择同时删除源分支;删除失败不会把合并判为失败;
  • 服务端报告有冲突时拒绝合并,并请你先解决;
  • 草稿、已关闭、已合并的请求不可合并;
  • 服务端不报告可合并状态时(例如 GitHub 返回空值),会允许你明确发起一次合并请求,且只发一次。

应用不会自动评论、批准或合并任何请求。每写一次都要你点一次。

最后更新于