Comfyui Animatool

Anima / ComfyUI-AnimaTool 生图入口

本 skill 只服务 ComfyUI-AnimaTool 的 Anima 生图策略

默认职责

本 skill 是 Anima 生图策略入口：判断分支、组织视觉决策、校验 hard anchors、组装 prompt。它不直接维护 ComfyUI 服务器，也不执行工作流。

触发与分支

有 Anima 生图意图时触发：生成图、画图、出图、reroll、roll 图、抽卡、随机图、指定 Anima/画师风格并要求生成。

没有生图意图时不执行生图：

• 查角色/作品/画师/tag → 只用 danbooru-tags
• 只要随机画师串 → 只用 danbooru-tags --random
• 查模型/规则 → 交给 comfyui-manager 查询；

生图分支：

1. 普通生图（用户可以只用一句话描述画面）→ danbooru-tags 校验硬锚点 → 组装完整 positive/negative → 通过 comfyui-manager 执行已导入工作流
2. 随机图 / roll / 抽卡（包含随机 tag / 随机画师 / 随机构图等多维度随机，用户说"随机/roll/抽卡/来一张随机的"）→ anima-random-gen 产出参数 → 校验 → 通过 comfyui-manager 执行
3. 仅随机画师（其他由用户指定，用户说"随机画师/抽个画师"）→ danbooru-tags --random 5 --for-prompt --json --compact → 选 1 个画师 → 组装参数 → 通过 comfyui-manager 执行
4. 随机角色/服装/姿势/场景抽卡 → 按 danbooru-tags 的候选预算选择 N，用 --random N --group <group> --json 抽候选 → 按兼容性筛选 → 组装参数。
5. 明确画师串、多画师融合、artist mixer 或多画师权重混合（用户给多个画师名/权重/融合比例）→ 走 local/anima-txt2img-aesthetic-lora-artist-mixer，把画师写入 artist_chain，不要把多画师堆进普通 prompt。
6. 明确"全 Danbooru tag / 纯 tag / 不加自然语言"（用户说"只写 tag/纯 tag/不要自然语言"）→ 只写 tag，不写 nltags

读取导航

生图前视觉简报

在组装参数前，必须先用 anima-composition-director 的方法形成简短视觉简报；不要把简报原样输出给用户，也不要写进 prompt_hint。

当需求涉及参考图构图、复杂场景、多人互动、特殊镜头、高分辨率、强光影、明暗对比、人物情感、故事感、象征构图，或模型明显缺少画面决策时，显式使用 anima-composition-director。本 skill 只接收它的输出：canvas、camera、composition、lighting、focus、nltags_sentences，再与 Danbooru hard anchors 组装 prompt。

视觉简报只用于决策：character / series / artist / appearance 锁定身份和画风；tags 放已确认锚点；environment 放短场景/光影 tag；nltags 使用 anima-composition-director 产出的短英文画面控制句。

分辨率与构图回写

不要一开始套默认 1024x1536。先按 anima-composition-director 的 canvas fit 固定最终 width/height，再把主体位置、景别、留白方向、背景展开方向回写到 nltags。用户明确给尺寸时必须使用，但要检查构图是否适配。

规则：用户允许使用某分辨率仅表示可用，不是默认全部使用。多图时每张图按各自的构图复杂度独立选择画布，禁止批量套用同一分辨率。

当前只按 Anima base1.0 正式版处理；默认初始生成不主动推荐任一边超过 1536。不要默认改用 1920x1080，更大输出交给放大节点。1536x1536 只用于高信息量中心构图；简单头像、表情图、普通半身图使用 1024x1024。

质量步数推断

默认 steps=30；禁止所有场景固定此值，必须按用户意图调整。

• 普通单人、简单半身、快速测试、没有强调精修或复杂背景 → steps=30。
• 用户明确高质量、精修、壁纸、大场景、复杂背景、强光影、透明感、细节层次，或指定画师风格本身依赖大背景和光影表现 → steps=40。
• 用户给了 1536x1536、1536x1024、1024x1536 等高分辨率，但未说明只是快速测试时，若画面语义包含多人互动、复杂背景或光影叙事，优先 steps=40。
• 用户明确要求速度、草稿、测试链路、快速看构图时，即使高分辨率也可保留 steps=30。

