核心用法
agent-selfie 是一款专为 AI 代理设计的自画像生成工具，通过调用 Google Gemini 图像生成 API，根据用户定义的人格配置（personality）、情绪状态（mood）和主题风格（theme）自动生成头像、横幅或完整竖版图片。用户可通过命令行指定 JSON 格式的人格描述（包含名称、视觉风格、性格氛围），或选择预设的 8 种情绪（如 professional、creative、chill）和 8 种季节/节日主题（如 spring、halloween、christmas）。输出支持三种格式：1:1 头像、16:9 横幅和 9:16 竖版，并可批量生成带 HTML 画廊的展示页面。
显著优点
极简依赖：纯 Python 3 标准库实现，零第三方包依赖，部署轻量且维护成本低。高度可定制：人格配置系统允许精细控制视觉特征与性格表达，支持从动漫风格到写实机器人的广泛创作空间。平台适配性强：针对 Discord、Twitter/X、AgentGram 等主流平台提供格式与使用建议，开箱即用。自动化友好：内置 Cron 集成示例，支持定时自动生成代理形象更新。生态联动：与 AgentGram 社交技能、gemini-image-gen 通用图像生成技能形成互补，构建完整的 AI 代理视觉工作流。
潜在缺点与局限性
单一供应商锁定：完全依赖 Google Gemini API，若服务中断、政策变更或区域限制将直接影响可用性。无本地模型选项：必须联网并消耗 API 配额，无法离线运行或控制推理成本。提示词透明度有限：用户输入的 style/vibe 描述直接透传至 API，缺乏本地预处理或安全过滤，存在提示词注入风险。输出可控性一般：图像生成结果受模型随机性影响，复杂描述可能出现风格偏离，需多次尝试。功能边界清晰但狭窄：专注"自画像"场景，不支持通用图像编辑、风格迁移或已有图像的迭代优化。
适合的目标群体
- AI 代理开发者：需要为聊天机器人、虚拟助手快速建立视觉身份的独立开发者或小团队
- 社交媒体运营者：管理 AI 人格账号（如 Twitter/X 上的 AI 角色），需要定期更新头像/横幅内容
- 创意实验者：探索 AI 代理人格化表达、构建虚拟角色 IP 的内容创作者
- 教育/演示场景：教学演示中需要可视化展示 AI 代理"形象"的讲师或学生
使用风险
API 密钥管理：GEMINI_API_KEY 泄露可能导致配额被盗用，建议配合密钥轮换与最小权限原则。网络稳定性：生成过程依赖 Google 服务可用性，高并发或批量任务需考虑重试与退避策略。内容合规：生成内容受 Gemini API 使用政策约束，特定风格描述可能触发安全过滤导致生成失败。存储管理：批量生成模式下 PNG 与 HTML 文件持续累积，需定期清理输出目录避免磁盘空间耗尽。