comfyui-anima-toolkit

功能详解文档(全功能手册)

本手册基于面板实际运行界面 + 源码整理,覆盖 LoRA 加载节点 与 本地管理面板 的全部功能模块。

2.37.0：连接、节点界面与画廊

更新插件后通过日常启动器重启一次 ComfyUI，再 Ctrl+F5 刷新页面。新增的后端接口与节点需要加载；此后修改 Agent 连接和模型，下次请求生效，无需再次重启。已有工作流、收藏、会话及用户配置保留。模型、个人账号及识别缓存不随包提供。

Agent 前台连接配置

节点“配置 → 本节点模型 → 管理连接与请求参数”可新建、编辑、复制、删除、刷新及检测 API 连接。填写自己的 Base URL、默认模型和 Key，选“保存并用于此节点”即可使用；普通保存仅更新所选连接。Key 留空保留原值，只有明确清除才删除；工作流不会保存 Key。每组连接保留自己的请求参数。

DSH 也在该窗口配置：填写 ComfyUI 所在机器的 DSH 用户目录，选择 Profile（通常为 web），保存并扫描，再从节点“连接来源”选择发现的来源。Relay 描述文件可自动定位或手动指定。静态 API 接入只读取现有配置；原生执行需要运行 DSH 与 Harness Relay，并安装可选依赖。API 预设即使取名 DSH，也不会因此继承 DSH 工具和 Skill。

“检测连接 / 读取模型”只请求模型列表，不执行计费生成，也不证明图片能力。无法提供模型列表的服务可手填官方模型 ID。一个来源含多个模型时需要明确选择；删除连接后不会自动切换其他账号。完整中英文教程。

现代节点和输出框

修复现代节点界面进入子图后的 Toolkit 自定义控件空白，以及工作流切换后旧面板残留。画廊界面在悬浮窗中时保持原挂载。输出文本框拖到合适高度后请保存工作流；重新打开工作流或刷新可恢复高度，各节点独立保存。

画廊与图片预览

多重画廊保持原图尺寸、float32 输出和逐像素结果，归一化改为原地计算并及时关闭 PIL 图片。4771×3096 实图保留首轮输出、再次执行选图解码时，额外分配峰值由 351.36 降至 224.58 MiB（约 36.1%）。该结果是解码内存测量，不是显存或整轮速度指标；完整 GPU 工作流连续两轮仍待复验，不能据此断言所有停顿已解决。

工具箱图片预览的编辑工具移到底部独立区域，窄屏自动换行，不再覆盖画面。网格 / 列表显示名称与选中状态；修复浅色主题下的按钮和导出菜单文字，导出明确显示保留或移除生成信息。

MOSS 可视布局

添加 TK MOSS Layout Editor，点“画框”拖出区域，松开立即输入描述。人物、物体、文字分区独立；文字区“可见文字”填写最终中文台词。B / V 切换工具，方向键微调，Ctrl+Z 撤销；支持多选、编组、关联副本、精确坐标、参考图、模板和 JSON 文件。展开画布可在非模态浮窗继续编辑。

直接使用：prompt 接正向提示词编码，width/height 接生图尺寸，不调用模型。AI 辅助：选择关联 Agent，点“扩写选区”或“扩写全部”（Ctrl+Enter）；复用该 Agent 的模型和辅助 Skill，结果回填原区域。模型只写描述，坐标和可见文字由画布维护。等待期间改了布局则保留当前编辑。

工作流连线：编辑器 layout → Agent layout → final_prompt → 编码节点。运行工作流会按 llm_expand 决定是否再次扩写；已经在画布上扩写好的内容应关闭该开关或直接使用 prompt。

导入示例工作流：两个人物和中文气泡已连接 Agent，默认关闭 llm_expand，运行时只编译、不重新付费扩写。交互扩写需要你自己的 Agent 连接；带参考图时模型必须支持图片。等待模型期间继续改布局，过期结果不会覆盖当前编辑。

