安装¶

这个工具是一个 Python 命令：specivo-jira-migration，需要 Python 3.12 或更高版本。它没有发布到 PyPI，请从 GitHub 上带标签的发布版本安装。

从发布版本安装¶

在 发布页面 选择需要的版本，然后用 uv 或 pipx 安装：

uv tool install git+https://github.com/specivo/[email protected]
# or
pipx install git+https://github.com/specivo/[email protected]

把 vX.Y.Z 换成发布标签。两条命令都会在独立的隔离环境中安装 specivo-jira-migration，并把它加入你的 PATH。

从源码检出安装¶

git clone https://github.com/specivo/jira-migration-tool.git
cd jira-migration-tool
uv sync
uv run specivo-jira-migration --help

工具与 Specivo 迁移 SDK 是一起开发的，因此源码检出会从旁边的目录路径安装 SDK；发布版本则把 SDK 固定到某个标签。除非你要修改工具本身，否则请使用发布版本。

检查安装¶

specivo-jira-migration --version
specivo-jira-migration --help

--help 会列出全部选项，各选项的说明见 导出页面。

在哪里运行¶

把工具运行在一台能访问 Jira、且有足够空间存放导入包的机器上。如果站点有大量大附件，所需磁盘空间可能相当大：每个不同的文件会在导入包的 files/ 文件夹中存一份，而且工具运行期间还会在输出旁边保存工作状态（见 运行中断时）。导出完成后，把导入包复制到运行 Specivo 的机器上，或者挂载到 Specivo 容器中。