核心用法
agent-selfie 是一款面向 AI 智能体开发者的头像与视觉身份生成工具，通过调用 Google Gemini 图像生成 API，根据预设或自定义的"人格配置"生成风格化的自画像。支持三种输出格式：avatar（1:1 头像）、banner（16:9 横幅）、full（竖版故事）。
基础工作流：
1. 配置 GEMINI_API_KEY 环境变量
2. 通过 --personality 定义智能体形象（name/style/vibe 三要素）
3. 选择 mood（8 种情绪）和 theme（8 种季节/节日主题）调节氛围
4. 指定 --format 和 --count 批量生成
高级特性：
- 支持 JSON 文件或内联字符串配置人格
- 内置
--moods/--themes枚举查询 - 可接入 crontab 实现自动化风格演进
- 与 AgentGram 社交技能无缝集成
显著优点
| 优势 | 说明 |
|------|------|
| **平台原生适配** | 针对 Discord、Twitter/X、AgentGram 等平台输出对应尺寸，无需二次裁剪 |
| **人格一致性** | 将 `style`（视觉）与 `vibe`（气质）分离建模，便于跨场景保持角色统一性 |
| **轻量易部署** | 纯 Python 脚本，单文件依赖，适合 CI/CD 和边缘部署 |
| **批量与自动化** | 支持 `--count` 批量生成和 crontab 定时任务，满足动态头像需求 |
局限性与风险
功能性限制：
- 严格依赖 Gemini API，无本地生成能力，网络中断即不可用
- 输出质量受限于 Gemini 图像生成模型的提示词理解能力，复杂风格可能"跑偏"
- 缺乏后期编辑（修图、重绘局部）功能，生成即终稿
成本与速率：
- Gemini 图像生成按张计费，高频自动化任务可能产生意外费用
- HTTP 429/5xx 错误提示需人工重试，无内置指数退避机制
合规隐患：
- 生成的虚拟形象若用于商业场景，需注意 Gemini 使用条款对"合成媒体"的限制
- 人格配置中的
style描述若涉及受版权保护的角色风格，存在潜在侵权风险
适合人群
- AI 智能体开发者（Discord/Twitter/X 机器人、AgentGram 用户）
- 需要快速建立视觉品牌但无设计资源的独立开发者
- 追求"动态人设"、希望头像随季节/情绪自动变化的内容运营者
- 原型验证阶段需批量生成候选形象的初创团队
常规风险等级：中等
主要风险集中于 API 依赖导致的可用性问题、生成内容的版权边界模糊，以及环境变量管理不善导致的密钥泄露。建议生产环境配合密钥管理服务使用。