mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 01:50:44 +08:00
oliver
4a23b715a2
本次迁移将网关/通道/工具/技能/脚本与协议资源集中到新结构，统一路径常量与脚本转发机制，减少顶层噪音并保证运行与测试行为一致。 Made-with: Cursor
1.8 KiB
1.8 KiB
oclaw 桌面端打包与交付（Windows）
本文档用于你后续自行打包并传递安装包，按步骤执行即可。
1) 前置环境
- Windows 10/11
- Python 3.10+（
python在 PATH 中可用） - Node.js 20+（含 npm）
在项目根目录先安装 Python 依赖：
python -m pip install -r requirements.txt
2) 安装桌面端依赖
cd .\desktop
npm install
3) 一键打包
npm run pack:win
这个命令会自动做两件事：
- 执行
prepare:icon，从oclaw/interfaces/admin/static/oliver.svg生成desktop/assets/oclaw.ico - 调用
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) 本地自测清单（打包后）
安装后至少验证以下项：
- 双击应用，默认进入
/chat - “设置/审计”入口可正常跳转到 admin 页面
- 插件页、运行页进入时有“加载中”提示
- 点击插件/运行操作不弹黑色控制台窗口
- 关闭应用后，后端进程被回收
7) 常见问题
- 提示找不到 Python
- 安装 Python 3.10+，或设置环境变量
PYTHON_EXECUTABLE
- 安装 Python 3.10+，或设置环境变量
- 图标不对
- 重新执行：
npm run prepare:icon
- 重新执行：
- 打包失败
- 先清理并重装：删除
desktop/node_modules后npm install
- 先清理并重装：删除