# 使用思维导图规划 Jira 版本

查看当前 Jira 项目的未发布版本，将已分配的工作项添加到思维导图，并通过共享的发布操作指南协调部署工作。

## 开始之前

你需要：

- 查看 Jira 项目及其工作项的权限。
- 如果要将发布工作项添加到思维导图，需要拥有该思维导图的编辑权限。
- 如果希望工作项显示在某个版本下，需要先在 Jira 中为其分配 **修复版本**。

版本面板使用当前 Jira 项目。请先在 Jira 中创建版本并分配 **修复版本**，然后再使用 Mind Map Studio 进行规划。

## 打开 Jira 版本发布

1. 在思维导图标题栏中选择 **Jira 版本发布**。
2. 等待未发布的 Jira 版本加载完成。
3. 找到要规划的版本。

每张版本卡片都会显示 **关联的工作项**，即 Jira 中已经分配给该版本的工作项。卡片还提供 **发布操作指南与备注**，用于记录由 Mind Map Studio 单独保存的规划内容。

下方卡片显示通过 Jira 的 **修复版本** 字段分配工作项后的未发布版本。

![包含一个已分配 Jira 工作项的未发布 3.0.0 版本。](/api/media/mindmap-media/zh-cn/jira/release-planning/release-overview-populated-dark.webp)

## 了解空版本

即使尚未分配任何 Jira 工作项，未发布版本仍然可以用于规划。此时，版本会显示 **此版本未分配任何 Jira 工作项**。你仍可添加标签并开始编写部署操作指南。

以下截图特意展示了真实的空状态。并非加载失败：版本 3.0.0 只是还没有分配 Jira 工作项、Mind Map Studio 标签或部署步骤。

![未发布的 Jira 版本卡片，显示 3.0.0 版本没有已分配的工作项。](/api/media/mindmap-media/zh-cn/jira/release-planning/release-overview-empty-dark.webp)

![空的发布操作指南，没有已分配的 Jira 工作项、标签或部署步骤。](/api/media/mindmap-media/zh-cn/jira/release-planning/release-runbook-empty-dark.webp)

## 将已分配的工作项添加到思维导图

1. 选择要在思维导图中作为该工作项父级的构思。
2. 在 **Jira 版本发布** 下找到 Jira 版本。
3. 在 **关联的工作项** 下找到该工作项。
4. 将指针悬停在工作项上，然后选择加号按钮。

Mind Map Studio 会添加一张包含 Jira 键和摘要的子卡片。你也可以将工作项从版本面板拖到画布上，放在应成为其父级的构思附近。

添加卡片只会更改思维导图。此操作不会分配或更改工作项的 **修复版本**，不会编辑工作项，也不会创建 Jira 工作项链接。

## 刷新版本列表

在 Jira 中更改版本或工作项分配后，选择面板顶部的 **刷新 Jira 版本发布**。

刷新操作会从 Jira Cloud 获取当前未发布版本及其已分配工作项。打开 **发布操作指南与备注** 时，会加载为该项目和版本保存的 Mind Map Studio 操作指南。刷新不会更改 Jira 中的任何内容。

如果工作项仍未出现，请在 Jira 中将其打开，并确认 **修复版本** 字段包含当前项目中的预期版本。

## 创建发布操作指南

1. 在 **Jira 版本发布** 下找到 Jira 版本。
2. 选择 **发布操作指南与备注**。
3. 输入部署步骤，然后按 **Enter** 或选择添加按钮。
4. 按团队应完成的顺序添加其余步骤。

使用简短、以操作为导向的步骤，例如“确认生产环境备份”“部署应用”和“运行冒烟测试”。操作指南属于此 Jira 项目和版本，因此处理同一版本的其他人员可以遵循相同顺序。

## 整理并完成操作指南

- 使用复选框将步骤标记为已完成。
- 使用 **上移步骤** 或 **下移步骤** 更改部署顺序。
- 使用 **删除步骤** 移除不再需要的步骤。
- 通过已完成步骤数量和进度条查看操作指南的完成程度。

此进度仅描述 Mind Map Studio 操作指南中的步骤，不会更改 Jira 版本状态或任何 Jira 工作项状态。

## 添加操作指南标签

使用 **添加标签** 创建简短标记，例如 `backend`、`mobile` 或 `approval`。编写部署步骤时，也可以输入 `/` 来创建或插入标签。

这些是用于整理发布操作指南的 Mind Map Studio 标签。它们不是 Jira 标签，也不会写入关联的 Jira 工作项。

## 检查结果

满足以下条件时，版本计划即准备就绪：

- 预期的未发布 Jira 版本显示在 **Jira 版本发布** 中。
- 其 **关联的工作项** 与 Jira 中已分配给该版本的工作项一致。
- 添加的工作项在思维导图中显示为已链接 Jira 的卡片。
- 操作指南中的步骤按预期顺序排列。
- 将步骤标记为已完成时，已完成步骤数量随之变化。

## 了解哪些内容保留在 Jira 和 Mind Map Studio 中

- **Jira 版本发布** 不会创建或编辑 Jira 版本。
- 它不会分配、移除或更改工作项的 **修复版本**。
- 它不会显示 Jira 版本发布日期。
- 发布操作指南由 Mind Map Studio 保存，不会复制到 Jira 版本说明中。
- 操作指南标签不是 Jira 标签。
- 将关联工作项添加到思维导图不会编辑 Jira 工作项。

需要创建版本、设置发布日期、更改发布状态、编辑说明或为版本分配工作项时，请使用 Jira。准备围绕这些 Jira 变更进行可视化规划时，再返回 Mind Map Studio 并刷新列表。

## 解决问题

### 版本未显示

面板显示当前 Jira 项目的未发布版本。请确认你位于正确的项目中，检查该版本尚未发布，然后选择 **刷新 Jira 版本发布**。

### 已分配的工作项未显示

在 Jira 中打开该工作项并检查其 **修复版本** 字段。Jira 保存分配后，返回 Mind Map Studio 并刷新版本列表。

### 添加按钮不可用

请先在思维导图中选择可编辑的构思。所选构思将成为新卡片的父级。

## 相关指南

- [将现有 Jira 工作项添加到思维导图](./add-existing-issues.md)
- [了解 Jira 中会发生哪些更改](./what-changes-in-jira.md)
- [创建和编辑思维导图](../building-and-editing.md)