apifox-mock-generator 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,135 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.1.1] - 2025-01-27
+
+### 🎯 核心功能改进
+
+#### 🏗️ Mock 文件架构优化
+
+- **新增文件架构管理** - 引入 `file-architecture.ts` 模块，统一管理 Mock 文件的基础结构
+- **两步生成模式** - Mock 文件生成改为两步模式：先确保文件架构，后生成接口内容
+- **智能架构检测** - 自动检测现有文件是否包含必要的 import 语句，避免重复添加
+- **增量架构更新** - 对于已存在的文件，智能添加缺失的基础架构而不覆盖现有内容
+
+#### 🔧 代码质量提升
+
+- **代码格式化优化** - 改进 `code-formatter.ts`，使用 Prettier 自动格式化生成的代码
+- **统一代码风格** - 所有生成的 Mock 文件都遵循统一的代码风格和格式
+- **更好的可读性** - 生成的代码更加整洁，便于维护和调试
+
+#### 📊 类型系统增强
+
+- **接口状态支持** - 在 `ApiEndpoint` 类型中新增 `status` 字段，支持接口状态管理
+- **更精确的类型定义** - 优化类型注释，提供更清晰的 API 文档
+- **废弃配置优化** - 改进 `excludedByTags` 的注释说明，明确其用于排除接口状态
+
+### 🚀 技术改进
+
+#### 📁 文件管理优化
+
+- **目录结构自动创建** - 生成 Mock 文件时自动创建必要的目录结构
+- **文件存在性检查** - 增强文件存在性检查，避免文件操作错误
+- **架构完整性保证** - 确保每个 Mock 文件都包含必要的 import 语句和基础设置
+
+#### 🎨 代码生成改进
+
+- **模块化架构** - 将文件架构管理独立为单独模块，提高代码复用性
+- **更好的错误处理** - 改进文件操作过程中的错误处理和日志输出
+- **增量更新支持** - 支持在现有文件中增量添加新的接口定义
+
+### 📖 文档更新
+
+### 📋 执行前提条件
+
+执行 `node dist/src/scripts/serve-mock.js` 需要满足以下条件：
+
+3. **配置文件存在** - 确保 `apifox.config.json` 在项目根目录
+4. **Mock 文件已生成** - 先运行 `npm run generate` 生成 Mock 文件
+5. **Mock 目录存在** - 确保 `mock/` 目录存在且包含有效的 Mock 文件
+6. **端口可用** - 确保配置的 `mockPort` 端口未被占用
+
+---
+
+## [1.1.0] - 2025-10-13
+
+### 🎯 核心功能
+
+#### 🎭 直接使用 Apifox Mock 规则
+
+- **使用 Apifox 配置** - 直接使用 Apifox 中为字段配置的 mock 规则
+- **统一管理** - Mock 规则在 Apifox 平台统一管理，本地与云端保持完全一致
+- **零配置** - 在 Apifox 中配置好 mock 规则，生成时自动应用
+
+### ✨ 新增功能
+
+#### 🔄 Apifox Mock 规则支持
+
+- **x-apifox-mock 字段** - 自动提取 Apifox 的 `x-apifox-mock` 扩展字段中的 mock 规则
+- **智能语法转换** - 自动将 Apifox 模板语法（`{{$xxx}}`）转换为 Mock.js 语法（`@xxx`）
+- **双语法支持** - 同时支持 Mock.js 语法和 Apifox 模板语法
+- **自动应用** - 启用 `includeApifoxExtensionProperties` 后自动拉取和应用规则
+
+支持的 Apifox 模板转换：
+
+- `{{$string.uuid}}` → `@guid`
+- `{{$person.fullName(locale='zh_CN')}}` → `@cname`
+- `{{$internet.email}}` → `@email`
+- `{{$phone.number}}` → `/^1[3-9]\\d{9}$/`
+- 更多模板映射...
+
+#### 📊 回退策略
+
+当字段没有配置 Apifox mock 规则时，使用以下回退策略：
+
+1. **示例值优先** - 使用 schema 中定义的 `example`
+2. **枚举值** - 使用 `enum` 中的值（通过 `@pick` 随机选择）
+3. **基本规则** - 根据字段类型使用简单的默认规则
+   - 字符串：`@cword(3, 8)`
+   - 数字/整数：根据 `minimum/maximum` 生成范围
+   - 布尔值：`@boolean`
+
+### 📖 文档更新
+
+- **README.md** - 新增"Apifox Mock 规则"章节
+  - 说明工作原理和使用方法
+  - 提供使用示例
+  - 更新项目结构说明
+- **CHANGELOG.md** - 详细记录所有变更
+
+### 🎯 优势
+
+- ✅ **统一管理** - 在 Apifox 中统一管理所有 mock 规则，团队协作更方便
+- ✅ **完全一致** - 本地 Mock 数据与 Apifox 云端 Mock 保持一致
+- ✅ **零学习成本** - 使用 Apifox 原生的 mock 规则，无需学习新语法
+- ✅ **功能完整** - 支持 Apifox 的所有 mock 规则和高级功能
+
+### 🚀 使用示例
+
+在 Apifox 中配置字段的 mock 规则：
+
+```
+字段名: email
+类型: string
+Mock 规则: @email
+```
+
+生成的 Mock 文件会自动应用该规则：
+
+```javascript
+Mock.mock({
+  email: '@email' // 直接使用 Apifox 配置的规则
+});
+```
+
+### ⚡ 兼容性
+
+- 向下兼容 v1.0.0
+- 无需修改配置文件
+- 自动应用 Apifox mock 规则
+
+---
+
 ## [1.0.0] - 2025-10-10
 
 ### ✨ 初始版本发布
