{
    "name": "image-generator",
    "version": "1.0.0",
    "description": "通用图片生成 Skill，支持多种 AI 模型（ModelScope、Gemini、RunningHub 等），可被其他 Skills 调用",
    "system_prompt": "name image-generator description 通用图片生成 Skill，支持多种 AI 模型（ModelScope、Gemini、RunningHub 等），可被其他 Skills 调用 version 1.2.0 author M. 图片生成 Skill 通用的图片生成服务，支持多种 AI 模型，可被其他 Skills 直接调用。 功能特性 🎨 支持多种 AI 模型（ModelScope、Gemini、RunningHub 等） 📦 可作为库被其他 Skills 导入调用 ⚙️ 灵活的配置系统 🔄 异步任务支持（ModelScope、RunningHub） 💾 自动保存生成的图片 🛡️ 错误处理和重试机制 🧪 测试模式支持（无需 API Key） 使用方式 方式 1：直接命令行调用 # 基本用法（默认使用 gemini） python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" # 指定 API 类型 python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" --api-type modelscope # RunningHub 文生图 python3 ~/.claude/skills/image-generator/generate_image.py \\ \"一只金色的猫在阳光下打盹\" \\ --api-type runninghub # 指定输出路径 python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" --output /path/to/image.jpg # 参考图编辑/身份保持（Gemini 图片模型） python3 ~/.claude/skills/image-generator/generate_image.py \\ \"保留人物身份，改为正面摄影棚头肩照\" \\ --reference-image /path/to/person.png \\ --size 1024x1280 \\ --output /path/to/portrait.png # 指定模型 python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" --model \"Tongyi-MAI/Z-Image-Turbo\" # 测试模式（无需 API Key） python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" -- test 方式 2：在其他 Skills 中导入调用 import sys from pathlib import Path # 添加 image-generator skill 到路径 image_gen_path = Path.home() / \".claude/skills/image-generator\" sys.path.insert( 0 , str (image_gen_path)) from generate_image import ImageGenerator # 创建生成器实例（不传 api_type 时从 config.json 的 default_api 读取） generator = ImageGenerator() # 生成图片 image_path = generator.generate( prompt= \"A beautiful landscape\" , output_path= \"/path/to/output.jpg\" ) print ( f\"图片已生成: {image_path} \" ) # RunningHub 文生图示例 from generate_image import ImageGenerator generator = ImageGenerator(api_type= \"runninghub\" ) image_path = generator.generate( prompt= \"一只金色的猫在阳光下打盹\" , output_path= \"/path/to/output.jpg\" ) 配置 首次使用配置 复制配置模板文件： cp ~/.claude/skills/image-generator/config.json.example ~/.claude/skills/image-generator/config.json 编辑配置文件填入你的 API Key： 配置文件位于： ~/.claude/skills/image-generator/config.json { \"default_api\" : \"runninghub\" , \"modelscope\" : { \"base_url\" : \"https://api-inference.modelscope.cn/\" , \"api_key\" : \"your-modelscope-token-here\" , \"model\" : \"Tongyi-MAI/Z-Image-Turbo\" , \"timeout\" : 300 , \"poll_interval\" : 5 } , \"gemini\" : { \"api_key\" : \"your-gemini-api-key-here\" , \"model\" : \"gemini-3-pro-image-preview\" , \"api_url\" : \"https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent\" , \"timeout\" : 120 , \"size\" : \"1024x1024\" , \"quality\" : \"standard\" } , \"runninghub\" : { \"base_url\" : \"https://www.runninghub.cn/openapi/v2\" , \"api_key\" : \"your-runninghub-api-key-here\" , \"model\" : \"rhart-image-n-g31-flash/text-to-image\" , \"timeout\" : 300 , \"poll_interval\" : 5 , \"resolution\" : \"2k\" } , \"output_dir\" : \"~/Downloads/shell/work/generated_images\" , \"image_format\" : \"jpg\" , \"quality\" : 95 } 配置参数说明 通用配置 ： default_api : 默认使用的 API（ modelscope 、 gemini 或 runninghub ） output_dir : 图片输出目录 image_format : 图片格式（ jpg 、 png 、 webp ） quality : 图片质量（1-100） ModelScope 配置 ： base_url : ModelScope API 地址 api_key : ModelScope API Token（从 https://modelscope.cn 获取） model : 使用的模型名称 timeout : 请求超时时间（秒） poll_interval : 轮询间隔（秒） Gemini 配置 ： api_key : Google Gemini API Key（从 https://ai.google.dev 获取） model : 使用的模型名称（如 gemini-3-pro-image-preview ） api_url : API 端点地址 timeout : 请求超时时间（秒） size : 图片尺寸（如 1024x1024 ） quality : 生成质量（ standard 或 high ） RunningHub 配置 ： base_url : RunningHub OpenAPI 地址 api_key : RunningHub API Key model : 使用的模型路径（如 rhart-image-n-g31-flash/text-to-image ） timeout : 请求超时时间（秒） poll_interval : 轮询间隔（秒） resolution : 默认分辨率（如 2k ） 注意 ： config.json 包含敏感的 API Key，已被 .gitignore 忽略 不要将包含真实 API Key 的配置文件提交到版本库 使用 config.json.example 作为模板参考 支持的模型 ModelScope Tongyi-MAI/Z-Image-Turbo - 高速图片生成 damo/text-to-image-synthesis - 文本到图片 其他 ModelScope 支持的模型 Gemini gemini-3-pro-image-preview - Gemini 3 Pro 图片生成 其他 Gemini 支持的模型 RunningHub rhart-image-n-g31-flash/text-to-image - 文生图（2K 分辨率） 其他 RunningHub OpenAPI 兼容模型 API 参数 generate() 方法 generator.generate( prompt: str , # 图片描述（必需） output_path: str = None , # 输出路径（可选） model: str = None , # 指定模型（可选） size: str = \"1024x1024\" , # 图片尺寸 quality: str = \"standard\" , # 生成质量 style: str = None , # 风格（可选） timeout: int = 300 , # 超时时间（秒） max_retries: int = 3 , # 最大重试次数 test_mode: bool = False , # 测试模式 reference_images: list [ str ] = None # Gemini 参考图片，可传多张 ) -> str # 返回图片路径 错误处理 自动重试失败的请求（最多 3 次） 详细的错误日志 优雅的降级处理 测试模式 支持测试模式，无需配置 API Key 即可快速测试图片生成流程： # 命令行使用测试模式 python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" -- test # Python 代码中使用测试模式 generator = ImageGenerator(api_type= \"gemini\" ) image_path = generator.generate( prompt= \"A beautiful landscape\" , test_mode= True # 启用测试模式 ) 测试模式会生成一张包含提示词内容的示例图片，适合在开发调试或无网络环境时使用。 示例 示例 1：基本使用 python3 ~/.claude/skills/image-generator/generate_image.py \"A futuristic city\" 示例 2：测试模式（无需 API Key） python3 ~/.claude/skills/image-generator/generate_image.py \"A golden cat\" -- test 示例 3：在 Python 中使用 from generate_image import ImageGenerator gen = ImageGenerator() image = gen.generate( \"A beautiful sunset over the ocean\" ) print ( f\"Generated: {image} \" ) 示例 4：在其他 Skill 中集成 # 在 write-article skill 中 from pathlib import Path import sys sys.path.insert( 0 , str (Path.home() / \".claude/skills/image-generator\" )) from generate_image import ImageGenerator def generate_article_cover ( title ): gen = ImageGenerator() cover_image = gen.generate( prompt= f\"Professional article cover for: {title} \" , output_path= f\"./covers/ {title} .jpg\" ) return cover_image 注意事项 API Key 配置 ： 需要在 config.json 中配置相应的 API Key 不要将 API Key 提交到版本控制 网络要求 ： 需要稳定的网络连接 某些 API 可能需要科学上网 生成时间 ： ModelScope 通常需要 10-30 秒 Gemini 通常需要 5-15 秒 RunningHub 通常需要 15-30 秒 成本考虑 ： 某些 API 可能产生费用 建议监控 API 使用情况 输出格式 ： 支持 JPG、PNG、WebP 等格式 默认输出为 JPG 格式 故障排除 问题 1：API Key 无效 错误: Unauthorized 解决: 检查 config.json 中的 API Key 是否正确 问题 2：生成超时 错误: Timeout 解决: 增加 config.json 中的 timeout 值 问题 3：网络连接失败 错误: Connection Error 解决: 检查网络连接，某些 API 可能需要科学上网 依赖 requests Pillow (PIL) 其他 Skills 可选依赖 许可证 MIT",
    "model_config": {
        "provider": "deepseek",
        "model": "deepseek-chat",
        "temperature": 0.7,
        "max_tokens": 4096,
        "top_p": 0.9
    },
    "trigger_words": [],
    "source": "DeepseekModel",
    "source_url": "https://deepseekmodel.com/skill?id=wlzh-skills-image-generator-skill-md"
}