MoviePilot-Frontend/README.md

MoviePilot-Frontend

中文 | English

MoviePilot 的前端项目，最低支持 Node.js 20.19，推荐使用 Node.js 24。

特性

• 基于 Vue 3 和 Vuetify 3 构建的现代化界面
• 使用 Vite 作为构建工具，提供快速的开发体验
• 支持多语言（中文/英文）
• 完整的插件系统支持，包括远程组件动态加载

开发部署

推荐的IDE设置

VSCode + Volar (并禁用 Vetur).

配置Vite

请参阅 Vite 配置参考.

依赖安装

yarn

开发运行

yarn dev

编译打包

yarn build

单元测试

yarn test:run
yarn test:coverage

测试文件组织、共享测试设施、HTTP mock、覆盖率门禁和新增用例规范见单元测试架构。

ESLint、Prettier、Node 兼容范围及渐进式 CI 门禁见前端代码质量工具链演进。

静态运行

1. 使用 nginx 等Web服务器托管 dist 静态文件，nginx配置参考 public/nginx.conf。

2. 使用 node 命令直接运行service.js，默认监听 3000 端口，设置环境变量 NGINX_PORT 来调整运行端口。

node dist/service.js

模块联邦功能

MoviePilot 现已支持模块联邦（Module Federation）功能，允许插件开发者创建可动态加载的远程组件，实现更丰富的插件用户界面。

• 模块联邦开发指南 - 如何开发远程组件插件
• 模块联邦问题排查指南 - 常见问题和解决方案
• 插件远程组件示例 - 开发插件组件的完整示例项目