apifox-mock-generator 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,56 @@
 格式基于 [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
 
 ### 🎯 核心功能
@@ -25,6 +75,7 @@
 - **自动应用** - 启用 `includeApifoxExtensionProperties` 后自动拉取和应用规则
 
 支持的 Apifox 模板转换：
+
 - `{{$string.uuid}}` → `@guid`
 - `{{$person.fullName(locale='zh_CN')}}` → `@cname`
 - `{{$internet.email}}` → `@email`
@@ -71,8 +122,8 @@ Mock 规则: @email
 
 ```javascript
 Mock.mock({
-  email: '@email'  // 直接使用 Apifox 配置的规则
-})
+  email: '@email' // 直接使用 Apifox 配置的规则
+});
 ```
 
 ### ⚡ 兼容性
@@ -206,4 +257,3 @@ Mock.mock({
 ## 许可证
 
 MIT License - 详见 [LICENSE](./LICENSE) 文件
-

package/README.md

@@ -16,12 +16,14 @@
 ## ✨ 功能特性
 
 ### 核心功能
+
 - 🚀 **Apifox 集成** - 自动从 Apifox 项目拉取 API 接口定义（支持 OpenAPI 3.0）
 - 📝 **类型生成** - 生成 TypeScript 类型文件（.ts 格式），支持复杂类型、嵌套对象、枚举等
 - 🎭 **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,7 +64,6 @@ pnpm add apifox-mock-generator -D
 }
 ```
 
-
 ### 2. 配置 package.json 脚本
 
 ```json
@@ -78,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` 中：
@@ -92,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();
+};
 ```
 
 ## 🔧 配置说明
@@ -137,7 +153,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
   "apiFilter": {
     "scope": {
       "type": "ALL",
-      "excludedByTags": ["已废弃", "测试接口"]
+      "excludedByTags": ["设计中", "已废弃"]
     },
     "includePaths": ["/api/auth/**", "/api/user/**"],
     "excludePaths": ["/api/admin/**"],
@@ -151,33 +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 扩展属性和文件夹标签功能，无需额外配置。
 
+#### 接口状态映射
+
+`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": {
@@ -190,6 +221,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 2：只导出指定文件夹**
+
 ```json
 {
   "apiFilter": {
@@ -202,6 +234,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 3：按标签导出**
+
 ```json
 {
   "apiFilter": {
@@ -214,6 +247,7 @@ const login = async (data: LoginRequest): Promise<LoginResponse> => {
 ```
 
 **场景 4：服务端 + 客户端双重过滤**
+
 ```json
 {
   "apiFilter": {
@@ -292,13 +326,13 @@ Mock 规则: @integer(0, 999)     ← Mock.js 语法
 
 ```javascript
 Mock.mock({
-  code: '@integer(0, 999)',     // 直接使用 Mock.js 规则
+  code: '@integer(0, 999)', // 直接使用 Mock.js 规则
   data: {
-    id: '@guid',                // {{$string.uuid}} → @guid
-    name: '@cname',             // {{$person.fullName(locale='zh_CN')}} → @cname
-    email: '@email'             // 直接使用 Mock.js 规则
+    id: '@guid', // {{$string.uuid}} → @guid
+    name: '@cname', // {{$person.fullName(locale='zh_CN')}} → @cname
+    email: '@email' // 直接使用 Mock.js 规则
   }
-})
+});
 ```
 
 #### 优势
@@ -328,11 +362,11 @@ export default {
     code: 0,
     message: 'success',
     data: {
-      token: 'custom-token-12345',  // 自定义数据
+      token: 'custom-token-12345', // 自定义数据
       userId: 10086
     }
   }
-}
+};
 ```
 
 > ⚠️ 注意：重新运行 `apifox-mock generate` 会覆盖自定义的修改
@@ -413,6 +447,7 @@ npm run mock:generate
 ```
 
 执行过程：
+
 - 从 Apifox 拉取 API 定义
 - 应用筛选规则
 - 生成 TypeScript 类型 → `src/types/api/`
@@ -439,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)
-})
+});
 ```
 
 ### 项目结构
@@ -540,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）                |
 
 ## 📚 技术栈
 
@@ -584,6 +619,7 @@ apifox-mock-generator/
 ### 1. 拉取 API 失败？
 
 检查：
+
 - `projectId` 和 `token` 是否正确
 - Token 是否有「项目维护者」或「管理员」权限
 - 网络连接是否正常
@@ -595,6 +631,7 @@ apifox-mock-generator/
 ### 3. 没有生成任何文件？
 
 检查：
+
 - `apiFilter` 筛选规则是否过于严格
 - Apifox 项目中是否有匹配的接口
 - 查看终端输出的错误信息
@@ -603,6 +640,7 @@ apifox-mock-generator/
 ### 4. 类型生成不准确？
 
 建议：
+
 - 在 Apifox 中完善接口的数据模型定义
 - 使用 JSON Schema 定义清晰的数据结构
 - 为每个字段添加描述和示例
@@ -610,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 项目
@@ -629,7 +693,7 @@ module.exports = {
       }
     }
   }
-}
+};
 ```
 
 ### React (Create React App)
@@ -647,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({
@@ -691,34 +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 数据文件
@@ -726,6 +794,7 @@ mock/
 - 🔥 **热重载** - 修改 Mock 文件自动生效，无需重启服务器
 
 #### 高级特性
+
 - 🎯 **API 筛选** - 支持路径、方法、标签、操作 ID 等多维度筛选
 - ⚡ **增量更新** - 智能识别文件变化，仅更新必要的内容
 - 🎨 **代码格式化** - 使用 Prettier 格式化生成的代码
@@ -734,6 +803,7 @@ mock/
 - ✅ **参数校验** - 基于 Schema 的请求参数验证
 
 #### 支持的特性
+
 - ✅ OpenAPI 3.0 规范
 - ✅ HTTP 方法：GET、POST、PUT、DELETE、PATCH
 - ✅ 路径参数、查询参数、请求体、响应体
@@ -848,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.1.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"}

package/dist/src/core/apifox-client.js

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import https from 'https';
+import * as https from 'https';
 import { logger } from '../utils/logger.js';
 /**
  * 从 Apifox 拉取 OpenAPI 数据
@@ -12,14 +12,14 @@ export async function fetchOpenAPIFromApifox(config) {
         const requestBody = buildRequestBody(config);
         const response = await axios.post(apiUrl, requestBody, {
             headers: {
-                'Authorization': `Bearer ${config.token}`,
+                Authorization: `Bearer ${config.token}`,
                 'Content-Type': 'application/json',
-                'X-Apifox-Api-Version': '2024-03-28'
+                'X-Apifox-Api-Version': '2024-03-28',
             },
             httpsAgent: new https.Agent({
-                rejectUnauthorized: false
+                rejectUnauthorized: false,
             }),
-            timeout: 30000
+            timeout: 30000,
         });
         logger.success(`✓ 从 Apifox 拉取成功（${Object.keys(response.data.paths || {}).length} 个接口）`);
         return response.data;
@@ -35,7 +35,7 @@ export async function fetchOpenAPIFromApifox(config) {
 function buildRequestBody(config) {
     const requestBody = {
         oasVersion: '3.0',
-        exportFormat: 'JSON'
+        exportFormat: 'JSON',
     };
     // 应用服务端过滤配置
     if (config.apiFilter) {
@@ -44,16 +44,16 @@ function buildRequestBody(config) {
             if (config.apiFilter.scope.type) {
                 scope.type = config.apiFilter.scope.type;
             }
-            if (config.apiFilter.scope.includedByTags && config.apiFilter.scope.includedByTags.length > 0) {
+            if (config.apiFilter.scope.includedByTags &&
+                config.apiFilter.scope.includedByTags.length > 0) {
                 scope.includedByTags = config.apiFilter.scope.includedByTags;
             }
-            if (config.apiFilter.scope.excludedByTags && config.apiFilter.scope.excludedByTags.length > 0) {
-                scope.excludedByTags = config.apiFilter.scope.excludedByTags;
-            }
+            // excludedByTags 现在是客户端过滤，不再发送到服务端
             if (config.apiFilter.scope.folderPath) {
                 scope.folderPath = config.apiFilter.scope.folderPath;
             }
-            if (config.apiFilter.scope.apiIdList && config.apiFilter.scope.apiIdList.length > 0) {
+            if (config.apiFilter.scope.apiIdList &&
+                config.apiFilter.scope.apiIdList.length > 0) {
                 scope.apiIdList = config.apiFilter.scope.apiIdList;
             }
             if (Object.keys(scope).length > 0) {
@@ -63,7 +63,7 @@ function buildRequestBody(config) {
         // 始终启用 Apifox 扩展属性和文件夹标签（写死为 true）
         requestBody.options = {
             includeApifoxExtensionProperties: true,
-            addFoldersToTags: true
+            addFoldersToTags: true,
         };
     }
     return requestBody;

package/dist/src/core/apifox-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"apifox-client.js","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAG3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAoB;IAC/D,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IAEpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sCAAsC,MAAM,CAAC,SAAS,8BAA8B,CAAA;QAEnG,QAAQ;QACR,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAE5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE;YACrD,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE;gBACzC,cAAc,EAAE,kBAAkB;gBAClC,sBAAsB,EAAE,YAAY;aACrC;YACD,UAAU,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC;gBAC1B,kBAAkB,EAAE,KAAK;aAC1B,CAAC;YACF,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,CAAA;QAEvF,OAAO,QAAQ,CAAC,IAAI,CAAA;IAEtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAiB,CAAC,KAAK,CAAC,CAAA;QACxB,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,MAAoB;IAC5C,MAAM,WAAW,GAAQ;QACvB,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,MAAM;KACrB,CAAA;IAED,YAAY;IACZ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAQ,EAAE,CAAA;YAErB,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAA;YAC1C,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9F,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAA;YAC9D,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9F,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAA;YAC9D,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAA;YACtD,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpF,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAA;YACpD,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,KAAK,GAAG,KAAK,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,WAAW,CAAC,OAAO,GAAG;YACpB,gCAAgC,EAAE,IAAI;YACtC,gBAAgB,EAAE,IAAI;SACvB,CAAA;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,WAAW;IACX,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChE,MAAM,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAA;YACjD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC3B,OAAM;QACR,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAW,CAAA;YAE5C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACvE,MAAM,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAA;gBACvD,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;YACvC,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACzC,MAAM,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAA;gBAC/C,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,WAAW,CAAC,kBAAkB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;gBAC9D,IAAI,SAAS,EAAE,OAAO,EAAE,CAAC;oBACvB,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,OAAO,EAAE,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC;YACD,OAAM;QACR,CAAC;IACH,CAAC;IAED,UAAU;IACV,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAA;IAC1C,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"apifox-client.js","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"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"}

package/dist/src/core/endpoint-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint-filter.d.ts","sourceRoot":"","sources":["../../../src/core/endpoint-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,EAAE,CAgE3F"}
+{"version":3,"file":"endpoint-filter.d.ts","sourceRoot":"","sources":["../../../src/core/endpoint-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAsB/D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,CAAC,EAAE,SAAS,GACjB,WAAW,EAAE,CAgGf"}