diff --git a/docs/src/.vitepress/config.mts b/docs/src/.vitepress/config.mts index 1e7086e..4f83867 100644 --- a/docs/src/.vitepress/config.mts +++ b/docs/src/.vitepress/config.mts @@ -6,7 +6,7 @@ import type { VitePressSidebarOptions } from 'vitepress-sidebar/types' import type { VitePressI18nOptions } from 'vitepress-i18n/types' const capitalizeFirst = (str: string): string => str.charAt(0).toUpperCase() + str.slice(1) -const supportLocales = ['en', 'ko'] +const supportLocales = ['en', 'ko', 'zhHans'] const defaultLocale: string = supportLocales[0] const vitePressI18nConfigs: VitePressI18nOptions = { @@ -15,7 +15,9 @@ const vitePressI18nConfigs: VitePressI18nOptions = { searchProvider: 'local', description: { en: 'Vutron is a preconfigured template for developing Electron cross-platform desktop apps. It uses Vue 3 and allows you to build a fast development environment with little effort.', - ko: 'Vutron은 Electron 크로스 플랫폼 데스크톱 앱 개발을 위해 미리 구성된 템플릿입니다. Vue 3을 사용하며 적은 노력으로 빠른 개발 환경을 구축할 수 있습니다.' + ko: 'Vutron은 Electron 크로스 플랫폼 데스크톱 앱 개발을 위해 미리 구성된 템플릿입니다. Vue 3을 사용하며 적은 노력으로 빠른 개발 환경을 구축할 수 있습니다.', + zhHans: + 'Vutron 是用于开发 Electron 跨平台桌面应用程序的预配置模板。它使用 Vue 3，可让您轻松构建快速开发环境。' }, themeConfig: { en: { @@ -33,6 +35,14 @@ const vitePressI18nConfigs: VitePressI18nOptions = { link: '/ko/installation-and-build/getting-started' } ] + }, + zhHans: { + nav: [ + { + text: '入门', + link: '/zhHans/installation-and-build/getting-started' + } + ] } } } diff --git a/docs/src/zhHans/electron-how-to/index.md b/docs/src/zhHans/electron-how-to/index.md new file mode 100644 index 0000000..428d399 --- /dev/null +++ b/docs/src/zhHans/electron-how-to/index.md @@ -0,0 +1 @@ +# Electron 操作方法 diff --git a/docs/src/zhHans/electron-how-to/main-and-renderer-process.md b/docs/src/zhHans/electron-how-to/main-and-renderer-process.md new file mode 100644 index 0000000..bb4d426 --- /dev/null +++ b/docs/src/zhHans/electron-how-to/main-and-renderer-process.md @@ -0,0 +1,25 @@ +# 主流程与渲染器流程 + +一个**Vutron**应用程序被分为代码，分为主进程和渲染器进程。 + +**“主”**是`src/main`的代码，主要是由Electron处理的进程代码。**“渲染器”**是`src/renderer`的代码，主要用于前端渲染过程，如Vue。 + +一般来说，**Node.js**脚本无法在渲染器进程中运行。例如，包含Node.js使用的API的模块，或**Node.js**的本机模块，如`path`或`net`、`os`或`crypto`。 + +预加载脚本在渲染器加载之前运行。它为主进程创建了一个桥梁，出于安全考虑，将Node.js脚本的执行与渲染器区域分开并隔离。 + +为了安全执行脚本，建议主进程执行Node脚本，渲染器通过消息传递接收执行结果。这可以通过**IPC通信**来实现。 + +欲了解更多信息，请参阅以下文章: https://www.electronjs.org/docs/latest/tutorial/ipc + +### 如何在渲染器上运行Node.js？ + +如果您想跳过安全问题并在渲染器中使用 Node.js 脚本，需要在 `vite.config.ts` 文件中将 `nodeIntegration` 设置为 `true`。 + +```javascript +rendererPlugin({ + nodeIntegration: true +}) +``` + +欲了解更多信息，请参阅以下文章: https://github.com/electron-vite/vite-plugin-electron-renderer diff --git a/docs/src/zhHans/electron-how-to/preload-script.md b/docs/src/zhHans/electron-how-to/preload-script.md new file mode 100644 index 0000000..d533864 --- /dev/null +++ b/docs/src/zhHans/electron-how-to/preload-script.md @@ -0,0 +1,24 @@ +# 预加载脚本 + +Electron.js中的预加载脚本是一个安全区域，用于主进程和渲染器进程之间的通信。它通常用于 **[IPC通信](https://www.electronjs.org/docs/latest/tutorial/ipc)**。 + +更多信息，请参阅以下文章: https://www.electronjs.org/docs/latest/tutorial/tutorial-preload + +为了与最新版本的Electron兼容并确保安全，我们不建议使用旧的`electron/remote`模块。如果您想使用系统事件或Node脚本，建议在主进程中使用，而不是在渲染器中。 + +Vutron的预加载脚本位于`src/preload`文件夹中。要创建新的IPC通信通道，请将通道名称添加到以下变量中，将其列入通信白名单。 + +- `mainAvailChannels`: 从主程序发送事件到渲染程序。 (`window.mainApi.send('channelName')`) +- `rendererAvailChannels`: 将事件从渲染器发送到主程序。 (`mainWindow.webContents.send('channelName')`) + +当从渲染器向主程序发送事件时，应访问`window.mainApi`对象，而不是`ipcRenderer.send`。`mainApi`是您在自己的Vutron模板中设置的名称，可以更改。 + +以下是mainApi支持的功能: + +- `send`: 将活动发送至主页面。 +- `on`: 一个接收主发送事件的听众。 +- `once`: 接听主叫方发送的事件。（仅处理一个呼叫） +- `off`: 移除事件监听器 +- `invoke`: 可异步发送事件和接收数据的功能。 + +要更改和修改此设置，您需要修改 `src/preload/index.ts` 中的 `exposeInMainWorld`。 diff --git a/docs/src/zhHans/index.md b/docs/src/zhHans/index.md new file mode 100644 index 0000000..d11e298 --- /dev/null +++ b/docs/src/zhHans/index.md @@ -0,0 +1,32 @@ +--- +layout: home + +title: Vutron +titleTemplate: Vite + Vue 3 + Electron 快速入门模板 + +hero: + name: Vutron + text: Vite + Vue 3 + Electron 快速入门模板 + tagline: Vutron是一个用于开发 "Electron" 跨平台桌面应用程序的预配置模板。它使用 "Vue 3"，可让您轻松构建快速开发环境。 + actions: + - theme: brand + text: 入门 + link: /zhHans/installation-and-build/getting-started + - theme: alt + text: GitHub + link: https://github.com/jooy2/vutron + image: + src: /icon.png + alt: Vue + +features: + - icon: + title: 功能强大的网络应用程序开发模板 + details: Vutron 支持跨平台、多语言、布局和主题以及风格框架。 + - icon: + title: 通过热加载实现快速开发 + details: 为开发人员提供最大程度的功能支持，缩短项目初始设置时间。 + - icon: + title: 可靠的维护支持 + details: 我们有许多实际的使用案例，而且我们拥有快速的技术支持。 +--- diff --git a/docs/src/zhHans/installation-and-build/automated-testing.md b/docs/src/zhHans/installation-and-build/automated-testing.md new file mode 100644 index 0000000..b9d7760 --- /dev/null +++ b/docs/src/zhHans/installation-and-build/automated-testing.md @@ -0,0 +1,23 @@ +--- +order: 4 +--- + +# 自动测试 + +**Vutron**包括自动测试。测试框架使用微软的\*\*[Playwright](https://playwright.dev)。 + +**Playwright**针对网络应用测试进行了优化，并完全支持**Electron**框架。它易于安装，无需配置即可立即开始测试，并且是跨平台的。您可以在此处了解有关**Playwright**的更多信息：https://github.com/microsoft/playwright + +此模板仅对模板主屏幕进行了非常简单的启动和行为测试。高级测试取决于您的应用程序范围。 + +目前，测试规范文件位于`tests`目录中，测试结果文件位于`tests/results`中。（内置测试规范文件不会生成单独的结果文件。） + +Playwright配置文件位于项目根目录下的playwright.config.ts，更多信息请参阅以下文档：https://playwright.dev/docs/test-configuration + +完成所有配置后，您可以使用以下命令进行测试。 + +```shell +$ npm run test +``` + +在运行测试之前，请清空构建目录（`dist`）并编译测试包。 diff --git a/docs/src/zhHans/installation-and-build/build-configuration.md b/docs/src/zhHans/installation-and-build/build-configuration.md new file mode 100644 index 0000000..03b3e41 --- /dev/null +++ b/docs/src/zhHans/installation-and-build/build-configuration.md @@ -0,0 +1,84 @@ +--- +order: 2 +--- + +# 构建配置 + +模块安装完成后，只需执行以下命令即可构建平台软件包。 + +```shell +# For Windows (.exe, .appx) +$ npm run build:win + +# For macOS (.dmg) +$ npm run build:mac + +# For Linux (.rpm, .deb, .snap) +$ npm run build:linux + +# All platform (.exe, .appx, .dmg, .rpm, .deb, .snap) - see below description +$ npm run build:all +``` + +已构建的软件包可在 `release/{version}` 位置找到。 + +如需了解更多信息，请参阅以下文章： https://webpack.electron.build/dependency-management#installing-native-node-modules + +## 多平台构建需要做些什么？ + +要为每个操作系统创建软件包，必须在相同的操作系统上构建。例如，macOS 的软件包必须在 macOS 机器上构建。 + +不过，你可以在一个操作系统上同时为 Windows、macOS 和 Linux 构建软件包。不过，这可能需要一些准备工作。 + +如果想在一个平台上同时构建多个平台，建议使用**macOS**。因为只需几个非常简单的设置就能对其进行配置。 + +您可以使用以下命令同时执行多平台构建。或者，你也可以通过上面的单独构建命令，只针对你想要的操作系统进行构建。 + +```shell +$ npm run build:all +``` + +Linux 构建可能需要 "Multipass" 配置。通过以下链接了解有关 `Multipass` 的更多信息： https://multipass.run + +要了解有关多平台构建的更多信息，请参阅以下文章： https://electron.build/multi-platform-build + +## 通过排除开发文件减少软件包大小 + +您可以通过在 `buildAssets/builder/config.ts` 的 files 属性中添加文件模式，在构建时排除不需要的文件。这将节省捆绑包的容量。 + +下面是一个不必要的 `node_modules` 文件模式，可以进一步节省捆绑包。根据项目情况，使用下面的规则可能会导致问题，因此请在使用前进行审查。 + +```json +[ + "!**/.*", + "!**/node_modules/**/{CONTRIBUTORS,CNAME,AUTHOR,TODO,CONTRIBUTING,COPYING,INSTALL,NEWS,PORTING,Makefile,htdocs,CHANGELOG,ChangeLog,changelog,README,Readme,readme,test,sample,example,demo,composer.json,tsconfig.json,jsdoc.json,tslint.json,typings.json,gulpfile,bower.json,package-lock,Gruntfile,CMakeLists,karma.conf,yarn.lock}*", + "!**/node_modules/**/{man,benchmark,node_modules,spec,cmake,browser,vagrant,doxy*,bin,obj,obj.target,example,examples,test,tests,doc,docs,msvc,Xcode,CVS,RCS,SCCS}{,/**/*}", + "!**/node_modules/**/*.{conf,png,pc,coffee,txt,spec.js,ts,js.flow,html,def,jst,xml,ico,in,ac,sln,dsp,dsw,cmd,vcproj,vcxproj,vcxproj.filters,pdb,exp,obj,lib,map,md,sh,gypi,gyp,h,cpp,yml,log,tlog,Makefile,mk,c,cc,rc,xcodeproj,xcconfig,d.ts,yaml,hpp}", + "!**/node_modules/**/node-v*-x64{,/**/*}", + "!**/node_modules/bluebird/js/browser{,/**/*}", + "!**/node_modules/bluebird/js/browser{,/**/*}", + "!**/node_modules/source-map/dist{,/**/*}", + "!**/node_modules/lodash/fp{,/**/*}", + "!**/node_modules/async/!(dist|package.json)", + "!**/node_modules/async/internal{,/**/*}", + "!**/node_modules/ajv/dist{,/**/*}", + "!**/node_modules/ajv/scripts{,/**/*}", + "!**/node_modules/node-pre-gyp/!(lib|package.json)", + "!**/node_modules/node-pre-gyp/lib/!(util|pre-binding.js|node-pre-gyp.js)", + "!**/node_modules/node-pre-gyp/lib/util/!(versioning.js|abi_crosswalk.json)", + "!**/node_modules/source-map-support/browser-source-map-support.js", + "!**/node_modules/json-schema/!(package.json|lib)" +] +``` + +## 使用本地 Node 模块的项目的构建设置 + +对于使用 **Native Node Module**的项目，请将以下脚本添加到您的 `package.json`： 安装依赖项时，`electron-builder` 会处理任何需要重建的模块。 + +```json +{ + "scripts": { + "postinstall": "electron-builder install-app-deps" + } +} +``` diff --git a/docs/src/zhHans/installation-and-build/getting-started.md b/docs/src/zhHans/installation-and-build/getting-started.md new file mode 100644 index 0000000..a0d189a --- /dev/null +++ b/docs/src/zhHans/installation-and-build/getting-started.md @@ -0,0 +1,58 @@ +--- +order: 1 +--- + +# 入门 + +## 克隆项目 + +### 方法 1: `npm init` (推荐) + +只需使用 npm 命令，就能轻松克隆一个版本库。 + +```shell +$ npm init vutron +``` + +上述方法不会为项目创建不必要的文档和`.github`相关文件。 + +### 方法 2: 使用此模板 + +点击 **[使用此模板](https://github.com/jooy2/vutron/generate)**，立即创建自己的项目。 + +此方法可立即在 GitHub 上创建一个仓库，但在使用之前，您需要在本地克隆该项目。 + +### 方法 3: 克隆该版本库 + +使用以下命令克隆该 repo。此方法适用于直接向 Vutron 代码库投稿。 + +```shell +$ git clone https://github.com/jooy2/vutron +``` + +## 安装 + +克隆项目后，在终端运行以下命令: + +```shell +# via npm +$ npm i + +# via yarn (https://yarnpkg.com) +$ yarn install + +# via pnpm (https://pnpm.io) +$ pnpm i +``` + +## 在开发环境中运行 + +开发环境中的应用程序通过 **[Vite](https://vitejs.dev)** 运行。 + +```shell +$ npm run dev +``` + +如果运行命令行命令后应用程序没有出现，您可能需要检查默认端口是否被其他应用程序使用。 + +Vite 默认使用端口 `5173`。 diff --git a/docs/src/zhHans/installation-and-build/index.md b/docs/src/zhHans/installation-and-build/index.md new file mode 100644 index 0000000..380e19b --- /dev/null +++ b/docs/src/zhHans/installation-and-build/index.md @@ -0,0 +1 @@ +# 安装和构建 diff --git a/docs/src/zhHans/installation-and-build/install-local-documentation.md b/docs/src/zhHans/installation-and-build/install-local-documentation.md new file mode 100644 index 0000000..edc6734 --- /dev/null +++ b/docs/src/zhHans/installation-and-build/install-local-documentation.md @@ -0,0 +1,36 @@ +--- +order: 5 +--- + +# 管理本地文档 + +Vutron 中的文档可以通过 VitePress 查看器在本地环境中查看。 + +此功能仅在克隆整个项目时可用。如果您使用 npm init vutron 创建项目，则不会包含 docs 文件夹。 + +## 安装 + +以下说明中的所有操作均应在"文档"文件夹中完成。 + +```shell +$ cd docs +``` + +使用以下命令安装相关软件包： + +```shell +# via npm +$ npm i + +# via yarn (https://yarnpkg.com) +$ yarn install + +# via pnpm (https://pnpm.io) +$ pnpm i +``` + +您可以通过以下命令运行托管文档的本地服务器。 + +```shell +$ npm run dev +``` diff --git a/docs/src/zhHans/installation-and-build/npm-scripts.md b/docs/src/zhHans/installation-and-build/npm-scripts.md new file mode 100644 index 0000000..0c55d6a --- /dev/null +++ b/docs/src/zhHans/installation-and-build/npm-scripts.md @@ -0,0 +1,39 @@ +--- +title: NPM Scripts +order: 3 +--- + +# Npm 脚本 + +> $ npm run %SCRIPT_NAME% + +## 一般情况 + +| 脚本名称 | 说明 | +| ----------------- | ---------------------------------------------------------- | +| `dev` | 启动电子作为开发环境 | +| `dev:debug` | 将 Electron 作为开发环境启动（使用 vite debug） | +| `dev:debug:force` | 以Electron作为开发环境启动（使用vite调试+清理vite缓存） | +| `build:pre` | 通常在编译时运行的命令。此脚本无需单独运行。 | +| `build` | 为当前操作系统打包。 | +| `build:all` | 为整个操作系统构建指定软件包（需要跨平台构建配置） | +| `build:dir` | `electron-builder`目录构建 | +| `build:mac` | 为macOS构建预配置软件包 | +| `build:linux` | 为Linux构建预配置软件包 | +| `build:win` | 为Windows构建预配置软件包 | +| `lint` | ESLint代码检查。它不会修改代码。 | +| `lint:fix` | ESLint代码检查。使用自动修复功能修复代码。 | +| `format` | 更漂亮的代码检查。它不会修改代码。 | +| `format:fix` | 更漂亮的代码检查。使用自动修复功能修复代码。 | +| `test` | 根据测试规范文件构建测试包并运行测试。 | +| `test:linux` | 根据测试规范文件构建测试包并运行测试。（仅适用于linux ci） | + +## 文档 + +仅用于为项目文档提供素材。必须从“文档”目录位置运行。 + +| Script Name | Description | +| ----------- | ---------------------------------------------- | +| `dev` | 启动本地文档服务器。（开发中） | +| `build` | 构建本地文档服务器。仅用于 GitHub 页面构建器。 | +| `serve` | 启动本地文档服务器。 | diff --git a/docs/src/zhHans/introduction.md b/docs/src/zhHans/introduction.md new file mode 100644 index 0000000..4e5c597 --- /dev/null +++ b/docs/src/zhHans/introduction.md @@ -0,0 +1,21 @@ +# 导言 + +**Vutron** 是一个预配置的模板，用于开发 `Electron` 跨平台桌面应用。它使用 `Vue 3`，使您能够轻松构建快速的开发环境。 + +## 使用优势 + +- ✅ 无需任何预设，即可立即构建，快速开发。 +- ✅ 快速维护，与最新的 `Vue` 和 `Electron` 以及许多模块兼容。 +- ✅ 通过使用各种附加模板，无需担心布局和数据管理。 + +## 特点 + +- ⚡️ 通过热重载实现快速开发 +- ⚡️ 跨平台开发和构建支持 +- ⚡️ 支持自动化应用程序测试 +- ⚡️ 支持 TypeScript +- ⚡️ 多语言支持 +- ⚡️ 支持主题（暗色和亮色） +- ⚡️ 基本布局管理器 +- ⚡️ 通过 Pinia 存储进行全局状态管理 +- ⚡️ 通过 GitHub 社区和官方文档提供快速支持 diff --git a/docs/src/zhHans/other-projects.md b/docs/src/zhHans/other-projects.md new file mode 100644 index 0000000..2885ac5 --- /dev/null +++ b/docs/src/zhHans/other-projects.md @@ -0,0 +1,15 @@ +# 其他项目 + +## 寻找使用 React 制作的 Electron 模板？ + +还可以查看由 Vite + React + Material-UI + Electron 组成的 "Retron" 项目。 + +https://github.com/jooy2/retron + +## (已废弃）在寻找使用 Webpack 5 编译器的 `Vutron`？ + +通过使用 Vite 编译器，我们实现了减少项目和软件包大小、改善开发环境和提高构建速度的目标。 + +使用 Webpack 5 编译器的旧版**Vutron**已被分割到以下软件源中，并将很快结束支持。 + +https://github.com/jooy2/vutron-webpack diff --git a/docs/src/zhHans/project-structures/index.md b/docs/src/zhHans/project-structures/index.md new file mode 100644 index 0000000..5504388 --- /dev/null +++ b/docs/src/zhHans/project-structures/index.md @@ -0,0 +1 @@ +# 项目结构 diff --git a/docs/src/zhHans/project-structures/pre-configured-components.md b/docs/src/zhHans/project-structures/pre-configured-components.md new file mode 100644 index 0000000..41d4a4b --- /dev/null +++ b/docs/src/zhHans/project-structures/pre-configured-components.md @@ -0,0 +1,32 @@ +--- +order: 2 +--- + +# 预配置组件 + +## 网络应用框架 + +- [Vite](https://vitejs.dev) +- [Electron](https://www.electronjs.org) +- [Electron Builder](https://www.electron.build) + +## 开发帮助工具 + +- [TypeScript](https://www.typescriptlang.org) +- [ESLint](https://eslint.org) +- [Prettier](https://prettier.io) + +## 前端框架（Vue） + +- [Vue](https://vuejs.org) +- [Vue-i18n](https://kazupon.github.io/vue-i18n) +- [Vue-router](https://router.vuejs.org) +- [Pinia](https://pinia.vuejs.org) + +## 设计框架 + +- [Vuetify](https://vuetifyjs.com) + +## 测试 + +- [Playwright](https://playwright.dev) diff --git a/docs/src/zhHans/project-structures/project-structure.md b/docs/src/zhHans/project-structures/project-structure.md new file mode 100644 index 0000000..c5ea153 --- /dev/null +++ b/docs/src/zhHans/project-structures/project-structure.md @@ -0,0 +1,73 @@ +--- +order: 1 +--- + +# 项目结构 + +``` +/ +├─ .github - GitHub文件（仅用于Vutron GitHub项目贡献） +│ └─ ISSUE_TEMPLATE/ +│ └─ resources/ - 用于自述文件（README.md）等的GitHub资源。 +│ └─ workflows/ - GitHub工作流程定义 +│ └─ dependabot.yml +│ └─ FUNDING.yml +├─ .vscode - Visual Studio Code IDE使用的通用项目配置文件 +├─ buildAssets/ - 用于Electron构建的资源包（图标、徽标等）文件 +│ └─ builder/ +│ │ │ └─ config.ts - `electron-builder`动态配置文件 +│ └─ icons/ +├─ dist/ - 用于生成软件包的输出目录 +├─ docs/ - 项目文件（可选） +│ └─ .vitepress/ +│ │ │ └─ config.mts - 用于文档托管的VitePress配置文件 +│ └─ public/ - VitePress文档页面的根目录 +├─ node_modules/ +├─ src/ +│ ├─ main/ - 主（电子）处理源代码 +│ │ ├─ utils/ - 主要工艺设备 +│ │ │ └─ Constants.ts - 全球主要定义 +│ │ │ └─ Menus.ts - 全球主菜单定义 +│ │ └─ index.ts - 主要流程入口 +│ │ └─ IPCs.ts - 主要流程 ipc 处理程序定义 +│ │ └─ MainRunner.ts - 主流程主窗口处理 +│ ├─ preload/ - 预加载（Electron-Vue通信桥）过程源代码 +│ │ └─ index.ts +│ ├─ renderer/ - 渲染器（Vue）处理源代码 +│ │ ├─ components/ - Vue组件集合 +│ │ │ └─ layout/ - 布局组件 +│ │ ├─ locales/ - Vue i18n 语言资源文件 +│ │ ├─ plugins/ - Vue插件定义 +│ │ ├─ public/ - 静态资源视图 +│ │ │ └─ images/ +│ │ ├─ router/ - 视图路由定义 +│ │ ├─ screens/ - 屏幕组件 +│ │ │ └─ ErrorScreen.vue - 当渲染程序出现错误时，屏幕上会显示错误信息 +│ │ │ └─ MainScreen.vue +│ │ │ └─ SecondScreen.vue - 屏幕截图 +│ │ ├─ store/ - Pinia商店（全球状态管理）定义 +│ │ ├─ utils/ - 渲染器进程实用程序 +│ │ ├─ App.vue - Vue应用程序的根组件 +│ │ ├─ index.html - 由电子渲染器进程加载的根静态索引 +│ └─ └─ main.ts - 渲染器进程入口点 +├─ tests/ - 应用程序测试配置 +│ ├─ results/ - PlayWright测试结果文件和屏幕截图的保存位置 +│ ├─ specs/ - PlayWright测试规格文件 +│ ├─ fixtures.ts - 测试公共执行API +│ └─ testUtil.ts - 测试实用程序 +├─ .editorconfig - 编辑器推荐的IDE配置文件 +├─ .eslintignore - ESLint忽略的文件列表 +├─ .eslintrc.json - ESLint规则配置 +├─ .gitignore - 不上传到Git的文件列表 +├─ .prettierignore - 要禁用的文件列表 更美观的文件格式 +├─ .prettierrc - 更漂亮的规则配置 +├─ CODE_OF_CONDUCT.md - 仅在GitHub上使用的文件 +├─ LICENSE - 项目许可证文件 +├─ package.json - Node.js 包配置 +├─ package-lock.json +├─ playwright.config.ts - 编剧测试规则配置 +├─ tsconfig.json - TypeScript配置 +├─ tsconfig.node.json - TypeScript配置 +├─ vite.config.mts - Vite编译器构建配置 +└─ README.md - 仅在GitHub上使用的文件 +```