aiLlmModelCapabilities

AI 大模型 capabilities 字段的默认值、归一化、Admin 表单 flags 互转与调用模式标签。

函数签名

const DEFAULT_AI_LLM_MODEL_CAPABILITIES: AiLlmModelCapabilities

function normalizeAiLlmModelCapabilities(raw: unknown): AiLlmModelCapabilities
function capabilitiesFromDbRow(row: Record<string, unknown>): AiLlmModelCapabilities
function capabilitiesFlagsFromCapabilitiesRaw(capabilities: unknown): AiLlmModelCapabilitiesFormFlags
function capabilitiesFlagsFromModelRow(row: { capabilities?: unknown }): AiLlmModelCapabilitiesFormFlags
function buildCapabilitiesPayload(flags: AiLlmModelCapabilitiesFormFlags): AiLlmModelCapabilities
function modelCallModeLabelFromCapabilities(capabilities: unknown): string
function modelCallModeLabelFromModelRow(row: { capabilities?: unknown }): string

类型见 zcw-shared/types/ai-llm-model-capabilities。

参数

参数名	类型	必填	说明
raw / capabilities	unknown	是	API 或 DB 中的 capabilities JSON
row	object	是	含 capabilities 字段的模型行
flags	AiLlmModelCapabilitiesFormFlags	是	Admin 表单勾选状态

返回值

函数	类型	说明
normalizeAiLlmModelCapabilities	AiLlmModelCapabilities	无效字段回退默认值
capabilitiesFlagsFrom*	AiLlmModelCapabilitiesFormFlags	表单用布尔 flags
buildCapabilitiesPayload	AiLlmModelCapabilities	flags → 落库结构
modelCallModeLabelFrom*	string	SSE 流式 或 HTTP 同步

工作原理

1. 默认：DEFAULT_AI_LLM_MODEL_CAPABILITIES 定义 attachments/imageInput/streaming 及 temperature 参数范围。
2. 归一化：normalizeAiLlmModelCapabilities 合并 raw 与默认，校验 boolean 与 parameters 数值。
3. 表单：capabilitiesFlagsFromCapabilitiesRaw 提取 attachments、imageInput、temperature、streaming 四个开关。
4. 落库：buildCapabilitiesPayload 由 flags 重建完整 capabilities（temperature 启用时带 min/max/default）。
5. 展示：modelCallModeLabelFromCapabilities 按 streaming 返回中文标签。

异常

无异常抛出；解析失败时使用默认值。