Mock — macOS 本地 OpenAPI Mock · 接口代理

联调摩擦，一次解决

后端没写完不用等、mock 数据不逼真不用忍、要真实后端的接口不用切工具。

🪄

智能 Mock 生成

导入 OpenAPI 3.0/3.1，每个接口自动带上成功/空列表/401/500/慢响应场景。字段按中文语义生成——姓名、手机号、订单号、日期都像真的；同份数据跨会话稳定不跳变。

🎛️

场景与数据随心切

胶囊一键切场景；自定义场景直接编辑响应体；?__count=50 控数组条数、X-Mock-Scenario 请求头切场景——前端自己就能切，不用回工具点。

🔁

代理透传保真

未启用 mock 的接口自动反向代理到所选后端环境（dev/test/pre…）。方法、query、重复响应头全部原样保真，还能按环境改写请求头（自动加鉴权头等）。

📡

抓包即接口

实时日志面板记录每次请求（MOCK/PROXY 来源标记），任何一条真实请求可一键固化成 mock 接口——前端调了没定义的接口？抓下来直接补。

📊

菜单栏常驻 + 真实统计

菜单栏图标直达服务开关与最近请求；今日与近 7 日的总数/成功率/耗时按天真实归档——没有流量就如实显示零，绝不伪造数据。

🔄

重导入是合并，不是覆盖

文档更新后重新导入：只列出冲突接口逐项抉择（保留项目 / 采用文档），代码合并工具式的逐行 diff 预览；你的开关、种子、自定义场景全部保留。

把工作台交给 AI 助手

内置 MCP 服务器——ZCode、Claude、Cursor 填一个 URL 即接入，30 个工具全量驱动，操作与界面实时同步。

你的助手现在会 Mock 了

一键导入配置：自动检测本机已安装的 AI 助手，勾选后直接写入它们的 MCP 配置。设置页随时查看哪些助手已接入，每个工具都有可复制的示例指令。

切场景、开关注册 mock、改响应体、控数组条数
查询接口清单与请求日志，定位前端到底发了什么
导入 OpenAPI、抓包转接口、环境与项目管理
控制端点仅监听 127.0.0.1，不出本机

# 在 AI 助手里直接说人话
你> 把用户列表切到空列表场景，测下前端空态
✓ set_scenario · GET /api/users → 空列表

你> 新建 POST /api/login，返回登录失败
✓ add_endpoint · 201 已创建

你> 刚才前端发的什么请求？
✓ get_logs · /api/orders 200 · 18ms

三步上手

下载 → 拖入 → 拖个 openapi.json 进来

下载安装

下载 DMG，把 Mock 拖进 Applications。首次打开需两步放行（见下方说明），仅此一次。

导入文档

把 openapi.json 拖进窗口、拖到 Dock 图标，或 ⌘O 选择——全部接口立刻可用。

开始联调

前端 baseURL 指向 http://localhost:3000；手机连同一 Wi-Fi 用局域网地址也能访问。

macOS 首次打开需要两步放行（仅一次）：因未购买 Apple 开发者证书（省下年费），首次打开会提示「无法验证开发者」—— ① 双击打开，弹窗点「完成」；② 系统设置 → 隐私与安全性 → 找到「已阻止使用 Mock」→ 仍要打开。命令行等效：xattr -cr /Applications/Mock.app。之后的升级由内置自动更新完成，不再触发。

常见问题

数据存在哪里？会被上传吗？

全部在本地 ~/Library/Application Support/Mock/（每项目一个 JSON 文件，可单独备份）。无遥测、无账号、无上传。

AI 助手怎么接入？支持哪些？

设置 → MCP 服务 →「导入配置…」，自动检测本机已装的 ZCode / Claude Desktop / Claude Code / Cursor / .agents 标准并一键写入配置（原有配置不动）。连上后直接说人话即可，详见文档。

一部分接口要真实后端怎么办？

按接口粒度开关 mock：关掉的接口自动反向代理到当前环境（dev/test/pre 可切换），透传保真且可配请求头改写规则。

性能怎么样？

本机压测万级 QPS（小响应 c50 ≈ 1.4 万 QPS、0 失败），日志面板高流量下经批量刷新优化不掉帧。

怎么升级？

应用内置自动更新：启动静默检查，发现新版本右上角出现徽标，点击即下载验签安装（EdDSA 验签，与 Apple 证书无关）。

把 openapi.json 拖进来，3 秒起服务