ComfyUI-Manager 工作流分享 API 集成指南-开发者社区

ComfyUI-Manager 工作流分享 API 集成指南

【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager

从"发链接靠截图"到"一键发布"：你的工作流分享困局

做 ComfyUI 的开发者或资深用户，几乎都遇到过这样的窘境：精心调好的工作流想分享给朋友，要么截图一堆节点图、要么把 workflow JSON 复制到聊天框里让人家手动导入，既费时又容易丢信息。其实 ComfyUI-Manager 内置了一套完整的工作流分享 API 集成方案，它把"工作流 + 生成结果 + 元数据"打包成一条可直接发布的内容，对接 OpenArt、YouML、Copus、Matrix、eSheep、ComfyWorkflows 等多个平台。下面这篇文章就带你从零跑通这套集成，约 15 分钟即可见效。

最短路径快速上手：3 步完成接入

先看效果、再讲原理。这套 API 的调用链非常短，你只需要在 ComfyUI 的前端环境里做三件事：

第 1 步：引入分享模块

// 在 comfyui-manager.js 同目录下导入公共分享入口 import { showOpenArtShareDialog, showCopusShareDialog, showYouMLShareDialog, ShareDialogChooser } from "./comfyui-share-common.js";

第 2 步：绑定一个触发按钮

<button onclick="handleShare()">把当前工作流分享出去</button>

第 3 步：调用统一入口