TK MOSS Layout Preview 的 images 接 VAE Decode，layout 接对应编辑器，可将结果同步为底图；同时提供原图、矩形区域 MASK、彩色叠框、透明度、尺寸和 BOUNDING_BOX。叠框只在单独输出上绘制。底图不是图生图控制条件；bbox 不是人物轮廓分割或 CLIP 区域条件。

模板存于当前浏览器，参考图使用 ComfyUI 临时文件引用；重要布局请导出 JSON，换机器重新载入底图。编辑器来源与组合发行许可见 许可说明。

像素草稿使用 abs/xyxy，编译结果使用 MOSS abs_centralized/yxyx，坐标由程序转换。旧布局数据可迁入。已验证实际宿主编辑、选区模型扩写与中文文字/坐标保留；嵌套子图预览回传和完整 GPU 生图画质仍待验证。本版尚无曲线画笔、分层遮罩或遮罩转 bbox。

源角色查库与增量维护

Agent 主界面的“源角色查库”默认开启，在看图扩写前将 WD14 识别的角色与本地候选资料交给模型，辅助多人特征对应。查不到角色不阻断；参考资料也不能保证模型永不串位。

在“配置 → 创作资料核验 → 角色库自动更新”先点击“查看更新状态”，再选择每日使用时空闲补充和查不到时在线补查，保存设置；也可“立即后台补充”。运行中的生图或内存压力可使更新推迟。增量资料单独持久化、记录来源和状态，失败保留旧资料，不覆盖随包底库和用户中文别名。收录新角色不代表生成模型训练过该角色。

2.36.0工作流节点语言切换

工具箱设置中的「语言」同时控制节点显示。覆盖 Agent、画廊、LoRA 浏览、提示词卡片/保存/批次、过滤、触发词、路由、服装与相机等主要界面；切换后保存工作流并刷新 ComfyUI 页面，无需重启宿主。自定义提示词、标签、名称及服务原始回复保持原样。原生下拉框只翻译显示名称，工作流保存的值不变。已在 ComfyUI frontend 1.55.17 验证；较旧前端可能继续显示原始选项名称。自定义分类或改名分类保留原名，AnimaDex 共用工具箱语言设置。

一、LoRA 加载节点(Anima Batch LoRA Loader)

LoRA 加载节点

本地 LoRA 浏览窗

LoRA 组

ComfyUI 工作流里的节点,批量挂载 LoRA:

TK 可动素体相机(新节点)

这是 TK 目录下唯一的相机节点(旧「TK 相机控制」已退役),用于通过轻量可动空壳素体观察和确定机位:

TK 服装抽卡

独立的服装选择/随机节点,读取 TK Toolkit 面板服装库的 clothing-db IndexedDB:

服装库读取走会话级轻量快照（预览图并发限流 + 小型缓存）；工作流快照为 v2， 仅保存当前抽卡结果和必要元数据，避免把整库或图片 Blob 塞进工作流，同时兼容旧 v1 快照。

Anima Trigger Words 触发词管理节点(新增 2026-08)

独立节点,避免 LoRA 节点臃肿,把各 LoRA 的触发词整理成可直接粘贴的字符串:

二、本地 LoRA 管理(面板 · 默认首页)

管理本地全部 LoRA 文件,Steam 风格界面,分 首页 / 详情 两种视图。

工具栏

统计卡片

首页视图(网格)

每个卡片显示:预览图、模型名(中英)、本地路径、版本号、作者标签、分类标签(人物/风格/光影…)

详情视图

点任一模型进入,右侧面板:

三、LoRA 探索(面板)

浏览 C 站 LoRA 数据(Anima 生态,筛选:下载量 > 250、赞/下载比 > 5%):

四、画师系列(面板)

管理画师风格标签,组合成画师串:

五、PROMPT 库(面板)

存档和复用提示词:

六、图片解析(面板)

拖入 PNG、JPEG 或 WebP，查看实际保存的提示词、工作流与生成参数。支持 ComfyUI 图结构、A1111 参数文本及 NovelAI 等常见字段；多保存分支按当前文件匹配唯一分支，采样/模型/LoRA 参数保留阶段关系。

