GNano Ihogmn 图片生成技能 V1
GNano Ihogmn 图片生成技能 - 第一版。支持动态 API 配置，根据用户提供的 Token 自动获取可用功能和参数。
快速开始
1. 安装依赖
pip install requests
2. 验证安装
python scripts/get_config.py --token "YOUR_API_TOKEN"
核心特性
- 动态配置: 不内嵌 API Token，每个新任务需要用户提供
- 自动探测: 根据 Token 获取该账户支持的模型、分辨率、参考图限制等
- 任务记忆: 在同一任务会话内记住配置，后续对话快速出图
- 模型支持: 自动适配 gemini-3-pro-image-preview 和 gemini-3.1-flash-image-preview
- 路径处理: 支持相对路径和绝对路径，自动转换
使用流程
1. 新建任务（首次对话）
用户首次使用或明确说"新建任务"时：
步骤 1: 请求 API Token
"请提供您的 GNano API Token，我将根据您的账户配置获取可用功能。"
"如果您没有 Token，请访问 https://gnano.ihogmn.top 获取。"
步骤 2: 验证并获取配置
python scripts/get_config.py --token "用户提供的TOKEN"
返回配置示例：
{
"success": true,
"api_token": "xxx",
"api_url": "https://gnano.ihogmn.top",
"models": ["gemini-3.1-flash-image-preview", "gemini-3-pro-image-preview"],
"default_model": "gemini-3.1-flash-image-preview",
"resolutions": ["1K", "2K", "4K"],
"default_resolution": "2K",
"max_reference_images": 2,
"max_reference_size_mb": 2,
"rate_limit_per_minute": 2
}
步骤 3: 向用户展示配置
"✅ 配置成功！您的账户支持以下功能：
- 可用模型: gemini-3.1-flash-image-preview, gemini-3-pro-image-preview
- 默认模型: gemini-3.1-flash-image-preview
- 支持分辨率: 1K, 2K, 4K
- 参考图限制: 最多2张，每张≤2MB
- 速率限制: 每分钟2张
现在可以直接告诉我您想生成什么图片了！"
2. 常规出图对话
在同一任务内，用户直接说：
执行命令：
python scripts/generate_image.py \
--token "YOUR_TOKEN" \
--prompt "一只可爱的猫咪" \
--model "gemini-3.1-flash-image-preview" \
--resolution "2K" \
--output "result.png"
使用参考图（图生图）
使用方法：
-
将参考图放到工作区目录
-
使用参考图生成
python scripts/generate_image.py \
--token "YOUR_TOKEN" \
--prompt "将图中人物外套脱掉" \
--reference "woman.jpg" \
--output "result.png"
注意：
- 参考图必须已保存到工作区目录
- 支持最多 2 张参考图，每张不超过 2MB
- 支持格式：PNG, JPG, JPEG, WEBP, GIF
- 支持相对路径和绝对路径
3. 切换任务/重置配置
用户说：
清除当前保存的配置，然后返回步骤 1，重新请求 API Token。
脚本说明
get_config.py - 获取配置
验证 API Token 并获取账户能力配置。
# 基本用法
python scripts/get_config.py --token "YOUR_API_TOKEN"
# 指定自定义 API 地址
python scripts/get_config.py --token "YOUR_API_TOKEN" --api-url "https://custom.api.com"
# 保存配置到文件
python scripts/get_config.py --token "YOUR_API_TOKEN" --output "config.json"
返回字段：
success: 是否成功api_token: API Tokenapi_url: API 地址models: 可用模型列表default_model: 默认模型resolutions: 支持的分辨率default_resolution: 默认分辨率max_reference_images: 最大参考图数量max_reference_size_mb: 参考图大小限制(MB)rate_limit_per_minute: 每分钟出图限制error: 错误信息（如有）warning: 警告信息（如有）
generate_image.py - 生成图片
根据配置生成图片。
# 基本用法
python scripts/generate_image.py --token "TOKEN" --prompt "提示词"
# 完整参数
python scripts/generate_image.py \
--token "TOKEN" \
--prompt "一只可爱的猫咪" \
--api-url "https://gnano.ihogmn.top" \
--model "gemini-3.1-flash-image-preview" \
--available-models "gemini-3.1-flash-image-preview,gemini-2.5-flash-image" \
--resolution "2K" \
--reference "ref1.png,ref2.png" \
--output "output.png" \
--max-ref 2 \
--max-ref-size 2
参数说明：
--token, -t: API Token（必需）--prompt, -p: 提示词（必需）--api-url, -u: API 地址--model, -m: 模型名称（优先使用）--available-models: 可用模型列表（逗号分隔，用于自动选择最佳模型）--resolution, -r: 分辨率 (1K, 2K, 4K)--reference, -ref: 参考图路径，多个用逗号分隔--output, -o: 输出图片路径--max-ref: 最大参考图数量--max-ref-size: 参考图大小限制(MB)--verbose, -v: 输出详细日志
返回字段：
success: 是否成功output_path: 输出图片路径model: 使用的模型mime_type: 图片 MIME 类型file_size: 文件大小（字节）file_size_mb: 文件大小（MB）references_used: 使用的参考图数量elapsed_time: 生成耗时（秒）error: 错误信息（如有）details: 详细错误信息（如有）
进度输出（stderr）：
脚本会输出 JSON 格式的进度信息到 stderr：
{"type": "progress", "message": "使用模型: gemini-3.1-flash-image-preview", "step": 1, "total": 5}
{"type": "progress", "message": "正在生成图片，请稍候...", "step": 4, "total": 5}
任务状态管理
任务状态可以保存在工作区的 .workbuddy/gnano-tasks/ 目录下：
WORKSPACE/
└── .workbuddy/
└── gnano-tasks/
├── {conversation_id}.json # 当前对话的任务状态
└── {other_conv_id}.json # 其他对话的任务状态
任务状态文件格式：
{
"api_token": "your-token",
"api_url": "https://gnano.ihogmn.top",
"models": ["gemini-3.1-flash-image-preview"],
"default_model": "gemini-3.1-flash-image-preview",
"resolutions": ["1K", "2K", "4K"],
"default_resolution": "2K",
"max_reference_images": 2,
"max_reference_size_mb": 2,
"rate_limit_per_minute": 2,
"supports_text_to_image": true,
"supports_image_editing": true,
"created_at": "2026-03-23T08:00:00",
"updated_at": "2026-03-23T08:00:00",
"last_accessed_at": "2026-03-23T08:00:00"
}
任务状态的读取和写入由 WorkBuddy 自动处理，无需额外脚本。
完整对话示例
示例 1: 新建任务并出图
用户: "我想用 GNano 出图"
助手:
"请提供您的 GNano API Token，我将根据您的账户配置获取可用功能。
如果您没有 Token，请访问 https://gnano.ihogmn.top 获取。"
用户: "我的 Token 是 abc123"
助手:
python scripts/get_config.py --token "abc123"
"✅ 配置成功！您的账户支持以下功能：
- 可用模型: gemini-3.1-flash-image-preview
- 默认模型: gemini-3.1-flash-image-preview
- 支持分辨率: 1K, 2K, 4K
- 参考图限制: 最多2张，每张≤2MB
- 速率限制: 每分钟2张
现在可以直接告诉我您想生成什么图片了！"
用户: "出图：一只可爱的猫咪在草地上玩耍"
助手:
python scripts/generate_image.py --token "abc123" --prompt "一只可爱的猫咪在草地上玩耍" --model "gemini-3.1-flash-image-preview" --resolution "2K" --output "generated_cat.png"
[显示生成的图片]
示例 2: 使用参考图
用户: "参考图：woman.jpg，提示词：将外套脱掉"
助手:
python scripts/generate_image.py --token "abc123" --prompt "将外套脱掉" --reference "woman.jpg" --model "gemini-3.1-flash-image-preview" --resolution "2K" --output "result.png"
[显示生成的图片]
示例 3: 切换 Token
用户: "我想换一个 Token"
助手:
"已清除当前配置。请提供新的 GNano API Token："
依赖要求
必需依赖
- Python: >= 3.8
- requests: >= 2.31.0 (用于 HTTP 请求)
安装方法
pip install requests
安装 troubleshooting
问题：requests 模块找不到
解决: 安装依赖
pip install requests
问题：Python 版本过低
解决: 升级 Python 到 3.8 或更高版本
# 检查版本
python --version
注意事项
- 所有回复使用中文
- 首次对话必须请求 API Token，不能跳过
- 同一任务内记住配置，后续对话快速出图，无需重复输入 Token
- Token 仅保存在本地任务状态，不对外传输
- 支持相对路径和绝对路径，自动转换
- 严格遵守速率限制，每分钟最多2张
- 参考图限制：最多2张，每张不超过2MB
- 如果 Token 失效，提示用户重新提供
错误处理
Token 无效
"❌ API Token 无效或已过期。请检查您的 Token 是否正确，或重新获取一个新的 Token。"
请求过于频繁
"⚠️ 请求过于频繁，请稍后再试。您的账户限制为每分钟2张图片。"
参考图过大
"⚠️ 参考图超过大小限制（2MB）。请压缩图片后重试。"
网络错误
"❌ 无法连接到 API 服务器。请检查网络连接后重试。"
