1. 状态页（体检）
状态页逐项检查并给出结论：
| 检查项 | 说明 |
|---|---|
| ChatGPT.app | 是否安装、版本号 |
| 内核 | bundled 内核路径与版本门禁 |
| 包装器 | ~/.coskey/bin/codex 是否已安装 |
| 环境注入 | 登录级环境是否指向包装器 |
| 钥匙串 | 每个供应商的密钥条目是否存在 |
| 端点连通（可加测） | 每个供应商端点是否可达 |
| 默认模型 | 是否已设定且在清单内 |
| 全局开关 | 启用 / 停用状态 |
| 中转 | 端口是否在线（app 未运行时不在线属正常） |
| 模型网关 | 已启用时是否运行、监听端口、访问范围、宿主 ChatGPT 登录与密钥 |
发现问题时按条目给出的结论处理即可；coskey doctor 是同一套检查的命令行入口。
coskey doctor # 本地项体检，不发网络请求
coskey doctor --probe # 加查各供应商端点连通性插件置灰、界面语言不生效、电脑操控入口缺失这类问题，可先在 ChatGPT.app 标签页 只读检查；需要调整能力时进入独立的「个性化」页，见 ChatGPT.app 检测与个性化。
2. 设置页
| 分组 | 内容 |
|---|---|
| 外观 | 快捷组合、主题色与侧栏深浅，即时生效并保存在本机 |
| 语言 | 跟随系统 / 简体中文 / English，即时生效 |
| 全局开关 | 关闭后包装器纯透传官方请求，等价原生行为 |
| 默认与策略 | 默认模型下拉（即时生效）、官方模型策略 redirect / passthrough、内核路径覆盖 |
| 下载镜像 | 更新清单、供应商预设与目录模板走 cosk.ai 还是 GitHub / Gitee：可选自动 / GitHub / Gitee，旁边可「测速」 |
| 维护 | 重新体检、日志、更新、立即同步包装器 |
| 危险区 | 卸载，见停用与卸载 |
3. 模型目录页
模型目录增强（目录模式）、目录缓存与目录模板单独成一页：
| 区块 | 内容 |
|---|---|
| 模型目录增强（目录模式） | 勾选后生成 ~/.coskey/models/cache.json；内核启动时读一次，改完要重启 app |
| 目录与模板 | 用户目录 / 系统目录 / 目录模板三个页签；用户目录一行 = 一个 slug + 一个目录模板基底；系统目录可改窗口两层与展示、直接开关启用 |
| 动作条 | 「重新生成目录文件（Cache）」把用户目录行重新合成进缓存；「重新生成系统目录」在内核升级后重新抽取官方基底条目 |
| 目录模板 | 装 / 更新 / 切换版本 / 预览 / 删除；下载走设置页「下载镜像」 |
细节见模型目录。
要把模型开放给其它 Agent，见模型网关。
4. 日志
~/.coskey/logs/wrapper.log、~/.coskey/logs/relay.log（JSON 行，默认 warn 级，已脱敏）；- 开调试日志后重启 app，能看到每次拦截、改写与路由的摘要——不含密钥。
5. 切换钉住状态
会话页与 CLI 都能解除钉住，让会话重新跟随默认模型：
coskey unpin <threadId> # 解除钉住
coskey threads # 查看会话的钉住情况下一步：ChatGPT.app 检测与个性化。