macOS 替代入口： 此入口复用既有私密窗口实现，但不与
install完全等价。
inc 和 incodex 在此命令及其参数中通用。
incodex launch [--dry-run] [--app <path>]
incodex launch --remove [--dry-run] [--yes]launch 在 macOS 打开普通 Codex，不复制、修改或重签应用。它自动选择已有接入：
- 已经安装 Incodex：复用有提交记录的安装、Loader、IPC、Runtime、菜单和权限流程。通过正常 LaunchServices 请求打开或激活应用。不另建 CDP controller，不发布 Runtime，也不要求先卸载。
- 未安装的官方原版：启动应用并连接本机 CDP。复用帽子入口和动作工厂，把私密窗口请求交给既有 Rust
open生命周期。
Windows 沿用现有 install 集成和官方图标。这个 macOS 替代入口不新增 Windows 启动包或第二条注入链。
若标准 Codex 档案已有经过验证的 Incodex 启动器宿主，launch 会唤回现有窗口，即使该宿主位于另一个应用路径。Finder 入口仍保留请求的目标，供后续启动使用。单凭档案锁不能授权控制进程。否则，已安装分支使用正常激活；CDP 分支复用已捕获的自有窗口，其他方式启动的应用须先正常退出。此命令不会关闭 Codex。
启动 Codex 前，launch 会发布 /Applications/ChatGPT - Inc.app。发布并验证共享入口后，它会迁移 ~/Applications/ChatGPT - Inc.app 与 ~/Applications/Incodex Launcher.app 中精确归属 Incodex 的旧入口。未知、已修改或其他用户拥有的入口保持不变。它不会创建 /Applications、回退到用户目录或请求 sudo。外部同名包会使前置检查失败，不会先打开官方应用。这个薄 shell 调用同一 CLI，保留 HOME，不复制配置或会话。CLI 保留渠道稳定链接，不固定 Homebrew Cellar 版本。Finder 入口随后退出；只有 CDP 分支保留 App 作用域的 CLI，因此终端命令须保持运行。启动请求成功不等于可见界面已经就绪。Finder 入口没有独立错误界面。终端命令会显示即时错误；~/.incodex/launchers/launch.log 保留最近的目标、阶段和有界错误回执。私有日志最多八条、4 KiB；预览和入口移除不写此日志。installed-requested 只代表 LaunchServices 收到请求，不代表窗口已就绪。启动器会跟随所选 ChatGPT 或 Codex Dock 图标样式；资源不可用时回退到宿主文件图标。它不会在后台监听 Dock 变化。运行 inc update，再运行 incodex launch 刷新。此操作不需要重签、重装或重启宿主。启动指南说明 Finder 位置与旧入口迁移。
创建与使用 Finder 入口
- 运行
incodex launch --dry-run预览目标。 - 运行
incodex launch，或在 macOSinc菜单选择 Launch。Open 则直接打开私密窗口。 - 在 Finder 中选择 前往 › 前往文件夹，输入
/Applications并按回车。打开其中的 ChatGPT - Inc.app，再点击应用内帽子眼镜控件，打开私密窗口。
Finder 入口复用同一个 launch 命令，不另建 Runtime 或安装器。它记住创建时选择的应用。再次运行 launch --app <path> 会替换此目标。
只移除 Finder 入口
incodex launch --remove --dry-run
incodex launch --remove命令先打印计划，在终端确认一次。非交互移除必须加 --yes。它只删除已识别的 Incodex 启动器包，包括旧名称。它不启动或关闭 Codex，不卸载应用集成，也不删除 Runtime 或会话。原 Codex 应用已不存在时仍可移除。--remove 不与 --app 合用。
incodex uninstall 移除应用集成，不是 Finder 入口的移除命令。脚本安装的 macOS CLI 自卸载也会清理已识别的自有 Finder 入口，避免指向已删除的 CLI。
参数
| 参数 | 含义 |
|---|---|
--dry-run |
预览启动或移除入口，不打开窗口，不写文件。 |
--remove |
只移除已识别的 Incodex Finder 入口。 |
--yes |
确认无终端移除；仅与 --remove 合用。 |
--app <path> |
指定官方 Codex .app；默认路径为 /Applications/ChatGPT.app。 |
Runtime 更新
已安装应用继续使用原有 Runtime 更新链。以下约束只适用于未安装的 CDP 分支。
launch 运行期间，兼容的注入器与共享动作工厂更新使用现有 UiUpdate 事务。渲染器和动作控制器都必须确认新代际。缺少确认或代际被取代时，事务会回滚。原生 open 请求会核对 CLI 是否包含所选 Runtime；旧 CLI 拒绝启动，不发布旧资产。原生或其他不可热换的 Runtime 资产变化需要重启；此入口不提供与 install 完全相同的功能。
未安装的 CDP 分支不提供现有 Dock/状态菜单或已安装权限探针。incodex install 仍是现有应用集成路径。其私密窗口使用 WindowServer 关窗观察，不要求 CLI 或启动器的辅助功能权限。这不会授予或转移官方应用权限。
私密子进程仍运行时，重复点击帽子会复用该 owner 并请求置前。成功须收到私密 guardian 的页面与系统激活确认，不能只凭管道写入成功。缺少控制能力或置前失败只使该请求失败，仍保留私密窗口。若已没有普通页面，重新激活会失败，不会暗中另开应用。
示例
incodex launch --dry-run
incodex launch
incodex launch --app "/Applications/ChatGPT.app"用 incodex launch --help 查看已安装版本的帮助。运行 inc update 更新至最新稳定版。