Moeblack Comfyui Animatool .

# Anima 二次元图像生成

使用 Anima 模型（circlestone-labs/Anima）在本地 ComfyUI 生成高质量二次元/插画图片。

## 触发条件

- 用户要求生成二次元/动漫/插画风格图片
- 用户提到 Anima 模型
- 用户要求使用特定画师风格（如 @fkey, @jima, @wlop）

## 使用方法

**直接调用 MCP 工具** `generate_anima_image`，传入结构化参数。

## 硬性规则

1. **画师必须带 `@` 前缀**（如 `@fkey, @jima`），否则几乎无效
2. **必须明确安全标签**：`safe` / `sensitive` / `nsfw` / `explicit`
3. **推荐画师组合**：`@fkey, @jima`（效果稳定）
4. **标签顺序**：质量 → 人数 → 角色 → 作品 → 画师 → 风格 → 外观 → 标签 → 环境
5. **画师名能用时，`style` 留空**：`style` 只在需要锁品类/媒介时才写（如 `splash art` / `watercolor`）
6. **不要写互斥风格词**：`tags`/`environment` 里不要塞 `chibi` / `lineart` / `flat shading` 这类会抢画师风格的词

## 画师名格式规则

- 必须以 `@` 开头：`@fkey`，而非 `fkey`
- 名字中间**无下划线**：`@kawakami rokkaku`，而非 `@kawakami_rokkaku`
- 多画师用逗号分隔：`@fkey, @jima`（但稳定性下降，建议最多 1-2 位）
- 如果画师名本身含括号（如 `yd (orange maru)`），需要转义：`@yd \(orange maru\)`，避免被解析器误认为附加信息

## LoRA 使用规则

- `loras` 参数接受数组，每项包含 `name`（文件名）和 `weight`（权重，默认 1.0）
- LoRA 仅作用于 UNET（不影响 CLIP），在 UNETLoader → KSampler 之间链式注入
- **`name` 必须与 `list_anima_models(model_type=loras)` 返回值逐字一致**（ComfyUI 会做枚举校验）
- `list_anima_models(model_type=loras)` 仅返回存在同名 `.json` sidecar 元数据文件的 LoRA
- Windows 下路径通常含反斜杠（如 `_Anima\xxx.safetensors`），本工具会自动规范化分隔符
- 远程 ComfyUI 场景下 list 功能不可用（无法读取远程文件系统），但可直接传 `loras` 参数使用

## Reroll / 历史记录

- 每次生成后会自动记录参数到历史（最近 50 条，重启保留）
- 响应末尾会附带历史 ID 提示，如：`已保存为历史记录 #12`
- `reroll_anima_image(source="last")` — 用相同参数重新生成（seed 自动随机）
- `reroll_anima_image(source="12", artist="@ciloranko")` — 基于 #12 换画师
- `reroll_anima_image(source="last", repeat=3)` — 再来 3 张
- `list_anima_history(limit=10)` — 查看最近 10 条生成记录

## 批量生成

- `repeat`：提交 N 次独立任务（queue 模式，每次随机 seed），显存友好，**推荐方式**
- `batch_size`：单次任务内 latent batch，速度快但吃显存
- 总张数 = repeat × batch_size

## 模型切换（高级）

- `unet_name`、`clip_name`、`vae_name` 可选参数覆盖默认的 Anima 模型
- 使用 `list_anima_models(model_type=diffusion_models/text_encoders/vae)` 查询可用模型
- 不指定时使用环境变量配置或 Anima 默认模型

## 必填参数

| 参数 | 说明 | 示例 |
|------|------|------|
| `quality_meta_year_safe` | 质量/年份/安全 | `"masterpiece, best quality, newest, year 2024, safe"` |
| `count` | 人数 | `"1girl"`, `"2girls"`, `"1boy"` |
| `artist` | 画师（带@） | `"@fkey, @jima"` |
| `tags` | 核心标签 | `"upper body, smile, white dress"` |
| `neg` | 负面提示词 | `"worst quality, low quality, blurry, text, watermark, signature, username, nsfw"` |

## 常用可选参数

| 参数 | 说明 | 示例 |
|------|------|------|
| `aspect_ratio` | 长宽比 | `"16:9"`, `"9:16"`, `"3:4"`, `"1:1"` |
| `character` | 角色名 | `"hatsune miku"` |
| `series` | 作品名 | `"vocaloid"` |
| `appearance` | 外观 | `"long hair, blue eyes"` |
| `style` | 画风（默认留空，只有需要锁定品类时才填） | `"splash art"`, `"watercolor"` |
| `environment` | 环境/光影 | `"sunset, backlight"` |
| `steps` | 步数 | `25`（默认） |
| `seed` | 种子 | 不填则随机 |

## 长宽比选项

```
横屏: 21:9, 2:1, 16:9, 16:10, 5:3, 3:2, 4:3
方形: 1:1
竖屏: 3:4, 2:3, 3:5, 10:16, 9:16, 1:2, 9:21
```

## 调用示例

用户："画一个穿白裙的少女在花园里，竖屏"

```json
{
  "aspect_ratio": "3:4",
  "quality_meta_year_safe": "masterpiece, best quality, newest, year 2024, safe",
  "count": "1girl",
  "artist": "@fkey, @jima",
  "tags": "upper body, smile, white dress, garden, flowers, sunlight",
  "environment": "outdoor, natural lighting, bokeh",
  "neg": "worst quality, low quality, blurry, bad hands, bad anatomy, extra fingers, missing fingers, text, watermark, signature, username, artist name, nsfw, explicit"
}
```

## 提示词技巧

- **自然语言最多一句**：用 `nltags` 字段，太长会注意力跑掉
- **构图优先**：1MP 分辨率下确保主体占画面比例足够大
- **手脚易崩**：负面词加 `bad hands, extra fingers, missing fingers, bad feet`
- **兽耳娘防变异**：负面加 `anthro`
- **反咒量大管饱**：负面词要细分，不要只写 `bad anatomy`
- **画师名能用时，`style` 留空**
- **`style` 只在需要锁品类/媒介时才写**（如 `league of legends splash art` / `watercolor` / `pixel art`）
- **不要同时写互斥的风格词**（如 `storybook illustration` 和 `splash art` 不能同时出现）
- **`tags`/`environment` 里不要塞会改变整体风格的词**（如 `chibi` / `lineart` / `flat shading`），除非你就是要那个效果

## 前置条件

- ComfyUI 需要运行在 `http://127.0.0.1:8188`
- Anima 模型文件需要已放置：
  - `anima-preview.safetensors`
  - `qwen_3_06b_base.safetensors`
  - `qwen_image_vae.safetensors`