@@ -128,4 +257,3 @@
 ## 许可证
 
 MIT License - 详见 [LICENSE](./LICENSE) 文件
-

package/README.md

@@ -16,12 +16,14 @@
 ## ✨ 功能特性
 
 ### 核心功能
+
 - 🚀 **Apifox 集成** - 自动从 Apifox 项目拉取 API 接口定义（支持 OpenAPI 3.0）
 - 📝 **类型生成** - 生成 TypeScript 类型文件（.ts 格式），支持复杂类型、嵌套对象、枚举等
-- 🎭 **Mock 生成** - 基于 Schema 自动生成 Mock 数据，使用 Faker.js 生成真实感数据
+- 🎭 **Apifox Mock** - **✨ 直接使用 Apifox 的 mock 规则**，无需本地配置，完全继承 Apifox 的数据生成能力
 - 🌐 **Mock 服务器** - 基于 Express 的本地 Mock 服务，快速响应，支持 CORS
 
 ### 高级特性
+
 - 🔥 **热重载** - 修改 Mock 文件自动生效，无需重启服务器
 - 🎯 **API 筛选** - 支持路径、方法、标签、操作 ID 等多维度筛选
 - ⚡ **增量更新** - 智能识别文件变化，仅更新必要内容
@@ -39,6 +41,15 @@ pnpm add apifox-mock-generator -D
 
 ## 🚀 快速开始
 
+### 前置条件
+
+在开始使用之前，请确保满足以下条件：
+
+- ✅ **Node.js 16+** - 确保已安装 Node.js 16 或更高版本
+- ✅ **项目编译** - 运行 `npm run build` 编译 TypeScript 代码
+- ✅ **Apifox 配置** - 创建 `apifox.config.json` 配置文件
+- ✅ **Mock 文件生成** - 运行 `npm run generate` 生成 Mock 文件
+
 ### 1. 创建配置文件
 
 在你的项目根目录创建 `apifox.config.json`：
