梦圣智杰
8781cbe921
- 修复新版 ComfyUI（前端 1.58+）下不跟随明暗主题。 - 收藏改成文件夹式的库：一个条目一个文件夹、可建文件夹设颜色、拖动排序，旧收藏自动迁移；存放位置挪到插件目录 data/saved，拷贝文件夹即迁移。 - AI 规则可按后端存多套预设，切换、另存为、删除、恢复默认就地完成；改过的规则带记号，未保存的不参与翻译。 - 修复删行尾带逗号标签误删换行、获取模型候选看不到选不了、问号提示框向左溢出三处界面问题。 - 恢复默认改为三步确认；删除参考图开关旁标注保存后生效。
ComfyUI 双语提示词管理器 v2.2.3
ComfyUI 双语提示词节点：把英文提示词拆成可点击的标签，边写边看中文解释、调顺序、试效果。
它解决什么问题：Anima / Danbooru 风格的提示词是一长串英文标签，写完很难确认模型到底读到了什么。这个节点把提示词变成可选中、可删除、可排序的芯片，每个芯片旁边就是它的中文解释；输出的永远只有英文提示词本身，中文只用于阅读。
目录
主要功能
提示词编辑
| 标签化视图 | 英文提示词按标签切成芯片，每张卡片上半是英文、下半就是它的中文解释，点一下还会和侧边栏的明细行联动高亮。看不清楚的标签不用再猜。 |
| 编辑 / 标签两种形态 | 「编辑文本」在纯文本编辑和标签视图之间切换。写完点「完成」进入标签视图，随时可以切回去改。 |
| 拖拽排序 | 按住标签直接拖，或在明细表里拖 ⠿ 手柄；也可以选中后用 Alt+↑ / Alt+↓ 微调。排版不会乱——逗号空格样式保留，换行分段不被合并。开启「拖动实时预览」后，被拖的标签会浮起来跟着光标走，其余标签像手机桌面挪图标那样平滑让开。 |
| 临时隐藏 | 鼠标移到标签卡片上，右下角会出现眼睛图标，点它把标签移出实际输出。标签不会从节点里消失，只是加删除线并灰化，照常可以拖动、改色、改权重，但模型完全看不到它。适合做「有 / 没有这个标签」的对比出图，之后逐个或一次性全部恢复。 |
| 删除标签 | 选中标签后卡片右上角出现 ×，点它删除；也可以选中后直接按 Delete。删掉的标签会先被划掉、擦走，再从列表里消失；添加标签时新标签则展开出现——两个过渡共用一个开关，可以关掉。 |
| 权重编辑 | 双击标签设置 0–3 权重，有常用预设和一键清除。 |
| 颜色分区 | 标签可按「收录状态」着色（未收录 / 机器翻译各自一色），也可以随机着色帮助分辨；需要时一个个自定义。 |
| 撤销重做 | 删除、排序、隐藏、权重、清空全部支持撤销重做，快捷键 Shift+Alt+Z / Shift+Alt+Y（Ctrl+Z 留给 ComfyUI 画布自己的撤销，插件不抢）。快捷键只在节点文本框 / 英文标签区有焦点时生效。 |
| 换行分段 | 提示词里的换行会渲染成行尾的 ↵ 块，标签区真的断行，中英两栏行数对齐。换行块本身也能拖动。 |
翻译与整理
| 能力 | 说明 |
|---|---|
| 四种处理方式 | 仅翻译 / 翻译并优化 / 优化 / 按 Anima 官方顺序整理（不新增标签，只重排分段） |
| 优化按模式分派 | 标签模式下「优化」整理现有英文标签流（只吃英文）；自然语言模式下改写为英文自然语句，中文会先译成英文。两种模式各用一套规则，可在助手设置里分别自定义 |
| 自动识别模式 | 自动区分纯标签、纯自然语言、混合文本和翻译指令，也可以在明细表上方手动指定；指定的模式跟着节点保存 |
| 自然语言模式 | 模式切到「自然语言」后，「按 Anima 顺序排序」自动隐藏——整段句子没有标签流可排 |
| 提示词诊断 | 自动标出可疑权重、重复标签、语法问题 |
| 快捷添加 | 底部的快捷输入框：写中文自动翻译成英文标签后追加，写英文标签直接追加；Enter 添加、Shift+Enter 换行、Ctrl+Enter 翻译并优化 |
词库与翻译服务
| 能力 | 说明 |
|---|---|
| 多来源词库 | 内置词库 + 个人词库 + 社区词库包，每条解释都会标注来源 |
| 概念搜索 | 搜「丝袜」能返回连裤袜、长筒袜、过膝袜等相关标签，支持滚动分页加载 |
| 大型 Danbooru 词库（可选） | 按需安装，覆盖面更广，不装也不影响其它功能 |
| 翻译服务可切换 | 纯词库（离线、免费）／ 百度翻译 ／ OpenAI 兼容 API ／ Ollama。翻译与解释可选任意一种；「翻译并优化」「优化」恒定走 AI |
| 密钥互不干扰 | AI 与百度密钥独立留存，切换翻译服务不会清空；均不写入工作流、不返回浏览器 |
上游提示词接管
节点左侧有一个 prompt 输入口，接法与 CLIP 文本编码器完全一样，把上游节点的文本输出拖过来即可。不接的时候节点行为和普通提示词节点一样。
接上之后，节点顶部会出现「上游输入」控制条：
- 拦截上游文本（默认开启）：运行时先把上游文本导入节点，然后暂停工作流让你整理——排序、隐藏、翻译、直接改都行——点「继续」后才把结果交给下游。暂停期间下游不执行，也不占用显卡资源。
- 关闭拦截：节点等价于一根导线，上游文本原样流向下游，不导入、不暂停。
- 导入策略（仅拦截时可用）：
导入：内容变化时（默认，不会冲掉你手工改过的内容）／导入：每次运行／导入：仅首次运行。
三点注意事项：
-
暂停用的是 ComfyUI 原生的异步节点机制，不是死等轮询；等待期间可以点 ComfyUI 的取消中断，也可以点「丢弃」终止本次等待。
-
暂停会占用 ComfyUI 的执行线程，队列里的其它任务要等这次确认完成。
-
没有浏览器界面时（例如用 API 提交工作流）没人能确认，节点约 20 秒后自动按透传放行，不会永久卡住。
收藏
出了一张满意的图，把当时的提示词存下来，下次直接复用。
- 保存：点节点上「英文原文（实际输出）」右侧的「收藏」按钮 → 填名字、写备注（可留空）、标上适合的模型、拖入或粘贴一张出图截图 → 保存。保存的是节点当前这份英文文本（包含其中被隐藏的标签）。不在节点上时，也可以从侧边栏「收藏」分页点「新建」，再选一个节点读取文本。
- 适合模型：输入关键词，会从本机
models/目录（checkpoints、diffusion_models、loras、embeddings、text_encoders）里匹配已安装的模型；Enter把高亮那条加成标签，↑↓切换候选，列表里没有的名字也能直接回车当自由文本填进去。最多 20 个。 - 编辑：卡片上的「编辑」按钮打开和保存时同一个弹窗，名字、备注、适合模型、配图、提示词正文都能改。不选新图就保持原图，选了新图会替换并删掉旧的。
- 结构：一个条目一个文件夹，文件夹名就是收藏的名字，参考图与文件夹同名——在文件管理器里直接就能看懂、改名、备份。新建时类型也可以选「文件夹」收纳条目：只填名称、备注、适合的模型、参考图；文件夹能设颜色（8 个预设色或随机取一个），里面的条目沿用同一个颜色、淡一档。拖动可以排序，也可以把条目拖进文件夹。
- 使用：侧边栏「收藏」分页按树形浏览，卡片直接显示适合模型和备注；支持搜索（模型名也算）、编辑、复制、载入节点、删除。
- 存放位置：插件目录的
data/saved/（和用户词库、配置放在一起，备份时一起带走），重装或更新插件不会丢。单图上限 5 MB，最多 2000 条。拷贝整个saved文件夹就是完整备份，粘到另一台机器的同一位置即可迁移。 - 旧数据迁移：从旧版本升级后第一次打开收藏，旧收藏会自动搬进新结构（只搬一次）；旧数据原文不动。
「载入节点」会先弹窗确认再覆盖节点文本，这个动作无法撤销。
侧边栏管理面板
标签管理、词库维护、词库包、收藏四个分页收在侧边栏的「双语提示词管理」面板里，节点本身保持简洁。面板里的改动会实时同步到页面上所有同类节点，不需要刷新页面。
「标签管理」默认跟着你点开的节点走：在画布上点一个「双语提示词检查器」节点，侧边栏就切到它。不想要这个行为，关掉「设置 → 通用」里的「点击节点时跟随切换」，之后只能在面板顶部的节点下拉里手动选。
助手设置不在这个面板里：它在 ComfyUI 的「设置」面板中，「设置 → 双语提示词检查器」下有两项 ——「通用」和「助手设置」，表单都直接铺在设置面板右侧。
操作反馈
每次操作都会给一条回执，按操作类型分色，不用再去状态栏找那一行字：
| 颜色 | 什么时候出现 |
|---|---|
| 蓝色 | 改内容：应用改写、改权重、隐藏 / 取消隐藏、保存词条、导入词库 |
| 紫色 | 添加标签（底部快捷输入、搜词库点结果） |
| 红色 | 删除标签 |
| 青色 | 移动标签 |
| 灰色 | 撤销 / 重做 |
| 绿色 | 翻译成功 |
| 橙色 | 「唯一」开关 |
- 右下角提示条：新的出现在最下面，旧的往上顶，最多同时显示 5 条，过一会儿自己收走，也可以点 ✕ 立刻关掉。
- 右上角弹窗：错误、翻译被拒、批量翻译的进度与汇总、重复标签的定位走这里，红色系、停留更久。同类操作会就地更新同一张卡（比如连点重复胶囊是在同一张卡里翻「第 2 / 3 处」），不会一条接一条地冒；批量翻译期间只留一张总进度卡。
- 两个都嫌打扰，可以在「设置 → 通用」里分别关掉「右上角通知弹窗」和「右下角提示条」，关掉后提示退回节点状态栏。
界面导览
节点上可以大致分成三块：
- 英文原文（实际输出）——节点真正输出给下游的文本。上面有「编辑文本 / 完成」「清空」「插入换行」「收藏」「优化」「按 Anima 顺序排序」几个按钮。
- 标签区——每张卡片上半是英文标签、下半是它的中文解释，只用于阅读，不进入输出，也不会传给下游。标签多了这里会自己滚动，也可以在明细表上方的筛选栏打开「适应高度」，让它跟着节点一起变高。
- 快捷添加——底部输入框，中文进英文出（自动翻译后追加），英文则直接追加。
明细表不在节点上：它被侧边栏的「标签管理」借走了（节点旁边的画布空间要留给画面）。那里每行一个标签，列出每行的来源、翻译、权重、分类，右侧按行状态给出操作（翻译 / 确认并存 / 重新翻译 / 编辑中文 / 收藏 / 复制 / 删除个人词条）；上方有搜索框、模式选择、颜色模式、筛选（全部 / 未知 / 机器翻译 / 个人词库 / 收藏）和问题提示。
安装
用 ComfyUI-Manager（推荐）：在 Manager 的节点列表里搜索 Bilingual Prompt Inspector 安装；也可以走 Manager 的「Install via Git URL」，填入仓库的仓库地址。
使用comfy-cli安装：
cd ComfyUI/
comfy node install prompt-translator-manager
手动安装：
cd ComfyUI/custom_nodes/
git clone --depth 1 https://github.com/mengshengzhijie/ComfyUI-Bilingual-Prompt-Inspector.git
如果网络受限也可以使用 gitee，或者用上神奇的 -c：
git clone https://gitee.com/MengShengZhiJie/ComfyUI-Bilingual-Prompt-Inspector.git
不过这里如果有动手能力的话推荐使用 git 安装，因为现在就我和我的朋友在使用，有时候修复bug和制作新功能我是总结下来然后一步一步的修复。直到把这次收录的bug和建议给完成之后才bump版本。
重启 ComfyUI，在节点菜单的 text/prompt 分类里找到 提示词翻译与管理（英文输出）（英文界面下显示为 Prompt Translator & Manager），也可以直接搜索「提示词」。
两个常见坑：
- 装完看不到节点 → 先确认
custom_nodes下的目录名正确、ComfyUI 确实重启了，然后Ctrl+F5完全刷新浏览器，清掉旧的 JS 缓存。 - 从原版（Qiongyi44/ComfyUI-Bilingual-Prompt-Inspector）升级 → 直接覆盖
custom_nodes下的目录，个人词库与词库设置会保留。
Nodes 2.0（ComfyUI 设置里的「现代节点设计」）下，标签拖拽排序与上游即时拦截已被官方前端旁路，无法工作，这是前端渲染方式的限制。要用完整功能请关闭该选项；1.2.1 起其余功能在两种模式下都正常。
快速上手
- 把节点接到 CLIP 文本编码器上，和普通提示词节点一样。
- 在「英文原文」里写提示词，或点「编辑文本」写完后点「完成」。
- 在标签视图里逐个检查：点标签看中文解释，双击调权重，拖动手柄排顺序。
- 想确认某个标签到底有没有用？鼠标移到标签卡片上，点右下角那颗眼睛隐藏它，重新出图对比，再一键恢复。
详细说明
翻译服务配置
默认走纯词库，不联网也能用。需要机器翻译或 AI 优化时，打开「设置 → 双语提示词检查器 → 助手设置」。这一项分三段：
| 分段 | 内容 |
|---|---|
| 翻译服务 | 翻译 / 解释按此选择：纯词库（离线、免费）／ 百度翻译（需自行申请开放平台的 APP ID 与密钥）／ OpenAI 兼容接口 ／ Ollama（本地）。选后面两个时，它们本身就是下面的 AI 服务 |
| 百度翻译 | 独立配置 APP ID 与密钥，切换翻译服务不会清空 |
| AI 服务 | 「翻译并优化」「优化」恒定走这里。翻译服务选了 OpenAI 兼容 / Ollama 时，下面直接就是那个后端的配置；选纯词库 / 百度翻译时，这里多出一个「AI 后端」下拉，决定优化用哪一套。两个后端各存一套配置，切换不清空： |
| ↳ OpenAI 兼容 | API 地址、模型、可选 API Key、温度、超时，另有「使用 LM Studio 本地预设」一键填入 1234/v1。远端地址必须 https，本机回环（127.0.0.1 / localhost）才允许 http；内网、保留、链路本地地址一律拒绝 |
| ↳ Ollama | API 地址、模型、温度、超时，没有密钥，另有「使用 Ollama 本地预设」一键填入 11434。地址只能是本机回环地址，其它一律拒绝 |
模型名称旁边的「获取模型」按钮会拿输入框里当前填的地址问一次服务端有哪些模型（OpenAI 兼容问 /models，Ollama 问 /api/tags），拉到的名字显示成输入框下方的行内候选列表——跨整行显示、点一下就填进去，也可以完全不管它自己手写。再点一次按钮就是重新拉取。列表只在本次会话内有效、地址一改就作废，不写进配置文件。密钥以输入框里填的为准，输入框留空就用你已经保存的那一份；无论哪种都只随这一次请求发出，不会随着设置一起回传给浏览器。服务端返回看不懂的内容（纯文本报错、登录页之类）时会原话告诉你，不会甩一段 JSON 报错。
两个后端各有自己的规则编辑器（翻译 / 翻译并优化 / 优化 / 自然语言）：本地小模型与云端大模型要写的提示词往往不一样，分开存可以随时切换后端而不用重改规则。其中「自然语言」那套只在自然语言模式下被「优化」使用，结果按完整英文句子保留标点，不套 Anima 的标点限制。地址不合规时会在发出请求前直接报错。
规则还能按后端存多套预设：规则区标题右侧的下拉选一套已存的预设，旁边「另存为 / 删除 / 恢复默认」就地完成——比如同一个后端留一套「直译」一套「精修」，随时切。编辑器里手改过的内容会被标出来（和内置默认、所有预设都对不上的那条会带记号），提醒你还没存进任何一套；改完记得点保存，未保存的规则不参与翻译。「恢复默认」要点三次才真正执行。预设文件存放在插件目录的 data/rule_presets/。
大型词库（可选）
由于社区数据的授权边界，本仓库不附带 danbooru_tags.sqlite3。需要更大覆盖面时，按 release_docs/大型词库手动安装说明.txt 自行构建安装；不装也不影响其它功能，界面会明确显示「未安装」。
界面语言与外观
界面文案跟随 ComfyUI 的语言设置，也可以在「设置 → 双语提示词检查器 → 通用」里固定为中文或英文。外观同样可在「跟随 ComfyUI / 暗色 / 亮色」之间切换，两项改完立即生效并单独保存。
这个折叠（「通知弹窗及实时动画预览」）里还收着几个手感和提示相关的开关，最上面另有一个「全部开启」总开关，一次控制下面这几项；各项都默认关闭，关掉就是原来那样：
| 开关 | 管什么 |
|---|---|
| 右上角通知弹窗 | 错误、被拒、批量翻译进度是否用右上角弹窗报 |
| 右下角提示条 | 操作回执是否用右下角提示条显示 |
| 拖动实时预览（节点标签区 / 明细表） | 拖动时其余标签是否实时让位，两个区域各管各的 |
| 标签增删动画（节点标签区） | 删除标签是否划掉擦走、添加标签是否展开出现 |
折叠上方还有一项「点击节点时跟随切换」：点画布上的节点时，侧边栏「标签管理」是否跟着切过去。
系统开了「减少动态效果」的话，第一次进入会把上面这几个纯装饰性的动画（两个拖动预览、标签增删动画）自动关掉，并在右上角说明一句。只做这一次，之后你手动打开就按你的来；右上角弹窗和右下角提示条不受影响——它们只是操作回执，关掉等于连结果都看不见。
常见问题
找不到节点 / 界面还是旧的
先确认 `custom_nodes` 下的目录名正确、ComfyUI 确实重启过；然后强制刷新浏览器（`Ctrl+F5`）清掉旧 JS 缓存。ComfyUI 前端缓存比较顽固，这一步不能省。点翻译提示要先配置翻译服务
纯词库模式下只能查词库，不会翻译。想翻译请在「设置 → 双语提示词检查器 → 助手设置」里选一个翻译服务（百度翻译、OpenAI 兼容接口或 Ollama）。
切换翻译服务后密钥消失了？
不会。两套密钥独立留存，切换翻译服务互不清空。只有 AI 后端 / 地址变更或换机器时才清 AI Key，百度密钥只在显式勾选「清除」时才清。拖拽排序 / 隐藏没反应？
这两种操作只在标签模式与混合模式下可用，纯自然语言模式下没有意义。另外如果开了 ComfyUI 的「现代节点设计（Nodes 2.0）」，请关掉再试，原因见上文安装一节。
拖标签时整片标签在动，看不清落点
那是「拖动实时预览」在起作用（默认关闭）。它会让其余标签实时让开，长提示词下偶尔显得晃；到「设置 → 通用」把它关掉，就退回只有落点提示线的老样子，松手才真正挪动。
运行到一半卡住了，好像在等什么
这是上游接管的暂停确认。节点在等你整理导入的上游文本，点「继续」放行，或点「丢弃」终止本次等待；也可以直接点 ComfyUI 的取消中断。无人确认时约 20 秒会自动透传。已知边界
- 本扩展是提示词工具，不保证某个标签一定被模型准确执行。
- 自动翻译与优化结果都需要人工复查。
- 自然语言块不支持按内部单词逐项删除，要回文本模式改。
- 拖拽排序与隐藏只在标签模式和混合模式下可用。
- 提示条、拖动实时预览、增删动画这几个都属于观感加成，默认关闭；关掉后行为和旧版本完全一致，不影响任何数据。
- 隐藏清单、接管开关与导入策略都保存在节点属性里，导出「API 格式」JSON 时不会带出——届时隐藏标记会丢失，被隐藏的标签会直接出现在输出里。
- 接管上游提示词需要浏览器界面来确认；用 API 提交工作流时节点自动透传，不会等待。
- 收藏不记录工作流名称与节点编号；载入节点会覆盖节点当前文本，只弹窗确认，不支持撤销。
- 若 ComfyUI 大幅改动前端文本控件结构，界面适配可能需要跟着更新。
性能与隐私
- 默认不联网：翻译服务的默认选项是纯词库，完全离线。
- 只在你主动使用某个服务时才发请求：调用百度或 AI 时，发送的是提示词文本与你的指令；密钥只存在后端本地，不回传浏览器、不写入工作流。
- 大型词库按需加载：不安装就不加载，装了也是本地文件查询。
- 收藏只存在本机：写在插件目录的
data/saved/下，插件不做任何上传。
反馈与联系
本插件由 mengshengzhijie 独立维护。遇到问题或有功能建议，欢迎反馈（不要附带 API Key、密钥、私人词典或完整配置文件）：
- GitHub Issues：https://github.com/mengshengzhijie/ComfyUI-Bilingual-Prompt-Inspector/issues
- 邮箱：mengshengzhijie@163.com
反馈时请附上：ComfyUI 版本、前端版本、安装方式（git clone / ComfyUI-Manager / 桌面版）、浏览器或桌面环境、复现步骤，以及去掉敏感信息的报错日志。
安全问题（如密钥泄露风险）请不要开公开 issue，走 GitHub 私有漏洞报告 或发邮件，详见 SECURITY.md。
致谢与许可
基于 Qiongyi44/ComfyUI-Bilingual-Prompt-Inspector 二次开发，现已独立维护。在原版基础上新增了百度翻译、侧边栏管理面板、标签拖拽排序、临时隐藏、上游接管与收藏，以及右下角提示条、拖动实时预览、标签增删动画这些交互细节。
词库数据来源与授权说明见 THIRD_PARTY_NOTICE.md，许可条款见 LICENSE，完整使用手册见 release_docs/使用手册(原README).md。