codebuddy可解析swagger/openapi文档自动生成mock数据：上传文档后校验合法性，配置接口生成策略（基础/批量/随机化），支持复制json或启动本地mock server（如http://localhost:3005）供前端调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果你正在前后端联调阶段，后端接口尚未就绪但已有swagger.json或openapi.yaml文档，CodeBuddy能直接解析该文件生成结构准确、字段合规的Mock响应数据，避免手动编写JSON样本或硬编码假值。
上传并解析Swagger文档
在CodeBuddy左侧导航栏点击「Mock中心」→「新建Mock项目」→ 选择「从API文档导入」。
点击「上传文件」按钮，选择本地的swagger.json或openapi.yaml；【必须确保文档中包含完整的paths和components.schemas定义，否则响应体字段可能缺失或类型推断错误】。
文档上传后，CodeBuddy自动校验语法合法性。若出现“Schema未定义”警告，说明部分响应引用了未声明的$ref，需检查文档是否完整导出（例如是否遗漏definitions节）。
配置目标接口与生成策略
文档加载成功后，右侧显示所有已识别的接口路径列表。展开任一路径（如/api/users），勾选对应HTTP方法（GET/POST等）。
点击该接口右侧的「生成Mock」按钮，在弹窗中选择生成模式：
方法一：基础生成——直接输出单条符合响应schema的JSON对象，字段值按类型填充默认示例（string→"example"，number→42，boolean→true）。
方法二：批量生成——输入数量（如10），生成含items数组的响应，适用于列表接口。
方法三：启用随机化——勾选后，name字段将从中文姓名库随机选取，email使用真实域名格式，id生成6位随机整数，避免前端缓存导致的渲染异常。
导出与接入本地开发环境
第一步：点击「复制JSON」，将生成结果粘贴至前端代码中的mock配置对象，或保存为mock-data.json供json-server加载。
第二步：若需实时HTTP服务，点击「启动本地Mock Server」，CodeBuddy自动分配端口（如http://localhost:3005），所有接口路径与原始文档完全一致，例如访问GET http://localhost:3005/api/users即返回刚生成的数据。
第三步：确认前端请求地址已切换为该本地地址，并关闭CORS代理——【此时若仍请求旧域名，浏览器控制台会报跨域错误，务必检查axios或fetch的baseURL配置】。
