init
all 视频 视频 视频 视频 视频 init
This commit is contained in:
144
README-PACKAGE.md
Normal file
144
README-PACKAGE.md
Normal file
@@ -0,0 +1,144 @@
|
||||
# 一力三期BMS - 故事AI导演工作台 打包指南
|
||||
|
||||
## 快速打包
|
||||
|
||||
双击运行 `build-electron.bat`,等待完成即可。
|
||||
|
||||
## 打包步骤详解
|
||||
|
||||
### 1. 环境准备
|
||||
|
||||
确保已安装:
|
||||
- Node.js 16+(下载地址:https://nodejs.org)
|
||||
- npm(随Node.js一起安装)
|
||||
|
||||
### 2. 安装依赖
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
### 3. 构建前端
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
### 4. 打包exe
|
||||
|
||||
```bash
|
||||
npm run electron:build:win
|
||||
```
|
||||
|
||||
### 5. 查看结果
|
||||
|
||||
打包完成后,在 `release` 目录找到:
|
||||
- `故事AI导演工作台 Setup 1.0.0.exe`(安装包)
|
||||
|
||||
## 给用户使用
|
||||
|
||||
用户只需:
|
||||
1. 双击安装包
|
||||
2. 按提示安装(可自定义安装目录)
|
||||
3. 桌面出现快捷方式
|
||||
4. 双击打开即可使用
|
||||
|
||||
## 应用特性
|
||||
|
||||
- ✅ 无需安装任何运行时
|
||||
- ✅ 桌面原生窗口体验
|
||||
- ✅ 自动创建桌面快捷方式
|
||||
- ✅ 支持自定义安装目录
|
||||
- ✅ 支持开始菜单快捷方式
|
||||
|
||||
## 自定义配置
|
||||
|
||||
### 修改窗口大小
|
||||
|
||||
编辑 `electron/main.js`:
|
||||
```javascript
|
||||
mainWindow = new BrowserWindow({
|
||||
width: 1400, // 修改宽度
|
||||
height: 900, // 修改高度
|
||||
// ...
|
||||
});
|
||||
```
|
||||
|
||||
### 修改应用名称
|
||||
|
||||
编辑 `package.json`:
|
||||
```json
|
||||
{
|
||||
"build": {
|
||||
"productName": "你的应用名称",
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 修改应用图标
|
||||
|
||||
1. 准备一个 256x256 的 PNG 图标
|
||||
2. 重命名为 `icon.png`
|
||||
3. 放到 `public` 目录
|
||||
4. 重新打包
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 打包失败怎么办?
|
||||
|
||||
A: 尝试以下步骤:
|
||||
1. 删除 `node_modules` 文件夹
|
||||
2. 删除 `package-lock.json` 文件
|
||||
3. 重新运行 `npm install`
|
||||
4. 再次打包
|
||||
|
||||
### Q: exe文件太大?
|
||||
|
||||
A: Electron应用包含完整的Chromium浏览器引擎,这是正常的。打包后约100-150MB。
|
||||
|
||||
### Q: 安装后打不开?
|
||||
|
||||
A: 尝试:
|
||||
1. 右键以管理员身份运行
|
||||
2. 检查杀毒软件是否拦截
|
||||
3. 确保系统是Windows 10+
|
||||
|
||||
### Q: 如何开发调试?
|
||||
|
||||
A: 运行:
|
||||
```bash
|
||||
npm run electron:dev
|
||||
```
|
||||
|
||||
这会同时启动开发服务器和Electron窗口,支持热更新。
|
||||
|
||||
## 技术说明
|
||||
|
||||
- **前端框架**: React + TypeScript
|
||||
- **3D引擎**: Three.js + React Three Fiber
|
||||
- **构建工具**: Vite
|
||||
- **桌面框架**: Electron
|
||||
- **打包工具**: electron-builder
|
||||
|
||||
## 文件结构
|
||||
|
||||
```
|
||||
storyai-3d-director-desk/
|
||||
├── electron/ # Electron主进程
|
||||
│ ├── main.js # 主进程入口
|
||||
│ └── preload.js # 预加载脚本
|
||||
├── src/ # 前端源码
|
||||
├── dist/ # 构建输出
|
||||
├── release/ # 打包输出
|
||||
├── package.json # 项目配置
|
||||
├── build-electron.bat # 一键打包脚本
|
||||
└── README-PACKAGE.md # 本文档
|
||||
```
|
||||
|
||||
## 更新日志
|
||||
|
||||
### v1.0.0
|
||||
- 初始版本
|
||||
- 支持Windows打包
|
||||
- 支持桌面快捷方式
|
||||
Reference in New Issue
Block a user