SuperAPI AI 工具集

install-desktop

部署与运维

查看项目

更新于 11-03 23:38

技能介绍

用途: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,不再次构建。其他平台支持情况、收费与价格信息暂未提供。