docs(skill): 提交模板复用键改形态指纹——命名规则/收编/异形态保留/wan3.1零新增预期
This commit is contained in:
parent
94c78dea1b
commit
fbf473b1d7
@ -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 等路径段),
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user