@@ -53,14 +64,12 @@ pnpm add apifox-mock-generator -D
 }
 ```
 
-> ⚠️ 重要：此文件包含敏感信息，请添加到 `.gitignore`
-
 ### 2. 配置 package.json 脚本
 
 ```json
 {
   "scripts": {
-    "mock:generate": "apifox-mock generate",
+    "auto-mock": "apifox-mock generate",
     "mock:serve": "apifox-mock serve",
     "mock:dev": "apifox-mock dev"
   }
@@ -79,6 +88,12 @@ npm run mock:generate
 npm run mock:serve
 ```
 
+> ⚠️ **执行前提条件**：
+>
+> - 必须先运行 `npm run generate` 生成 Mock 文件
+> - 确保 `apifox.config.json` 配置文件存在且配置正确
+> - 确保 `mock/` 对应项目根目录存在且包含有效的 Mock 文件
+
 ### 5. 配置代理（Vite 项目）
 
 在 `vite.config.ts` 中：
@@ -93,21 +108,21 @@ export default defineConfig({
       }
     }
   }
-})
+});
 ```
 
 ### 6. 使用生成的类型
 
 ```typescript
-import type { LoginRequest, LoginResponse } from './src/types/api/auth/login'
+import type { LoginRequest, LoginResponse } from './src/types/api/auth/login';
 
 const login = async (data: LoginRequest): Promise<LoginResponse> => {
   const response = await fetch('/api/auth/login', {
     method: 'POST',
     body: JSON.stringify(data)
-  })
-  return response.json()
-}
+  });
+  return response.json();
+};
 ```
 
 ## 🔧 配置说明
@@ -138,11 +153,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
   "apiFilter": {
     "scope": {
       "type": "ALL",
-      "excludedByTags": ["已废弃", "测试接口"]
-    },
-    "options": {
-      "includeApifoxExtensionProperties": false,
-      "addFoldersToTags": true
+      "excludedByTags": ["设计中", "已废弃"]
     },
     "includePaths": ["/api/auth/**", "/api/user/**"],
     "excludePaths": ["/api/admin/**"],
@@ -156,38 +167,48 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 
 **`scope` 配置** - 控制从 Apifox 导出哪些接口：
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `type` | `'ALL' \| 'FOLDER' \| 'TAG' \| 'API_LIST'` | 导出类型：全部/按文件夹/按标签/按 API ID |
-| `includedByTags` | `string[]` | 包含的标签 |
-| `excludedByTags` | `string[]` | 排除的标签 |
-| `folderPath` | `string` | 文件夹路径（type 为 FOLDER 时） |
-| `apiIdList` | `string[]` | API ID 列表（type 为 API_LIST 时） |
+| 参数             | 类型                                       | 说明                                                      |
+| ---------------- | ------------------------------------------ | --------------------------------------------------------- |
+| `type`           | `'ALL' \| 'FOLDER' \| 'TAG' \| 'API_LIST'` | 导出类型：全部/按文件夹/按标签/按 API ID                  |
+| `includedByTags` | `string[]`                                 | 包含的标签                                                |
+| `excludedByTags` | `string[]`                                 | 排除的接口状态（支持中文：`设计中`、`已废弃`、`待定` 等） |
+| `folderPath`     | `string`                                   | 文件夹路径（type 为 FOLDER 时）                           |
+| `apiIdList`      | `string[]`                                 | API ID 列表（type 为 API_LIST 时）                        |
+
+> 📝 **注意**: 系统默认启用 Apifox 扩展属性和文件夹标签功能，无需额外配置。
 
-**`options` 配置** - 导出选项：
+#### 接口状态映射
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `includeApifoxExtensionProperties` | `boolean` | 是否包含 Apifox 扩展属性 |
-| `addFoldersToTags` | `boolean` | 是否将文件夹路径添加到标签 |
+`excludedByTags` 支持中文状态配置，系统会自动映射到 Apifox 的英文状态：
+
+| 中文状态 | 英文状态     | 说明           |
+| -------- | ------------ | -------------- |
+| `设计中` | `designing`  | 接口正在设计中 |
+| `开发中` | `developing` | 接口正在开发中 |
+| `已完成` | `completed`  | 接口开发完成   |
+| `已废弃` | `deprecated` | 接口已废弃     |
+| `待定`   | `pending`    | 接口状态待定   |
+| `测试中` | `testing`    | 接口正在测试   |
+| `已发布` | `published`  | 接口已发布     |
 
 #### 客户端过滤（生成时）
 
 在生成 Mock 和类型文件时进行二次过滤：
 
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| `includePaths` | `string[]` | 只包含这些路径（支持 `*` 和 `**` 通配符） |
-| `excludePaths` | `string[]` | 排除这些路径 |
-| `includeOperationIds` | `string[]` | 只包含这些 operationId |
-| `excludeOperationIds` | `string[]` | 排除这些 operationId |
-| `excludeDeprecated` | `boolean` | 排除废弃的接口 |
-| `includeMethods` | `string[]` | 只包含这些 HTTP 方法 |
-| `excludeMethods` | `string[]` | 排除这些 HTTP 方法 |
+| 参数                  | 类型       | 说明                                      |
+| --------------------- | ---------- | ----------------------------------------- |
+| `includePaths`        | `string[]` | 只包含这些路径（支持 `*` 和 `**` 通配符） |
+| `excludePaths`        | `string[]` | 排除这些路径                              |
+| `includeOperationIds` | `string[]` | 只包含这些 operationId                    |
+| `excludeOperationIds` | `string[]` | 排除这些 operationId                      |
+| `excludeDeprecated`   | `boolean`  | 排除废弃的接口                            |
+| `includeMethods`      | `string[]` | 只包含这些 HTTP 方法                      |
+| `excludeMethods`      | `string[]` | 排除这些 HTTP 方法                        |
 
 #### 常用场景
 
 **场景 1：导出所有接口，排除已废弃**
+
 ```json
 {
   "apiFilter": {
@@ -200,6 +221,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 2：只导出指定文件夹**
+
 ```json
 {
   "apiFilter": {
@@ -212,6 +234,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 3：按标签导出**
+
 ```json
 {
   "apiFilter": {
@@ -224,6 +247,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 4：服务端 + 客户端双重过滤**
+
 ```json
 {
   "apiFilter": {
@@ -269,6 +293,63 @@ npm run mock:dev
 
 ## 🎯 高级用法
 
+### 🎭 Apifox Mock 规则
+
+本工具**直接使用 Apifox 中配置的 mock 规则**，无需在本地重复配置。只需在 Apifox 中设置好字段的 mock 规则，生成时会自动应用。
+
+#### 工作原理
+
+1. **在 Apifox 中配置** - 为每个字段设置 mock 规则（支持 Mock.js 语法和 Apifox 模板语法）
+2. **自动拉取规则** - 启用 `includeApifoxExtensionProperties` 后，导出的 OpenAPI 数据中会包含 `x-apifox-mock` 扩展字段
+3. **智能转换** - 自动将 Apifox 模板语法（如 `{{$string.uuid}}`）转换为 Mock.js 语法（如 `@guid`）
+4. **生成 Mock 文件** - 工具自动提取并转换 Apifox 的 mock 规则，生成本地 Mock 文件
+
+#### 示例
+
+在 Apifox 中配置字段的 mock 规则：
+
+```
+字段名: id
+类型: string
+Mock 规则: {{$string.uuid}}     ← Apifox 模板语法
+
+字段名: name
+类型: string
+Mock 规则: {{$person.fullName(locale='zh_CN')}}
+
+字段名: code
+类型: number
+Mock 规则: @integer(0, 999)     ← Mock.js 语法
+```
+
+生成的 Mock 文件会自动转换：
+
+```javascript
+Mock.mock({
+  code: '@integer(0, 999)', // 直接使用 Mock.js 规则
+  data: {
+    id: '@guid', // {{$string.uuid}} → @guid
+    name: '@cname', // {{$person.fullName(locale='zh_CN')}} → @cname
+    email: '@email' // 直接使用 Mock.js 规则
+  }
+});
+```
+
+#### 优势
+
+- ✅ **统一管理** - 在 Apifox 中统一管理所有 mock 规则，团队协作更方便
+- ✅ **完全一致** - 本地 Mock 数据与 Apifox 云端 Mock 保持一致
+- ✅ **智能转换** - 自动转换 Apifox 模板语法为 Mock.js 语法，无缝兼容
+- ✅ **双语法支持** - 同时支持 Mock.js 语法（`@xxx`）和 Apifox 模板语法（`{{$xxx}}`）
+
+#### 回退策略
+
+如果字段没有配置 Apifox mock 规则，会使用以下回退策略：
+
+1. **示例值** - 使用 schema 中定义的 `example`
+2. **枚举值** - 使用 `enum` 中的值（通过 `@pick` 随机选择）
+3. **基本规则** - 根据字段类型使用简单的默认规则（如字符串用 `@cword(3,8)`）
+
 ### 自定义 Mock 数据
 
 修改生成的 Mock 文件（如 `mock/api/auth/login.js`）：
@@ -281,11 +362,11 @@ export default {
     code: 0,
     message: 'success',
     data: {
-      token: 'custom-token-12345',  // 自定义数据
+      token: 'custom-token-12345', // 自定义数据
       userId: 10086
     }
   }
-}
+};
 ```
 
 > ⚠️ 注意：重新运行 `apifox-mock generate` 会覆盖自定义的修改
@@ -366,6 +447,7 @@ npm run mock:generate
 ```
 
 执行过程：
+
 - 从 Apifox 拉取 API 定义
 - 应用筛选规则
 - 生成 TypeScript 类型 → `src/types/api/`
@@ -392,20 +474,20 @@ export default defineConfig({
       }
     }
   }
-})
+});
 ```
 
 #### 5️⃣ 在代码中使用
 
 ```typescript
 // 导入类型
