PhotoCraft OpenFill：安装与生成式填充操作指南

OpenFill 在桌面 PhotoCraft 旁提供生成式编辑面板，使用本地 ComfyUI 引擎，不在本站编辑器里运行。 如果你希望通过选区和提示词编辑，不想每次从节点图开始，可以考虑这种工作流。

验证状态——2026 年 10 月 28 日： 本文根据文档核查编写，针对 OpenFill 0.2.4 及其文档列出的 PhotoCraft 0.12–0.16 支持范围。我们没有自行安装扩展、生成图片或检查插件导出结果。项目作者报告的测试不属于本站实测。安装较新版本前，请阅读 PhotoCraft 专用说明。

应该下载哪个包、使用什么版本？

从 OpenFill for PhotoCraft 0.2.4 发布页 选择 openfill-photocraft-0.2.4.zip。同一仓库也支持 GIMP，GIMP 包不是 PhotoCraft 安装程序。桌面 PhotoCraft 请按本站 下载指南 单独获取。

文档列出的平台是 Windows 10/11、Linux 和 Apple Silicon macOS。Intel Mac、其他 PhotoCraft 版本及未列出的 GPU 组合应视为未验证。AMD 支持另有注意事项；模型下载大小也不等于显存要求。下载大模型前，先核对项目的 引擎与硬件配置说明。

如果你只打开了浏览器编辑器，先看 网页版与桌面版区别。本地 OpenFill 控制面板也可能在浏览器中打开，但仍需要桌面应用和本地引擎。

安装伴随程序并连接引擎

运行安装程序前，先准备 Python 3.10 或更新版本。 OpenFill 脚本不会安装 Python。已有 ComfyUI 时可以复用它的解释器；安装程序找不到时，将 OPENFILL_PYTHON 设为该解释器可执行文件的完整路径。检查的必须是同一个解释器，不要误查另一套系统 Python：

• Windows： 运行 py -3 --version，或用所选解释器执行 --version。安装程序能为部分检测到的标准 Python 安装补充 Pillow。通过 OPENFILL_PYTHON 指定的解释器必须已经有 Pillow，可在命令提示符中运行 "%OPENFILL_PYTHON%" -c "import PIL; print(PIL.__version__)" 检查。
• macOS/Linux： 运行 python3 --version 和 python3 -c "import PIL; print(PIL.__version__)"。Python 3.10+ 和 Pillow 缺一不可，否则 shell 安装脚本会退出。复用 ComfyUI 时，将 python3 换成带引号的实际解释器路径。缺少 Pillow 时，用 python3 -m pip install Pillow 安装到该环境；如果是系统管理的 Python，应改用 ComfyUI 环境或虚拟环境，不要强制进行系统级安装。

这些前置条件来自 0.2.4 的 shell 安装脚本 和 Windows 安装脚本。检查通过后，按对应系统继续：

系统	解压 PhotoCraft 专用 ZIP 后的起点
Windows	安装桌面 PhotoCraft，再运行 Install OpenFill for PhotoCraft.cmd，使用生成的 PhotoCraft with OpenFill 启动入口
Linux	运行 sh install.sh，按安装提示操作，使用安装程序配置的入口
Apple Silicon macOS	把 PhotoCraft 安装到 Applications，准备 ComfyUI，运行 sh install.sh，再打开 PhotoCraft with OpenFill

已有 ComfyUI 时，选择现有引擎目录，不必再下载一份。PhotoCraft 专用文档说明了如何选中包含 main.py 的目录或便携安装目录。引擎目录选择与上面的 Python 解释器检查是两项独立配置。

0.2.4 发布说明指出，Python 环境没有 Tk 时，面板会在默认浏览器中打开。这是预期的后备方式，不代表安装了 Web 版。以后移动 Python 环境时，需要用新位置重新运行安装程序。

模型要另外下载吗？

需要。安装编辑器与伴随程序，不代表已有可用模型。打开面板中的模型管理器，按操作选择模型。模型文档 列出用于消除的 LaMa，以及用于填充、扩图、创建的 DreamShaper 8 Inpainting，并分别说明内存要求和许可。

首次检查只选一种操作和适合它的模型。只用于消除的模型不能验证按提示词生成物体。商用前查看模型自己的许可；伴随程序开源，不代表所有模型的使用权相同。为引擎和解压后的模型文件预留磁盘空间，并另外检查可用显存。

首次填充：任务与验收清单

下面是你可以在自己设备上完成的任务，不是本站已经复现的结果：

1. 保留未修改的原图。通过 OpenFill 启动桌面应用，打开一张较小、无敏感信息的图片。记录编辑器版本、系统、GPU、OpenFill 版本和模型名称。
2. 选择一块适中的区域，保留周边视觉背景。在 OpenFill 中选择 Fill 和兼容模型，输入简单请求，例如“a small red ceramic cup”，从面板提交。
3. 等待生成完成。比较可用候选，用 Keep 保留想要的结果，或用 Discard 放弃。项目文档描述的结果会作为带蒙版的图层返回。
4. 放大到 100%，检查选区边缘、阴影、附近文字和必须保持不变的内容。切换结果图层可见性，对照原图。生成成功也可能没有完成视觉任务。
5. 保存一份可编辑副本，另外导出 PNG 或 JPG。分别重新打开，检查尺寸和外观，并确认可编辑副本保留了需要的图层。如果不清楚格式和保存位置，参考 保存与导出指南。

需要消除时，用 Remove 和对应模型重复检查，重点看重建背景是否可信。需要扩图时，放大检查每一条新增边缘。不要只凭面板中的小预览判断画质。

失败时先检查什么？

现象	下一步检查
PhotoCraft 打开了，但 OpenFill 无法控制	保存后关闭普通桌面实例，通过配置好的 OpenFill 启动入口重开
找不到引擎或模型	先检查 ComfyUI 目录，再看模型管理器；只安装伴随程序还不够
打开浏览器标签页而不是浮动面板	检查所选 Python 是否没有 Tk，这是文档说明的 0.2.4 后备方式
Mac 输入提示词或选择模型后失去焦点	检查实际安装的是不是 0.2.4；该版本处理了这些焦点问题，不代表解决了所有卡死
生成失败或慢到无法使用	先看引擎错误和模型内存要求，再用更小选区或较轻的受支持模型重试
预览正常，保存的图片不满意	重新打开导出文件并放大对照；保留原图，任务完成不代表画质合格

每次只改一项设置，再重复同一个小任务，才方便比较。报告问题时附上版本、模型及失败阶段；公开日志中去掉令牌、私人图片和个人文件路径。

什么时候改用 Bridge？

希望把 PhotoCraft 的输入输出接入自己节点图时，可选择 ComfyUI PhotoCraft Bridge。OpenFill 可以复用引擎，不代表还要同时安装 Bridge。OpenFill、GenGate 与本站的能力边界见 AI 工作流总览。