Coskey 是一个独立的桌面应用。它不改动 ChatGPT.app、不重新打包，只是把 app 的 Code 会话接到你选择的任意 OpenAI 兼容大模型供应商上。
1. 准备工作
| 条件 | 说明 |
|---|---|
| 系统 | macOS 13+ 或 Windows 10+ |
| ChatGPT.app | 已安装（macOS 默认探测 /Applications/ChatGPT.app，也支持 ~/Applications；Windows 为 MSIX 包） |
| 供应商 | 一个 OpenAI 兼容端点（https://…/v1）与 API key |
端点的协议要求很简单：原生支持 /v1/responses 的直接透传；只有 /v1/chat/completions
的端点，由 Coskey 的本地翻译层自动互转，同样可用。
2. 下载与安装
安装包见产品页的下载入口，两个平台同内容同步发布：
| 平台 | 产物 |
|---|---|
| macOS（Apple Silicon） | Coskey_<版本>_aarch64.dmg |
| macOS（Intel） | Coskey_<版本>_x64.dmg |
| Windows（x64） | Coskey_<版本>_x64-setup.exe |
macOS：双击 DMG，把 Coskey.app 拖进「应用程序」，直接打开即可（安装包已签名并公证）。 若系统仍提示「来自身份不明的开发者」（例如手动替换过二进制），右键点应用 →「打开」放行一次。
Windows：双击 -setup.exe 安装。安装器是 per-user 的（装在当前用户目录，不弹 UAC）。
首发版本尚未做 Authenticode 签名，首次运行会有 SmartScreen 提示——点「更多信息 → 仍要运行」
即可（应用内的更新包有独立的 minisign 签名校验，不受影响）。
3. 首次启动：安装包装器
首次打开只有一个引导步骤：
点「安装包装器与启动配置」，Coskey 会把包装器装到 ~/.coskey/bin/codex，并配置登录时注入
CODEX_CLI_PATH（当前会话立即生效，无需注销）。引导页顶部会显示是否检测到 ChatGPT.app。
这一步做什么：ChatGPT.app 的 Code 能力由它内嵌的 codex 内核驱动，而 app 支持用
CODEX_CLI_PATH 覆盖内核路径。Coskey 把内核路径指向自己的包装器，包装器再拉起真实内核，
于是有了一个可以按请求决定「用哪个供应商、哪个模型」的切入点。
首次安装会顺手建好用户目录：包装器第一次装上时，Coskey 按内置目录模板各生成一条同名 用户目录条目，所以「模型目录」页一进去就有一份能直接用的清单。已经有一份时只补缺：已有 的行原样保留，缺的同名条目补在后面；之后再重装都不会动这份目录。
装完直接进主界面（供应商页此时为空）：
4. 生效时机
| 操作 | 何时生效 |
|---|---|
| 安装包装器、注入环境变量 | 首次装好后仍需重开一次 ChatGPT.app 让注入生效 |
| 新增 / 修改供应商、上游模型、模型映射（含「启用」停用） | 即时生效：运行中的包装器热加载配置，下一个请求就用新值；ChatGPT.app 的选择器列表最迟约 5 分钟后随窗口焦点刷新，重启 app 立即看到 |
| 用户目录 / 系统目录（含「展示」「启用」）/ 目录缓存 | 退出并重新打开 ChatGPT.app（内核只在启动时读一次 ~/.coskey/models/cache.json） |
| 设置页切「默认模型」、全局开关 | 即时：未钉住的会话下一轮对话即跟随 |
5. 升级
两种入口：设置页「检查更新 → 立即更新」，或下载新安装包覆盖安装。更新包带 minisign 签名
校验。供应商、模型映射与密钥都在 ~/.coskey 与系统钥匙串里，升级不影响，也不需要迁移。
包装器会随应用自动同步：应用自更新重启后，新版本启动时自动把 ~/.coskey/bin/codex 对齐
到本次随应用分发的内嵌版本，成功给一条轻提示，不用再手动装一次；失败会写日志并在顶部横幅
给出原因，下次启动自动重试。「设置 → 维护」里的「立即同步」是同一件事的手动入口（幂等，
不改任何配置）。
下一步：供应商与上游模型。