OCOpenCowork
Get startedInstallChannelsAgentsCapabilitiesSkillsModelsPlatformsOpsReferenceHelp

构建与打包

构建 OpenCowork 生产版本并打包为各平台安装包。

构建与打包 / Building & Packaging

构建命令 / Build Commands

# 类型检查 + 构建(推荐)
npm run build

# 构建各平台安装包
npm run build:win    # Windows (.exe)
npm run build:mac    # macOS (.dmg)
npm run build:linux  # Linux (.AppImage / .deb)

构建产物 / Build Artifacts

打包完成后,安装包位于 dist/ 目录:

平台文件
WindowsOpenCowork-x.x.x-setup.exe
macOSOpenCowork-x.x.x.dmg
LinuxOpenCowork-x.x.x.AppImage

构建工具链 / Build Pipeline

  1. electron-vite:统一的 Vite 构建配置,支持主进程/预加载/渲染进程三入口
  2. electron-builder:打包为各平台安装包
  3. better-sqlite3node-pty 等原生模块通过 postinstall 脚本为 Electron 重建

自动更新 / Auto Update

集成了 GitHub Releases 自动更新(electron-updater):

# electron-builder.yml
publish:
  provider: github
  owner: AIDotNet
  repo: OpenCowork
  • 应用启动时检查新版本
  • 后台下载更新包
  • 提示用户重启安装

环境变量 / Environment Variables

变量说明
VITE_APP_VERSION应用版本号
GH_TOKENGitHub Token(用于发布 Release)

文档站点构建 / Docs Site Build

文档站点是一个独立的 Fumadocs + Next.js 项目:

cd docs
npm install
npm run dev     # 本地开发
npm run build   # 生产构建(output: standalone)

On this page