1. 三层事实
- 供应商 = 一个 OpenAI 兼容 Base URL + 一个 API key。key 只存系统钥匙串
（macOS 钥匙串 service=
ai.cosk.coskey），不写配置文件、不进日志。 - 上游模型 = 挂在供应商下的一条事实记录：请求上游时的
model字段、走哪条协议。 上下文窗口不在本页设置，改在「模型映射」页配置。 - 应用模型（映射） = 出现在 ChatGPT.app 选择器里的条目，在「模型映射」页维护。
上游模型默认只入目录，不会出现在 ChatGPT.app 的选择器里。要让它出现在选择器里， 去「模型映射」页加一条映射，见模型映射与窗口。
2. 新增供应商
进「供应商」页，点右上「新增供应商」。表单顶部是一排常用供应商——DeepSeek、千问、
智谱、Kimi、MiniMax，点一下就把前三项（id、展示名、Base URL）填好，剩下只填
API key；最前面的「自定义」是清空表单（连已填的 API key 一起清掉）。用的不是这几家
（自建网关等）就直接手填四栏：
| 字段 | 说明 |
|---|---|
| 供应商 id | 仅字母数字与 - _；会作为映射 id 的命名空间 |
| 展示名（可选） | 卡片标题，以及自动展示名的前缀 |
| Base URL | OpenAI 兼容端点，照供应商文档原样填（是否带 /v1 以文档为准） |
| API key | 输入不回显；保存时写入系统钥匙串 |
这一排末尾的「更多…」会去远端拉一次最新预设清单，按 id + 版本合并，远端独有的新条目直接 追加到这一排（提示里写清从哪家拉的、新增几条、更新几条）；清单缓存 24 小时，重复点不会 反复下载。拉回来的只是这份预设清单，不写配置、不碰钥匙串，要哪家仍然得你自己点、自己保存：
保存后卡片立即出现，标题右侧显示「钥匙串 ✓」，标题最前面的小图标按 Base URL 认出来：
图标比对的是完整端点再退一步只比主机，所以 https://api.deepseek.com 与带 /v1 的写法
都画得出图标；不在预设清单里的端点就空着不画。
3. 从上游清单导入模型
卡片右上点「导入模型…」。Coskey 用该供应商的钥匙串密钥拉一次上游 /models，
列出还没入库的模型：
- 搜索框按名字过滤，模型多时不用翻长列表；搜索只影响显示，不会丢掉已勾选项；
- 全选当前结果 = 勾选当前搜索结果里的全部；
- 勾好之后点「导入 N 个」。
导入时逐个探测 /responses 并按结论落库，完成后模型出现在卡片里：
- 原生 = 上游原生支持
/v1/responses，请求直接透传（保留工具定义与系统指令）； - 转译 = 上游只有 chat/completions，由本地翻译层做 responses ⇄ chat 双向翻译， 流式与工具调用照旧；
- 「被谁使用」列这一格只有一颗「+ 使用模型」按钮：点它就是就地给它建一条映射，弹窗就是 「模型映射」页的新增表单（「指向」已预填）；还没建映射时，模型进了目录，但还没出现在 ChatGPT.app 选择器里。
上游清单里没有的模型（自建网关常见）用「+ 添加模型」手工录入：只填上游
model字段， 同样会自动探测协议。一次加一条：点「添加」后表单即收起，结论挂在新出现的那行下面。
4. 卡片上的其它操作
| 操作 | 说明 |
|---|---|
| 按供应商导航 | 列表上方一排胶囊，点一下滚到那家卡片；按住左右拖动可调整供应商顺序（松手落盘，CLI coskey provider list 同序） |
| 导入模型… | 拉上游 /models 清单，搜索、多选导入（推荐方式） |
| + 添加模型 | 手工录入单个模型（清单里没有的） |
| 测速 Base URL | 测你填的地址是否可达、往返耗时 |
| 复制 Base URL / API key | 卡片上两枚复制图标：前者复制端点，后者从系统钥匙串读出 key 写入剪贴板（界面不回显明文） |
| 测试连接 | 按该模型标记的协议发一次最小请求：原生模型给「不思考 / 带思考」两个耗时，转译模型给「首包」 |
| 探测协议 | 每个模型行可单独重探 /responses，结论显示在那一行下面 |
| 编辑 / 删除 | 删除供应商会连带其模型、选择器条目与钥匙串条目（有二次确认） |
| + 使用模型 | 每个模型行的「被谁使用」列：就地新建一条指向该上游模型的映射，保存后本列立刻出现名字 |
| 「被谁使用」列 | 显示该上游模型在 ChatGPT.app 选择器里出现的名字；表头那颗 # 可在展示名与模型 id 之间切换 |
供应商、上游模型与映射的改动即时生效：运行中的包装器热加载配置，下一个请求就用新值， 不必重启 app；ChatGPT.app 的选择器列表最迟约 5 分钟后随窗口焦点刷新（重启更快）。
下一步：模型映射与上下文窗口。