这是一个可复制到现有 Fooocus 安装中的非官方中文本地补丁,不是 Fooocus 完整发行版,也与 Fooocus 官方没有隶属或认可关系。
- 已静态比对:Fooocus
2.5.5 - 上游快照:
ae05379cc97bc4361ec8b4ec90193dab21be763f - 上游项目:lllyasviel/Fooocus
- 上游及本仓库衍生文件许可证:GPL-3.0
launch_zh_cn_ui_patch.py 是该快照中 launch.py 的近完整衍生副本,仅进行
安全边界、MPS 环境变量保留和本地 JS 注入修改。其他 Fooocus 版本未经验证,
启动器、依赖、语言键或 UI DOM 变化都可能导致不兼容。详细来源见
NOTICE.md。
- 默认不启用
--share,界面仅按 Fooocus 的本地监听配置运行。 - Python、pip 和 Hugging Face 下载保持系统默认 HTTPS 证书校验。
- 本补丁不提供关闭 TLS 校验的兼容开关,也不建议通过忽略证书错误解决网络问题。
- 本仓库不包含模型、生成图片、输出目录、缓存、日志或虚拟环境。
- 本补丁不会自动提供模型;Fooocus 首次启动仍可能下载依赖、基础模型或辅助文件。
- 生成式 AI 模型、LoRA、其他权重和输出内容的许可及使用条件由用户自行确认。
- 从官方来源安装 Fooocus,并先确认官方启动方式可以运行。
- 记录 Fooocus 版本或提交,并备份现有同名文件。
- 下载或克隆本仓库。
- 按 INSTALL_FILES.txt 将文件复制到 Fooocus 根目录,保持相对路径不变。
本仓库的补丁文件都使用独立名称,正常情况下不会覆盖 Fooocus 官方文件。仍建议 安装前备份,因为未来 Fooocus 版本可能新增同名文件。
start-gpu-zh-cn-local.bat使用补丁启动器,加载语言文件和额外 JS;禁用 Fooocus 自己打开浏览器,最多 等待本地服务 180 秒后打开一次浏览器。URL 非回环地址、包含凭据或端口已占用 时会拒绝启动。
start-gpu-zh-cn-fixed.bat使用补丁启动器,加载语言文件和额外 JS,由 Fooocus 处理浏览器行为。
start-gpu-zh-cn.bat调用移除全局 TLS 绕过的固定基线启动器,只加载 zh_cn_patch 语言文件,不注入
额外 JS。Fooocus 2.5.5 的官方 launch.py 本身包含全局关闭证书校验的逻辑,
因此补丁安装期间不把它作为安全启动路径。
三个脚本都默认关闭公网分享,并把额外命令行参数透传给 Fooocus。例如:
start-gpu-zh-cn-local.bat --gpu-device-id 0补丁不设置 FORCE_CPU,不会替换用户传入的 GPU/CPU 参数;补丁启动器也会保留
用户已经设置的 MPS 环境变量。
只有确实理解风险时才在当前终端显式启用:
set "FOOOCUS_SHARE=1"
start-gpu-zh-cn-fixed.bat脚本会显示警告并添加 --share。这可能创建可从公网访问的 Gradio 分享链接;
不要在界面中暴露私人图片、提示词、路径或其他敏感信息。普通本地使用不要设置
该变量。
set "FOOOCUS_DIR=D:\path\to\Fooocus"
set "PYTHON_EXE=D:\path\to\python.exe"
set "FOOOCUS_URL=http://127.0.0.1:7865"
set "GRADIO_SERVER_PORT=7865"
start-gpu-zh-cn-local.batFOOOCUS_DIR和PYTHON_EXE支持空格与中文路径,脚本调用时保持引号。FOOOCUS_URL只供 local 脚本检查端口和打开浏览器,必须是不含凭据的127.0.0.1或localhostHTTP URL。- 修改端口时,应让
FOOOCUS_URL与GRADIO_SERVER_PORT保持一致。 FOOOCUS_NO_PAUSE=1可用于自动化环境保留真实退出码而不等待按键。
- 4 个中文使用场景 preset,不指定或下载额外模型、LoRA。
language/zh_cn_patch.json:Fooocus 语言键补充。javascript/zz_zh_cn_ui_patch.js:只修改本地 DOM 文本和显示,不读取、上传用户数据,不加载远程脚本。launch_zh_cn_ui_patch.py:固定基线启动器副本与 JS 注入。- 3 个 Windows 启动脚本。
LOCAL_CUSTOM_README_CN.txt:复制到 Fooocus 目录后的本地说明。
完整安装与回滚清单:
presets/portrait_cn.json
presets/clean_photo_cn.json
presets/art_photo_cn.json
presets/arcane_cn.json
language/zh_cn_patch.json
javascript/zz_zh_cn_ui_patch.js
launch_zh_cn_ui_patch.py
start-gpu-zh-cn.bat
start-gpu-zh-cn-local.bat
start-gpu-zh-cn-fixed.bat
LOCAL_CUSTOM_README_CN.txt
- 关闭 Fooocus。
- 删除 INSTALL_FILES.txt 中列出的补丁文件。
- 恢复安装前备份的任何同名文件。
- 补丁文件移除后,使用 Fooocus 官方启动方式重新验证原安装。
不要删除 Fooocus 官方源码、模型目录、输出目录、数据库或环境。补丁不会修改
官方 Git 历史,回滚不需要 git reset。
本仓库按 GPL-3.0 发布。Fooocus 启动器衍生文件继续受上游 GPL-3.0 约束, 上游署名、基线和本地差异见 NOTICE.md。
本项目是非官方兼容补丁,不保证支持所有 Fooocus 版本,也不对模型或生成内容 提供授权、质量或安全保证。