Cypress cypress/webpack-batteries-included-preprocessor 深度解析零配置的 Webpack 测试文件预处理器【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址: https://gitcode.com/GitHub_Trending/cy/cypress本文围绕 Cypress monorepo 中的cypress/webpack-batteries-included-preprocessor包展开基于 AGENTS.md 对该包的定位、构建命令与架构说明结合 index.ts 源码与 README.md 的完整使用示例讲清楚这个自带电池的预处理器解决了什么问题、如何在cypress.config.js中接入、它内置的 Babel/TypeScript 编译链路是如何工作的以及开发该包本身时的构建与测试方式。读完后你既能用它免配置处理 JS/TS 测试文件也能从源码层面理解它的默认 webpack 配置、Node polyfill 策略与版本兼容逻辑。包定位为什么需要Batteries Included在 Cypress monorepo 中cypress/webpack-preprocessor是最基础的测试文件预处理器它把每个 spec/support 文件交给 webpack 打包。但它遵循依赖由用户自备的原则——babel-loader、ts-loader、babel/core等都要用户自己安装并配置详见 npm/webpack-preprocessor/README.md 中列出的 peer dependencies。而cypress/webpack-batteries-included-preprocessor的定位正如其名它是一个发布到 npm 的包装包在cypress/webpack-preprocessor之上叠加了一套预配置好的 webpack 方案开箱即用地包含 Babel 与 TypeScript 支持面向的是不想自己折腾 webpack 配置的用户见 AGENTS.md。两个包的分工是包适用人群额外依赖要求cypress/webpack-preprocessor已有webpack.config.js、依赖齐全的项目需自备babel/core、babel-loader、webpack等cypress/webpack-batteries-included-preprocessor零 webpack 经验、不想写配置文件的项目无依赖全部随包发布从源码结构看这种差异直接体现在 package.json 的dependencies中包直接把babel/core、babel/preset-env、babel/preset-react、babel/preset-typescript、babel-loader、ts-loader、webpack、webpack-bundle-analyzer等全部声明为直接依赖消费者无需再安装这些包。这一点与cypress/webpack-preprocessor形成刻意对照AGENTS.md 中将其列为 Gotcha 之一。安装与接入完整操作步骤安装安装时必须同时安装两个包因为 batteries-included 版本通过 peer dependency 依赖底层预处理器package.json 中peerDependencies声明cypress/webpack-preprocessor: ^6.0.4。README 说明这样做可以让用户独立升级底层包的版本。版本选择规则来自 README.mdwebpackv5项目使用cypress/webpack-batteries-included-preprocessor3.x.x及以上webpackv4项目使用cypress/webpack-batteries-included-preprocessor2.x.xnpm install --save-dev cypress/webpack-batteries-included-preprocessor cypress/webpack-preprocessor最简用法纯 JavaScript 项目在项目的cypress.config.js的 plugins 回调中注册file:preprocessor事件const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) module.exports (on) { on(file:preprocessor, webpackPreprocessor()) }启用 TypeScript 支持先安装 TypeScript若项目尚未安装再通过typescript选项传入其解析路径const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) module.exports (on) { on(file:preprocessor, webpackPreprocessor({ typescript: require.resolve(typescript) })) }源码中 index.ts 的preprocessor()工厂函数对这条链路做了校验如果用户没有传typescript选项却把.ts/.tsx/.mts文件交给它处理会直接 reject 并提示安装 TypeScript。另外typescript选项也支持传布尔值true此时会尝试从用户tsconfig.json所在目录向上解析typescript见 index.ts#L98-L106解析失败则抛出TypeScriptNotFoundError。自定义 polyfillgetFullWebpackOptions从 4.x 起该预处理器只为浏览器构建注入buffer、os、path、process、stream五个 Node 内置模块的 polyfill。如果项目还需要其他内置模块如zlib可以取出默认 webpack 选项并自行增补const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) function getWebpackOptions () { const options webpackPreprocessor.getFullWebpackOptions() // add built-ins as needed options.resolve.fallback.zlib require.resolve(browserify-zlib) return options } module.exports (on) { on(file:preprocessor, webpackPreprocessor({ webpackOptions: getWebpackOptions() })) }getFullWebpackOptions在 index.ts#L330-L338 实现返回getDefaultWebpackOptions()的产物且支持传入filePath与typescript参数把 TS 编译规则一并算进返回的选项里。除typescript选项外该预处理器支持与底层cypress/webpack-preprocessor完全相同的其余选项webpackOptions、watchOptions、additionalEntries等细节见底层包的 README。源码解析默认 webpack 配置里到底预置了什么包的入口只有一个文件index.ts编译产物输出到dist/tsconfig.json 中outDir: ./dist、include: [index.ts]与 AGENTS.md 的 Architecture 一节描述一致。下面按源码拆解它预置的完整能力。默认选项 getDefaultWebpackOptionsgetDefaultWebpackOptions() 构造的核心内容编译模式mode: development。Node 全局行为node: { global: true, __filename: true, __dirname: true }让浏览器 bundle 里的global/__dirname/__filename保持可用。JS 规则两条test: /\.mjs$/且位于node_modules内排除browserslist设type: javascript/auto缓解 webpack 5 对 ESM 包的resolve.fullySpecified强制问题test: /(\.jsx?|\.mjs)$/排除node_modules与browserslist走babel-loader选项来自 getBabelLoaderOptions()。Babel 选项的细节index.ts#L38-L68babel/preset-env固定targets: { chrome: 64 }、modules: commonjs注释说明该 Chrome 版本需与packages/web-config/webpack.config.base.ts和packages/server/lib/browsers/chrome.ts保持同步——即与 Cypress 内置浏览器的能力对齐无条件包含babel/preset-react即开箱支持 JSX插件链固定为babel-plugin-add-module-exports、babel/plugin-transform-class-properties、babel/plugin-transform-object-rest-spread、babel/plugin-transform-runtimeabsoluteRuntime指向包内babel/runtime覆盖 ES 新特性提案阶段的常用语法configFile: false, babelrc: false刻意不读取用户项目里的 Babel 配置保证行为可预测。插件webpack.ProvidePlugin注入Buffer来自buffer包与process解析为包内process/browser.js。源码注释解释了process特意用require.resolve的原因要解析到随 Cypress 二进制一起安装的process库而非用户node_modules下可能不存在的同名包index.ts#L248-L253当debug命名空间cypress-verbose:webpack-batteries-included-preprocessor:bundle-analyzer开启时动态加入BundleAnalyzerPlugin——这正是下文 Debugging 小节提到的 bundle 报告入口index.ts#L255-L258。resolve 与 polyfillextensions为[.js, .json, .jsx, .mjs]fallback把buffer→buffer、os→os-browserify/browser、path→path-browserify、process→process/browser.js、stream→stream-browserify指向浏览器实现其余约三十个 Node 内置模块fs、http、crypto、dns等统一置为false明确禁用。这正是 AGENTS.md 所述包含 Node.js polyfillsbuffer、os-browserify、path-browserify、process、stream-browserify的源码出处。默认选项同时挂载在导出函数上preprocessor.defaultOptions { webpackOptions: getDefaultWebpackOptions(), watchOptions: {} }index.ts#L325-L328供用户直接修改默认值。TypeScript 编译链路 addTypeScriptConfig当传入了typescript选项addTypeScriptConfig() 会为每个被处理的文件动态装配 TS 规则逻辑分四步查找 tsconfig.json用get-tsconfig包从文件路径向上查找。若找不到且文件是.ts/.tsx/.mts/.mjs系列则抛出TsConfigNotFoundError对应 cypress-io/cypress#18938 的问题见 index.ts#L87-L91。解析 TypeScript 编译器typescript: true时从 tsconfig 所在目录解析typescript模块解析失败抛TypeScriptNotFoundError。按 TS 版本选择编译策略通过底层包的getResolvedTypescriptVersionsemver判断TS ≥ 7TypeScript 7 不再提供 JavaScript 编译器 APIts-loader会崩溃因此改用babel-loaderbabel/preset-typescript做纯转译index.ts#L143-L155。启用 TS 时还会加入babel-plugin-transform-typescript-metadata和 legacy 版babel/plugin-proposal-decorators以与ts-loader的emitDecoratorMetadata行为对齐TS 7注入ts-loader固定transpileOnly: true、silent: true、logLevel: errorTS ≥ 6 时传configFile路径TS 6 时改传内联compilerOptions。若用户 tsconfig 写了moduleResolution: node10会被改写为等价的node以规避部分 ts-loader 版本的校验问题。路径别名解析resolve.extensions追加.ts/.tsxextensionAlias设为{ .js: [.ts, .js], .mjs: [.mts, .mjs] }让import ./foo能命中foo.ts再注册tsconfig-paths-webpack-plugin处理 tsconfig 的paths别名——TS 6 用 v3 版本TS ≥ 6 用 v4 版本且仅当确实找到 tsconfig.json 时才注册避免 v4 在无配置时向上遍历 cwd 导致 resolve 崩溃源码注释见 index.ts#L187-L204。函数还做了两处幂等保护用户已自行配置ts-loader时hasTsLoader正则检测不会重复注入options.__typescriptSupportAdded标记避免重复装配。装配完成后最终委托给webpackPreprocessor(options)(file)执行实际打包index.ts#L321——这就是 AGENTS.md Integration Points 所述通过 peer dependency 直接包装cypress/webpack-preprocessor的具体调用点。测试侧对多版本 TS 的覆盖也印证了上述分支package.json 的 devDependencies 中同时安装了typescript6.x、typescript-v5~5.4.5与typescript-v77.x三个别名依赖供测试分别验证不同版本链路的装配逻辑。调试定位 chunk 加载错误与 bundle 体积问题遇到 chunk load error 或 bundle 体积异常尤其出现在 E2E 测试中时启动 Cypress 前设置环境变量DEBUGcypress-verbose:webpack-batteries-included-preprocessor:bundle-analyzer源码中该命名空间对应 WBADebugNamespace一旦debug检测到它开启默认 webpack 选项的plugins里就会加入BundleAnalyzerPlugin首轮流 bundle 对应 support file后续 bundle 对应各 spec file从而生成webpack-bundle-analyzer报告。README 还建议在向 Cypress 社区提 issue 时附上该报告便于定位问题。另有一个仅供测试用的preprocessor.__reset钩子透传自底层预处理器见 index.ts#L340-L342用于在 vitest 用例间重置状态。开发该包本身构建、检查与测试命令AGENTS.md 的 Key Commands 一节给出了包内的标准工作流与 package.json 的scripts一一对应yarn build # tsc输出到 dist/ yarn check-ts # TypeScript 类型检查--noEmit不产出文件 yarn lint # ESLint yarn test -- path-to-spec # 运行指定 vitest spec 文件 yarn test -- glob-pattern # 运行匹配 glob 的 vitest specs对应package.json中的定义build为tsc || echo built, with errors允许带类型错误产出构建物、check-ts为tsc --noEmit、lint为eslint . --no-warn-ignored、test为vitest run。测试代码位于 test/ 目录分为 unit/index.spec.ts单元层验证选项装配与错误分支和 e2e/features.spec.ts端到端层另有fixtures/存放测试用的项目样例。贡献者还需使用与 Cypress 一致的 Node 版本README Contributing 一节。小结与注意事项结合 AGENTS.md 的 Gotchas 与源码证据使用和维护该包时需注意三点peer dependency 必须成对安装cypress/webpack-preprocessor缺一不可且可独立升级版本依赖是刻意内聚的babel/core、babel/preset-env、ts-loader等被直接打包进本包的dependencies这是它与底层cypress/webpack-preprocessor的有意差异不要为了去重而改动polyfill 范围有边界浏览器目标构建只提供buffer/os/path/process/stream五个内置模块的浏览器实现4.x 起其余内置模块在resolve.fallback中显式为false需要时通过getFullWebpackOptions()扩展。该包采用 MIT 许可变更记录见 CHANGELOG.md更底层的选项语义watchOptions、additionalEntries、defaultOptions修改方式、DEBUGcypress:webpack:stats等则应参考底层包的 README。【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址: https://gitcode.com/GitHub_Trending/cy/cypress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Cypress @cypress/webpack-batteries-included-preprocessor 深度解析：零配置的 Webpack 测试文件预处理器
Cypress cypress/webpack-batteries-included-preprocessor 深度解析零配置的 Webpack 测试文件预处理器【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址: https://gitcode.com/GitHub_Trending/cy/cypress本文围绕 Cypress monorepo 中的cypress/webpack-batteries-included-preprocessor包展开基于 AGENTS.md 对该包的定位、构建命令与架构说明结合 index.ts 源码与 README.md 的完整使用示例讲清楚这个自带电池的预处理器解决了什么问题、如何在cypress.config.js中接入、它内置的 Babel/TypeScript 编译链路是如何工作的以及开发该包本身时的构建与测试方式。读完后你既能用它免配置处理 JS/TS 测试文件也能从源码层面理解它的默认 webpack 配置、Node polyfill 策略与版本兼容逻辑。包定位为什么需要Batteries Included在 Cypress monorepo 中cypress/webpack-preprocessor是最基础的测试文件预处理器它把每个 spec/support 文件交给 webpack 打包。但它遵循依赖由用户自备的原则——babel-loader、ts-loader、babel/core等都要用户自己安装并配置详见 npm/webpack-preprocessor/README.md 中列出的 peer dependencies。而cypress/webpack-batteries-included-preprocessor的定位正如其名它是一个发布到 npm 的包装包在cypress/webpack-preprocessor之上叠加了一套预配置好的 webpack 方案开箱即用地包含 Babel 与 TypeScript 支持面向的是不想自己折腾 webpack 配置的用户见 AGENTS.md。两个包的分工是包适用人群额外依赖要求cypress/webpack-preprocessor已有webpack.config.js、依赖齐全的项目需自备babel/core、babel-loader、webpack等cypress/webpack-batteries-included-preprocessor零 webpack 经验、不想写配置文件的项目无依赖全部随包发布从源码结构看这种差异直接体现在 package.json 的dependencies中包直接把babel/core、babel/preset-env、babel/preset-react、babel/preset-typescript、babel-loader、ts-loader、webpack、webpack-bundle-analyzer等全部声明为直接依赖消费者无需再安装这些包。这一点与cypress/webpack-preprocessor形成刻意对照AGENTS.md 中将其列为 Gotcha 之一。安装与接入完整操作步骤安装安装时必须同时安装两个包因为 batteries-included 版本通过 peer dependency 依赖底层预处理器package.json 中peerDependencies声明cypress/webpack-preprocessor: ^6.0.4。README 说明这样做可以让用户独立升级底层包的版本。版本选择规则来自 README.mdwebpackv5项目使用cypress/webpack-batteries-included-preprocessor3.x.x及以上webpackv4项目使用cypress/webpack-batteries-included-preprocessor2.x.xnpm install --save-dev cypress/webpack-batteries-included-preprocessor cypress/webpack-preprocessor最简用法纯 JavaScript 项目在项目的cypress.config.js的 plugins 回调中注册file:preprocessor事件const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) module.exports (on) { on(file:preprocessor, webpackPreprocessor()) }启用 TypeScript 支持先安装 TypeScript若项目尚未安装再通过typescript选项传入其解析路径const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) module.exports (on) { on(file:preprocessor, webpackPreprocessor({ typescript: require.resolve(typescript) })) }源码中 index.ts 的preprocessor()工厂函数对这条链路做了校验如果用户没有传typescript选项却把.ts/.tsx/.mts文件交给它处理会直接 reject 并提示安装 TypeScript。另外typescript选项也支持传布尔值true此时会尝试从用户tsconfig.json所在目录向上解析typescript见 index.ts#L98-L106解析失败则抛出TypeScriptNotFoundError。自定义 polyfillgetFullWebpackOptions从 4.x 起该预处理器只为浏览器构建注入buffer、os、path、process、stream五个 Node 内置模块的 polyfill。如果项目还需要其他内置模块如zlib可以取出默认 webpack 选项并自行增补const webpackPreprocessor require(cypress/webpack-batteries-included-preprocessor) function getWebpackOptions () { const options webpackPreprocessor.getFullWebpackOptions() // add built-ins as needed options.resolve.fallback.zlib require.resolve(browserify-zlib) return options } module.exports (on) { on(file:preprocessor, webpackPreprocessor({ webpackOptions: getWebpackOptions() })) }getFullWebpackOptions在 index.ts#L330-L338 实现返回getDefaultWebpackOptions()的产物且支持传入filePath与typescript参数把 TS 编译规则一并算进返回的选项里。除typescript选项外该预处理器支持与底层cypress/webpack-preprocessor完全相同的其余选项webpackOptions、watchOptions、additionalEntries等细节见底层包的 README。源码解析默认 webpack 配置里到底预置了什么包的入口只有一个文件index.ts编译产物输出到dist/tsconfig.json 中outDir: ./dist、include: [index.ts]与 AGENTS.md 的 Architecture 一节描述一致。下面按源码拆解它预置的完整能力。默认选项 getDefaultWebpackOptionsgetDefaultWebpackOptions() 构造的核心内容编译模式mode: development。Node 全局行为node: { global: true, __filename: true, __dirname: true }让浏览器 bundle 里的global/__dirname/__filename保持可用。JS 规则两条test: /\.mjs$/且位于node_modules内排除browserslist设type: javascript/auto缓解 webpack 5 对 ESM 包的resolve.fullySpecified强制问题test: /(\.jsx?|\.mjs)$/排除node_modules与browserslist走babel-loader选项来自 getBabelLoaderOptions()。Babel 选项的细节index.ts#L38-L68babel/preset-env固定targets: { chrome: 64 }、modules: commonjs注释说明该 Chrome 版本需与packages/web-config/webpack.config.base.ts和packages/server/lib/browsers/chrome.ts保持同步——即与 Cypress 内置浏览器的能力对齐无条件包含babel/preset-react即开箱支持 JSX插件链固定为babel-plugin-add-module-exports、babel/plugin-transform-class-properties、babel/plugin-transform-object-rest-spread、babel/plugin-transform-runtimeabsoluteRuntime指向包内babel/runtime覆盖 ES 新特性提案阶段的常用语法configFile: false, babelrc: false刻意不读取用户项目里的 Babel 配置保证行为可预测。插件webpack.ProvidePlugin注入Buffer来自buffer包与process解析为包内process/browser.js。源码注释解释了process特意用require.resolve的原因要解析到随 Cypress 二进制一起安装的process库而非用户node_modules下可能不存在的同名包index.ts#L248-L253当debug命名空间cypress-verbose:webpack-batteries-included-preprocessor:bundle-analyzer开启时动态加入BundleAnalyzerPlugin——这正是下文 Debugging 小节提到的 bundle 报告入口index.ts#L255-L258。resolve 与 polyfillextensions为[.js, .json, .jsx, .mjs]fallback把buffer→buffer、os→os-browserify/browser、path→path-browserify、process→process/browser.js、stream→stream-browserify指向浏览器实现其余约三十个 Node 内置模块fs、http、crypto、dns等统一置为false明确禁用。这正是 AGENTS.md 所述包含 Node.js polyfillsbuffer、os-browserify、path-browserify、process、stream-browserify的源码出处。默认选项同时挂载在导出函数上preprocessor.defaultOptions { webpackOptions: getDefaultWebpackOptions(), watchOptions: {} }index.ts#L325-L328供用户直接修改默认值。TypeScript 编译链路 addTypeScriptConfig当传入了typescript选项addTypeScriptConfig() 会为每个被处理的文件动态装配 TS 规则逻辑分四步查找 tsconfig.json用get-tsconfig包从文件路径向上查找。若找不到且文件是.ts/.tsx/.mts/.mjs系列则抛出TsConfigNotFoundError对应 cypress-io/cypress#18938 的问题见 index.ts#L87-L91。解析 TypeScript 编译器typescript: true时从 tsconfig 所在目录解析typescript模块解析失败抛TypeScriptNotFoundError。按 TS 版本选择编译策略通过底层包的getResolvedTypescriptVersionsemver判断TS ≥ 7TypeScript 7 不再提供 JavaScript 编译器 APIts-loader会崩溃因此改用babel-loaderbabel/preset-typescript做纯转译index.ts#L143-L155。启用 TS 时还会加入babel-plugin-transform-typescript-metadata和 legacy 版babel/plugin-proposal-decorators以与ts-loader的emitDecoratorMetadata行为对齐TS 7注入ts-loader固定transpileOnly: true、silent: true、logLevel: errorTS ≥ 6 时传configFile路径TS 6 时改传内联compilerOptions。若用户 tsconfig 写了moduleResolution: node10会被改写为等价的node以规避部分 ts-loader 版本的校验问题。路径别名解析resolve.extensions追加.ts/.tsxextensionAlias设为{ .js: [.ts, .js], .mjs: [.mts, .mjs] }让import ./foo能命中foo.ts再注册tsconfig-paths-webpack-plugin处理 tsconfig 的paths别名——TS 6 用 v3 版本TS ≥ 6 用 v4 版本且仅当确实找到 tsconfig.json 时才注册避免 v4 在无配置时向上遍历 cwd 导致 resolve 崩溃源码注释见 index.ts#L187-L204。函数还做了两处幂等保护用户已自行配置ts-loader时hasTsLoader正则检测不会重复注入options.__typescriptSupportAdded标记避免重复装配。装配完成后最终委托给webpackPreprocessor(options)(file)执行实际打包index.ts#L321——这就是 AGENTS.md Integration Points 所述通过 peer dependency 直接包装cypress/webpack-preprocessor的具体调用点。测试侧对多版本 TS 的覆盖也印证了上述分支package.json 的 devDependencies 中同时安装了typescript6.x、typescript-v5~5.4.5与typescript-v77.x三个别名依赖供测试分别验证不同版本链路的装配逻辑。调试定位 chunk 加载错误与 bundle 体积问题遇到 chunk load error 或 bundle 体积异常尤其出现在 E2E 测试中时启动 Cypress 前设置环境变量DEBUGcypress-verbose:webpack-batteries-included-preprocessor:bundle-analyzer源码中该命名空间对应 WBADebugNamespace一旦debug检测到它开启默认 webpack 选项的plugins里就会加入BundleAnalyzerPlugin首轮流 bundle 对应 support file后续 bundle 对应各 spec file从而生成webpack-bundle-analyzer报告。README 还建议在向 Cypress 社区提 issue 时附上该报告便于定位问题。另有一个仅供测试用的preprocessor.__reset钩子透传自底层预处理器见 index.ts#L340-L342用于在 vitest 用例间重置状态。开发该包本身构建、检查与测试命令AGENTS.md 的 Key Commands 一节给出了包内的标准工作流与 package.json 的scripts一一对应yarn build # tsc输出到 dist/ yarn check-ts # TypeScript 类型检查--noEmit不产出文件 yarn lint # ESLint yarn test -- path-to-spec # 运行指定 vitest spec 文件 yarn test -- glob-pattern # 运行匹配 glob 的 vitest specs对应package.json中的定义build为tsc || echo built, with errors允许带类型错误产出构建物、check-ts为tsc --noEmit、lint为eslint . --no-warn-ignored、test为vitest run。测试代码位于 test/ 目录分为 unit/index.spec.ts单元层验证选项装配与错误分支和 e2e/features.spec.ts端到端层另有fixtures/存放测试用的项目样例。贡献者还需使用与 Cypress 一致的 Node 版本README Contributing 一节。小结与注意事项结合 AGENTS.md 的 Gotchas 与源码证据使用和维护该包时需注意三点peer dependency 必须成对安装cypress/webpack-preprocessor缺一不可且可独立升级版本依赖是刻意内聚的babel/core、babel/preset-env、ts-loader等被直接打包进本包的dependencies这是它与底层cypress/webpack-preprocessor的有意差异不要为了去重而改动polyfill 范围有边界浏览器目标构建只提供buffer/os/path/process/stream五个内置模块的浏览器实现4.x 起其余内置模块在resolve.fallback中显式为false需要时通过getFullWebpackOptions()扩展。该包采用 MIT 许可变更记录见 CHANGELOG.md更底层的选项语义watchOptions、additionalEntries、defaultOptions修改方式、DEBUGcypress:webpack:stats等则应参考底层包的 README。【免费下载链接】cypressFast, easy and reliable testing for anything that runs in a browser.项目地址: https://gitcode.com/GitHub_Trending/cy/cypress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考