「模型目录」页是目录体系的总控台，两块内容：
- 模型目录增强（目录模式）：一个开关 + 缓存状态，决定内核启动时读不读 Coskey 生成的目录缓存；
- 目录与模板：三个页签——用户目录（你自己建的条目）、系统目录（官方基底条目的覆盖）、 目录模板（合成基底本身）。
页头那行小字就是规矩：本页任何改动都要重启 ChatGPT.app 才生效——目录缓存只在内核进程启动时
读一次。全程零写 ~/.codex，只写 ~/.coskey/models/。
1. 模型目录增强（目录模式）
开关「启用模型目录增强（自动生成 models/cache.json）」管三件事：
- 解锁窗口上限：三方模型可以超过内核自带的 272K（映射页才拖得出更大的窗口）；
- 决定三方模型的提示词与请求形态：按目录条目下发，不再用内核兜底元数据；
- 应用官方基底条目的覆写：即「系统目录」页签里改的窗口 / 展示 / 启用。
开关下面的状态行给出：缓存路径与条数（有效 N 条）、内核版本、查看明细（列出缓存里每条模型名 / 是否在 ChatGPT.app 展示 / 默认窗口 / 窗口上限），以及「用户目录条目：N 行」和默认目录模板的缺省值。
关闭是破坏性动作，会先弹确认框，逐项列出会失效的东西：
models/cache.json 会保留，重新开启即恢复，已保存的窗口与模板设置都不会丢。确认后重启 app 生效。
2. 用户目录
一行 = 一个 slug + 一个目录模板（合成基底）。行只保存界面可输入的参数（窗口两层与「高级」里的 能力开关），提示词、工具形态这些由基底决定。表格列：
| 列 | 含义 |
|---|---|
| slug | 条目名；应用模型 id 以它为前缀即命中该条目（内核按最长前缀匹配） |
| 目录模板 | 合成基底；同一基底可以建多行（不同前缀 / 不同窗口） |
| 默认窗口 / 窗口上限 | 该条目给出的窗口范围（映射页的滑块参照它） |
| 能力 | 输入模态、原图细节、联网搜索等标签 |
每行右侧是编辑与删除。点「新增目录」在表下方展开表单：
- 目录模板（合成基底）先行：选中后，下面各项按它的取值加载；基底没提供的项不可输入 （模态只能在基底给出的集合里选，能力开关只能在基底已开启的范围内收窄）；
- 目录名（slug）：新增时按所选模板条目的 slug 预填，可以加后缀建成多行；
- 默认窗口 / 窗口上限：多数情况下直接用基底预填值；
- 其余参数收在「高级」折叠区里。
三个页签之上靠右的「重新生成目录文件（Cache）」是三个页签共用的动作：把用户目录条目按各自的 目录模板重新合成进缓存。基底缺失或形态异常的行会跳过，并在提示里点名（原样保留，不阻断缓存）。
首次安装时 Coskey 会按内置目录模板自动补一份同名用户目录，并把内置目录模板展开到
models/third-party/，同时生成目录缓存：用户层恒在，官方基底（系统目录）需要 ChatGPT.app 的内核抽取——先装 Coskey、后装 app 时缓存先只含用户层，装好 app 重启后 包装器自动补齐。已有用户目录时只补缺，重装与更新都不会动你改过的行 （见安装与首次启动）。
内置的国内常用模型
Coskey 当前内置 7 个面向国内常用模型的目录模板。首次安装后，「用户目录」会自动生成一组 slug 与目录模板同名的条目，开箱即可作为这些模型的合成基底：
| 模型家族 | 用户目录中的内置 slug |
|---|---|
| DeepSeek | deepseek-flash、deepseek-v4-pro |
| 通义千问 Qwen | qwen3.8-flash、qwen3.8-max |
| 智谱 GLM | glm-5.3 |
| Kimi | kimi-k3 |
| MiniMax | MiniMax-M3 |
这些模板默认从 272K 窗口起步，窗口上限为 1M。除 deepseek-v4-pro 仅声明文本输入外，
其余模板都声明了文本与图片输入，并带原图细节和联网搜索能力；实际可用能力仍取决于供应商
端点是否支持。
内置条目只负责目录层的提示词、请求形态、窗口与能力开关，不等于已配置好供应商和模型映射。
要真正调用某个模型，仍需先添加供应商与上游模型，再在「模型映射」里把应用模型指向它；应用模型
id 以对应内置 slug 为前缀时，就会命中该目录模板。例如 deepseek-flash-640K 命中
deepseek-flash 条目，但实际请求发往哪个供应商、哪个上游模型，仍由模型映射的「指向」决定。
3. 系统目录
这里列的是内核自带的官方基底条目，不能增删改名，但可以改它们在 app 里的形态：
| 列 | 说明 |
|---|---|
| slug / 默认窗口 / 窗口上限 | 官方条目的名字与窗口两层（覆盖后的生效值用「已覆盖」标出） |
| 展示 | 只读状态：这条当前进不进 ChatGPT.app 选择器 |
| 启用 | 只读状态：这条要不要合成进 cache.json |
| 操作 | 图标动作，顺序见下表；图标按动作取形 |
操作列的图标动作：
| 动作 | 图标 | 说明 |
|---|---|---|
| 编辑 | 铅笔 | 弹窗里改默认窗口 / 窗口上限，以及展示（勾上 = 进 ChatGPT.app 选择器，取消 = 只留在目录里）与启用，一次保存 |
| 展示 / 不展示 | 眼睛 | 当前展示 → 眼睛划斜线（点一下收进「不展示」）；当前隐藏 → 眼睛（点一下放开） |
| 启用 / 停用 | 电源 | 当前启用 → 带斜线的电源（点一下停用）；当前停用 → 电源（点一下启用）。停用 = 这一条整体不合成进 cache.json（app 里当它不存在） |
| 恢复官方配置 | 回转箭头（改过才出现） | 把这行清回官方原值（窗口 / 展示 / 启用覆盖一并移除） |
覆盖值存在 ~/.coskey/models/system-overrides.json，官方基底文件保持原值，内核升级换基底后展示态
自动跟随。两个入口都能重新抽取官方基底：「系统目录」页签顶部那枚常驻；页头漂移提示里那枚只在
检测到内容漂移时出现。
「重新生成系统目录」同一行靠右还有三枚批量动作，都作用于全部官方基底条目、都要先确认：
| 批量动作 | 说明 |
|---|---|
| 批量不展示 | 全部条目的展示位覆写为「不展示」，都不再进 ChatGPT.app 选择器（条目仍在目录里） |
| 批量停用 | 全部条目 enabled: false，整体不合成进 cache.json。没有用户目录条目兜底时会被拒绝——一条启用条目都不剩会让目录变空，内核拒绝空目录 |
| 批量恢复官方配置 | 清掉 system-overrides.json 的全部覆盖（窗口 / 展示 / 启用一并回官方原值） |
整批一次落盘、只重合并一次缓存；全是「无事可做」的那一档（已全不展示 / 已全停用 / 没有覆盖）会置灰。
4. 目录模板
目录模板就是合成基底本身（一文件一条目），首行固定是内嵌的 default（随 Coskey 升级、
不能删）。表格列：目录模板 / 版本 / 来源 / 被引用 / 远端版本 / 操作。
- 来源：
内置（随 Coskey 安装的种子）/cosk.ai（从官网下载安装的）/本地（自建）； - 被引用：有多少条用户目录行用它当基底；
- 远端版本：点「检查更新」后与索引比对的结果，可更新时会标「可更新到 vX」。
点「检查更新」会拉一次远端索引：
动作条上出现「更新全部（N）」，行内给出可做的事，并多出一张「可安装的目录模板」表——这张表只来自 本次检查的结果，不会保存，重启 app 后消失，再点「检查更新」会重新出现。
操作列的按钮按状态出现：
| 按钮 | 何时出现 | 说明 |
|---|---|---|
| 更新 | 远端版本更高 | 一律装最新版；下载前校验 sha256 与内核形态 |
| 切换 | 可选版本 ≥ 2 | 开弹窗挑一版（含历史版本）。显式选过的版本记为「用户选定」，Coskey 升级带的种子不会再顶掉它 |
| 生成目录 | 没有任何用户目录行引用它 | 按该模板在「用户目录」建一条同名条目（slug 与基底都是这个模板 id，取值随模板现算） |
| 删除 | 非内置模板 | 移除本地模板文件；已引用它的用户目录行会标「目录模板缺失」并跳过合成，行本身不删 |
动作条上的「批量生成目录」是「生成目录」的批量版：给所有引用数为 0 的模板各建一条同名用户目录 条目（首次安装时也会自动补一遍）。
切换版本：
预览：点表格里的模板名（含首行的 default）开预览弹窗，两个页签——「模板 JSON」与「提示词」；
远端有、本地没装的版本会先下载并校验，只展示、不安装：
模板从哪下载由设置页的下载镜像选项决定（自动 / GitHub / Gitee），与更新清单、供应商预设同一套偏好。
5. 生效与排障
本页任何改动都要重启 ChatGPT.app：目录缓存只在内核启动时读一次。映射（改指向 / 窗口 / 启用停用）是另一回事，即时生效，见模型映射与上下文窗口。
| 现象 | 原因 / 处理 |
|---|---|
| 映射页窗口拖不过 272K | 该模型 id 没命中任何目录条目：去「用户目录」建一条 slug 是它前缀的条目（映射页也有「+ 用户目录」快捷入口） |
| 某行标「目录模板缺失」 | 它的基底模板被删了（或文件不在）：改成别的基底，或删掉这行；合成时会跳过它 |
| 某行标「已覆盖」 | 「系统目录」里改过官方条目；不想保留就点这行的「恢复官方配置」图标（或整表「批量恢复官方配置」） |
| 关掉增强后所有大窗口失效 | 预期行为：内核回到自带目录（272K）。重新开启并重启 app 即恢复，设置都还在 |
| 「可安装」表重启后没了 | 那张表只来自本次「检查更新」，不落盘；再点一次即回来 |
| 检查更新报「索引来自本地缓存」 | 联网失败时用本地缓存兜底；按提示重试，或先在设置页「下载镜像」里测速 |
下一步：在 ChatGPT.app 里使用。