必须先做的 tag 校验

生图前先写一个最多 4 项的检索计划，然后按 danbooru-tags skill 的批量入口一次取回结果。Shell 下优先使用 --batch-stdin，不要内联多行 --batch-json。

画师称呼解析

用户给出的画师名可能不是 Danbooru/Anima 的 artist tag。不要维护本地固定别名表，也不要把中文昵称按字面直接丢给 tag 检索器。

流程：

1. 如果画师输入不是明确的 Danbooru artist tag（例如没有 @，或包含“太太/老师/画师/社团”等自然语言称呼），先进行网络搜索确认 canonical artist name、常见别名和公开资料来源。
2. 优先采用官方主页、社交主页、百科或作品页等互相印证的信息；不要只凭单个图片聚合站结果下结论。
3. 将网络确认出的英文/罗马字画师名转为候选 @artist，再用 danbooru-tags --group artist 校验。
4. 只有 danbooru-tags 返回 confirmed artist 后，才写入 prompt；查不到时向用户说明无法确认 tag，或改用最接近的 confirmed artist 候选。
5. 网络搜索只用于解析称呼和别名，不替代 Anima CSV / Danbooru tag 校验。

硬性限制：

1. 普通生图最多 1 次批量查询 + 1 次补查；超过后把缺失内容写进 nltags。
2. 必查：角色、作品、最终选定画师。
3. 可查：最多 1 个用户明确指定且高度可标签化的外观/服装锚点。
4. 不查：构图、环境光影、恶堕/氛围、情绪、连续动作、复杂服饰组合；这些写进 nltags。
5. 不要把角色名当 appearance 查，例如不要查 appearance --keyword "alice"；命名角色外观不确定时，不要用 appearance/clothing 盲查反推设定，先依据用户参考图、官方资料或轻量网络搜索确认关键外观，再只检索少量可标签化锚点，不确定细节写入 nltags。
6. 只把 confirmed_tags 中与用户意图一致的项放入参数；candidate_tags 必须筛选。

检索计划遵循 danbooru-tags 的批量与变体规则。普通生图最多 4 个语义锚点；每个锚点最多 2–3 个变体；总 query 控制在 12–16 内。使用 --compact 后只读 JSON 并筛选，不向用户复述完整检索过程。Rust CLI 的 group 空结果 fallback 只作为 candidate_tags，不能当 confirmed 回填。

Prompt 组装规则

正向内容必须英文。默认单画师结构顺序：

quality_meta_year_safe → count → character → series → artist → style → appearance → tags → environment → nltags

画师串/多画师融合只在用户明确要求时启用 Artist Mixer 工作流。此时 prompt_11 仍按上述结构组装，但不要包含 @artist 或多画师串；画师列表改写入 artist_chain。

本地默认使用美学 LoRA 增强工作流，默认质量前缀为：

masterpiece, very aesthetic, best quality, score_9, score_8, highres, absurdres, newest, year 2025, nsfw

只有用户明确指定基础工作流、禁用 LoRA 或做对比测试时，才使用基础质量前缀：

masterpiece, best quality, score_7, newest, year 2025, nsfw

安全标签必须是 safe / sensitive / nsfw / explicit 之一；用户未指定时默认 nsfw。

period 与 dataset tag

newest / recent / mid / early / old 是风格时期控制，不是固定装饰。用户要求早期、老动画、平成感、赛璐璐、复古 Galgame 或指定年份时，按意图选择对应 period，并移除冲突的默认 newest / year 2025。

• 默认现代二次元风格：保留 newest, year 2025。
• 指定年份：优先使用 year xxxx，必要时配合最接近的 period；不要同时放冲突 period。year xxxx 和 period 控制词属于 Anima prompt 控制，不依赖 danbooru-tags 检索确认。
• 旧画风/赛璐璐/早期代表作：优先考虑 old 或 early，并让年份、代表作/IP 和画师时期一致。
• retro_artstyle、faux_retro_artstyle、heisei_retro、traditional_media 这类 Danbooru 风格 tag 可以用 danbooru-tags 校验后放入 tags；不要用检索器查询 old 来代表 period，因为它也可能表示老人、旧设计或旧物。
• ye-pop、deviantart 等 dataset tag 只在用户明确要求非纯 anime、欧美插画、网络绘画或特定数据域质感时使用；默认 Anima 生图不要主动加入。dataset 控制词优先按 Anima 规则使用；检索器只用于确认它是否也存在为 Danbooru tag，不存在不算失败。

