macOS 本机安装
完整替换当前构建的应用，保留旧版备份。
- 版本
- v1.1.0
- 更新
- 内容复核
- 2026-10-06
- 使用条件
- macOS、Xcode、Python 3.10+
验证范围：24项离线脚本回归、12项技能库边界测试；真实设备/签名/公证/上传尚未执行。 完整公开包已复核脱敏；真实业务操作仍待对应环境验收。
给你的 Agent
交给你的 Agent
临时使用：复制提示词，再补充你的具体任务。长期复用：下载下面的完整技能包。
安装到自己的 Agent
解压后保留整个 macos-app-install 文件夹，包括 scripts、references 等配套文件。先阅读内容、核实依赖，再放进所用 Agent 的技能目录；Codex 常用 ~/.codex/skills/，Claude Code 常用 ~/.claude/skills/，已有配置优先。同名技能先比较并备份到加载目录外。
包内 skill.json 记录版本和验证范围。在解压的技能文件夹中运行 shasum -a 256 -c SHA256SUMS（macOS），或 sha256sum -c SHA256SUMS（Linux），核对文件完整性。查看说明不需要网站源码。
项目现有 CI 负责正式构建与发布。本入口用于快速验证当前工作树，优先使用项目已有构建配置；通用脚本适用于单一 Xcode 主应用。
- 按项目规则确认最新基线、本次改动、容器、scheme 和安装位置。
- 使用本技能 scripts/macos_app_install.py；默认 Release，每次独立临时 DerivedData。明确要求时通过 --run-xcodegen 生成工程。
- 从顶层构建产物选择主 app，读取真实 bundle ID。旧目标身份不同或元数据缺失时停止。
- 在安装目录同一文件系统准备完整新副本，验证身份后替换。旧应用保存在安装目录的 .codex-app-backups，替换失败恢复旧版。
- 用户要求时打开应用；报告来源 SHA/dirty、scheme、配置、app 身份、构建和安装路径、备份位置及实际启动结果。
python3 "<本技能目录>/scripts/macos_app_install.py" --project-root "$PWD" --open
python3 "<本技能目录>/scripts/macos_app_install.py" --project-root "$PWD" --install-dir "$HOME/Applications"
默认 /Applications；无写权限时使用用户指定的 ~/Applications。定位技能目录后替换占位符。应用身份冲突、多个容器/产品、构建或复制失败都报告实际阻塞，不随意选其它应用。
签名、公证、外部分发由项目流程或 macos-app-distribution 处理。不要把本机打开成功写成对外分发验收。
本版已完成临时目录的完整替换、旧版备份和失败恢复回归，真实应用构建安装未执行。
3 个内容文件 · 包内另附版本说明与校验清单
- SKILL.md
16032952fca42174f6253dacd636a78e341b15d3f707eb17941444d40eb73046 - agents/openai.yaml
d1df013aebce8776b34909b3407625567dbf3f30b6cdbead26c5423915f951b8 - scripts/macos_app_install.py
065fa7d930a28a2ac157d4bcf25060ff68559744a759d269f4823f743c4f1694