-import type { LoginRequest, LoginResponse } from '@/types/api/auth/login'
+import type { LoginRequest, LoginResponse } from '@/types/api/auth/login';
 
 // 发起请求（自动代理到 Mock 服务器）
 const response = await fetch('/api/auth/login', {
   method: 'POST',
   body: JSON.stringify(data)
-})
+});
 ```
 
 ### 项目结构
@@ -455,7 +537,7 @@ apifox-mock-generator/
 │   │   └── openapi-converter.ts   # OpenAPI 转换器
 │   ├── generators/                # 生成器模块
 │   │   ├── templates/             # 模板生成
-│   │   │   ├── mock-template.ts   # Mock 文件模板
+│   │   │   ├── mock-template.ts   # Mock 文件模板（使用 Apifox mock 规则）
 │   │   │   └── type-template.ts   # TypeScript 类型模板
 │   │   ├── mock-generator.ts      # Mock 文件生成器
 │   │   └── type-generator.ts      # 类型文件生成器
@@ -493,23 +575,23 @@ apifox-mock-generator/
 
 项目采用**模块化分层架构**，职责清晰分离：
 
-| 层级 | 目录 | 职责 |
-|------|------|------|
-| **核心层** | `core/` | Apifox API 交互、配置加载、OpenAPI 转换和过滤 |
-| **生成层** | `generators/` | Mock 和 TypeScript 类型生成、代码模板 |
-| **服务层** | `server/` | Express 服务器、动态路由、热重载、参数校验 |
-| **工具层** | `utils/` | 文件操作、增量更新、代码格式化、日志输出 |
-| **脚本层** | `scripts/` | CLI 命令入口（generate、serve） |
-| **类型层** | `types/` | 公共 TypeScript 类型定义 |
+| 层级       | 目录          | 职责                                          |
+| ---------- | ------------- | --------------------------------------------- |
+| **核心层** | `core/`       | Apifox API 交互、配置加载、OpenAPI 转换和过滤 |
+| **生成层** | `generators/` | Mock 和 TypeScript 类型生成、代码模板         |
+| **服务层** | `server/`     | Express 服务器、动态路由、热重载、参数校验    |
+| **工具层** | `utils/`      | 文件操作、增量更新、代码格式化、日志输出      |
+| **脚本层** | `scripts/`    | CLI 命令入口（generate、serve）               |
+| **类型层** | `types/`      | 公共 TypeScript 类型定义                      |
 
 ## 🛠️ 脚本说明
 
-| 命令 | 说明 |
-|------|------|
-| `npm run build` | 编译 TypeScript 代码 |
+| 命令               | 说明                                        |
+| ------------------ | ------------------------------------------- |
+| `npm run build`    | 编译 TypeScript 代码                        |
 | `npm run generate` | 一键生成（拉取 API + 生成 Mock + 生成类型） |
-| `npm run serve` | 启动 Mock 服务器 |
-| `npm run dev` | 开发模式（generate + serve） |
+| `npm run serve`    | 启动 Mock 服务器                            |
+| `npm run dev`      | 开发模式（generate + serve）                |
 
 ## 📚 技术栈
 
@@ -537,6 +619,7 @@ apifox-mock-generator/
 ### 1. 拉取 API 失败？
 
 检查：
+
 - `projectId` 和 `token` 是否正确
 - Token 是否有「项目维护者」或「管理员」权限
 - 网络连接是否正常
@@ -548,6 +631,7 @@ apifox-mock-generator/
 ### 3. 没有生成任何文件？
 
 检查：
+
 - `apiFilter` 筛选规则是否过于严格
 - Apifox 项目中是否有匹配的接口
 - 查看终端输出的错误信息
@@ -556,6 +640,7 @@ apifox-mock-generator/
 ### 4. 类型生成不准确？
 
 建议：
+
 - 在 Apifox 中完善接口的数据模型定义
 - 使用 JSON Schema 定义清晰的数据结构
 - 为每个字段添加描述和示例
@@ -563,10 +648,36 @@ apifox-mock-generator/
 ### 5. 热重载不生效？
 
 确认：
+
 - Mock 文件保存成功
 - 查看终端是否有文件变化的提示
 - 检查文件路径是否在 `mockDir` 配置的目录下
 
+### 6. 启动 Mock 服务器失败？
+
+检查以下条件：
+
+- ✅ **配置文件存在** - 确保 `apifox.config.json` 在项目根目录
+- ✅ **Mock 目录存在** - 确保 `mock/` 目录存在且不为空
+- ✅ **项目已编译** - 运行 `npm run build` 编译代码
+- ✅ **Mock 文件已生成** - 先运行 `npm run generate` 生成 Mock 文件
+- ✅ **端口未被占用** - 检查 `mockPort` 配置的端口是否可用
+
+常见错误及解决方案：
+
+```bash
+# 错误：未找到 apifox.config.json 配置文件
+# 解决：创建配置文件
+cp apifox.config.json.example apifox.config.json
+
+# 错误：未找到 Mock 目录
+# 解决：先生成 Mock 文件
+npm run generate
+
+# 错误：未找到任何 Mock 文件
+# 解决：检查 API 筛选配置，确保有匹配的接口
+```
+
 ## 🤝 不同框架的配置示例
 
 ### Vue CLI 项目
@@ -582,7 +693,7 @@ module.exports = {
       }
     }
   }
-}
+};
 ```
 
 ### React (Create React App)
