JohnXu22786/model-catalog

README 摘要

Model Catalog — 模型目录自动发现（dsh 插件） 本插件为 dsh（插件化 DeepSeek harness，一切皆是插件）生态设计：当你在 dsh 中配置了一个 OpenAI 兼容的 API 主机（官方 API、中转网关、本地推理服务等）后，插件自动从该主机的接口拉取模型信息——模型列表、定价（每百万 token 的输入/输出/缓存价）、推理参数（上下文长度、最大输出、能力标志：工具调用/结构化输出/视觉/并行工具等），归一化后生成可直接使用的模型配置，省去手工填写。 核心价值 ： - 主机类型自动识别，无需配置协议细节； - 全链路单位归一化（每 token 美元 / 每百万美元 / 倍率 / 按次）； - 定价可溯源（captured at + 来源端点），动态定价结构化表达； - 能力缺失时可选轻量实测探测； - 输出三种产物：完整目录、dsh 配置片段、人类可读报告。 功能特性 - 主机类型自动识别 ：标准兼容（最小字段）/ 富元数据（/models 带定价与参数清单）/ 倍率计价网关（quota 体系）/ 能力标志代理（/model/info 能力布尔族）/ Ollama / vLLM，全部端点探测失败时报错并支持 --kind 手工指定。 - 归一化模型记录 ： id / 上下文窗口 / 最大输出 / 定价族（input、output、cache read、cache write、internal reasoning，单位 USD/1M）/ 能力标志 / 来源溯源 。 - 定价来源链 ：主机接口 → 用户覆盖配置 → 外部价格镜像 → 内置默认表 → 标注未知（产生告警）。 - 内置默认表 ：官方 API（DeepSeek）的模型事实与定价兜底；动态定价（2026-08-16 起 peak/off-peak 分时计费）以结构化 tiers 表达。 - 能力探测验证 （可开关）：对元数据缺失的能力项（工具调用/结构化输出/流式）发送最小化请求实测，结果按 (baseUrl, model) 缓存。 - 缓存与并发安全 ：分类/探测/镜像结果按 TTL 缓存；文件锁 + 原子写防止并发进程互相破坏；损坏缓存自动恢复。 - 交互式配置生成 ： pick 命令列出模型与价格，选择后生成 dsh 配置片段。 - 自包含 ：manifest + 入口工厂 + 工具/事件接口，harness 可直接加载（见 接入说明）。 工作原理 快速开始 要求：Node.js ≥ 21（无运行时依赖；构建仅需 typescript）。 运行后在 out/ 目录得到三份产物。把 dsh-models.json 交给 dsh harness 即完成模型配置（字段说明见 接入说明）。 主机类型 类型 识别依据 定价来源 说明 bare 标准兼容 /v1/model…

分类