Mock 数据生成规范
本技能提供四种 Mock 数据生成方式。默认生成 Apifox Mock JSON，只有用户明确指定时才切换到其他方式。
选择规则
| 用户指令特征 | 生成方式 | 输出形式 | 参考文档 |
|---|---|---|---|
| 默认（无特殊指定） | Apifox Mock JSON | 直接在聊天中返回 JSON 代码块 | apifox-mock-json.md |
提到 js、脚本、script，或需要字段关联/条件逻辑 | Apifox Mock 脚本 | 生成 .js 文件到项目根目录 mock/ 下，文件名与接口方法对应 | apifox-mock-script.md |
提到 local、本地，或指定了 .vue 文件 | 本地 Mock 文件 | 生成 .ts 文件到 Vue 文件同级目录 | local-mock.md |
提到 开启 mock 地址、初始化 mock 地址、接入 mock、代理到 Apifox | Mock 地址初始化 | 修改 .env.development 与 vite.config.ts | init-mock-address.md |
通用流程
无论哪种方式，前两步相同：
1. 解析接口文件
读取 @/api/xxx/controller 下的接口文件，识别：
- 响应类型（如
RPageMcpServiceVo、RMcpServiceDetailVo） - 请求类型（如
McpServicePageQuery）
2. 追溯类型定义
在 interface/apiTypes/ 目录下找到完整的类型定义，包括：
- 嵌套类型（如
PageMcpServiceVo→McpServiceVo[]） - 关联类型（如
TagVo、McpServiceToolVo） - JSDoc 注释中的枚举值和业务含义
字段语义推断规则
根据字段名和类型智能生成合适的 mock 值，三种方式共用：
| 字段名模式 | 推断类型 | 示例值 |
|---|---|---|
id, *Id | 自增/随机整数 | 1, 2, 3 |
name, *Name（中文语境） | 中文标题/姓名 | '商品名称', '张三' |
name（英文标识符语境） | 英文单词拼接 | 'mcp-service-alpha' |
description, *Desc | 中文段落 | '这是一段描述...' |
url, *Url, icon | 图片/链接 URL | 'https://picsum.photos/800/800' |
*Time, *At, created*, updated* | 日期时间 | '2024-01-15 08:30:00' |
status, is*（布尔语义） | 0/1 或 true/false | 1 |
*Color | 十六进制颜色 | '#3B82F6' |
*Count, *Num, total | 自然数 | 42 |
*Order, *Sort | 自增排序 | 1, 2, 3 |
imgs, images, *List | 对应类型数组 | [{...}, {...}] |
content（富文本） | HTML 内容 | '<div><img src="..." /></div>' |
枚举值识别
优先从 JSDoc 注释中提取枚举值：
interface Example {
/** 创建类型：1-HTTP转MCP，2-MCP服务直接代理 */
createType?: number;
// → mock 值范围限定为 1 或 2
}
响应结构
项目统一的接口响应结构：
{
"code": 200,
"bizCode": 0,
"data": {},
"msg": "success"
}
分页响应包含 records、total、size、current、searchCount、pages 等字段。