Text_Translation_V2_Full 在ComfyUI哪个插件中调用？

Question

在使用 ComfyUI 进行多语言文本处理时，用户常遇到 **Text_Translation_V2_Full** 节点无法正常调用的问题。该功能通常集成于 **ComfyUI-Translation** 或 **ComfyUI-LayerStyle** 等支持多语言翻译的插件中，但部分用户反馈在安装后仍无法在节点列表中找到该模块。常见原因包括插件版本不匹配、依赖库（如 transformers、sentencepiece）未正确安装，或模型文件缺失。此外，某些插件需手动启用高级功能选项才能显示 V2 全量翻译模型。如何确认当前环境中哪个插件实际注册并提供了 `Text_Translation_V2_Full` 节点？是否可通过自定义节点管理器查看其所属插件来源？

Answer 1

一、问题背景与现象描述

在使用 ComfyUI 进行多语言文本生成与处理时，Text_Translation_V2_Full 节点作为关键的翻译组件，广泛应用于跨语言提示词工程（Prompt Engineering）场景中。然而，大量用户反馈即使安装了如 ComfyUI-Translation 或 ComfyUI-LayerStyle 等主流插件后，仍无法在节点菜单中找到该节点。

典型表现为：

• 节点搜索框输入“translation”无结果返回；
• 插件已通过 Git 安装至 custom_nodes/ 目录；
• 重启 ComfyUI 后界面未加载新节点；
• 日志输出中出现 ImportError: No module named 'transformers' 类似错误。

二、依赖环境排查：基础支撑层分析

Text_Translation_V2_Full 节点高度依赖 Python 第三方库支持，尤其是 Hugging Face 生态中的核心包。若缺失以下任一依赖，节点将无法注册到运行时环境中。

依赖库	作用说明	安装命令
transformers	Hugging Face 模型推理框架	pip install transformers
sentencepiece	用于 BPE 分词，支持多语言 tokenizer	pip install sentencepiece
torch	PyTorch 深度学习引擎	pip install torch
safetensors	安全加载模型权重文件	pip install safetensors

三、插件来源识别：谁提供了 Text_Translation_V2_Full？

目前社区中提供该节点的主要插件包括：

1. ComfyUI-Translation：专为翻译设计的轻量级插件，明确导出 Text_Translation_V2_Full 节点类；
2. ComfyUI-LayerStyle：图像风格化工具集，其高级文本模块集成完整翻译链路；
3. Custom Translation Nodes (CTN)：小众分支项目，可能重命名或封装同类功能。

可通过以下脚本快速定位注册源：

import os
from comfy.utils import common_annotator_import

# 扫描 custom_nodes 中包含目标节点定义的文件
def find_node_registration(path):
    for root, dirs, files in os.walk(path):
        for file in files:
            if file.endswith(".py") and not file.startswith("__"):
                with open(os.path.join(root, file), 'r', encoding='utf-8') as f:
                    content = f.read()
                    if "Text_Translation_V2_Full" in content:
                        print(f"[+] Found in: {os.path.join(root, file)}")

find_node_registration("./custom_nodes")
    

四、节点注册机制解析：从代码到 UI 的映射路径

ComfyUI 使用动态节点注册机制，所有自定义节点需在 Python 文件中调用 NODE_CLASS_MAPPINGS 全局字典进行声明。例如：

class Text_Translation_V2_Full:
    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "text": ("STRING", {"multiline": True}),
                "source_lang": ("STRING", {"default": "auto"}),
                "target_lang": ("STRING", {"default": "en"})
            }
        }

    RETURN_TYPES = ("STRING",)
    FUNCTION = "translate"
    CATEGORY = "translation"

NODE_CLASS_MAPPINGS = {
    "TextTranslationV2Full": Text_Translation_V2_Full
}
    

只有当此文件被 ComfyUI 主进程成功导入时，节点才会出现在对应分类下。

五、可视化确认方式：利用自定义节点管理器追溯来源

部分增强型管理器（如 ComfyUI-Manager）提供“节点溯源”功能，可查看每个节点所属插件及其版本信息。操作流程如下：

graph TD A[启动 ComfyUI] --> B[打开 ComfyUI-Manager 面板] B --> C[点击 'Custom Node View'] C --> D[搜索 Text_Translation_V2_Full] D --> E{是否显示？} E -- 是 --> F[查看所属插件名称与路径] E -- 否 --> G[检查插件是否启用] G --> H[进入 settings.json 手动开启 experimental features]

六、高级配置与隐藏功能启用

某些插件默认隐藏 V2 全量模型以降低资源消耗，需手动修改配置激活。例如在 ComfyUI-LayerStyle/config.json 中添加：

{
  "enable_advanced_translation": true,
  "translation_model_variant": "v2-full",
  "hf_cache_dir": "./models/translation/"
}
    

此外，还需确保模型文件存在于指定目录：

• ./models/translation/tatoeba_mt_en_zh
• ./models/translation/nllb-200-distilled-600M
• config.json, pytorch_model.bin, tokenizer.model

七、综合诊断清单与建议步骤

检查项	验证方法	修复建议
插件是否存在	ls custom_nodes/ | grep -E 'Translation|LayerStyle'	重新克隆仓库
依赖是否完整	pip list | grep -E 'transformers|sentencepiece'	执行 requirements.txt 安装
模型是否下载	检查 models/translation/ 目录内容	使用 hf-mirror 下载
节点是否报错	查看浏览器控制台及 terminal 日志	捕获 ImportError 并补全路径
类别是否可见	在画布右键菜单中查找 “translation” 分类	重启服务并清除缓存