秋叶启动器如何设置ComfyUI中文界面？

Question

使用秋叶启动器部署ComfyUI后，界面仍为英文，如何设置为中文？部分用户在通过秋叶启动器一键安装ComfyUI后，发现操作界面默认为英文，不清楚如何切换至中文。尽管ComfyUI本身支持多语言，但当前版本并未原生集成中文语言选项，需依赖第三方插件（如“ComfyUI-Language-Pack”）实现汉化。然而，许多用户反馈在安装插件后重启仍无效果，或插件无法正确加载，提示“Translation file not found”等错误。此外，插件与启动器路径配置不匹配、语言包未放置在正确目录（custom_nodes/ComfyUI-Language-Pack）等问题也较为常见。如何在秋叶启动器环境下正确安装并启用中文语言包，确保界面成功汉化，是当前用户普遍关注的技术难题。

Answer 1

一、问题背景与核心痛点分析

在使用秋叶启动器（Autodl-Start）一键部署ComfyUI后，许多用户发现其Web界面默认为英文，尽管ComfyUI架构支持多语言扩展，但官方版本并未内置中文语言包。因此，实现中文化必须依赖第三方插件，如“ComfyUI-Language-Pack”。然而，大量用户反馈即使安装了该插件，重启服务后仍无任何汉化效果，甚至出现“Translation file not found”或“Failed to load custom node”等错误。

此类问题的根本原因往往并非单一，而是涉及路径配置、插件兼容性、加载机制以及启动器封装逻辑等多个层面的耦合问题。尤其对于具备5年以上经验的IT从业者而言，这不仅是功能配置问题，更是一次对自动化工具底层行为的逆向理解过程。

二、基础概念梳理：ComfyUI 多语言机制原理

• 国际化支持框架：ComfyUI基于Python+前端JS构建，其语言切换依赖于custom_nodes中的插件动态注入翻译资源。
• 语言包加载流程：
  1. 启动时扫描custom_nodes/目录下的插件；
  2. 插件注册自身提供的翻译文件（JSON格式）；
  3. 前端通过浏览器语言或用户设置匹配对应locale；
  4. 渲染界面时替换原始英文文本。
• 关键限制：若插件未正确注册、路径错误或JSON结构不完整，则无法触发翻译流程。

三、常见故障类型与诊断路径

故障现象	可能原因	排查方式
界面仍为英文	语言包未启用或未加载	检查日志是否输出“Loading translation for zh_CN”
提示“Translation file not found”	zh_CN.json缺失或路径错误	确认文件位于custom_nodes/ComfyUI-Language-Pack/locales/zh_CN/
插件未出现在节点列表	Git克隆失败或权限不足	手动进入目录执行git clone
页面报错“Custom Node Error”	插件版本与ComfyUI主干不兼容	查看GitHub Issues是否有类似反馈
更改无效且缓存残留	浏览器强缓存或后端未热重载	清除缓存并重启整个服务进程

四、标准解决方案实施步骤

1. 关闭秋叶启动器运行的所有ComfyUI实例；
2. 进入ComfyUI根目录下的custom_nodes子目录：
   cd D:\stable-diffusion\ComfyUI\custom_nodes
3. 克隆语言包插件仓库：

   git clone https://github.com/chasecrum/ComfyUI-Language-Pack.git

4. 验证文件结构完整性：
   • 确保存在locales/zh_CN/LC_MESSAGES/路径；
   • 检查__init__.py是否包含语言注册逻辑。
5. 修改配置文件config.json（若不存在可创建），添加：

   {
     "translation": "zh_CN"
   }

6. 重新通过秋叶启动器启动ComfyUI服务；
7. 打开浏览器访问http://127.0.0.1:8188；
8. 观察控制台输出是否包含“Loaded translation: zh_CN”；
9. 若仍未生效，尝试强制刷新（Ctrl+F5）并检查开发者工具Network标签中是否有404请求；
10. 最后一步：检查秋叶启动器是否设置了独立的插件白名单或沙箱路径。

五、高级调试策略与自动化检测脚本

针对资深开发者，建议编写自动化校验脚本来预防路径错位问题：

# check_language_pack.py
import os
import json

COMFYUI_ROOT = r"D:\stable-diffusion\ComfyUI"
LANG_PACK_PATH = os.path.join(COMFYUI_ROOT, "custom_nodes", "ComfyUI-Language-Pack")
LOCALE_FILE = os.path.join(LANG_PACK_PATH, "locales", "zh_CN", "LC_MESSAGES", "messages.json")

def validate_installation():
    if not os.path.exists(LANG_PACK_PATH):
        print("[ERROR] Language pack directory not found.")
        return False
    if not os.path.exists(LOCALE_FILE):
        print(f"[ERROR] Translation file missing: {LOCALE_FILE}")
        return False
    config_path = os.path.join(COMFYUI_ROOT, "config.json")
    if os.path.exists(config_path):
        with open(config_path, 'r', encoding='utf-8') as f:
            cfg = json.load(f)
            if cfg.get("translation") != "zh_CN":
                print("[WARN] config.json does not set translation to zh_CN")
    print("[SUCCESS] All checks passed.")
    return True

if __name__ == "__main__":
    validate_installation()

六、Mermaid 流程图：中文语言包加载判断逻辑

graph TD
    A[启动ComfyUI服务] --> B{custom_nodes目录下
是否存在ComfyUI-Language-Pack?}
    B -- 否 --> C[提示插件未安装]
    B -- 是 --> D[读取config.json中language设置]
    D --> E{language == zh_CN?}
    E -- 否 --> F[加载默认en_US]
    E -- 是 --> G[查找locales/zh_CN/messages.json]
    G --> H{文件存在?}
    H -- 否 --> I[抛出Translation file not found]
    H -- 是 --> J[注入翻译资源至前端]
    J --> K[渲染中文界面]