Import from Git V1 与 V2

1. 概述

现在 Import from Git 会并行提供 V1 和 V2。

当您点击 Register Test Case → Import from Git 时，Testany 会先弹出版本选择框，让您决定使用哪一种导入方式。

Import from Git 版本选择

📝

Import from Git V1 不会下线。如果您所在团队已经建立了稳定的基于凭证的 Sync Link 流程，可以继续使用 V1。若您希望使用 GitHub 账号授权、仓库访问范围管理，以及 Managed Import 或新的同步生命周期，请选择 V2。

2. 什么时候选 V1，什么时候选 V2

项目	V1	V2
凭证模型	通过 Testany Secrets Service 保存 Git 凭证	通过 Git 平台账号授权
仓库访问方式	依赖已注册凭证	依赖已连接的 GitHub 账号 + GitHub App 仓库访问范围
当前支持的平台	GitHub、Bitbucket	仅 GitHub
更适合	已经在用 V1 的团队、偏凭证式流程的场景	希望采用 GitHub 原生授权和显式仓库范围控制的团队
后续维护方式	通过重新进入向导更新导入记录	通过导入记录详情页进行维护
导入模式	仅 `Sync Link`	`Sync Link` 和 `Managed Import`

3. V2 当前支持哪些平台

在当前版本中，Import from Git V2 只支持 GitHub。

界面里虽然会显示 GitLab、Bitbucket Cloud、Azure DevOps Services 的 Coming Soon / Request Access 入口，但它们暂时还不能实际导入。

4. 使用 V2 前，先了解这几件事

4.1 `Connection Management` 和 `Imports` 是两个独立区域

V2 页面被明确拆成两块：

Connection Management：连接 GitHub 账号、管理仓库访问范围
Imports：新建导入，或进入现有 Import History

4.2 连上 GitHub 账号，不等于仓库已经可导入

V2 使用的是两阶段访问模型：

在 Testany 中连接 GitHub 账号。
在仓库所属的个人账号或组织上，为 Testany Git Connector 授予访问权限。

如果第二步没有完成，您在 Testany 中可能已经能看到该 GitHub 账号，但仓库列表依然会是空的。

4.3 仓库可见范围是按 installation 管理的

在 V2 中，仓库可见性由 GitHub App installation 的访问范围决定，而不是由 PAT 或手工填写的仓库 URL 决定。

如果目标仓库属于 GitHub 组织，通常要先把目标仓库加入已选范围，Testany 才能看到它。这个动作既可以由 GitHub 组织管理员在组织 installation 中完成，也可以由目标仓库管理员在仓库侧完成。

4.4 V2 有两种导入模式

Sync Link

Testany 与 Git 文件建立同步关系
执行时直接从 Git 拉取脚本
在 Track Latest 下，代码总是跟随当前分支最新 commit

Managed Import

Testany 先把代码导入平台内部的 Mirror
执行时从 Mirror 拉取脚本
在 Track Latest 下，仍然需要手动 Sync 或 GitHub Webhook 来推进 Mirror

4.5 `Track Latest` 和 `Pinned Commit` 是两种不同的维护策略

Track Latest

跟随所选分支
适合希望导入记录持续跟进分支变化的场景
可以启用 Webhook

Pinned Commit

固定在某一个 commit
适合更强调可复现性的场景
不支持 Webhook 同步

4.6 代码更新和关系更新是两件事

在 V2 中，这两层能力被故意分开：

代码层更新：最新 commit、Mirror 刷新、手动 Sync、Webhook
关系层更新：Import Added Files、Mark Source Deleted

这是 V2 相对 V1 最重要的使用差异之一。新增文件和源端删除文件不会自动变成新的 Test Case 或自动删除已有 Test Case。

5. 推荐阅读顺序

如果您准备使用 V2，建议按以下顺序阅读：

如果您会继续使用 V1，请阅读：

Import from Git V1（基于凭证的 Sync Link）