@@ -600,7 +711,7 @@ module.exports = {
 // src/setupProxy.js
 const { createProxyMiddleware } = require('http-proxy-middleware');
 
-module.exports = function(app) {
+module.exports = function (app) {
   app.use(
     '/api',
     createProxyMiddleware({
@@ -644,18 +755,38 @@ mock/
 
 ### 💡 最佳实践
 
-| 场景 | 建议 |
-|------|------|
-| **配置文件** | `apifox.config.json` 不要提交，提供 `.example` 示例 |
-| **类型文件** | 建议提交到 Git，团队共享类型定义 |
-| **Mock 数据** | 可以不提交，每个开发者自行生成 |
-| **切换环境** | 后端完成后只需修改代理配置，代码无需改动 |
+| 场景          | 建议                                                |
+| ------------- | --------------------------------------------------- |
+| **配置文件**  | `apifox.config.json` 不要提交，提供 `.example` 示例 |
+| **类型文件**  | 建议提交到 Git，团队共享类型定义                    |
+| **Mock 数据** | 可以不提交，每个开发者自行生成                      |
+| **切换环境**  | 后端完成后只需修改代理配置，代码无需改动            |
 
 ## 📝 更新日志
 
+### v1.1.0 (2025-10-13)
+
+#### 🎯 核心功能
+
+- 🎭 **直接使用 Apifox Mock 规则** - 使用 Apifox 中配置的 mock 规则，本地与云端保持完全一致
+- 🔄 **统一管理** - Mock 规则在 Apifox 平台统一管理，团队协作更方便
+
+#### ✨ 新功能
+
+- ✅ 支持 Apifox 的 `x-apifox-mock` 扩展字段，提取 mock 规则
+- ✅ 智能转换 Apifox 模板语法（`{{$xxx}}`）为 Mock.js 语法（`@xxx`）
+- ✅ 同时支持 Mock.js 和 Apifox 两种语法
+- ✅ 完善的回退策略（示例值 → 枚举值 → 基本规则）
+
+#### 📖 文档更新
+
+- 新增"Apifox Mock 规则"章节，说明使用方法
+- 更新项目结构说明
+
 ### v1.0.0 (2025-10-10)
 
 #### 核心功能
+
 - 🚀 **Apifox API 客户端** - 从 Apifox 项目拉取 API 接口定义
 - 📝 **类型生成器** - 自动生成 TypeScript 类型文件（.ts 格式）
 - 🎭 **Mock 生成器** - 基于 Schema 自动生成 Mock 数据文件
@@ -663,6 +794,7 @@ mock/
 - 🔥 **热重载** - 修改 Mock 文件自动生效，无需重启服务器
 
 #### 高级特性
+
 - 🎯 **API 筛选** - 支持路径、方法、标签、操作 ID 等多维度筛选
 - ⚡ **增量更新** - 智能识别文件变化，仅更新必要的内容
 - 🎨 **代码格式化** - 使用 Prettier 格式化生成的代码
@@ -671,6 +803,7 @@ mock/
 - ✅ **参数校验** - 基于 Schema 的请求参数验证
 
 #### 支持的特性
+
 - ✅ OpenAPI 3.0 规范
 - ✅ HTTP 方法：GET、POST、PUT、DELETE、PATCH
 - ✅ 路径参数、查询参数、请求体、响应体
@@ -785,4 +918,3 @@ copies or substantial portions of the Software.
 如有问题或建议，欢迎提 [Issue](https://github.com/yourname/apifox-mock-generator/issues)！
 
 ⭐ 如果这个项目对你有帮助，请给一个 Star！
-

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "apifox-mock-generator",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "从Apifox拉取API接口并生成本地mock和TypeScript类型文件",
     "main": "dist/src/index.js",
     "type": "module",

package/dist/src/core/apifox-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apifox-client.d.ts","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CA6B/E"}
+{"version":3,"file":"apifox-client.d.ts","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,GAAG,CAAC,CA8Bd"}