用途:install-desktop 用于在本地构建并安装 Opensteer 桌面应用(Opensteer.app,包标识 com.opensteer.opensteer),或在需要本地包反馈时生成无密钥的桌面端验证产物。
主要能力:
- 支持授权范围内的本地安装,需关闭其他 Opensteer 副本,使用干净代码检出和显式完整 40 位源码提交 SHA。
- 安装命令:pnpm desktop:install-local --source-sha FULL_40_CHARACTER_COMMIT_SHA --config /absolute/install-mac-local.json
- 输入项参考 scripts/install-mac-local.ts 中的 localInstallConfigSchema。
- 支持以相同 SHA 和配置续跑;回执或产物漂移会以 fail closed 方式失败。
- 可检查 <stateDirectory>/<SHA> 下的回执、命令日志、应用目录树和 journey 结果。
- 提供 arm64 Mac 上的无密钥证明构建: pnpm install --frozen-lockfile pnpm desktop:build-release --unsigned --out /absolute/proof-inputs 产物位于 apps/desktop/release/contributor/mac-arm64/。
使用方式与约束:
- 使用根目录 Node/pnpm 版本,以及 Go、Xcode 工具和 apps/agent-phone/README.md 中的 Android/JDK 前置条件。
- 不得读取或操作密钥材料;签名配置由操作者在代码检出目录之外准备。
- 本地安装会推迟 Apple 公证,不能证明已具备公开分发就绪性。
- 不得让两个副本同时访问同一个 Personal store;安装旧版应用不会回滚迁移。
- 无密钥证明应用使用开发信任、版本 0.0.0,且无更新元数据,不能用于分发准备;不要为其设置 OPENSTEER_DESKTOP_UPDATE_*。
- 不要在宿主机上启动 GUI/Electron 验证,应使用一次性虚拟机。
- 文档还提到诊断 Launch Services 错误。
适用场景:需要基于本地源码包进行安装验证、排查本地安装回执与产物、或在 arm64 Mac 上进行无签名桌面包验证时使用。
限制:Stable 与 Beta 为应用设置中选择的更新通道,全新安装默认 Stable,二者均通过 accounts.opensteer.com 登录账户;Stable 晋级会逐字节复制已验证的 insider ZIP,不再次构建。其他平台支持情况、收费与价格信息暂未提供。