代码托管平台
在应用里浏览、创建、审阅和合并拉取请求(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 返回空值),会允许你明确发起一次合并请求,且只发一次。
应用不会自动评论、批准或合并任何请求。每写一次都要你点一次。
最后更新于