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——描述完工作内容后会发生什么。