# ComfyUI 工作流高级参数 导入 API 工作流并连接 ComfyUI 后,高级区会根据实际节点定义识别可编辑的布尔、数值、字符串和枚举。连线、隐藏输入及强制连接的输入不生成编辑控件。 未修改的参数沿用原工作流。修改只应用于提交和导出的副本,不改写导入原文;可以逐项或全部恢复。切换工作流不会把旧节点编号对应的覆盖值误用到新图。 ## 可选的显示声明 以下 `studio` 元数据是本项目的扩展约定,不是 ComfyUI 标准。未声明的普通 API 仍可识别其可编辑参数。 ```json { "32": { "class_type": "PrimitiveInt", "inputs": { "value": 0 }, "_meta": { "title": "输出模式", "studio": { "controls": [{ "input": "value", "label": "输出类型", "description": "选择此工作流实现的输出形式。", "group": "输出", "options": [ { "value": 0, "label": "单个人物" }, { "value": 1, "label": "设定页" } ] }] } } } } ``` `controls` 将真实已有字段列为推荐参数,并可提供名称、说明、分组和枚举标签;它不能创建不存在的字段、改变连接类型或绕过节点定义的值域。没有推荐声明的可编辑字段进入折叠的“其他参数”。`hiddenInputs` 可列出不希望显示或覆盖的字段名,例如内部路由的比较符、正则表达式及固定配置。 自动计算的布尔连线不会变成手动开关。工作流若需“自动/开启/关闭”,应提供真实的模式常量,并在图内实现对应分支。 ## 高级参考图片 未绑定到主三槽或参考拼图映射的图片加载节点,可在高级区上传替换图片。普通图片节点未上传时保留原工作流图片;支持空值的设定集节点未提供时明确清空。 为完整设定集加载节点添加 `_meta.studio.imageRole: "character_sheet"` 后,它会显示为角色设定集入口,不参与主三槽的自动映射。上传图片沿用最长边1024的读取方式,保存在 IndexedDB;localStorage 配方备份不包含这些图片。 设定集作为输入和设定页作为输出是不同用途。元数据只描述入口和控件,实际生成能力必须由 API 内的节点与连接实现。 ## 允许的参考组合 工作流可在一个节点的 `_meta.studio.referenceCombinations` 声明允许输入的节点集合,例如: ```json [["1", "2"], ["1", "3"], ["2", "3"], ["1", "2", "3"], ["31"]] ``` 网页按用户实际提供的图片精确匹配集合;JSON 残留图片不算用户已提供。不声明此字段的旧工作流仍遵循原有映射与必填检查。 “导出当前 API”包括选定的高级参数和当前提示词;图片上传发生在提交时,导出不会把浏览器里的图片打包进 JSON。也可从 JSON 编辑窗口导出原始 API。 部分 ComfyUI 画布转 API 工具只保留节点标题,会丢弃自定义 `studio` 元数据。需要保留推荐控件和组合声明时,请使用包含该声明的 API 文件。