XMind2TestCase 是一个基于 FastAPI 构建的现代化测试用例管理工具。它能将 XMind 思维导图智能转换为测试用例,支持在线管理、编辑、预览,并可导出为 TestLink、ZenTao (禅道) 和 XMind 格式。
- XMind 解析: 支持 XMind 8 和 XMind Zen 格式。
- 自动识别: 智能识别测试用例优先级、步骤和预期结果。
- 即时预览: 解析后立即预览测试用例详情。
- 项目管理: 创建及管理多个测试项目,支持按项目归档。
- 在线编辑:
- 支持直接在浏览器中编辑测试用例标题、步骤和预期结果。
- 即时备注: 预览页新增“备注”列,支持在线记录测试执行情况。
- 便捷重命名: 点击文件名即可快速重命名。
- 智能保存:
- 自动保存: 编辑内容(包括备注、结果、步骤)后自动异步保存,无需手动点击。
- 防丢失: 刷新页面或复制结果前确保数据已持久化。
- 结果记录:
- 执行状态: 支持标记用例执行结果(通过、失败、阻塞、跳过)。
- 复制汇总: 一键复制格式化的执行结果汇总,自动包含最新的执行状态和备注信息。
- Excel/CSV: 完美适配禅道 (ZenTao) 导入格式。
- XML: 支持 TestLink 用例导入。
- XMind: 支持将编辑后的用例导回为 XMind 格式,保持层级结构。
- 一键打包: 支持一键下载所有格式的压缩包 (ZIP)。
- Glassmorphism: 采用现代化的磨砂玻璃风格设计。
- 响应式设计: 完美适配桌面和移动端设备。
- 交互优化:
- 实时保存编辑内容,并在按钮上给出可视化反馈。
- 智能的 Toast 提示。
- 平滑的过渡动画。
- 后端: FastAPI + Python 3.13 + SQLite
- 前端: HTML5 + Vanilla JS + CSS3 (Modern Flexbox/Grid)
- 依赖管理: uv (极速 Python 包管理器)
- 部署: Uvicorn (ASGI 服务器)
确保已安装 Python 3.13+ 和 uv (强烈推荐)。
# 如果未安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh# 初始化项目(创建目录、同步依赖、初始化数据库)
bash run.sh init# 开发模式(带自动重载)
bash run.sh dev
# 生产模式(多 Worker 运行)
bash run.sh prod
# 后台运行
bash run.sh start服务默认启动在 http://127.0.0.1:8000。
项目提供了一个全功能的脚本 run.sh 来简化操作:
| 命令 | 说明 |
|---|---|
init |
初始化项目环境,安装依赖及配置数据库 |
dev |
启动开发服务器(代码热更新) |
prod |
在当前终端启动生产级服务器 |
start |
后台启动生产服务器 (使用 nohup) |
stop |
停止后台运行的服务 |
restart |
重启后台服务 |
status |
查看服务运行状态及 PID |
clean |
清理 Python 编译缓存 (__pycache__) |
test |
运行项目测试用例 |
db |
启动交互式数据库管理工具 |
xmind2testcase/
├── app/
│ ├── api/ # API 路由 (FastAPI Routers)
│ ├── core/ # 核心配置 (Config, Database)
│ ├── lib/ # 核心转换库 (XMind解析逻辑)
│ ├── services/ # 业务逻辑服务
│ ├── static/ # 静态资源 (CSS, JS, Images)
│ └── templates/ # HTML 模板 (Jinja2)
├── docs/ # 项目文档
├── logs/ # 日志文件目录
├── uploads/ # 文件上传目录
├── data.db3 # SQLite 数据库
├── run.sh # 生命周期管理脚本
├── pyproject.toml # 依赖及项目配置
└── README.md # 说明文档
请遵循简单的编写规范:
- 中心主题: 即测试集名称(或产品名称)。
- 分支节点: 模块或功能名称(支持多级)。
- 用例节点: 必须标记优先级(Priority 1/2/3)才会被识别为测试用例。
- 子节点: 自动识别为"测试步骤"。
- 孙节点: 自动识别为"预期结果"。
访问右上角的 ⚙️ 系统配置:
- 项目管理: 添加或管理项目(项目删除需在此处进行)。
- 标签管理: 自定义测试阶段和用例类型。
- 功能开关: 开启/关闭禅道或 TestLink 导出按钮。
- 上传: 在首页或项目详情页上传 XMind 文件。
- 预览与执行:
- 在预览页直接标记测试结果(Pass/Fail)。
- 在“备注”列记录问题或说明。
- 系统会自动保存您的所有更改。
- 点击“复制执行结果”可生成汇总报告。
欢迎提交 Issue 或 Pull Request 来改进这个项目!
Apache License 2.0