comfyui-portrait-master
ComfyUI Portrait Master 是一款专为 ComfyUI 设计的自定义节点工具，旨在帮助创作者轻松生成高质量的人像提示词。它解决了用户在绘制人物时难以精准描述五官、肤质、妆容及光影细节的痛点，让 AI 能更准确地理解并还原复杂的人像特征。
无论是刚接触 AI 绘画的普通用户，还是追求极致细节的专业设计师，都能从中受益。该工具采用模块化设计，将人物创作拆解为基础特征、皮肤纹理、风格姿态、化妆造型等独立单元，用户可像搭积木一样自由组合。其独特亮点在于拥有超过 1000 种预设选项，涵盖 192 种国籍混合、65 种艺术风格及专业的皮肤毛孔渲染控制，甚至支持将复杂的权重提示词自动转换为自然语言风格，以适配现代模型。此外，内置的随机生成与配置保存功能，进一步提升了创作效率与探索乐趣，让人像生成变得既专业又简单。
使用场景
一位独立游戏开发者正在为一款叙事驱动的角色扮演游戏批量生成具有特定文化背景和真实皮肤质感的 NPC 肖像。
没有 comfyui-portrait-master 时
- 提示词构建繁琐：手动编写包含国籍、年龄、发型及微表情的详细提示词耗时极长，且容易遗漏关键特征描述。
- 肤色质感单一：难以精准控制皮肤细节，生成的角色往往像“塑料娃娃”，缺乏毛孔、瑕疵等自然纹理，导致画面失真。
- 风格一致性差：在尝试混合多种族特征或统一光照风格时，全靠运气调整权重，难以复现理想的视觉效果。
- 创意探索受限：每次微调参数都需要重写整段提示词，无法快速随机测试不同造型组合，严重拖慢原型设计进度。
使用 comfyui-portrait-master 后
- 模块化高效搭建：通过“基础角色”和“妆容”等节点，仅需拖拽滑块和选择下拉菜单，即可秒级生成结构严谨的专业提示词。
- 极致皮肤渲染：利用“皮肤细节”节点精确调控毛孔与瑕疵，轻松打造出拥有真实肌肤质感的照片级人像。
- 精准风格控制：借助内置的 192 种国籍库和混血功能，配合专业光照预设，稳定输出符合设定要求的多样化角色。
- 工作流自动化：利用随机生成和预设保存功能，一键批量产出数百张不同配置的肖像草图，极大加速了美术资产的生产流程。
comfyui-portrait-master 将复杂的人像提示词工程转化为可视化的模块化操作，让创作者能专注于艺术构思而非文字调试。
运行环境要求
- 未说明
未说明（依赖 ComfyUI 及所选模型，如 SD1.5/SDXL/Flux 的硬件需求）
未说明
快速开始
ComfyUI 人像大师
一款专为 ComfyUI 设计的全面自定义节点，旨在帮助 AI 图像创作者生成详细且专业的真人肖像提示词。这款强大的工具提供了对肖像生成各个方面的模块化控制，从基本的人物特征到高级的皮肤细节和造型选项。
🌟 功能
模块化节点系统
- 人像大师：基础角色 - 核心角色属性（性别、年龄、国籍、体型、面部特征）
- 人像大师：皮肤细节 - 高级皮肤渲染控制（毛孔、瑕疵、自然皮肤效果）
- 人像大师：风格与姿势 - 光线、姿势、服装和艺术风格
- 人像大师：化妆 - 全面的化妆选项及颜色控制
- 人像大师：人脸生成器 - 简化的脸部生成，快速出图
- 人像大师：提示词样式器 - 将加权提示词转换为现代模型的对话式风格
高级功能
- 预设系统 - 在所有节点中保存和加载您喜爱的配置
- 随机生成 - 内置随机化功能，用于创意探索
- 权重控制 - 细致调整每个参数的影响程度
- 国籍混合 - 多种族融合，精确控制比例
- 全面列表 - 所有类别中超过1000+选项
丰富的选项库
- 192个国籍 - 完整覆盖全球
- 65+种艺术风格 - 从复古摄影到现代特效
- 100+种发型 - 全面的发型选择
- 70+种灯光类型 - 专业灯光设置
- 87+种模特姿势 - 多样化的姿势库
- 还有更多 - 眼睛、嘴唇、化妆、服装、表情和体型等
📋 要求
- ComfyUI - 推荐使用最新版本
- Python 3.8+ - ComfyUI 的必要依赖
- 兼容模型 - 支持 SD1.5、SDXL、Flux 及其他现代检查点
- 可选依赖：
- ComfyUI Manager - 方便安装
- ComfyUI 提示词控制 - 用于国籍混合语法
🚀 安装
方法 1：ComfyUI 管理器（推荐）
- 打开 ComfyUI 管理器
- 在搜索栏中输入
florestefano1975 - 点击“ComfyUI 人像大师”的安装按钮
- 重启 ComfyUI
方法 2：手动安装
- 导航到您的 ComfyUI
custom_nodes文件夹 - 在该目录下打开终端或命令提示符
- 运行：
git clone https://github.com/florestefano1975/comfyui-portrait-master - 重启 ComfyUI
方法 3：手动更新
要更新现有安装：
- 导航到
comfyui-portrait-master文件夹 - 运行：
git pull - 重启 ComfyUI
⚠️ 注意：更新命令会覆盖您对文件所做的任何自定义修改。
📖 使用指南
基本流程
- 添加基础角色节点 - 从
PortraitMasterBaseCharacter开始，获取核心功能 - 串联其他节点 - 连接
PortraitMasterSkinDetails、PortraitMasterStylePose等节点 - 配置参数 - 根据喜好调整滑块和下拉菜单
- 连接提示词 - 将最终输出连接到您的
CLIPTextEncode节点 - 生成 - 运行工作流以创建详细的肖像提示词
节点说明
人像大师：基础角色
控制人物的基本属性：
- 拍摄类型：头部肖像、全身、特写等
- 人口统计：性别、年龄、支持国籍混合
- 身体特征：体型、胸部/臀部大小、面部特征
- 头发与胡须：样式、颜色、长度选项
- 面部细节：表情、脸型、不对称控制
人像大师：皮肤细节
高级皮肤渲染控制：
- 皮肤质量：自然肌肤、素颜、洗净/干燥效果
- 细节：皮肤毛孔、瑕疵、痤疮、晒黑皮肤
- 特征：酒窝、雀斑、痣、皱纹
- 眼睛：精细的眼部渲染、虹膜细节、瞳孔形状
人像大师：风格与姿势
环境和艺术控制：
- 姿势：姿势库中的87+种模特姿势
- 服装：普通服装和女性内衣选项
- 灯光：70+种专业灯光设置，可控制方向
- 风格：65+种艺术风格，从复古到现代
- 增强：照片真实感提升开关
人像大师：化妆
全面的化妆系统：
- 样式：多种化妆风格和配色方案
- 单独元素：眼影、眼线、睫毛膏、腮红、口红、唇彩
- 颜色控制：可选择特定的化妆颜色
人像大师：人脸生成器
简化的人脸生成，快速出图：
- 优化设置：预设正面、对称的脸部
- 基本控制：性别、年龄、国籍、基本特征
- 干净输出：中性表情搭配专业灯光
人像大师：提示词样式器
将传统加权提示词转换为对话式风格：
- 风格选项：描述性、电影感、插画风、艺术风、纪录片风、时尚风
- 现代兼容性：针对 Flux、Sana、HiDream 等模型优化
- 干净转换：去除 SD1.5/SDXL 的权重语法
🎛️ 预设系统
保存预设
- 在节点中将所有参数配置为您想要的设置
- 向下滚动至底部的
--- PRESETS ---部分 - 在
save_preset_as字段中输入一个描述性名称（例如：“赛博朋克英雄”） - 将
save_preset切换为True - 将提示词加入队列以保存预设
- 再次将
save_preset切换回False
加载预设
- 使用
load_preset下拉菜单 - 从您保存的预设中选择适用于该节点的预设
- 将提示词加入队列以应用预设设置
预设存储
预设存储在 comfyui-portrait-master/presets/ 中，每个节点类型都有独立的子目录：
presets/BaseCharacter/presets/SkinDetails/presets/StylePose/presets/Makeup/presets/FaceGenerator/
🎲 随机生成
通过内置随机化功能开启创意探索：
- 随机选项：从任意下拉菜单中选择“random 🎲”
- 种子控制：连接种子输入以实现可重复的随机化
- 权重控制：使用滑块控制随机选择的影响程度
📊 可用参数
核心参数
| 参数 | 描述 | 选项 |
|---|---|---|
shot |
人像构图类型 | 8种选项（头部特写、全身等） |
gender |
角色性别 | 男、女 |
age |
角色年龄 | 多个年龄段 |
nationality_1 & nationality_2 |
民族选项 | 192种国籍 |
body_type |
身材体型 | 多种体型 |
eyes_color |
眼睛颜色 | 10多种颜色选项 |
hair_style |
发型 | 100多种发型 |
hair_color |
发色 | 21种发色选项 |
高级控制
- 权重参数：以小数精度精细调整影响程度（0.00-2.00）
- 国籍混合：使用
nationality_mix滑块混合不同民族特征（0.0-1.0） - 面部不对称：添加逼真的面部细节差异
- 皮肤细节：控制毛孔、瑕疵及自然肤质效果
- 光照方向：专业灯光设置，可定向控制
🖼️ 模型姿势库
model_pose选项提供87+种预设姿势：
- 使用姿势库时请禁用ControlNet
- 使用
shot参数调整构图 - 姿势针对人像生成进行了优化
💡 小贴士与最佳实践
最佳设置
- 皮肤细节：过高数值可能覆盖构图设置，必要时可调低
- 眼睛细节：需与构图类型平衡，避免冲突
- 负面提示词：若细节参数产生干扰，可加入
(closeup, close up, close-up:1.5) - 模型选择：为获得最佳效果，请使用高质量检查点
推荐模型
- FormulaXL 2.0 - 非常适合写实风格人像
- SDXL模型 - 通常能提供更优质的人像效果
- Flux模型 - 配合Prompt Styler使用可获得最佳结果
工作流集成
- 兼容Prompt Composer
- 串联多个Portrait Master节点以创建复杂角色
- 使用预设保持项目间的一致性
🔧 故障排除
常见问题
节点未在ComfyUI中显示
- 安装后请重启ComfyUI
- 检查文件是否放置于正确的
custom_nodes目录下 - 查看控制台是否有Python错误信息
随机选项无法正常工作
- 连接种子输入以启用随机化
- 确保下拉菜单中已选择“随机🎲”
- 检查种子连接是否正确
预设系统无法运行
- 确认ComfyUI目录具有写入权限
- 检查
presets文件夹是否已自动生成 - 确保预设名称不包含非法字符
国籍混合功能无效
- 安装ComfyUI Prompt Control以支持完整语法
- 使用格式：
[nationality_1:nationality_2:mix_value] - 此功能尚属实验性，可能并非所有模型均适用
输出提示词过于复杂
- 使用Prompt Styler节点简化提示词，使其适配现代模型
- 降低权重值以实现微妙效果
- 将未使用的参数设置为“-”以将其排除
性能问题
- 大型工作流：建议同时运行较少的节点
- 内存占用：高细节设置可能会增加显存需求
- 生成速度：复杂提示词可能导致推理速度变慢
📝 版本历史
版本3.5.0（最新）
- ✨ 新增：人脸生成节点，简化人脸创建流程
- ✨ 增强：基础角色节点新增胸部和臀部尺寸选项
- 🔧 改进：整体代码性能与稳定性提升
版本3.4.0
- ✨ 新增：全面的预设系统覆盖所有节点
- ✨ 新增：Prompt Styler节点，用于兼容现代模型
- 🔄 重构：拆分为五个专用模块
- 🔧 改进：代码优化及性能提升
以往版本
完整版本历史请参阅CHANGELOG.md。
🤝 贡献方式
我们欢迎各位为Portrait Master贡献力量：
- Bug报告：请通过GitHub Issues提交Bug报告
- 功能请求：可通过GitHub Issues提出新功能建议
- 代码贡献：欢迎提交Pull Request以改进代码
- 文档编写：帮助完善文档与示例说明
📄 许可协议
本项目遵循LICENSE文件中的条款进行许可。
💖 支持本项目
若您觉得Portrait Master很有用，请考虑支持开发者：
您的支持将有助于维护并持续改进该项目，造福整个社区。
🔗 相关项目
- ComfyUI Prompt Composer - 高级提示词组合工具
- ComfyUI HiDiffusion - 高分辨率扩散模型增强
📚 其他资源
由AI Wiz Art（Stefano Flore）制作
版本3.5.0 | GitHub仓库
常见问题
相似工具推荐
openclaw
OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。
gemini-cli
gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。 这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。 它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。
markitdown
MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。 在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。 这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器
LLMs-from-scratch
LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。 该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。 LLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备