diff --git a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md index 96f3e88..b416ba5 100644 --- a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md +++ b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md @@ -90,6 +90,21 @@ tools: [fetch_model_doc, extract_llm_api_spec, apply_llm_config, apply_model_pri - 任务查询接口供应商级共用(DashScope 全系生成模型都是 GET /tasks/{task_id}): 查询步骤模板按 `{protocol}-query-{path}` 命名复用,多模型共享一份 +**param_schema 必须 Bricks 合规(2026-09-06 用户指正,生成器已硬编码执行)**: +schema 是 Bricks 动态表单的渲染契约,违规字段会被前端**静默丢弃** +(Input.create 遇未注册 uitype 返回 null 只打一行 debug,表单上字段直接消失,无任何报错)。规则: +- uitype 只用 Bricks 已注册控件白名单:text/hidden/code/date/datetime/image/audio/video 等, + **禁 textarea/number 等未注册值**(长文本用 text,数值用 code+data 枚举或 text) +- 媒体字段:专用控件 `image`/`audio`/`video` + `multiple: true`(三数组契约需多选) +- 默认值字段名必须是 `defaultvalue`——`default` 无人消费,等于没有默认值 +- 枚举业务参数(文档列了可选值):`uitype: code` + `data: [{value, text}]`, + 提取层 field_enums 逐字照抄文档,禁止编造枚举值 +- 结构常量(如 media 元素的 type: reference_image)不进表单——用户不该填、填了也没处放 +- 同名字段禁止重复出现(旧版曾按示例 3 元素产出 3 个重复 type 字段) +- **自愈门禁**:apply 复用存量模板前跑 `_schema_violations` 体检,hard 违规 + (未注册 uitype/default/重复/结构常量)一律弃用重建,soft(如缺 multiple)仅提示—— + 存量数据跟着代码自动痊愈,不需要人工去页面改 + **助手注意事项**: - extract 时确保 `request_example`/`response_example`/`request_headers` 逐字提取—— 它们是模板生成的唯一事实来源,漏提会降级为 request_fields 兜底(无默认值,notes 会警告)