catalog-maintainlisted
Install: claude install-skill xlong-c/apifix
# catalog-maintain
维护 `catalog.json`(唯一数据源)。流程:**调研 → 写 incoming 批次 → merge → validate → PR**。
**铁律**:只采信厂商官方文档(模型页 / API 文档 / 定价页),聚合站、中转后台、论坛不作来源;
未文档化就写 `null`,绝不臆造数值,不确定就降 `confidence`;每条必须带 `sources`
(http/https),否则 validate 报 error;`incoming/` 是宽松批次,**手工修正直接写 `catalog.json`**
(合并时手工条目优先);价格会过时,**最新研究优先**。
## 1)写模型批次(`incoming/<batch>.json`)
```json
{
"batch": "example-batch", "researched_at": "2026-09-15", "source": "official docs",
"models": [{
"id": "example-model-1", "vendor": "example", "family": "Example",
"api_protocol": "chat_completions", "verified": true,
"lifecycle": "current", "lifecycle_note": "2026-09-01 发布",
"context_window": 200000, "max_output_tokens": 64000,
"reasoning": {"supported": true, "effort_values": ["low", "high"], "default_effort": "high",
"summary_values": null, "can_disable": true, "thinking_budget": null},
"sampling": {
"temperature": {"supported": true, "range": "[0,2]", "constraint": null},
"top_p": {"supported": true, "range": null, "constraint": "默认 0.95"},
"top_k": {"supported": false, "range": null, "constraint": "忽略"}
},
"tools": {"function_calling": true, "parallel": null, "strict": true, "choice_modes": ["auto", "none"]},
"structured_output": {"supported": true, "mechanism": "response_format.type=json_object"},
"vision": true, "pdf": false,
"caching": {"mode": "automatic", "min_tokens": null, "ttl_options": null},
"aliases": [], "legacy_ids"