FAQ

常见问题 (FAQ)

安装问题

Q: ComfyUI 启动后没有看到路由注册日志？

A: 检查以下几点：

1. 确认 ComfyUI-AnimaTool 目录在 custom_nodes/ 下
2. 查看 ComfyUI 启动日志是否有导入错误
3. 确认依赖已安装：pip install -r requirements.txt

Q: 模型文件放在哪里？

A:

文件	路径
anima-preview.safetensors	ComfyUI/models/diffusion_models/
qwen_3_06b_base.safetensors	ComfyUI/models/text_encoders/
qwen_image_vae.safetensors	ComfyUI/models/vae/

Q: 显存不够怎么办？

A: Anima 模型需要约 6-8GB 显存。可以尝试：

1. 使用更小的分辨率
2. 关闭其他占用显存的程序
3. 使用 --lowvram 参数启动 ComfyUI

---

MCP Server 问题

Q: Cursor 显示 "Connection closed"？

A:

1. 确认 mcp 库已安装到正确的 Python 环境
2. 检查 .cursor/mcp.json 中的路径是否正确
3. Windows 路径使用 \\ 或 /

Q: MCP Server 状态一直是 "Starting"？

A:

1. 检查 Python 路径是否正确
2. 点击 "Show Output" 查看错误日志
3. 手动运行 python mcp_server.py 测试

Q: 图片没有显示在聊天窗口？

A:

1. 确认 MCP Server 状态为 "Running"
2. 确认 ComfyUI 正在运行
3. 检查 ComfyUI 控制台是否有错误

---

生成问题

Q: 报错 "should be divisible by spatial_patch_size"？

A:

分辨率不是 16 的倍数。Anima 基于 Cosmos 架构，要求分辨率必须是 16 的倍数。

解决方法：

• 使用预设的 aspect_ratio（系统会自动计算正确分辨率）
• 如果手动指定 width/height，确保是 16 的倍数（如 512、768、1024、1152）

安全分辨率：512, 640, 768, 896, 1024, 1152, 1280

Q: 生成失败，提示 "timeout"？

A:

1. 确认 ComfyUI 正在运行（http://127.0.0.1:8188）
2. 检查 ComfyUI 控制台的错误信息
3. 可能是显存不足导致的
4. 可通过 ANIMATOOL_TIMEOUT 环境变量增加超时时间

Q: 画师风格没有效果？

A:

画师名必须带 @ 前缀：

• ✅ @fkey, @jima
• ❌ fkey, jima

Q: 生成的图片质量不好？

A:

1. 使用推荐的质量标签：masterpiece, best quality, highres, newest, year 2024
2. 负面词要详细：worst quality, low quality, blurry, bad anatomy, bad hands...
3. 使用推荐的画师组合：@fkey, @jima

Q: 手脚经常崩坏？

A:

负面词加入：

bad hands, extra fingers, missing fingers, bad feet, extra limbs, bad anatomy

Q: 如何固定种子复现结果？

A:

在参数中指定 seed：

{
  "seed": 12345,
  ...
}

---

API 问题

Q: HTTP API 调用卡住不返回？

A:

确保使用最新版本。旧版本可能存在事件循环阻塞问题。

Q: 如何修改 ComfyUI 地址？

A:

通过环境变量配置（推荐）：

// .cursor/mcp.json
{
  "mcpServers": {
    "anima-tool": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "COMFYUI_URL": "http://192.168.1.100:8188"
      }
    }
  }
}

或在命令行设置：

# Linux/macOS
export COMFYUI_URL=http://192.168.1.100:8188

# Windows PowerShell
$env:COMFYUI_URL = "http://192.168.1.100:8188"

Q: 如何禁用图片本地保存？

A:

通过环境变量：

"env": {
  "ANIMATOOL_DOWNLOAD_IMAGES": "false"
}

Q: 远程/Docker 的 ComfyUI 怎么连接？

A:

局域网其他电脑：

"env": { "COMFYUI_URL": "http://192.168.1.100:8188" }

Docker 容器访问宿主机：

"env": { "COMFYUI_URL": "http://host.docker.internal:8188" }

Q: 如何启用模型预检查？

A:

设置 COMFYUI_MODELS_DIR 环境变量：

"env": {
  "COMFYUI_MODELS_DIR": "C:\\ComfyUI\\models"
}

生成前会自动检查模型文件是否存在，缺少时给出友好提示。

Q: 支持哪些环境变量？

A:

环境变量	默认值	说明
COMFYUI_URL	http://127.0.0.1:8188	ComfyUI 服务地址
COMFYUI_MODELS_DIR	(未设置)	models 目录，用于预检查
ANIMATOOL_TIMEOUT	600	生成超时（秒）
ANIMATOOL_DOWNLOAD_IMAGES	true	是否保存图片到本地
ANIMATOOL_UNET_NAME	anima-preview.safetensors	UNET 文件名
ANIMATOOL_CLIP_NAME	qwen_3_06b_base.safetensors	CLIP 文件名
ANIMATOOL_VAE_NAME	qwen_image_vae.safetensors	VAE 文件名

---

其他问题

Q: 支持哪些采样器？

A:

ComfyUI 支持的所有采样器都可以使用。推荐：

• er_sde（默认，效果稳定）
• euler_ancestral
• dpmpp_2m_sde

Q: 支持批量生成吗？

A:

目前每次调用生成 1 张图片。如需批量生成，可以多次调用或修改工作流模板。

Q: 可以自定义工作流吗？

A:

可以修改 executor/workflow_template.json，但需要保持输入输出接口兼容。

---

还有问题？

请在 GitHub Issues 提交问题。