生效时机
Q：配置改完了，ChatGPT.app 里没反应？ 供应商、上游模型、模型映射（含「启用」停用）是即时生效的——运行中的包装器热加载配置， 下一个请求就用新值；ChatGPT.app 的选择器列表自带缓存，最迟约 5 分钟后随窗口焦点刷新 （走开再切回最快），重启 app 立即看到。只有用户目录 / 系统目录（目录缓存）和首次注入 环境变量要重启 app。
Q：改了窗口，会话还是旧窗口？ 上下文窗口只在会话建立时注入一次。活跃会话的窗口覆盖不可更新，会话页会标「窗口待生效」； fork（ChatGPT.app 的「从聊天中继续」）、克隆会话或重启 app 后生效。
Q：输入框里填了 1M，为什么实际生效 608K？ 生效窗口 = min(注入值, 目录条目上限) × 95%，界面按这个公式显示结果。
Q：窗口滑块拖不过 272K？ 该应用模型 id 没命中任何目录条目，落回退默认值。去「模型目录」页（或映射页的 「+ 用户目录」）建一条以该 id 前缀命名的条目。
Q：长上下文限制在哪解锁？ 在模型目录页勾选「启用模型目录增强（自动生成 models/cache.json）」。 缓存只在内核启动时读一次，改完要重启 ChatGPT.app；同页还管理用户目录 / 系统目录 / 目录模板。
Q：目录模板从哪来？ 内置 DeepSeek、千问、GLM、Kimi、MiniMax 等常用模板，可用「检查更新」装新模板、更新或切换 到某个版本；下载走设置页的「下载镜像」（自动测速，或指定 GitHub / Gitee）。
供应商与密钥
Q：卡片显示「缺密钥」？ 钥匙串里没有该供应商的 key（可能被清理过）。编辑供应商补录一次，旧值不会回显。
Q：密钥存在哪里，会上传吗？
只存系统钥匙串（macOS 钥匙串 / Windows 凭据管理器）与本地中转进程内存：不落配置文件、
不进日志。本地中转只监听 127.0.0.1，上游密钥仅在转发时替换，中转进程以外的任何地方都拿不到。
Q：供应商页里某个模型一直显示没有「被谁使用」？ 它只在目录（资产层）里，还没建映射，所以不会出现在 ChatGPT.app 里。去「模型映射」页加一条。
Q：模型标签上的「原生」和「转译」是什么意思？
原生 = 上游原生支持 /v1/responses，请求直接透传（保留工具定义与系统指令）；转译 = 上游只有
chat/completions，由本地翻译层做 responses ⇄ chat 互转（流式与工具调用照旧）。翻译路径下
图片、文件等富内容会被剥离，thinking 模型建议优先选原生端点。
Q：想临时回到官方模型？
设置页关掉「全局开关」并重启 app；或把官方模型策略设为 passthrough，在新会话里选官方模型
走原生 OpenAI（注意该会话中途不能再切回第三方）。
排错
Q：会话在 ChatGPT.app 里打不开，报 Model provider 'xxx' not found？
会话持久化的 provider 在当前配置里解析不到。想去第三方就接管，想还给原生打开就转交，见
会话管理。
Q：重启 app 后 Coskey 好像没生效？
先看状态页（或跑 coskey doctor）。常见原因：登录级环境变量没注入、包装器未安装，
或 app 是在安装包装器之前打开的。
Q：想确认链路真的在工作？
状态页的「中转」项在 app 打开会话期间应显示在线；需要细节时开调试日志，能看到每次改写与路由
的摘要（不含密钥）。日志在 ~/.coskey/logs/，默认 warn 级且已脱敏。
Q：卸载 Coskey 之后，原来的会话还能打开吗？
受管会话的 provider 是 coskey，直接卸载会打不开。卸载时选「恢复接管前 provider」，或先转交，
见停用与卸载。
Q：多个账号 / 多个 app 实例会互相影响吗？ 注入的是登录用户级环境变量，同一用户的 ChatGPT.app 共用同一套 Coskey 配置与钥匙串条目。