%20(1).png)
ComfyUI FK Server 插件完全教程
插件简介
插件地址： https://github.com/juehackr/comfyui_fk_server
ComfyUI FK Server 是一个功能强大的 ComfyUI 插件，主要提供以下核心功能：
- 翻译功能 - 让 ComfyUI 任意长文本输入框支持中文输入并自动翻译（调用百度翻译）
- 提示词润色功能 - 输入简单关键词帮你写出专业的AI绘画提示词（调用智谱AI大模型）
- 模型引用修复功能 - 一键修复工作流中模型文件路径不一致的问题
- FK高级贴图编辑器 - 支持融合深度图的高级贴图编辑工具
- 3D姿态编辑器 - 简单好用的3D姿态编辑器节点
- PS互通插件 - 一键实现ComfyUI与PS互通交互
- 云算力环境配置 - 支持云端算力配置
如何安装
方法一：Git克隆安装（推荐）
- 进入 ComfyUI 插件目录：
/ComfyUI/custom_nodes/ - 执行命令：
git clone https://github.com/juehackr/comfyui_fk_server.git - 重启 ComfyUI
方法二：手动下载安装
- 从 GitHub 下载插件压缩包
- 解压到
/ComfyUI/custom_nodes/目录 - 重启 ComfyUI
节点详细解析
总节点数量统计
经过源码分析，该插件包含 3个主要节点：
- FK_图片编码转换 (FK_Node)
- FK_高级贴图编辑器 (FK_ShowBaseNode)
- FK_3D姿态编辑器 (FK_3dpose)
3.1 FK_图片编码转换节点 (FK_Node)
节点功能
这个节点就像一个"图片打包机"，它把你的图片（背景图、深度图、贴图）转换成特殊的代码格式，让其他节点能够读取和处理这些图片数据。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 背景图 | background | IMAGE | 必填 | 就像画画的画布，是整个图片的底色背景 | 输入的背景图像数据，作为贴图编辑的基础层 | 连接任何图片加载节点，比如Load Image |
| 深度图 | Depth | IMAGE | 必填 | 就像地形图，告诉电脑哪里高哪里低，让贴图更立体 | 深度信息图像，用于3D效果和空间感的计算 | 通常来自深度估计节点或ControlNet |
| 贴图 | Texture | IMAGE | 必填 | 要贴上去的图案，就像贴纸一样 | 需要应用到背景上的纹理图像 | 可以是任何想要贴到背景上的图片 |
| 贴图遮罩 | TextureMask | MASK | 必填 | 就像模板，决定贴图贴在哪些地方 | 控制贴图应用区域的遮罩，白色区域应用贴图 | 通常来自分割节点或手动绘制的遮罩 |
输出说明
| 输出名 (UI显示) | 输出名 (代码里) | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|---|
| 背景图代码 | background | STRING | 背景图变成的密码本，其他节点能读懂 | Base64编码的背景图像数据 |
| 深度图代码 | Depth | STRING | 深度图变成的密码本 | Base64编码的深度图像数据 |
| 贴图代码 | Texture | STRING | 贴图变成的密码本 | Base64编码的贴图数据（包含透明度信息） |
3.2 FK_高级贴图编辑器节点 (FK_ShowBaseNode)
节点功能
这个节点就像一个"高级图片编辑器"，它接收上面转换好的图片代码，然后打开一个专门的编辑界面，让你可以像用Photoshop一样编辑和调整贴图效果。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 背景图输入 | background | STRING | 来自FK_Node | 接收背景图的密码本 | 强制输入连接，接收背景图的Base64数据 | 必须连接FK_图片编码转换节点的背景图输出 |
| 深度图输入 | depth | STRING | 来自FK_Node | 接收深度图的密码本 | 强制输入连接，接收深度图的Base64数据 | 必须连接FK_图片编码转换节点的深度图输出 |
| 贴图输入 | Texture | STRING | 来自FK_Node | 接收贴图的密码本 | 强制输入连接，接收贴图的Base64数据 | 必须连接FK_图片编码转换节点的贴图输出 |
| 背景图代码显示 | backgroundcode | STRING | 自动生成 | 显示背景图密码本的地方，不用手动填写 | 多行文本框，显示背景图的Base64编码 | 会自动填充，用于查看或调试 |
| 深度图代码显示 | depthcode | STRING | 自动生成 | 显示深度图密码本的地方，不用手动填写 | 多行文本框，显示深度图的Base64编码 | 会自动填充，用于查看或调试 |
| 贴图代码显示 | Texturecode | STRING | 自动生成 | 显示贴图密码本的地方，不用手动填写 | 多行文本框，显示贴图的Base64编码 | 会自动填充，用于查看或调试 |
特殊功能
- 这个节点会自动打开一个网页编辑器界面
- 支持实时预览贴图效果
- 可以调整贴图的透明度、混合模式等参数
- 支持深度图融合，让贴图更有立体感
3.3 FK_3D姿态编辑器节点 (FK_3dpose)
节点功能
这个节点就像一个"3D小人编辑器"，让你可以在3D空间里摆弄一个虚拟小人的姿势，然后生成对应的姿态图、深度图等，用于ControlNet控制图片生成。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 姿态数据 | pose | STRING | 编辑器生成 | 3D小人的姿势信息，就像动作指令 | 3D姿态的JSON数据，包含关节位置信息 | 在3D编辑器中摆好姿势后自动生成 |
| 深度数据 | depth | STRING | 编辑器生成 | 3D小人的远近信息，哪里凸出哪里凹进 | 深度图的数据，用于生成深度控制图 | 编辑器根据3D模型自动计算 |
| 法线数据 | normal | STRING | 编辑器生成 | 3D小人表面的方向信息，用于光照计算 | 法线贴图数据，表示表面朝向 | 编辑器自动生成，用于更真实的光影效果 |
| 边缘数据 | canny | STRING | 编辑器生成 | 3D小人的轮廓线信息，就像简笔画 | Canny边缘检测结果，提取轮廓信息 | 编辑器自动生成轮廓线 |
输出说明
| 输出名 (UI显示) | 输出名 (代码里) | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|---|
| OpenPose图 | OpenPose | IMAGE | 骨架姿态图，显示人体关节连线 | 标准OpenPose格式的姿态控制图 |
| 深度图 | Depth | IMAGE | 远近关系图，白色近黑色远 | 深度控制图，用于ControlNet深度控制 |
| 法线图 | Normal | IMAGE | 表面方向图，用于光影效果 | 法线贴图，RGB通道表示XYZ方向 |
| 边缘图 | Canny | IMAGE | 轮廓线图，黑白线条画 | Canny边缘检测图，用于轮廓控制 |
| 宽度 | Width | INT | 图片的宽度像素数 | 生成图像的宽度尺寸 |
| 高度 | Height | INT | 图片的高度像素数 | 生成图像的高度尺寸 |
特殊功能
- 打开专门的3D编辑界面
- 可以360度旋转查看姿态
- 支持预设姿态快速应用
- 实时预览生成的控制图效果
- 支持导出多种格式的控制图
4. 使用技巧和建议
4.1 翻译功能使用技巧
- 双击激活：双击任意长文本输入框即可启用自动翻译模式
- 自动检测：输入中文后，鼠标移开或点击其他区域即可自动翻译
- 密钥配置：需要申请百度翻译API密钥，每月100万字符免费额度
- 报错翻译：选择报错内容点击翻译按钮可翻译错误信息
4.2 贴图编辑器使用技巧
- 数据准备：必须先使用FK_图片编码转换节点准备图片数据
- 深度融合：利用深度图可以让贴图更有立体感和真实感
- 遮罩精确：精确的遮罩能让贴图效果更自然
- 实时预览：编辑器支持实时预览，可以即时看到效果
4.3 3D姿态编辑器使用技巧
- 姿态预设：可以使用内置的姿态预设快速开始
- 多角度查看：利用3D视角功能从不同角度检查姿态
- 批量生成：一次编辑可以生成多种类型的控制图
- 尺寸匹配：注意输出尺寸要与目标生成图片尺寸匹配
5. 常见问题解答
Q1：翻译功能不工作怎么办？
A1：
- 检查是否正确配置了百度翻译API密钥
- 确认网络连接正常
- 检查API密钥是否有剩余额度
- 重启ComfyUI后重新配置
Q2：贴图编辑器打不开怎么办？
A2：
- 确保已经使用FK_图片编码转换节点生成了图片数据
- 检查浏览器是否阻止了弹窗
- 尝试刷新页面或重启ComfyUI
- 检查网络连接和端口是否被占用
Q3：3D姿态编辑器卡顿怎么办？
A3：
- 降低编辑器的显示质量设置
- 关闭不必要的实时预览功能
- 检查电脑显卡性能和内存使用情况
- 尝试使用较小的输出尺寸
Q4：模型引用修复功能如何使用？
A4：
- 在ComfyUI设置中找到FK Server相关选项
- 启用模型引用修复功能
- 加载有问题的工作流时会自动尝试修复路径
- 基于模型文件名进行智能匹配
Q5：如何配置云算力环境？
A5：
- 需要安装Node.js环境
- 插件会自动检测并配置必要的依赖
- 如果自动安装失败，需要手动在server目录执行npm install
- 配置完成后可以使用云端算力功能
6. 高级功能说明
6.1 PS互通功能
- 支持Windows和macOS系统
- 需要在PS中安装对应的插件
- 可以实现ComfyUI与Photoshop的双向数据传输
- 支持图层、画布、选区等多种数据类型
6.2 提示词润色功能
- 使用智谱AI大模型进行提示词优化
- 输入简单关键词即可生成专业提示词
- 支持中文输入，自动优化为英文提示词
- 可自定义润色模板和风格
6.3 云算力配置
- 支持多种云算力平台
- 可以配置API密钥使用云端GPU
- 支持负载均衡和任务队列管理
- 提供使用统计和费用监控
7. 注意事项
- 网络要求：部分功能需要稳定的网络连接
- API配置：翻译和润色功能需要配置相应的API密钥
- 浏览器兼容：建议使用Chrome或Edge浏览器以获得最佳体验
- 性能要求：3D编辑器对显卡有一定要求
- 数据安全：注意保护API密钥等敏感信息
- 版本兼容：确保ComfyUI版本与插件版本兼容
8. 更新日志
当前版本：v1.31
- 优化了翻译功能的稳定性
- 改进了贴图编辑器的用户界面
- 修复了3D姿态编辑器的一些bug
- 增强了云算力配置的兼容性
总结： ComfyUI FK Server 是一个功能丰富的综合性插件，特别适合需要中文支持、高级贴图编辑和3D姿态控制的用户。通过合理配置和使用，可以大大提升ComfyUI的使用体验和工作效率。