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 3d7540f..ccb1e0a 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 @@ -87,11 +87,15 @@ tools: [fetch_model_doc, extract_llm_api_spec, apply_llm_config, apply_model_pri - 旧骨架模板(含 `__from_doc__`/`__note__`/`xxx_file`/旧单值 `params.image_file)` 标记) 视为不可用,apply 时自动弃用(status=deprecated)并按文档示例重建——**存量坏模板 重跑一次 apply 即自愈,不需要人工去页面改** +- **提交模板复用键=(协议×能力×形态指纹)**(2026-09-06 用户定夺):指纹=归一化 + (path, request_template, response_template, param_schema) 的 sha256 前 12 位, + 命名 `{protocol}-{cap}-自动配置-{指纹}`。同形态→复用(旧命名无指纹段的收编改名); + 异形态→各建各的、旧模板保留(还挂着存量模型,不弃用)。解决两个实测问题: + happyhorse r2v 纯图 vs wan3.0 r2v 四模态按能力共享模板静默丢媒体; + wan3.1 若 API 与 wan3.0 完全一致则指纹相同、零新增模板。 - 任务查询接口供应商级共用(DashScope 全系生成模型都是 GET /tasks/{task_id}): - 查询步骤模板按 `{protocol}-query-{path}` 命名复用,多模型共享一份。 - **提交模板复用查询排除两种命名**(2026-09-06 i2v 实测):共享命名含中缀 - `-query-`,legacy 命名 `{vmid}-query` 以 `-query` 结尾——只排中缀会让 legacy - 查询模板被误选为提交模板(空 schema 无 hard 违规,静默误挂,运行必 404) + 查询步骤模板按 `{protocol}-{purpose}-{path}` 命名复用,多模型共享一份。 + 提交模板按精确命名(含指纹段)查找,查询/下载步骤模板命名不同、天然不会误选 **param_schema 必须 Bricks 合规(2026-09-06 用户指正,生成器已硬编码执行)**: schema 是 Bricks 动态表单的渲染契约,违规字段会被前端**静默丢弃** @@ -133,8 +137,8 @@ schema 是 Bricks 动态表单的渲染契约,违规字段会被前端**静默 有匹配端点时**只选匹配项**(不匹配/未标注的都排除) - apply 自检:活跃账号未绑本协议端点 → 自动补绑并报 `account_notes` - 运行时 `_join_url` 拼接去重:path 带 base_url 已有前缀时不重复拼 -- 提交模板复用查询排除 `%-query-%`/`%-download-%`(步骤模板同库同协议同能力, - 不排除会被误选为提交模板 → 提交打到查询 path → 404) +- 提交模板按精确命名(`{protocol}-{cap}-自动配置-{指纹}`)查找,查询/下载步骤模板 + 命名形态不同,天然不会误选为提交模板(历史版本靠 LIKE 排除,已升级为指纹命名) **给内部 agent 的规则**: - base_url 必须取文档示例 URL 除接口路径外的**完整前缀**(含 /api/v1 等路径段),