托管平台和拉取请求
MyTwig 支持 GitHub、GitHub Enterprise Server、GitLab(gitlab.com 和自建)、Gitea 和 Forgejo(包括 Codeberg),以及 Bitbucket Cloud。
设置 → 账户列出 MyTwig 能用的所有账户,以及每个账户的令牌保存在哪里。
GitHub 和 GitHub Enterprise:点添加 GitHub 账户,登录 github.com 或你的服务器(输入主机名或 URL)。两种方式:
- 个人访问令牌。创建令牌…会打开对应页面,并带上 MyTwig 需要的权限(
repo、read:org、notifications、workflow)。MyTwig 会校验令牌并显示它属于谁。 - GitHub CLI。如果你运行过
gh auth login,MyTwig 会自动使用 gh 在各个主机上的账户。
MyTwig 也会使用 $GITHUB_TOKEN、$GH_TOKEN,以及 Git 凭据助手为 github.com 保存的令牌。
GitLab、Gitea、Forgejo、Bitbucket:在其他账户里用令牌登录(Bitbucket 用邮箱加 Atlassian API 令牌,或用户名加应用密码)。也会使用 $GITLAB_TOKEN。
在应用里登录的令牌保存在系统钥匙串里(macOS 的钥匙串、Windows 的凭据管理器、Linux 的 Secret Service),不会写入磁盘或日志。
有多个账户时,仓库优先使用所有者的账户,其次是所属组织成员的账户,再次是默认账户。资料菜单可以为某个仓库另选账户。
左侧面板里的拉取请求和议题
Section titled “左侧面板里的拉取请求和议题”左侧面板会列出仓库中打开的拉取请求(GitLab 叫合并请求)和议题。选中一个,详情面板会显示:创建者、分支和标签、描述,以及检出、创建分支、在浏览器中打开等按钮。它的最新提交会在提交图中选中。
有打开的拉取请求的分支,标签旁会显示拉取请求图标,颜色表示状态,悬停可以看到审查和 CI 情况。
创建拉取请求
Section titled “创建拉取请求”- 在提交图或左侧面板里,把你的分支拖到一个远程分支上。MyTwig 会先推送,再以该分支为目标打开创建拉取请求对话框。
- 或者从分支菜单、工作区面板的下一步建议,或命令面板里选创建拉取请求。
对话框会从仓库的拉取请求模板开始。设置了 AI 服务时,可以根据提交和差异生成标题和描述。
检出拉取请求
Section titled “检出拉取请求”拉取请求详情里的检出会抓取它并为它检出一个分支,来自分叉的拉取请求也可以。在菜单栏里,还可以把拉取请求检出到单独的工作树。
在应用里审查拉取请求
Section titled “在应用里审查拉取请求”审查拉取请求(目前支持 GitHub),从拉取请求菜单、分支菜单或命令面板打开,会显示在窗口中间:
- 每个改动的文件,与它离开目标分支时的状态比较;
- 审查讨论显示在对应行下方,可以回复、标记为已解决或重新打开;
- 点按任意一行的行号栏开始评论;
- 最后选择批准、请求修改或评论提交审查;准备好时也可以合并、压缩合并或变基合并。
设置 → Git 可以把提交说明里的文字变成链接,比如把 JIRA-\d+ 链到你的缺陷跟踪系统。${0} 是整个匹配,${1}… 是分组。GitHub 自己的 #123 链接无需设置。