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 等字段。