async function handleShare() { // 弹出平台选择器，让用户挑选目标站点 if (!ShareDialogChooser.instance) { ShareDialogChooser.instance = new ShareDialogChooser(); } ShareDialogChooser.instance.show(); }

到这里，你的页面上已经拥有了一个可用的"分享"入口，用户点开后能自由选择六个目标平台。如果只想要单平台直达，直接调用showOpenArtShareDialog()这类函数即可。

核心能力拆解：这套 API 到底能做什么

能力一：把工作流"翻译"成可传输的 JSON

app.graphToPrompt()是 ComfyUI 官方提供的方法，返回的对象里workflow字段就是可导入、可复用的工作流定义，output字段则是本次执行的完整提示词数据。所有分享逻辑都以此为数据源，你可以把它理解成把"图纸"（workflow）和"施工记录"（prompt）一起打包带走。

能力二：自动识别输出节点与产物

画布上的节点五花八门，API 不会盲目全部打包。getPotentialOutputsAndOutputNodes(nodes)会遍历所有节点，只认SUPPORTED_OUTPUT_NODE_TYPES里登记的六类"出口"：

export const SUPPORTED_OUTPUT_NODE_TYPES = [ "PreviewImage", "SaveImage", "VHS_VideoCombine", "ADE_AnimateDiffCombine", "SaveAnimatedWEBP", "CR Image Output" ];

对于视频类节点（如VHS_VideoCombine），还会通过parseURLPath()解析预览 widget 中的 URL 参数，过滤出format以image开头的产物，避免把不支持格式塞进请求。这一步的结果是一个结构清晰的数组：

{ type: "output", // 产物类型：image 或 output title: "我的预览图", // 节点标题 node_id: 12, // 节点 id output: { // 具体的文件定位信息 filename: "abc.png", subfolder: "outputs", format: "image/png" } }

能力三：按平台分发，一套逻辑多处复用

不同平台的能力差异，统一收敛在两个层面：前端各自实现一个继承自ComfyDialog的对话框类（如OpenArtShareDialog、CopusShareDialog），后端则通过glob/share_3rdparty.py里的若干/manager/*路由提供服务。下表可帮你快速对齐：

平台	前端入口	认证方式	特色能力
OpenArt	`showOpenArtShareDialog()`	API Key（存`.openart_key`）	发布 + 开发者管理模式
YouML	`showYouMLShareDialog()`	`.youml`配置文件	工作流转交互式应用
Copus	`showCopusShareDialog()`	平台账号	元数据丰富，支持区块链存储
Matrix	`showShareDialog('matrix')`	账号密码（存`matrix_auth`）	发图 + 发 workflow 文件到聊天室
ComfyWorkflows	`showShareDialog('comfyworkflows')`	shareKey	附带模型 SHA256 与快照信息
eSheep	`shareToEsheep()`	无需认证	弹窗跳转到平台网页上传

完整实战案例：把工作流发布到 OpenArt

下面以 OpenArt 为例，走一遍从"读配置"到"发布成功"的完整链路。

环境准备

确保你的 ComfyUI 已安装 ComfyUI-Manager，并在前端环境中能看到window.app与window.api（这两个对象由 ComfyUI 注入）。

第一步：读取/保存 API Key

// 保存密钥：POST 到 /manager/set_openart_auth await api.fetchApi(`/manager/set_openart_auth`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ openart_key: '你的密钥' }) }); // 读取密钥：GET /manager/get_openart_auth，未配置时后端返回 404 const key = await api.fetchApi(`/manager/get_openart_auth`) .then(r => r.ok ? r.json() : { openart_key: '' }) .then(d => d.openart_key);

第二步：组装发布数据

const prompt = await app.graphToPrompt(); const workflowJSON = prompt["workflow"]; // 工作流定义 const nodes = app.graph._nodes; const { potential_outputs } = getPotentialOutputsAndOutputNodes(nodes); const payload = { workflow: workflowJSON, images: potential_outputs, // 用户勾选的产物 title: "人像重绘工作流", description: "一键完成人脸修复与风格迁移", credits: "作者名", is_nsfw: false };

第三步：调用后端路由完成发布

const resp = await api.fetchApi(`/manager/share`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ ...payload, matrix_auth: { homeserver: "", username: "", password: "" }, cw_auth: { cw_sharekey: "" }, share_destinations: ["openart"] }) });

发布成功后，前端对话框里会渲染出"已发布，点击查看"的跳转链接，整个流程即告完成。

进阶技巧与避坑指南

常见报错对照表

现象	根因	处理建议
提示找不到输出节点	画布上没有六类受支持节点，或未跑过一次生成	先添加 PreviewImage/SaveImage 并执行一次
产物列表为空	节点存在但`images`数组为空	先跑通一次生成再点分享
读取 API Key 返回 404	密钥从未保存	先 POST 保存，再 GET 读取
OpenArt 校验失败	密钥错误或网络不通	检查密钥、确认能访问 openart.ai
分享对话框打不开	缺少配套 CSS	确认`custom-nodes-manager.css`等样式已引入

安全与认证建议

🔑 密钥写在后端文件（如.openart_key），前端只读不回显，避免把密钥硬编码进源码。
📌 区分环境：comfyui-share-copus.js里用env变量切换 prod/test 的 API 地址，联调时记得切到测试环境。
⚠️ 若你的应用走 HTTPS，跳转外站时注意混入内容警告；eSheep 流程依赖前端构造window.location地址并window.open，请确保域名与端口拼接正确。

个性化定制

想改默认分享站点？读写/manager/share_option路由即可持久化用户偏好，前端comfyui-manager.js中的分享按钮会据此决定直达还是弹出选择器。
想扩展输出节点类型？把新节点名加进SUPPORTED_OUTPUT_NODE_TYPES，并在getPotentialOutputsAndOutputNodes里补充对应的产物解析分支。

总结与延伸资源

回顾一下这次集成：入口在js/comfyui-share-common.js，分发逻辑在各平台的分享对话框类里，后端路由集中在glob/share_3rdparty.py。你只需要掌握app.graphToPrompt()取数据、getPotentialOutputsAndOutputNodes()筛产物、api.fetchApi()走接口这三板斧，就能在自己的应用里复刻一套完整的工作流分享能力。

想继续深入，推荐按这份清单延展阅读：

统一入口与工具函数：js/comfyui-share-common.js
各平台对话框实现：js/comfyui-share-openart.js、js/comfyui-share-copus.js、js/comfyui-share-youml.js
后端路由与认证存取：glob/share_3rdparty.py
前端接线示例：js/comfyui-manager.js

动手跑一遍上面的示例，再对照源码逐行读，你很快就能在 ComfyUI-Manager 的分享体系上搭建出自己的发布管道。如果你对某个平台的细节（比如 YouML 的交互式应用转换、Copus 的区块链存储）感兴趣，欢迎带着问题再去翻对应的对话框源码，那里有更完整的答案。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考