界面区分“存在元数据”和“找到可靠提示词”。工作流存在不代表保存了动态展开后的文本；未记录的原文不能恢复。WD14/在线反推结果单独标示来源，不冒充图片原始提示词。复制 Prompt、LoRA 或下载工作流均使用实际可恢复的数据。

七、Outputs 图片管理(面板)

目录与浏览

整理与识别

点击“开始整理”，按已有提示词重新分类启用的目录；“识别设置”中选择已安装的 WD14 ONNX+CSV 模型、普通/角色阈值，可重试未识别、暂停并查看进度与资源等待原因。未安装模型时不自动下载；常规本地推断使用 CPU，生图或内存不足时等待。

“待整理”表示尚未完成处理，“未识别”表示处理后仍没有可靠角色；作品明确时仍可归入作品，歧义角色不强行猜选。转义括号、作品连写、LoRA 触发词等参与规范化匹配，原始明确身份优先。可关闭的本机识别缓存只消费已有结果，不随插件分发，也不代表对所有图片都能准确识别。

预览与编辑

Pixiv 接收桥

工具箱菜单“更新日志与 QQ 交流群”内可下载配套扩展，也可从仓库 integrations/pixiv-drop-bridge 取得。Chrome / Edge 首次解压并加载扩展后，刷新工具箱与 Pixiv 两端，从列表或预览拖动即可；地址和端口自动识别，无需 Key。仅支持本机 HTTP localhost / 127.0.0.1，本次不承诺远程服务器或其他浏览器。仅交给上传控件，不会自动投稿；单图最多 32 MiB。

全局导出设置控制清除生成元数据、保留元数据和署名，列表/预览/编辑拖出使用同一策略。关闭去元数据时不会宣称生成信息已删除；不支持原生网页文件拖放的目标仍可下载后通过系统文件选择器添加。

八、设置与更新提示(面板)

工具箱菜单“更新日志与 QQ 交流群”可重看当前日志、下载接收桥及复制 QQ 群号 758086740。更新后首次进入页面自动弹日志，同一浏览器同一站点按版本记忆；清除站点数据后会再次显示。

九、TK 作图节点

配合作画的工作流节点。节点清单与分类见 README 的「TK 节点目录」。

TK 多重画廊（6 个图源：D站 / C站 / P站 / Safebooru / yande.re / Konachan.net）

一个节点六个图源，按标签或关键词搜索、筛选、下载并输出图片及元数据。

D站 风控自救

当 Danbooru 的 Cloudflare 把出口节点 IP 拦成「Just a moment」人机校验页时（表现为搜索失败 / 一直转圈 / 请求超时），节点会自动隐形式拉起本机 Edge/Chrome 作为内置浏览器网关继续搜索与下载，无需手动换节点；偶发仍被拦请到 Clash Verge 换个节点/地区。

搜索与交互

AnimaDex 角色浮窗（本地角色库，不是图源）

画廊工具条「角色」按钮打开的浮窗，数据与图源无关，完全本地：

TK 批量提示词注入

读取 input/prompts/ 提示词文件按组批量出图（一组 = 一张图）：

文件格式与配套 AI 撰写 skill 见 README 的「TK 批量提示词节点 + 配套 AI 撰写 skill」。

TK 图像选择

多路图像路由，用于在不同图源之间切换而不必改连线：

十、TK 文本与提示词节点

TK Prompt Agent

支持 Anima / Krea 2，兼容 Chat Completions API。当前 Prompt 可留空，用中文指令创建；随后继续修改并用范围/锁定保护已有内容，支持撤销与历史恢复。新节点默认快速直写，也可切按流程创作；确认的 Final Prompt 通过第二路 STRING 输出接编码器。

反推支持已安装 WD14、PixAI、ToriiGate 或配置的视觉服务；仅调用所选来源，结果先显示候选，点替换/追加后更新 Prompt。看图扩写使用原图与标签，沿用所选模型的参数。DSH 当前连接和原生 skill/工具执行均为可选，需要对应环境，普通 API 模式不依赖它们。完整设置见 Prompt Agent 使用说明。