画师字段

artist 是当前工具 schema 的必填字段，且画师 tag 必须以 @ 开头。不要使用固定默认画师组合。

• 用户指定画师：先用 danbooru-tags --group artist 校验，保留其选择。
• 用户要求随机画师：用 danbooru-tags --random 5 --for-prompt --json --compact 取 1 个。
• 用户要求“抽 N 个候选画师再任选一个”：只调用一次 danbooru-tags --random N --json，从 random_artists 里选 1 个；不要循环调用 --for-prompt。
• 用户要求随机角色/服装/姿势/场景抽卡：只调用一次 danbooru-tags --random N --group <group> --json；模型按任务自选 N，普通建议 10–50，硬上限 1–300；只有用户明确要大量抽卡候选时才按指定数量执行。
• 随机候选只供内部筛选；最终 prompt 只放筛出的少量兼容 tag，不向用户复述完整候选 JSON。
• 用户未指定画师：先按风格意图从预设池选 1 个候选，再只校验该画师；不要用 dark/corruption/恶堕 这类风格词查 artist。
  • 日系本子 / 恶堕 / 成年向：优先候选 @pija, @okara, @mignon。
  • 肉感 / 黑丝白丝：优先候选 @rhasta, @mignon, @yom。
  • 中性通用 / 清爽二次元：优先候选 @mignon, @fkey, @hiroichi。
  • 最终只选 1 个并用批量查询校验。
• 用户明确不要画师：如果客户端允许空值，可传 artist: ""；若工具校验拒绝，先说明 AnimaTool 当前 schema 要求画师字段。
• 默认普通生图只选 1 个画师，并写入 artist / 普通 prompt 槽位。
• 多个画师分别出图不等于画师串。用户说“分别用 A/B 画师”“每组一个画师”“A 画师 N 张、B 画师 N 张”时，走普通默认工作流，为每个 job/prompt 写单个 @artist。
• 用户明确要求画师串、多画师融合、artist mixer 或多画师权重混合时，使用 local/anima-txt2img-aesthetic-lora-artist-mixer；把不带 @ 的画师串写入 artist_chain，并从 prompt_11 移除画师标签。
• Artist Mixer 默认参数由 comfyui-manager 工作流提供；非用户要求不要改这些参数。
• artist_chain 可用 (name:weight) 表达画师之间的相对比例。
• 画师组合优先选风格相近者；需要主辅关系时，可从主画师 1.0、辅画师 0.2–0.4 这类相对权重开始。
• 画师串建议保持小规模；用户未指定数量时优先 2–4 个。用户明确要求更多时可以按需求执行，但应提醒画师越多速度和风格可控性越差。

画师时代、代表作与风格锚定

• 用户指定年份、年代、旧画风、新画风、赛璐璐、某时期或某代表作时，必须把 year 视为风格控制参数，而不是普通元数据。此时更新 quality_meta_year_safe 中的年份，移除冲突的 newest / year 2025。
• 用户指定某画师的代表作、时期作品或 IP 风格时，可把该代表作/IP 作为 series 或 style anchor 使用；先用 danbooru-tags --group series 校验可用 tag，查不到时写入 nltags，不要伪造 Danbooru tag。
• 同一画师在不同年代可能对应不同画风；组 prompt 前要先判断用户要的是“画师整体风格”“某一时期风格”还是“某部代表作风格”。
• 画师融合时优先用 Artist Mixer 的 artist_chain 表达主次和权重，不要再依赖普通 prompt 中的画师顺序。只有用户明确要求强化某个时期、代表作或可见风格锚点时，才在 artist_chain 或代表作/IP 锚点上谨慎加权。
• 画师/代表作/年份三者不能互相冲突。例如用户要求早期风格时，不要同时保留 newest、现代年份和晚期代表作锚点。
• 不确定代表作对应的可用 tag 时，优先保留画师与年份，把代表作描述放入 nltags，不要用错误 tag 污染 hard anchors。