1. 状态页（体检）
状态页逐项检查并给出结论：
| 检查项 | 说明 |
|---|---|
| ChatGPT.app | 是否安装、版本号 |
| 内核 | bundled 内核路径与版本门禁 |
| 包装器 | ~/.coskey/bin/codex 是否已安装 |
| 环境注入 | 登录级环境是否指向包装器 |
| 钥匙串 | 每个供应商的密钥条目是否存在 |
| 端点连通（可加测） | 每个供应商端点是否可达 |
| 默认模型 | 是否已设定且在清单内 |
| 全局开关 | 启用 / 停用状态 |
| 中转 | 端口是否在线（app 未运行时不在线属正常） |
发现问题时按条目给出的结论处理即可；coskey doctor 是同一套检查的命令行入口。
coskey doctor # 本地项体检，不发网络请求
coskey doctor --probe # 加查各供应商端点连通性2. 设置页
| 分组 | 内容 |
|---|---|
| 外观 | 主题与浅深色，即时生效并保存在本机 |
| 全局开关 | 关闭后包装器纯透传官方请求，等价原生行为 |
| 模型目录 | 解锁长上下文限制、窗口模板与目录缓存 |
| 默认与策略 | 默认模型下拉（即时生效）、官方模型策略 redirect / passthrough |
| 维护 | 重新体检、日志、更新 |
| 卸载 | 移除注入与包装器，见停用与卸载 |
3. 日志
~/.coskey/logs/wrapper.log、~/.coskey/logs/relay.log（JSON 行，默认 warn 级，已脱敏）；- 开调试日志后重启 app，能看到每次拦截、改写与路由的摘要——不含密钥。
4. 切换钉住状态
会话页与 CLI 都能解除钉住，让会话重新跟随默认模型：
coskey unpin <threadId> # 解除钉住
coskey threads # 查看会话的钉住情况下一步：常见问题。