saa-agent

saa-agent 是一款通过 WebSocket 连接 Character Select Stand Alone App (SAA) 后端的命令行图像生成工具，支持 ComfyUI 和 WebUI 两种架构，为用户提供程序化控制 AI 绘画的能力。

核心用法：用户通过 CLI 命令调用后端生成图像，基础用法仅需提供 WebSocket 地址、模型名称和提示词即可工作。工具支持区域提示词（Regional Prompting）高级功能，可通过 --regional 参数实现左右分镜构图，满足复杂场景需求。输出支持本地文件保存和 base64 编码 stdout 输出两种方式，便于集成到自动化脚本或第三方工作流中。

显著优点：参数设计兼顾简洁与专业，提供合理的默认值（1024x1360 分辨率、28 步、euler_ancestral 采样器）降低使用门槛，同时支持 CFG、调度器等高级调参。双后端兼容性强，区域提示词功能在同类型工具中较为罕见。Skeleton Key 机制提供应急解锁能力，避免后端死锁导致工作流中断。完善的错误码体系（0-5）和 --verbose 调试模式便于问题排查。

潜在缺点：作为 T3 来源的个人开发者项目，长期维护和功能更新存在一定不确定性。功能强依赖 SAA 后端（需版本 >2.4.0 且启用 SAAC），若后端未启动则完全不可用。后端单线程特性易导致"Backend Busy"错误，且不支持自动重试，需要用户手动等待重试。HiResFix 功能 GPU 资源消耗巨大，误用可能导致系统卡顿或显存溢出。

适合目标群体：主要面向具备技术背景的 AI 绘画用户，特别是需要将图像生成集成到自动化脚本、批处理流水线或 CI/CD 流程的开发者。适合已部署 ComfyUI/WebUI 且希望实现 API 级程序化控制的本地/局域网用户，以及需要区域化构图控制的专业创作者。不适合普通 GUI 用户或无 Python 环境的技术小白。

使用风险：WebSocket 地址若暴露在公网可能存在未授权访问风险，建议在可信内网使用。Skeleton Key 强制解锁功能若滥用可能导致正在进行的生成任务异常终止。HiResFix 参数启用前需确认 GPU 负载能力，避免资源耗尽。依赖项（websockets、aiohttp）虽成熟稳定，但需保持更新以防范潜在安全漏洞。