文档

GitHub

将 GitHub 与 App 或个人访问令牌关联,了解二者分别授予的权限。

GitHub 可通过 CoroidGitHub App个人访问令牌。可在设置 → 连接 → 源代码管理.

App 或令牌

优先选用 App。它按代码库而非用户授予权限,即便配置人员离职仍能正常运行,且无需轮询即可接收 Webhook 事件。

若安装 App 需要无法获取的组织管理员审批,则可使用令牌。

GitHub App个人访问令牌
访问范围按代码库用户可查看的所有内容
不受安装人员离职影响
Webhook 事件轮询
归属关系该 App令牌所有者

安装应用

在GitHub中选择设置 → 连接 → 源代码管理随后按照安装流程操作。GitHub会询问要授予权限的代码仓库,后续也可从GitHub自身的设置中修改该配置。

如果创建项目时未显示某代码仓库,几乎可以确定是该应用未被授予该仓库的访问权限,这是最常见的原因。

使用令牌

创建一个具备以下范围的经典令牌:repo或者创建一个细粒度令牌,赋予其对代码内容和拉取请求的读写权限,之后将其粘贴到源代码管理设置中。

令牌在存储时会加密,API绝不会返回令牌内容,也不会将其包含在设置导出数据中。

GitHub Issue

同一连接支持将Issue导入为工作任务。详情请参阅导入工作任务.

Coroid在您的代码仓库中的操作

  • 读取代码以理解并修改代码
  • 为每个任务创建独立分支
  • 推送该分支并向您的基准分支发起pull request

它绝不会向您的默认分支提交代码,也不会执行合并操作。您的分支保护规则、必填检查项及审核规则仍会正常生效。