import { ImageGenError } from "./errors.js"; import type { ModelCapability, ModelInfo } from "./types.js"; export class ModelRegistry { constructor(private readonly models: ModelInfo[]) {} all(): ModelInfo[] { return [...this.models].sort((a, b) => a.id.localeCompare(b.id)); } byCapability(cap: ModelCapability): ModelInfo[] { return this.all().filter((m) => m.capabilities.includes(cap)); } get(id: string): ModelInfo | undefined { return this.models.find((m) => m.id === id); } select(capability: ModelCapability, explicit?: string, configured?: string): ModelInfo { const preferred = explicit || configured; const isConfiguredDefault = explicit === undefined && configured !== undefined; if (preferred) { const model = this.get(preferred); if (!model) throw new ImageGenError("model_unavailable", `模型 ${preferred} 不在已发现模型列表中。`, "请在 /image-config 中刷新模型,或确认模型名称。 "); if (!model.capabilities.includes(capability) && !model.capabilities.includes("unknown")) { const operation = capability === "image_edit" ? "图片编辑" : capability === "image_variation" ? "图片变体" : "图片生成"; const suggestion = isConfiguredDefault ? `当前${operation}跟随生图模型 ${preferred},但该模型未声明支持此操作。请在 /image-config 选择专用模型,或手动声明模型能力。` : "请在 /image-config 中查看可用模型,或用 IMAGE_MODEL_CAPABILITIES 手动声明能力。 "; throw new ImageGenError("model_unavailable", `模型 ${preferred} 未声明支持 ${capability}。`, suggestion); } if (model.capabilities.includes("unknown")) { throw new ImageGenError("capability_unknown", `无法自动判断模型 ${preferred} 是否支持 ${capability}。`, "请设置 IMAGE_MODEL_CAPABILITIES='model:image_generation' 之类的手动能力声明。 "); } return model; } const capable = this.byCapability(capability); if (capable.length > 0) return capable[0]!; const unknown = this.byCapability("unknown"); if (unknown.length > 0) { throw new ImageGenError("capability_unknown", `没有可确认支持 ${capability} 的模型,但发现 unknown 模型。`, `请在 /image-config 中查看模型,并用 IMAGE_MODEL 或 IMAGE_MODEL_CAPABILITIES 手动指定。`); } throw new ImageGenError("model_unavailable", `没有发现支持 ${capability} 的模型。`, "检查 API 是否支持图片接口,或手动配置对应模型。 "); } summary(): Record { return { image_generation: this.byCapability("image_generation").map((m) => m.id), image_edit: this.byCapability("image_edit").map((m) => m.id), image_variation: this.byCapability("image_variation").map((m) => m.id), vision: this.byCapability("vision").map((m) => m.id), text: this.byCapability("text").map((m) => m.id), unknown: this.byCapability("unknown").map((m) => m.id), }; } }