开发语言
- 后端：Java（Spring Boot 3 + MyBatis-Plus + Sa-Token）
- 前端：TypeScript / Vue 3（Vite + Arco Design Vue）
- 其他：MySQL 8.0、Playwright、MinIO、Docker Compose
项目文档地址
项目首页地址
- 在线演示：https://mokatest.cn （账号
mokatest/mokatest） - GitHub： GitHub - Jinglong233/MokaTest: MokaTest测试平台 · GitHub
- Gitee（国内镜像）：https://gitee.com/Jinglong233/MokaTest
摘要
MokaTest 是面向测试团队的一站式自动化测试平台，覆盖从需求到报告的完整测试流程：质量管理（需求池/BUG 池/测试用例/血缘追踪）、API 测试（调试、断言、Mock、数据模板）、UI 自动化（可视化编排、元素库、断点调试、AI 定位自愈）、测试计划与报告，以及团队/项目/成员三级权限协作。Docker Compose 一键部署，BSL 1.1 协议，企业内网自用免费。
详细介绍内容
这是什么
MokaTest 是一个面向测试团队的一站式自动化测试平台，把「质量管理 + API 测试 + UI 自动化 + 测试计划 + 团队协作」整合在同一个系统里，覆盖从需求录入到测试报告产出的完整测试流程。测试同学不需要在禅道、Postman、Selenium IDE、Jenkins 之间来回切换，一个平台即可闭环。
核心功能
1. 质量管理
- 需求池：支持 Epic/Story 层级、优先级、状态流转（草稿→评审→开发→测试→上线）
- BUG 池：严重程度/优先级/环境/重现概率全维度管理，支持评论与操作日志
- 测试用例：文件夹树管理、步骤化编写、与自动化用例双向绑定
- 血缘追踪：需求 → 用例 → BUG 的思维导图式关系图，一键看清覆盖率和质量风险
2. API 测试
- 接口调试：Header/Query/Body 全参数化，支持断言、提取、前后置脚本
- 参数级 Mock：可视化配置生成规则（手机号/姓名/UUID/枚举等 30+ 种），无需手写表达式
- 数据模板：可复用的结构化数据生成器，支持批量生成 1000 条并导出 JSON/CSV/Excel
- 响应定义：按结构定义自动校验响应（类型/必填/枚举/嵌套），Mock 响应自动跟随
- 多环境：环境/全局变量集中管理，一键切换
3. UI 自动化
- 场景可视化编排：工作流画布 + 步骤列表双视图，支持条件/循环/iframe 等复杂步骤
- 浏览器录制插件：录制操作一键导入生成场景（关注公众号「MokaTest」回复「MokaTest录制插件」获取）
- 元素库：页面元素集中管理，多场景复用
- 调试器：支持暂停/继续、断点、「执行到此步骤」，暂停期间修改步骤可热加载续跑
- AI 定位自愈：元素定位失败时，AI 分析页面快照自动推荐新定位器，真实页面验证通过后一键写回元素库
4. 测试计划与报告
- 手动/定时触发，支持并发执行
- Webhook 通知、多维度测试报告
5. 团队协作
- 团队/项目/成员三级权限隔离，角色权限灵活配置
- 站内信通知：@提及、状态变更、指派等 11 个场景，项目级可配置
- 操作日志/登录日志完整审计
技术栈
| 层级 | 技术 |
|---|---|
| 前端 | Vue 3 + Vite + Arco Design Vue + TypeScript |
| 后端 | Spring Boot 3 + MyBatis-Plus + Sa-Token |
| 数据库 | MySQL 8.0 |
| 其他 | Playwright（UI 自动化）、MinIO（文件存储）、Docker Compose |
部署方式
Docker Compose 一键部署，无需本机安装任何依赖：
git clone https://github.com/Jinglong233/MokaTest.git
cp .env.example .env
docker compose up -d --build
启动后访问 http://<服务器IP>，默认账号 admin / abc123。
授权说明
- 学习、测试、评估、非生产环境使用：完全免费
- 公司内网部署、内部业务自用（含生产环境）：免费，无需授权
- 作为托管/云服务提供给第三方、转售等用途需商业授权
- 每个版本发布满 4 年后自动转为 Apache License 2.0
项目状态
项目目前处于早期阶段（v0.x），由个人独立开发维护，功能持续迭代中。欢迎通过 Issue 反馈问题，也欢迎 Star 支持。
- 在线体验：https://mokatest.cn （账号
mokatest/mokatest） - 使用文档： MokaTest
- GitHub： GitHub - Jinglong233/MokaTest: MokaTest测试平台 · GitHub
- Gitee：https://gitee.com/Jinglong233/MokaTest