TK Prompt Cards（提示词卡片库编辑器）

英中对照 tag 卡片拼/存提示词：

TK Prompt Saver（提示词保存）

TK Text Join（文本合并）

TK String Router（字符串路由）

TK Danbooru Tag Getter（Danbooru 分类提取）

单一 Prompt 输入即可自动识别并分类 Danbooru Tag，输出清理去重后的 Tag String。

TK 空 Latent（预设空 Latent）

十一、数据持久化（跨重启不丢）

数据 位置 说明
Prompt 库 IndexedDB + data/prompt_library.json（含 .bak） 面板、TK Prompt Cards、TK Prompt Saver 共用同一份镜像；清理浏览器站点数据、切换 localhost/127.0.0.1 或更新插件后，启动会自动恢复缺失条目。「导出全部数据」也包含 Prompt 库，导入按 ID 合并
LoRA 组 / 分类 / 偏好 data/anima_meta.json 键级合并 + 空值护栏；data/ 在更新链的排除目录里，一键更新不会碰
自定义场景预设 data/tag_presets.json Tag Getter 的场景预设库
服装库 浏览器 clothing-db IndexedDB ⚠️ 工具箱与 ComfyUI 必须使用同一个浏览器配置和同一个地址/端口打开，否则浏览器会视作不同数据源
图源密钥 data/ 下各自文件 不进仓库、不随包发布
批次清单 data/batches/ 批量提示词的排队/执行状态

技术架构(给开发者)

浏览器(面板 SPA,Vite + TypeScript)
   │  fetch /anima/* API(HTTP + JSON)
   ▼
ComfyUI 后端(Python)
   ├─ __init__.py        路由:模型扫描 / 元数据 / C 站代理 / 下载
   ├─ anima_backend/ 后端实现（节点、画廊、提示词）
   ├─ services/ 更新、索引、元数据与后台任务
   └─ web/js/            节点前端(ComfyUI 扩展)

2.34.0：语言与 Prompt Agent 使用补充

工具箱设置页可切换简体中文 / English，语言偏好保存在当前浏览器站点。本轮只覆盖工具箱，工作流节点及其余界面尚未全面翻译，下轮继续。用户提示词与历史记录保持原文。英文手册见 English guide。

Prompt Agent 通过配置按钮选择统一连接、模型、Skill、反推与过滤设置。创作 / 看图反推和常用选项保留在节点上；更改模型影响下一轮请求，无需重启。运行失败时保留并标注旧结果；翻译检查只提示质量问题，不保证模型已完成翻译。区域画笔与遮罩转 bbox 仍为待办。

2.35.0：画廊悬浮窗与原始反推结果

画廊点击“展开画廊”，可在页面内拖动、缩放、最大化或最小化，不受画布缩放和平移影响。关闭或“返回节点”保留查询、滚动、筛选和选图顺序。位置尺寸保存在本浏览器。页面只有一个窗口，标题标明绑定节点；删除节点或切换工作流后暂停绑定，需重新从目标节点展开。

图片按原始比例在最短列排列为瀑布流，横图不会再占用竖图高度；完整显示、不裁边。搜索贴数紧跟主标签，译名另起一行；方向键选择提示，Enter/Tab 确认，Escape 收起。顶部调整常用筛选、排序与缩略图尺寸，分类与预设可折叠，底部显示选中数量、已选图片与输出摘要。大图查看不改变选择。

画廊窗口

搜索贴数

Prompt Agent 的“原始反推结果”放在节点主体、Final Prompt 上方，默认展开、可收起，显示 WD14 等来源返回的标签或描述。它是只读显示，不会替换最终提示词或更改输出。反推完成即更新，扩写失败仍保留已经取得的原始结果。

原始反推结果与最终提示词

看图扩写、视觉反推及角色分析指令取消 4000 字符输入限制。配置中的输出长度为软目标与提醒值，默认 4000，填 0 关闭；超长不截断或阻断，JSON 保留完整。所选服务的上下文和输出 token 限制仍适用。更新后 Ctrl+F5 刷新页面。

This site is open source. Improve this page.