🎨 手办工坊 (Figurine Workshop)
当前版本: 1.3.4
一个基于 Google Gemini 2.5 / 3.0 多模态大模型的 AstrBot 插件。
不仅仅是手办化,现在支持将任意图片一键转换为 手办、Galgame CG、Cosplay 真人 或 双V混合 等多种风格。
✨ 功能特性
- 多风格转换:
- 🧸 手办化:生成放置在包装盒或桌面场景的精美二次元手办图片。
- 🎮 Galgame化:将图片转换为经典的日系视觉小说(Galgame)CG 风格。
- 👗 Cos化:打破次元壁,将二次元图片转换为真人 Cosplay 风格。
- ✌️ 双V模式:独特的 2.5D / Live2D 混合渲染风格。
- 多种输入方式:
- 发送图片同时带上指令。
- 回复一张图片并发送指令。
- 直接
@用户+ 指令,自动获取对方头像进行制作。
- 自定义提示词:支持在指令后追加补充描述(如“手办化 红色头发”),精准控制生成细节。
- 智能处理:
- 自动识别 GIF 动图并提取第一帧处理。
- 高可用性设计,支持配置多个 Key 自动轮询切换。
- 高度定制:所有风格的底层 Prompt 均在配置中开放,可自由调教。
📦 安装与配置
1. 安装
- 下载本插件压缩包并解压。
- 将
astrbot_plugin_figurine_workshop文件夹放入 AstrBot 的data/plugins目录下。 - 重启 AstrBot。
2. 配置
请在 AstrBot 管理面板的 插件管理 -> 手办工坊 中填入必要的配置:
| 配置项 | 类型 | 必填 | 描述 |
|---|---|---|---|
gemini_api_keys |
列表 | 是 | Google Gemini API 密钥。建议填写多个以防并发限制。获取 Key |
gemini_model |
字符串 | 否 | 使用的模型名称,默认为 gemini-2.5-flash-image,也可尝试 gemini-2.0-flash-exp 等。 |
figurine_style |
下拉 | 否 | 仅针对“手办化”指令。可选 deluxe_box (豪华盒装) 或 classic (经典桌面)。 |
save_image |
开关 | 否 | 是否将生成的图片保存到本地硬盘。 |
prompts |
对象 | 否 | 高级配置,可自定义各个模式(galgame, cosplay, double_v 等)的提示词。 |
🕹️ 使用方法
基础指令
支持以下四种核心指令(不区分大小写):
| 指令 | 效果描述 |
|---|---|
手办化 |
将图片变为手办模型(受配置文件中风格选项影响)。 |
!galgame |
(注意带感叹号) 将图片变为 Galgame 游戏 CG 风格。 |
cos化 |
将图片(通常是动漫图)变为真人 Cosplay 风格。 |
双v |
生成双 V (Double V) 风格的图片。 |
触发方式示例
直接发送:
发送图片的同时,文字消息包含指令。[图片] 手办化
回复图片:
长按/右键回复群里的一张图片。!galgame
迫害群友:
直接艾特想转换的人。cos化 @某群友
追加描述(微调):
在指令后面加上额外的描述,模型会参考你的要求。手办化 背景要是粉色的,头发变成金色
🤝 致谢
本插件逻辑重构自 Zhalslar 的 astrbot_plugin_lmarena。
感谢 Gemini 提供的强大视觉模型能力。