mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 05:50:44 +08:00
oliver
4a23b715a2
本次迁移将网关/通道/工具/技能/脚本与协议资源集中到新结构，统一路径常量与脚本转发机制，减少顶层噪音并保证运行与测试行为一致。 Made-with: Cursor
70 lines
1.8 KiB
Markdown
70 lines
1.8 KiB
Markdown
# oclaw 桌面端打包与交付（Windows）
|
||
|
||
本文档用于你后续自行打包并传递安装包，按步骤执行即可。
|
||
|
||
## 1) 前置环境
|
||
|
||
- Windows 10/11
|
||
- Python 3.10+（`python` 在 PATH 中可用）
|
||
- Node.js 20+（含 npm）
|
||
|
||
在项目根目录先安装 Python 依赖：
|
||
|
||
```powershell
|
||
python -m pip install -r requirements.txt
|
||
```
|
||
|
||
## 2) 安装桌面端依赖
|
||
|
||
```powershell
|
||
cd .\desktop
|
||
npm install
|
||
```
|
||
|
||
## 3) 一键打包
|
||
|
||
```powershell
|
||
npm run pack:win
|
||
```
|
||
|
||
这个命令会自动做两件事：
|
||
|
||
1. 执行 `prepare:icon`，从 `oclaw/interfaces/admin/static/oliver.svg` 生成 `desktop/assets/oclaw.ico`
|
||
2. 调用 `electron-builder` 生成 NSIS 安装包
|
||
|
||
## 4) 打包产物位置
|
||
|
||
产物位于 `desktop/dist/`，重点关注：
|
||
|
||
- `oclaw-setup-<version>.exe`（安装包，给用户分发这个）
|
||
- `oclaw-setup-<version>.exe.blockmap`（增量更新元数据，可选）
|
||
- `win-unpacked/oclaw.exe`（免安装可执行目录）
|
||
|
||
## 5) 传递建议（你说的“直接传递”）
|
||
|
||
推荐传递：
|
||
|
||
- 首选：`oclaw-setup-<version>.exe`
|
||
- 可选补充：`SHA256` 校验值（用于校验完整性）
|
||
|
||
如果需要免安装运行，再额外传 `win-unpacked` 目录压缩包。
|
||
|
||
## 6) 本地自测清单（打包后）
|
||
|
||
安装后至少验证以下项：
|
||
|
||
1. 双击应用，默认进入 `/chat`
|
||
2. “设置/审计”入口可正常跳转到 admin 页面
|
||
3. 插件页、运行页进入时有“加载中”提示
|
||
4. 点击插件/运行操作不弹黑色控制台窗口
|
||
5. 关闭应用后，后端进程被回收
|
||
|
||
## 7) 常见问题
|
||
|
||
- **提示找不到 Python**
|
||
- 安装 Python 3.10+，或设置环境变量 `PYTHON_EXECUTABLE`
|
||
- **图标不对**
|
||
- 重新执行：`npm run prepare:icon`
|
||
- **打包失败**
|
||
- 先清理并重装：删除 `desktop/node_modules` 后 `npm install`
|
||
|