ComfyUI 中文汉化插件 — 全面、智能、兼容的 ComfyUI 界面中文翻译解决方案。

作者：猪的飞行梦

本项目基于 AIGODLIKE-ComfyUI-Translation 和 ComfyUI-DD-Translation 进行的修改，特别感谢大佬们对开源社区的杰出贡献。此项目将持续保持开源。

• 插件简介
• 核心特性
• 效果展示
• 安装方法
• 使用说明
• 翻译覆盖范围
• 技术架构
• 注意事项
• 更新记录
• 社区与支持
• 开源许可

ComfyUI-Chinese-Translation 是一个专为 ComfyUI 设计的中文汉化插件。通过前后端协同工作，实现界面元素的实时中文翻译，覆盖节点、菜单、设置面板、管理器等所有可见文本，同时与 ComfyUI 官方原生翻译完美兼容。

• 智能检测机制 — 自动识别已翻译文本，避免重复翻译和无限递归
• 原生翻译兼容 — 与 ComfyUI 官方中文翻译完美共存，互不干扰
• 上下文感知 — 根据不同界面元素类型（节点、菜单、控件等）采用最合适的翻译策略
• 回调安全保护 — 右键菜单翻译后所有功能（断开连接、重命名等）完全正常

• 七彩动态效果 — 激活状态下显示流畅的彩虹渐变动画
• 灰色简约设计 — 未激活状态下采用优雅的灰色渐变
• 原生低调模式 — 可选与 ComfyUI 默认主题一致的低调配色
• 实时状态反馈 — 按钮文字和颜色实时反映当前翻译状态

• 实时切换 — 无需重启即可开启/关闭翻译
• 状态持久化 — 翻译设置自动保存，重启后保持状态
• 设置面板集成 — 在 ComfyUI 设置面板中可配置语言和按钮样式
• 新增翻译即生效 — 添加新的翻译文件后无需重启

• 完善的异常捕获 — 所有关键操作都有错误处理
• 优雅降级 — 翻译失败时自动回退到原始文本
• DOM 安全保护 — 翻译不会破坏 Vue/PrimeVue 组件的事件绑定
• 多版本兼容 — 同时支持 ComfyUI 新旧版本界面

cd ComfyUI/custom_nodes
git clone https://github.com/a63976659/ComfyUI-Chinese-Translation.git

安装完成后重启 ComfyUI。

1. 打开插件文件夹ComfyUI\Custom_nodes
2. Win11系统空白处右键，选择在终端中打开。Win10系统地址栏输入cmd回车。
3. 点击此网页右上角的code展开，复制地址。（也可以直接复制网址）
4. 在命令窗口输入git空格clone空格，粘贴地址并回车。输入参考git clone https://github.com/a63976659/ComfyUI-Chinese-Translation.git
5. 安装完成，重启ComfyUI。（安装失败，开启科学上网并重试）

1. 打开 ComfyUI Manager
2. 数据改为：频道（远程）
3. 点击节点管理
4. 搜索 猪的飞行梦
5. 点击安装，重启 ComfyUI

1. 在 GitHub 页面点击 Code → Download ZIP
2. 解压到 ComfyUI/custom_nodes/ComfyUI-Chinese-Translation
3. 重启 ComfyUI

安装后界面会出现翻译开关按钮，点击即可切换翻译状态：

• 开启翻译 — 按钮显示 翻译开启 (zh-CN)，界面文字翻译为中文
• 关闭翻译 — 按钮显示 翻译关闭 (原生)，恢复原始英文界面

在 ComfyUI 设置中提供两个配置项：

zh-CN/
├── Nodes/          # 节点翻译（标题、输入、输出、控件）
│   └── internal.json
├── Categories/     # 节点分类翻译
│   ├── Internal.json
│   └── Other.json
└── Menus/          # 菜单和界面翻译
    ├── Comfy设置菜单及管理器菜单.json
    ├── Comfy条件选项.json
    ├── Comfy模版汉化-zdfxm.json
    └── ...

