Import from Git V2：管理 GitHub 连接与仓库访问范围

1. Connection Management 是做什么的

Connection Management 是 V2 的访问控制面板。

您可以在这里：

• 连接 GitHub 账号
• 查看每个账号的当前状态
• 按 GitHub App installation 管理仓库访问范围
• 在 GitHub 侧变更后刷新仓库范围

2. 理解“两阶段访问模型”

V2 不是“贴一个凭证就结束”的流程。

要让一个仓库真正可导入，下面两件事必须同时成立：

1. GitHub 账号已经在 Testany 中连接成功。
2. Testany Git Connector 已经在仓库所属 owner 上获得仓库访问权限。

这就是为什么您有时已经能在 Testany 里看到 GitHub 账号卡片，但向导里仍然看不到任何仓库。

3. 如何连接 GitHub 账号

连接新账号的步骤如下：

1. 打开 Connection Management
2. 点击 Connect GitHub 或 Add New Account
3. 完成 GitHub 授权弹窗

授权成功后，Testany 会：

• 新建一条连接
• 或者如果该 GitHub 账号已经存在，则复用现有连接

4. installation 和仓库范围怎么理解

一个已连接的 GitHub 账号，可能会对应多个仓库 owner，例如：

• 您自己的个人账号
• 一个或多个 GitHub 组织

在 Testany 中，它们会显示成多个 installation binding，每个 binding 都有自己独立的仓库访问范围。

界面会显示这类信息：

• installation owner
• 已选仓库数
• 当前可导入仓库数
• 最近验证时间

5. 各种状态分别是什么意思

6. 主要操作按钮该怎么用

6.1 Manage Repository Access

Manage Repository Access 会把您带到当前 owner 对应的 GitHub 入口。

以下场景都应该用它：

• 这个 owner 还没有安装 App
• App 已安装，但目标仓库没有被选进访问范围
• 您想检查当前到底开放了哪些仓库

6.2 Refresh GitHub App Scope

当您已经在 GitHub 里改完仓库访问范围后，需要回到 Testany 点击 Refresh GitHub App Scope。

这一步会让 Testany 重新构建它所使用的范围快照。

如果省略这一步，Testany 可能仍然停留在旧快照上。

6.3 Reconnect GitHub Account

当账号授权过期，或者 Testany 提示需要重新授权时，请使用 Reconnect GitHub Account。

7. 个人账号 owner 和组织 owner 的区别

目标仓库属于谁，会直接决定操作方式：

个人账号

• 该 GitHub 账号的持有者通常可以自己管理 App 访问范围

组织

• 目标仓库加入访问范围通常有两条途径：
• GitHub 组织管理员在组织 installation 中调整已选仓库
• 目标仓库管理员从仓库侧把该仓库加入访问范围

8. 为什么仓库还是看不到

如果仓库下拉框仍然为空，请按以下顺序排查：

1. 连接的是不是正确的 GitHub 账号
2. 在向导里选的是不是正确的 installation
3. 目标仓库是否已被加入这个 installation 的 GitHub App 范围
4. GitHub 侧改动后，是否已经执行 Refresh GitHub App Scope
5. 当前连接状态是否不是 Reconnect Required

9. 相关文档

连接就绪后，继续阅读：

• Import from Git V2：连接 GitHub 并创建导入
• Import from Git V2：维护 Sync Link 导入
• Import from Git V2：维护 Managed Import 导入