
接口联调的工具链很容易越攒越散:调接口一个工具、写 Mock 一个服务、跑自动化测试又一个框架、压测和 CI 再各一套。Miyo 的卖点就是把这些收进一个本地优先的桌面工作台:请求调试、Mock、自动化测试、压测、协议调试和 CI 执行都在同一处,数据留在本地,安装包据项目说明只有 10 MB 左右。本篇讲清楚它到底覆盖了哪些环节,以及本地优先这个定位会带来哪些取舍。
GitHub 国内访问较慢,如打不开可多刷新几次
软件信息表
| 项目 | Miyo |
|---|---|
| 一句话定位 | 基于 Rust 与 Tauri 的本地优先 API 调试客户端 |
| 技术构成 | Rust、Tauri 2、Vue 3,桌面端用系统 WebView,不捆绑浏览器运行时 |
| 适用平台 | 跨平台桌面应用,具体系统版本以仓库发行说明为准 |
| 安装包体积 | 据项目说明约 10 MB,依赖目标系统的 WebView |
| 请求与协议 | HTTP 请求编辑、GraphQL、WebSocket、SSE,支持环境变量与多种授权方式 |
| 授权方式 | API Key、Basic、Bearer、多种 OAuth2 授权方式 |
| Mock 能力 | 本地 axum Mock 服务,按方法、路径、请求头和请求体匹配规则,支持模板变量与故障注入 |
| 测试与压测 | JSON 测试脚本、变量提取、断言、多用例运行,压测按并发数与请求总量分析 QPS 与延迟分位数 |
| 数据交换 | 支持 OpenAPI 3.x、OpenAPI 3.1、Swagger 2.0、Postman Collection v2.1 的导入或导出 |
| 代码生成 | cURL、JavaScript、Java、Go、Rust、Python、PHP 等多种语言客户端代码 |
| CI 执行 | miyo-cli,可在 CI 中运行 API 集合并生成 JUnit 输出 |
| 数据管理 | 本地数据目录可配置,支持 JSON 备份恢复,数据目录可用 MIYO_DATA_DIR 指定,修改后需重启生效 |
| 获取方式 | GitHub 开源项目 |
上手指南
- 先确认目标系统的 WebView 可用:Miyo 用系统 WebView 而不是自带浏览器内核,WebView 出问题会直接影响客户端表现,装之前先核对仓库的系统要求。
- 把现成的接口资产导进来:已有 OpenAPI、Swagger 或 Postman Collection 的,直接导入验证字段和示例是否完整,不要从零手写全部接口。
- 建环境并配好授权:开发、测试环境的域名抽成环境变量,Token 走 API Key、Bearer 或 OAuth2 配置,不要把真实凭证写进请求体示例里。
- 后端还没好时先用本地 Mock 顶上:按方法、路径、请求头和请求体写匹配规则,需要模拟超时或错误时用故障注入,别等后端联调才发现前端逻辑没法测。
- 把关键流程写成 JSON 测试脚本:提取上一步的变量、给下一步做断言,多用例一次跑完,回归时不用手动一个个点。
- 有余力再上压测:设好并发数与请求总量,看 QPS、延迟分位数和错误样本;但要注意,项目说明没有交代它适合的压测规模,结果只适合做基础负载判断,别当成正式压测报告。
- 需要进 CI 时接 miyo-cli:把 API 集合放进流水线跑,输出 JUnit 结果,失败用例能在 CI 报告里直接看到。
取舍与对比
结论先行:一个人或小团队想用一个轻量工作台打通调试、Mock、测试、压测和 CI,Miyo 很对路;但凡团队协作和治理是硬需求,就要先验证,别默认它能替代云端协作工具。
| 你的场景 | 建议 |
|---|---|
| 个人开发、日常接口联调 | 适合,调试、历史、响应分析都在一处,安装包也轻 |
| 后端未就绪,需要先行 Mock | 适合,本地 Mock 服务加故障注入,联调不用等后端 |
| 想把接口回归放进 CI | 适合,miyo-cli 加 JUnit 输出就是为这个准备的 |
| 已有大量 OpenAPI 或 Postman 资产 | 适合,导入导出覆盖主流格式,迁移成本低 |
| 团队依赖云端协作、集中权限管理 | 先验证,本地优先定位下这类能力需要单独核对,别直接上 |
| 需要大规模正式压测 | 只做基础判断,正式压测仍需专业压测工具校准结果 |
常见问题
为什么安装包能做到 10 MB 左右?据项目说明,因为它基于 Rust 与 Tauri 2,用系统 WebView 渲染界面,不捆绑一整套浏览器运行时。代价就是运行效果跟本机 WebView 绑定,换系统或 WebView 版本有差异时要先验证。
本地 Mock 服务能对外提供吗?Mock 服务和 loopback Agent 控制平面都属于本机能力,公开说明没有完整交代跨机器访问方式和网络暴露边界。启用前先审查监听范围和令牌保护,不要默认它可以安全地暴露给局域网甚至公网。
数据丢了怎么办?Miyo 提供 JSON 备份恢复,数据目录也可以自己指定。建议一开始就定好数据目录位置并定期导出 JSON 备份,升级前先用备份验证一次恢复流程,确认能恢复再升级。
改了数据目录为什么没生效?据项目说明,通过 MIYO_DATA_DIR 或应用内配置修改数据目录后需要重启应用才生效,改完没重启会以为配置没起作用,先重启再排查。
压测结果能直接当性能结论吗?不能直接当结论。压测面板展示了 QPS、延迟分位数和错误样本,适合做基础负载判断,但项目说明没有交代适用规模和校准方法,正式结论仍需专业工具复核。
适合谁与一句话结论
适合的人:重视离线使用和轻量部署的开发者和测试人员,尤其适合接口联调、Mock、自动化测试和 CI 都想收进一个工作台的小团队。
不适合的人:依赖成熟云端协作、集中权限管理和企业级治理的团队,这类需求在采用前必须逐项核对,核对不上就别硬上。
一句话结论:如果你受够了调试、Mock、测试、压测散在四五个工具里,又接受数据留在本地这个前提,Miyo 值得装上跑一轮真实联调再决定。

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







