AI 创意工坊 (Figurine Pro) 功能与使用说明

📖 简介

Figurine Pro 是一个功能强大的 AI 图像生成插件，它集成了 Google 的 gemini-2.5-flash-images-preview 模型，支持多种创意玩法，包括从文本到图像（Text-to-Image）和图像到图像（Image-to-Image）生成。无论你是想制作角色手办、创作极简风格的图像，还是生成专业商品图，Figurine Pro 都能满足你的需求。

该插件提供了丰富的预设指令，同时也允许用户进行高度自定义的图像生成，满足多样化的创意需求。它的设计旨在为用户提供稳定、高效且富有创造力的 AI 作图体验，支持多 API Key 管理、额度轮询、失败自动禁用等功能。

✨ 主要特性

  • 功能多样: 提供超过20种精心调校的预设指令，涵盖人物、物品、场景和设计等多个领域。
  • 双模式生成: 支持图生图（Image-to-Image）和文生图（Text-to-Image）两种生成方式。
  • 智能 Key 管理:
    • 支持添加多个 Google API Key，自动轮询使用。
    • 当单个 Key 连续失败5次后，自动禁用，防止额度浪费。
    • 每日早上8点自动重置所有被禁用的 Key。
  • 用户友好:
    • 设置普通用户冷却时间（默认1分钟），防止滥用。
    • 管理员（主人）无使用限制。
    • 提供详细的帮助菜单。
  • 高度灵活:
    • 支持通过 #bnn 指令进行完全自定义的图文生成。
    • 支持设置反向代理，适应不同的网络环境。

🚀 用户使用指南

🎨 预设指令

👤 人物特效 (需要提供图片)

通过发送图片 + 指令、回复图片 + 指令或**@用户 + 指令**来使用。

  • #手办化 / #手办化2 / #专属手办: 将人物图片生成为写实风格的1/7比例手办模型图。
  • #Q版化: 将角色转换成可爱的二头身Q版粘土人风格。
  • #cos化: 将二次元角色图生成为真人 Cosplay 照片。
  • #各表情头像: 根据角色生成包含喜怒哀乐等多种表情的头像组图。
  • #用嘴P图: 在指令后跟上简单的修图要求（如“把头发染成粉色”），对图片中的人物进行修改。

🖼️ 场景与物品 (大部分需要提供图片)

  • #痛车: 将角色图“痛”在小米 SU7 电动汽车上，生成夜晚街景效果图。
  • #痛屋: 以角色为主题，生成一个布满其周边的“宅男”房间。
  • #二次元蛋蛋的忧伤: 生成一张颇具故事感的图片：前景是美食与显示着角色图片的手机，背景是该角色的Coser与别人亲密。
  • #包包挂件: 将图片中的主体制作成亚克力或橡胶钥匙扣，并挂在LV包上。
  • #模特卖家秀: 将一张图中的模特“穿上”另一张图中的衣服。
  • #AR眼镜: 为场景图中的主要地标添加AR风格的轮廓和信息框。
  • #3D版本Logo: 将Logo图片转换为赛博朋克、蒸汽朋克等5种不同风格的3D版本。
  • #全屋装修效果图: 为一张空房间的图片根据文字描述进行AI装修。
  • #真人快打: （特定用途）根据指令描述合成两张图片中的人物和场景。

✍️ 纯文字作图 (无需图片)

直接发送指令 + 描述文字即可。

  • #写实肖像: 生成一张老年陶艺家的写实风格特写照片。
  • #可爱贴纸: 生成一张可爱风格的小熊猫贴纸。
  • #现代logo: 为咖啡店设计一个现代简约风格的Logo。
  • #专业商品图: 生成一张专业影棚灯光下的咖啡杯商品图。
  • #极简构图: 生成一张极简主义构图的红枫叶图片。
  • #漫画分镜: 生成一格黑色电影风格的漫画分镜。

💬 自定义指令

  • #bnn <你的英文提示词> [图片] 这是自由度最高的指令。你可以用英文描述任何你想要的画面，并选择性地附带图片让AI参考。支持多图。

🛠️ 管理员配置指南 (Master Only)

📁 文件结构

插件的所有数据存储在 data/figurine/ 目录下：

  • config.yaml: 核心配置文件。
  • google_api_keys.json: 存储你的 Google API Key。
  • user_usage.json: 记录普通用户的使用时间。

⚙️ 核心配置 (config.yaml)

初次运行时会自动生成，你可以按需修改：

  • masterQQ: 主人的QQ号，拥有所有管理权限且无使用限制。
  • useLimit: 普通用户的冷却时间，单位为毫秒（例如 60000 代表60秒）。
  • reverseProxyUrl: 反向代理地址。留空则直连官方。
  • useProxy: 是否启用HTTP代理 (true/false)。
  • proxyUrl: HTTP代理地址，例如 http://127.0.0.1:10808。

🔑 API Key 管理

  • 添加 Key: #figurine-addkey <密钥1> <密钥2>...
    • 可以一次添加一个或多个Key，用空格、逗号或换行分隔。
  • 查看 Key 列表: #figurine-keylist
    • 列出所有Key、状态（✅激活 / ❌禁用）、使用次数和连续失败次数。
  • 删除 Key: #figurine-delkey <序号>
    • 根据 #figurine-keylist 中显示的序号删除指定的Key。
  • 手动重置 Key: #figurine-resetkey <序号>
    • 手动将一个被自动禁用的Key重新激活，并清零其失败计数。

🌐 网络设置

  • 设置反向代理: #设置反代 <你的URL>
    • 将API请求地址指向你的反代服务器。例如: #设置反代 https://my.proxy.com
    • 如果要取消反代，恢复直连，执行 #设置反代（后面不跟任何URL）。

📜 运行机制说明

  • Key 轮询: 插件会按顺序使用 google_api_keys.json 中所有状态为 active 的 Key。
  • 自动禁用与恢复:
    • 当一个 Key 调用 API 连续失败达到5次，其状态会被设为 disabled 并暂停使用。
    • 每天早上8点，插件的定时任务会自动将所有 disabled 状态的 Key 重新恢复为 active，使其可以重新被调用。