ComfyUI-DD-Translation
A plugin offering supplementary Chinese translations for ComfyUI custom nodes.
ComfyUI 中文翻译插件
ComfyUI 的简体中文翻译插件,让 ComfyUI 界面和常用插件尽量显示中文。装好后跟随 ComfyUI 的语言设置生效:在设置里选「中文」就是中文,选「English」就恢复英文。
本项目基于 AIGODLIKE-ComfyUI-Translation 衍生开发,在此特别感谢原项目的开发者们对开源社区的杰出贡献。正是因为有人愿意成为先驱者,后人才能继承前人的薪火。
视频展示
https://github.com/user-attachments/assets/ad2c1253-18a1-4c36-b92d-8e72abf1f851
项目背景
由于原作者已停止更新,而 ComfyUI 原生对中文的支持进展缓慢,特别是对自定义节点的适配,因此我决定继续维护这个项目,使其能够:
- 兼容支持 ComfyUI 的最新版本
- 添加新的翻译内容
- 完善翻译体验
功能特点
- 更完整的简体中文:节点名称、输入输出、下拉选项、节点分类、设置面板,以及常用插件的面板都会显示中文。
- 右键菜单也是中文:节点 / 画布的右键菜单里,rgthree、VideoHelperSuite、Impact Pack、KJNodes 等插件写死的英文菜单项也会翻译。
- 顶栏 / 状态栏也是中文:Crystools 的监控条(内存 / 显存 / 温度 / 硬盘)、右侧操作条(管理器 / 分享 / 保存 / 刷新)以及设置面板里插件写死的英文,同样会换成中文。
- 在官方中文的基础上补上官方没翻或翻得不够的地方,比只用官方中文更完整。
- v3 起跟随 ComfyUI 的语言设置:选中文就是中文,选英文就恢复英文,不再有悬浮开关。
- 目前只做简体中文,暂不考虑其他语言。
为什么改用官方中文机制
旧版本是直接改界面上的文字来翻译。ComfyUI 2.0 的新节点系统(Nodes 2.0)和很多插件都依赖界面原本的结构, 文字被外部改掉之后,容易出现按钮失灵、下拉框错乱、节点功能异常等问题——在旧方案里,这类问题基本无解。
改成 ComfyUI 自带的中文机制后,等于由官方方式接管翻译,兼容性最好,也不会破坏插件本身的功能。 所以这不是随便升级,而是目前最稳妥、也是唯一能长期跟得上 ComfyUI 更新的做法。
右键菜单、设置面板、顶栏 / 状态栏是少数例外:里面的文案由插件直接写死英文, 没有走 ComfyUI 的翻译接口。为了让这些地方也显示中文,插件只在对应区域出现时替换整段文字, 不碰节点结构、参数和连线。
使用建议
建议使用较新版本的 ComfyUI(近半年内的版本即可)。
如果发现有哪里没翻译、或者翻译得不对,欢迎到 Issues 反馈——旧版本转换过来的内容难免有遗漏,我会尽快补上。
安装方法
方法1:
- 下载本项目
- 将整个文件夹放入 ComfyUI 的
custom_nodes目录下 - 重启 ComfyUI
方法2(推荐): 直接在Manager或启动器中使用git进行安装
https://github.com/Dontdrunk/ComfyUI-DD-Translation.git
方法3(推荐): 直接在Manager中搜索插件名称安装
安装或更新后请重启 ComfyUI:只刷新浏览器页面不会生效,必须重启一次。
开源协议
本项目以 GPL-3.0-only(GNU General Public License v3.0)发布,完整协议见 LICENSE。
你可以自由使用、修改、分发本项目,也可以商用;但基于本项目代码开发的衍生插件必须同样以 GPL-3.0 开源,分发时需要提供完整源代码,不能改成闭源插件。
Copyright (C) 2025-2026 Dontdrunk
翻译数据来自 AIGODLIKE-ComfyUI-Translation 及各位贡献者,相关权利归原作者和贡献者所有。
贡献者名单
感谢以下贡献者对于ComfyUI中文开源生态的支持
- msola-ht丶是小张啊丶alinuo666丶猪的飞行梦丶ZXSZS丶tanglangxia丶AIGCZero丶Artistjjw丶henrylaobai丶FanXiangTM丶xuchenxu168丶LovedeHua丶uiiiaiii丶fuxijun-max丶ANe5s丶cnolka 丶XXXAbit7 丶Yifo98丶xiaobai9009丶Aifredd丶junesnowing-source
更新日志
v3.2.2 (2026-11-14) 【MAINodes(Snap)设置面板与全部节点汉化】
- 设置面板:MAINodes 的设置页(Snap)已整体汉化,包括代码审查、评级、元数据、语音质检、Astrid 地址、提案过期、智能体运行、打开位置,以及每项的说明和下拉选项。
- 侧栏图标:设置侧栏的 MAINodes 分类加上 🧠 图标,和 KJNodes、视频套件、Crystools 等分类保持一致。
- 全部节点:MAINodes 的 128 个节点全部汉化,包含节点标题、859 个输入槽位、301 个输出、249 条下拉选项与节点分类(H3 / 转盘 / 流程 / 显存实验室 / RelayVSR / Snap 等)。
- 单引号选项兜底:英文原文里带单引号的下拉选项无法通过 vue-i18n 的点路径查到译文,改为在面板内按整段文本替换,避免残留英文。
- 构建:
rebuild.bat/rebuild.sh支持多个--extra数据文件,并支持手工节点数据里的outputs。
v3.2.1 (2026-11-14) 【设置面板与顶栏 / 状态栏汉化修复】
- 修复设置面板里的英文:v3.2.0 的设置面板只挂了 1 条专用译文,等于把通用词典(5600+ 条)挡在面板外面;现在改成「面板专用译文优先、通用词典兜底」,插件写死的设置项会正常显示中文,例如「🐍 文本自动补全」「最大建议数量」「🔝全局连接」。
- 修复顶栏 / 状态栏里的英文:Crystools 监控条和右侧操作条以前不在替换范围内,现在也纳入。实测:内存 / 显存 / 温度 / 硬盘 / 管理器 / 分享 / 保存 / 刷新。
- 补齐译文:Crystools 的硬盘监视器(HDD → 硬盘);旧版悬浮菜单里已收录的 Save / Refresh / Manager / Share 现在也能显示中文。
- 行为不变:仍然只替换「整段文字完全等于词条」的文本,数字、百分比、图标和节点内容都不动;切回英文会还原。
- 保留英文的部分:CPU / GPU 这类按现有译法保持不变。
- 感谢 #200 的反馈。
v3.2.0 (2026-11-11) 【右键菜单中文化】
- 右键菜单翻译:节点右键菜单、画布右键菜单里的插件英文菜单项现在会显示中文,包括 rgthree 的「队列所选节点」、KJNodes 的 Set/Get、VideoHelperSuite 的预览控制、Impact Pack 的 SAM 检测等。
- 沿用旧插件的做法:这些文案在插件 JS 里写死,官方 locales 覆盖不到,所以在菜单弹出时做菜单级文字替换;只替换整段匹配的菜单项,不影响功能。
- 词典来源:直接复用
source/zh-CN/Menus里旧插件的全部菜单译文(约 5700 条),并补了少量菜单专用译文。 - 切换语言照常生效:选中文显示中文,选 English 恢复英文。
- 开源协议:明确为 GPL-3.0-only,基于本项目代码的衍生插件必须同样开源。
v3.1.0 (2026-11-11) 【更好用的中文翻译】
- 更稳定:翻译改成跟随 ComfyUI 自带的中文机制,兼容新的 Nodes 2.0 节点系统和更多插件;不再去改界面上的文字,插件功能不容易被影响,ComfyUI 以后升级也不用跟着改代码。
- 更完整:
- 节点名称、输入输出、下拉选项、节点分类都是中文
- 设置面板里的每一项和说明都是中文
- rgthree-comfy 的设置窗口、ComfyUI 管理器的面板和各个列表页也都是中文
- 覆盖 4000 多个节点、150 多处下拉选项、40 多个设置项
- 更好用:不用再点悬浮的翻译开关,直接在 ComfyUI 设置里切换「中文 / English」。
- 升级不丢东西:以前所有翻译内容都保留,另外补上了以前没翻的设置项和插件面板。
- 怎么升级:用新版本替换掉旧的插件文件夹,重启 ComfyUI;之前装过其他中文翻译插件的,先把它删掉,避免两个同时生效。
更早的 v1.x – v2.x 记录见 CHANGELOG.md。