model-spec-lookuplisted
Install: claude install-skill xlong-c/apifix
# model-spec-lookup
输入一个模型 ID(支持中转/别名写法),输出**官网规格值**与可直接粘贴的配置片段。
零网络请求,数据来自仓库内 `catalog.json`。
**何时使用**:问某模型支持什么参数(上下文 / 最大输出 / 推理档位 / 采样限制);在中转、
relay 上配置模型需要粘贴片段;怀疑模型被「降智」或参数不生效;把中转 ID
(`gpt-6-astra-free`、`openai/gpt-6-astra`)对照官网规范 ID。
**前置条件**:`git clone` 本仓库 + Node.js >= 18,在仓库根目录跑 `node apifix.mjs`;
全局安装过则用 `apifix <id>`。**离线可用**,不联网、不读本地客户端配置。
## 怎么跑
```bash
node apifix.mjs <id> # 默认输出 opencode 片段(最小字段集)
node apifix.mjs <id> --emit pi # pi 片段(也支持 codex / claude-env / curl / sdk)
node apifix.mjs <id> --emit codex -f # 完整 codex config.toml(provider 段 + 占位符)
node apifix.mjs <id> --emit claude-env -f # ~/.claude/settings.json 的 env 块(占位符)
node apifix.mjs <id> --canonical-id # key 用官网规范 id(修正中转旧名)
node apifix.mjs <id> --card # 完整规格卡片(含 gotchas / sources)
node apifix.mjs <id> --json # catalog 原始条目(含 pricing 元数据)
node apifix.mjs <id> -f # 完整模式:追加 cost / status / modalities
node apifix.mjs --match ids.txt # 批量逐行匹配
```
退出码:`0` 成功、`1` 未收录(`<id>` 与 `--match`)、`2` 用法/文件错误。
## 怎么读输出
**匹配标签**:`[OK]` 精确命中 / `[A]` 别名 / `[L]` legacy 或退役 id(中转常沿用旧名,值按
**当前**官网规格给)/ `[~]` 归一化(去前缀、`-free`/`-preview` 等后缀、分隔符等价)/
`[?]` 未收录(可能拼错或第三方专有命名,会给出最接近建议)。
注意:`[~]` 归一化命中只出现在**直接查询**(`apifix <id>` / `--match` / UI);`audit` / `fix` /
`protocols` 读配置时**只认 id / 别名 / legacy**——中转自造的名字应先登记为 catalog 的 `aliases`
(锚定),否则会记为未收录并给出「最接近(归一化写法,未自动采用官网规格)」建议。
**stderr 提示**(不污染 stdout,可 `2>/dev/null` 丢弃):`[i]` 解析说明,`[!]` 生命周期
警告与可信度提示。生命周期