👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
CI/CD 说明
这个模板自带一套不依赖具体语言栈的 CI/CD 骨架。
当前 release 入口
scripts/release-package.sh:构建 universalOpen Computer Use.app,cross-compile Linux / Windows runtime,stage 三个既有 root/alias npm 包;每个包都会内置 macOS app、Linux binaries 和 Windows exes,并暴露open-computer-use/ocu等 npm bin 入口。脚本同时调用scripts/package-github-release-assets.sh,产出 npm tarballs、GitHub Release 直接下载制品与对应 manifest。正式 release 必须使用 Apple 签名身份并内嵌四个同团队、同架构的 Locked Use 组件;本地 debug/dev 构建可显式关闭 Locked Use 嵌入以使用 ad-hoc signing。scripts/package-github-release-assets.sh:把已构建的 universal.app、Linux 双架构 binary、Windows 双架构.exe和open-computer-useskill 封装到dist/release/github/,并生成SHA256SUMS与release-assets-manifest.json。macOS 必须分发完整 app bundle,不能把 bundle 内 binary 当成独立安装包。scripts/build-cursor-motion-dmg.sh:本地构建Cursor Motion.app并封装dist/release/cursor-motion/CursorMotion-<version>.dmg,支持native/arm64/x86_64/universal。scripts/build-open-computer-use-linux.sh:本地构建实验性 Linuxopen-computer-usebinary,支持arm64/amd64;release package 会把这两个产物内置进既有 npm 包的dist/linux/。scripts/build-open-computer-use-windows.sh:本地构建实验性 Windowsopen-computer-use.exe,支持arm64/amd64;release package 会把这两个产物内置进既有 npm 包的dist/windows/。.github/workflows/release.yml:支持 push semver tag 自动发布,也支持手动触发;tag push 时会并行构建 npm/direct-download artifacts 与Cursor MotionDMG,只有两个构建 job 都成功后,单一汇总 job 才会创建或更新 GitHub Release 并上传全套 assets。Open Computer Use的 npm 与 app 正式制品需要OPEN_COMPUTER_USE_CODESIGN_*secrets;workflow 导入Developer ID Application证书,以同一 identity 对主 App 与四个 Locked Use 组件签名并检查,缺少身份时构建失败。若同时配置APPLE_NOTARY_*secrets,direct-download app zip 会在 notarization 与 staple 后重新封装;Cursor MotionDMG 也会走 notarization 和 staple。
设计原则
这套默认流水线的目标,是在项目真正成形前先把交付链路搭起来,而不是假装已经知道未来项目该怎么 build 和 deploy。
当新项目的技术栈确定后,你应该继续在 scripts/release-package.sh 这条真实构建链路上扩展,而不是另起一套平行流程。
所有 GitHub Actions 都已经 pin 到 commit SHA。后续升级 action 时,也要继续保持这个约束。
Windows 观察与输入回归
.github/workflows/windows-observation.yml 在相关 PR 上运行 Windows Go 测试、PowerShell 生产采集函数测试,以及独立 WPF / native MCP smoke,也支持手动触发。工作流仅需 contents: read,沿用固定 SHA 的 checkout / setup-node / setup-go,不发布制品。桌面 smoke 使用自己的窗口,验证采集开关、索引与 UIA 设值,以及正常 / 1x1 / 最小化 / cloaked 窗口的截图边界。输入回归另外验证默认窗口消息滚动、四向物理滚轮、点击 / 拖拽 / 组合键和 stale / 遮挡拒绝,并运行 PowerShell 故障注入测试检查释放保护。复现命令见 按需观察与 Windows 输入。
推荐接入顺序
- 保留
ci.yml,作为仓库的基础门禁。 - 在
scripts/ci.sh里继续叠加项目自己的验证命令。 - 在
scripts/release-package.sh已有的真实构建基础上继续扩展 release 产物。 - 技术栈和环境稳定后,再补具体的部署 job。
- 即使交付方式变化,SBOM 和 provenance 这类供应链能力也建议保留。
默认 release 产物
当前 release 流水线会产出:
dist/release/release-manifest.jsondist/release/npm/open-computer-use-<version>.tgzdist/release/npm/open-computer-use-mcp-<version>.tgzdist/release/npm/open-codex-computer-use-mcp-<version>.tgzdist/release/github/Open-Computer-Use-<version>-macOS-universal.app.zipdist/release/github/open-computer-use-cli-<version>-linux-{arm64,amd64}.tar.gzdist/release/github/open-computer-use-cli-<version>-windows-{arm64,amd64}.zipdist/release/github/open-computer-use-skill.zipdist/release/github/open-computer-use.skilldist/release/github/SHA256SUMSdist/release/github/release-assets-manifest.jsondist/release/cursor-motion/CursorMotion-<version>.dmg- GitHub Actions 中上传的 npm 与 direct-download release artifacts
- GitHub Releases 中上述 direct-download assets 与和 tag 对齐的
CursorMotion-<version>.dmg
也就是说,即使项目还没进入更复杂的部署阶段,仓库现在也同时具备 npm 分发链路,以及由 git tag 驱动、覆盖 macOS / Linux / Windows 和 skill 的直接下载链路。