文档

连接您的代码

关联一个 GitHub 或 GitLab 代码库,以便 Coroid 能从中读取内容并针对其创建拉取请求。

Coroid 在执行任何操作前都需要访问代码库。你只需在组织级别配置一次源代码管理提供商,随后即可将单个代码库关联到对应项目。

连接配置在设置 → 连接 → 源代码管理(/settings/connections/source-control).

支持的提供商

提供商连接方式可用性
GitHub安装 GitHub 应用,或使用个人访问令牌全面可用
GitLab个人访问令牌私有预览版

GitHub:应用安装或令牌

对于 GitHub,安装 Coroid GitHub 应用是更优选择。该应用按代码库而非用户授予权限,即便初始配置人员离职也能正常运行,且无需轮询即可让 Coroid 接收 Webhook 事件。

如果应用安装需要管理员审批而你没有相应权限,可选择使用个人访问令牌。

要安装该应用,请前往设置 → 连接 → 源代码管理,选择GitHub,然后按照安装流程操作。GitHub 会询问你授予哪些代码库的访问权限;后续也可从 GitHub 的设置中修改此配置。

通过个人访问令牌建立连接

先在提供商处创建令牌,然后将其粘贴到设置 → 连接 → 源代码管理.

该令牌需具备读取代码库内容、创建分支及拉取请求的权限。在 GitHub 中,传统令牌需具备repo权限;在 GitLab 中则需具备api.

令牌在存储前会经过加密处理,API 不会返回令牌内容,保存后界面中也不会再显示。令牌也不会包含在设置导出包中——导出的包中仅含占位符,导入到其他位置时需重新输入密钥。

将代码库关联到项目

连接配置仅让代码库可被访问;真正供 Coroid 运作的是项目。可在项目 → 新建中创建项目,选定已连接的代码库后,Coroid 会对代码库进行首次扫描,以识别所用语言、构建命令及测试命令。

正是这份首次分析结果能让智能体构建并测试你的项目,因此值得核对结果。若分析有误,可在项目设置中修正。

Coroid 的工作分支是哪一个

Coroid 会从默认分支派生出新分支,并针对该分支创建拉取请求。若需合并到其他分支而非main.

验证连接是否正常

当代码库出现在项目创建列表中且项目的首次分析完成后,说明连接正常。若预期的代码库未显示,常见原因包括:

  • 已安装 GitHub 应用,但未授予其对该特定代码库的访问权限
  • 令牌的权限范围过窄,无法列出私有代码库
  • 代码库所属的组织与已配置的组织不一致

下一步

任务如何转化为 pull request——描述完工作内容后会发生什么。