在 zh-CN/Nodes/ 目录下创建 JSON 文件即可：

{
  "YourNodeClassName": {
    "title": "节点中文名称",
    "inputs": {
      "input_name": "输入名翻译"
    },
    "outputs": {
      "output_name": "输出名翻译"
    },
    "widgets": {
      "widget_name": "控件名翻译"
    }
  }
}

在 zh-CN/Menus/ 目录下创建 JSON 文件即可添加菜单翻译：

{
  "English Menu Text": "中文菜单文本",
  "Another Item": "另一个项目"
}

添加翻译文件后无需重启 ComfyUI，切换翻译开关即可生效。

┌──────────────────────────────────────────────────────┐
│                    ComfyUI 主程序                      │
│                                                        │
│  Python 后端 (__init__.py)     前端 JS (js/)           │
│  ├─ HTTP API 路由              ├─ main.js (翻译引擎)   │
│  ├─ 翻译数据编译               ├─ MenuTranslate.js     │
│  └─ 配置持久化                 └─ utils.js (工具函数)  │
│         │                             │                │
│         ▼                             ▼                │
│   zh-CN/ 翻译数据              MutationObserver        │
│   ├─ Nodes/*.json              实时 DOM 翻译           │
│   ├─ Categories/*.json                                 │
│   └─ Menus/*.json                                      │
└──────────────────────────────────────────────────────┘

完整技术细节请参考 TECHNICAL_DOCUMENTATION.md

• 翻译插件冲突 — 本插件会和其他翻译插件冲突（如 AIGODLIKE-ComfyUI-Translation），请卸载其他翻译插件后使用
• 已知冲突插件 — ComfyUI Browser 可能存在兼容性问题
• 浏览器支持 — 推荐使用 Chrome、Edge、360 浏览器，其他浏览器未充分测试

修复：右键菜单功能失效问题

• 修复了翻译开启后，输出接口右键菜单的「断开连接」「重命名接口」等操作无响应的严重 Bug
• 根因：LiteGraph 底层通过 value.content 英文文本匹配来分发回调动作，翻译后匹配失败
• 方案：实现回调包装（Callback Wrapping）机制，在回调执行瞬间临时恢复英文、执行后恢复中文，兼顾翻译显示与功能正确性
• 同时包装 value.callback（独立回调）和 options.callback（共享回调）两种模式
• 增加 _originalContent 多次翻译覆盖保护，防止画布菜单经过两次翻译管道后原始值丢失

修复：DOM 翻译破坏事件绑定问题

• 修复了 replaceText 中 innerText 赋值摧毁子元素及 Vue/PrimeVue 事件监听器的问题
• 方案：增加叶子节点检查 target.children.length === 0，仅对无子元素的节点执行 innerText 赋值

重命名

• 插件名称从 ComfyUI-Translation-node 更名为 ComfyUI-Chinese-Translation
• 显示名称从「翻译节点」改为「中文翻译」，更符合插件定位

功能增强

• 改版为支持多国语言文件架构（版本 2.0）
• 新增设置面板，可在 ComfyUI 设置中配置语言和按钮样式
• 新增原生低调 UI 样式选项
• 修复重启后图标设置失效问题（感谢群友「幻影」反馈）

作者主页

• 哔哩哔哩：猪的飞行梦
• 小红书：猪的飞行梦

交流群

• ComfyUI 交流 QQ 群：202018000

反馈与贡献

• 问题反馈：GitHub Issues
• 贡献翻译：欢迎提交 PR 补充翻译文件

支持作者

如果觉得插件不错，欢迎点个 ⭐ Star 和支持作者：

本项目基于 MIT License 开源。

Copyright (c) 2025 猪的飞行梦

任何人都可以自由复制、修改和分发本项目，但需保留原始版权声明。详见 LICENSE 文件。