Skip to content

Repository files navigation

Fooocus 中文本地 UI 补丁

English README

这是一个可复制到现有 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、其他权重和输出内容的许可及使用条件由用户自行确认。

安装前准备

  1. 从官方来源安装 Fooocus,并先确认官方启动方式可以运行。
  2. 记录 Fooocus 版本或提交,并备份现有同名文件。
  3. 下载或克隆本仓库。
  4. INSTALL_FILES.txt 将文件复制到 Fooocus 根目录,保持相对路径不变。

本仓库的补丁文件都使用独立名称,正常情况下不会覆盖 Fooocus 官方文件。仍建议 安装前备份,因为未来 Fooocus 版本可能新增同名文件。

三种启动方式

1. 本地补丁与单次浏览器打开

start-gpu-zh-cn-local.bat

使用补丁启动器,加载语言文件和额外 JS;禁用 Fooocus 自己打开浏览器,最多 等待本地服务 180 秒后打开一次浏览器。URL 非回环地址、包含凭据或端口已占用 时会拒绝启动。

2. 本地补丁与 Fooocus 默认浏览器行为

start-gpu-zh-cn-fixed.bat

使用补丁启动器,加载语言文件和额外 JS,由 Fooocus 处理浏览器行为。

3. 安全基线启动器与语言文件

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.bat
  • FOOOCUS_DIRPYTHON_EXE 支持空格与中文路径,脚本调用时保持引号。
  • FOOOCUS_URL 只供 local 脚本检查端口和打开浏览器,必须是不含凭据的 127.0.0.1localhost HTTP URL。
  • 修改端口时,应让 FOOOCUS_URLGRADIO_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

回滚

  1. 关闭 Fooocus。
  2. 删除 INSTALL_FILES.txt 中列出的补丁文件。
  3. 恢复安装前备份的任何同名文件。
  4. 补丁文件移除后,使用 Fooocus 官方启动方式重新验证原安装。

不要删除 Fooocus 官方源码、模型目录、输出目录、数据库或环境。补丁不会修改 官方 Git 历史,回滚不需要 git reset

许可证与免责声明

本仓库按 GPL-3.0 发布。Fooocus 启动器衍生文件继续受上游 GPL-3.0 约束, 上游署名、基线和本地差异见 NOTICE.md

本项目是非官方兼容补丁,不保证支持所有 Fooocus 版本,也不对模型或生成内容 提供授权、质量或安全保证。

About

非官方 Fooocus 中文本地 UI 补丁,提供中文界面、常用预设与可回滚的 Windows 本地启动配置。

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages