Voice-Tag-Editor

🏷️ ComfyUI Voice Tag Editor

辅助 TTS 文本编辑的 ComfyUI 自定义节点，提供可视化标签面板，快速在文本中插入非语言标签（如 [laughing]、[sigh] 等）。

✨ 功能

• 可视化标签面板 — 按分类展示标签芯片（chip），点击即插
• 光标位置插入 — 点击标签在文本输入框光标位置精准插入标签代码
• 多配置集管理 — 支持创建/切换/编辑/删除多套标签配置
• 标签 CRUD — 支持增删改单个标签、调整顺序、修改别名和分类
• 双输出 — 同时输出 clean_text（去除标签的纯文本）和 tagged_text（保留标签的原文）
• 预设配置 — 内置基于 VoxCPM 官方文档 的 11 个非语言标签

📦 安装

通过 ComfyUI Manager（推荐）

搜索 ComfyUI-Voice-Tag-Editor 并点击安装。

手动安装

cd ComfyUI/custom_nodes/
git clone https://github.com/your-username/ComfyUI-Voice-Tag-Editor.git

无需额外依赖，无需安装 pip 包。

🚀 使用

1. 在 ComfyUI 节点菜单中找到 🏷️ Voice Tag Editor（位于 text 分类）
2. 节点上方展示标签面板，按分类分组
3. 在文本框中输入或粘贴文本
4. 点击标签芯片 → 标签代码自动插入到光标所在位置
5. 节点输出：
   • clean_text — 纯文本（所有 [...] 标签已清除），可传给不支持的 TTS 引擎
   • tagged_text — 带标签的原文，可传给 VoxCPM 等支持标签的 TTS 引擎

管理配置

点击节点右上角的 ⚙ 齿轮按钮 打开配置管理对话框：

| 标签页 | 功能 | |--------|------| | 📝 编辑当前配置 | 修改配置名称、描述，增删改标签（代码/别名/分类），调整标签顺序 | | 📂 管理配置集 | 查看所有配置集，切换激活、复制、删除、新建配置集 |

通过顶部的 下拉菜单 快速切换激活的配置集。

🏗️ 配置格式

配置以 JSON 文件形式存储在 tags_configs/ 目录下：

{
  "name": "VoxCPM 默认",
  "description": "基于 VoxCPM 官方文档的预设标签",
  "tags": [
    {
      "code": "[laughing]",
      "alias": "😄 笑声",
      "category": "笑与叹息"
    },
    {
      "code": "[sigh]",
      "alias": "😮‍💨 叹息",
      "category": "笑与叹息"
    }
  ]
}

字段说明：

| 字段 | 说明 | |------|------| | name | 配置显示名称 | | description | 配置描述说明 | | tags[].code | 实际插入的标签代码（如 [laughing]） | | tags[].alias | 标签语义别名，显示在标签芯片上 | | tags[].category | 标签分组，相同分类的标签显示在一起 |

📋 预设标签

内置配置基于 VoxCPM 官方文档，共 11 个非语言标签，分为 4 个类别：

| 分类 | 标签代码 | 别名 | |------|----------|------| | 笑与叹息 | [laughing] | 😄 笑声 | | 笑与叹息 | [sigh] | 😮‍💨 叹息 | | 停顿与思考 | [Uhm] | 🤔 迟疑嗯 | | 停顿与思考 | [Shh] | 🤫 嘘声 | | 疑问语气 | [Question-ah] | ❓ 疑问-啊 | | 疑问语气 | [Question-ei] | ❓ 疑问-诶 | | 疑问语气 | [Question-en] | ❓ 疑问-嗯 | | 疑问语气 | [Question-oh] | ❓ 疑问-哦 | | 情绪表达 | [Surprise-wa] | 😲 惊讶-哇 | | 情绪表达 | [Surprise-yo] | 😲 惊讶-哟 | | 情绪表达 | [Dissatisfaction-hnn] | 😤 不满-哼 |

🔧 API 接口

节点提供以下 REST API（供高级用户和自动化使用）：

| 方法 | 路径 | 用途 | |------|------|------| | GET | /voice-tag-editor/configs | 列出所有配置集 | | GET | /voice-tag-editor/config?name=xxx | 加载指定配置 | | POST | /voice-tag-editor/config | 保存/创建配置 | | DELETE | /voice-tag-editor/config?name=xxx | 删除配置 | | GET | /voice-tag-editor/active-config | 获取当前激活配置 | | POST | /voice-tag-editor/active-config | 设置激活配置 |

⚠️ 注意事项

• 当前实现仅支持 [...] 格式的标签清除（clean_text 输出）。如果使用其他格式需自行修改正则表达式
• VoxCPM 官方推荐使用英文小写标签（如 [laughing]），比变体（如 [Laughter]）更稳定
• 建议控制标签数量，不要在一句话里叠加过多标签

📄 许可

Apache-2.0 License