测试用例转飞书兼容 XMind

测试用例转飞书兼容 XMind

概述

将 Utest-design（模式C）生成的六级 Markdown 测试用例文档转换为飞书项目可直接导入的四级 XMind 思维导图文件。

核心转换：六级 Markdown 层级 → 四级 XMind 节点层级

层级映射规则

源格式（六级 Markdown）

H1 # 文档标题
H2 ## 功能模块
H3 ### 功能测试点
H4 #### 验证点
H5 ##### 用例场景（核心单元）
H6 ###### 需求ID / 测试步骤 / 预期结果

目标格式（四级 XMind）

L0 根节点（用例集，导入时不读取）
└─ L1 用例标题（含优先级标签）
   └─ L2 前置条件（模块路径 + 需求ID）
      └─ L3 测试步骤
         └─ L4 预期结果

映射规则

源层级	目标层级	转换逻辑
H1 文档标题	L0 根节点	直接映射
H2 功能模块	合入 L2	作为前置条件路径的第一段
H3 功能测试点	合入 L2	作为前置条件路径的第二段
H4 验证点	合入 L2	作为前置条件路径的第三段
H5 用例场景	L1 用例标题	扁平化提升为用例节点，标题末尾追加优先级标签 [P0]
H6 优先级	合入 L1	追加到用例标题末尾 [P0/P1/P2]
H6 需求ID	合入 L2	追加到前置条件路径末尾 [需求ID: xxx]
H6 测试步骤	L3 步骤节点	每条步骤创建一个 L3 子节点
H6 预期结果	L4 预期节点	按序号挂载到对应 L3 步骤下

详细映射规则与模板说明见 references/xmind-structure.md

工作流程

Step 1：读取并解析 Markdown 文档

1a. 读取输入文件（testcases/*.md）

1b. 逐行解析六级 Markdown 结构，提取：

• 当前模块路径（H2 > H3 > H4）
• 用例标题（H5）
• 需求ID、优先级、测试步骤列表、预期结果列表（H6 下的列表项）

1c. 每个 H5 场景组装为一条完整用例记录

Step 2：确认项目名称与模块前缀

2a. 询问用户是否需要在用例标题前添加项目名称和模块名称前缀

2b. 如果需要，格式为：【项目名】【模块名】用例标题

• 项目名由用户指定
• 模块名自动从 H2 层级提取

2c. 如果用户不需要前缀，保持原始用例标题

Step 3：构建 XMind JSON 结构

3a. 创建根节点（L0），标题取自 H1

3b. 每条用例创建 L1 节点（含前缀的用例标题 + 优先级标签）

• 有优先级时格式：【项目名】【模块名】用例场景描述 [P0]
• 无优先级时省略标签

3c. 每条用例创建 L2 子节点：

{H2模块} > {H3测试点} > {H4验证点} [需求ID: {需求ID}]

3d. L2 下创建 L3 步骤节点，每条测试步骤对应一个

3e. L3 下创建 L4 预期节点，按索引一对一配对：

• 步骤 1 → 预期 1
• 步骤 2 → 预期 2
• 多余步骤无预期子节点
• 多余预期创建 (验证) 步骤节点挂载

Step 4：打包生成 .xmind 文件

4a. 将 JSON 结构写入 content.json

4b. 生成 metadata.json 和 manifest.json

4c. 使用 ZIP 压缩打包为 .xmind 文件

4d. 输出路径：与输入文件同目录，扩展名替换为 .xmind

转换脚本：直接使用 #[[file:converter.py]]，命令行或代码中调用均可。 脚本格式说明见 references/converter-script.md

Step 5：提示后续操作

5a. XMind 文件生成完成后，提示用户：

"XMind 文件已生成。如需将测试用例导入飞书项目，可使用 Ufeishu-sync skill（模式 B：导入测试用例）。"

输出规范

文件格式

• 输出格式：.xmind（ZIP 压缩包含 content.json、metadata.json、manifest.json）
• 输出路径：testcases/{原文件名}.xmind（去掉 .md 后缀）
• 编码：UTF-8

XMind 节点结构示例

数字人智课平台测试用例                              ← L0 根节点
├─【AI智课】【数字人形象与配音设置】形象类型切换 [P0] ← L1 用例标题（含优先级）
│  └─ 数字人形象与配音设置 > 数字人形象选择 > 形象类型切换 [需求ID: FR-001]  ← L2 前置条件
│     ├─ 进入数字人形象选择页面                      ← L3 步骤
│     │  └─ 显示数字人形象选择区域                   ← L4 预期
│     ├─ 点击"我的形象"选项卡                       ← L3 步骤
│     │  └─ 显示用户已保存的自定义形象列表            ← L4 预期
│     └─ 点击"系统形象"选项卡                       ← L3 步骤
│        └─ 显示系统内置的数字人形象库                ← L4 预期
├─【AI智课】【数字人形象与配音设置】系统形象库展示 [P1] ← L1 用例标题（含优先级）
│  └─ ...

质量检查

• 所有 H5 用例场景均已转换为 L1 节点（无遗漏）
• 每条用例的前置条件（L2）包含完整模块路径和需求ID
• 步骤与预期结果正确配对（L3-L4 一对一）
• 项目名称和模块名称前缀格式正确（如有）
• 优先级标签正确追加到用例标题末尾（如有优先级数据）
• 生成的 .xmind 文件可被 XMind 正常打开
• 文件编码为 UTF-8，中文内容无乱码
• 输出文件路径正确：testcases/{原文件名}.xmind

参考资源

• 转换脚本 — Python 转换脚本完整实现（#[[file:converter.py]]）
• XMind 层级结构规范 — 飞书兼容的四级节点结构说明
• 转换脚本使用说明 — 脚本调用方式与参数说明
• XMind 模板文件：Test-skills/xmind_template.xmind