RongheDraw 多模式绘图插件
支持 Flow/Generic/Gemini 三种 API 模式的 AstrBot 绘图插件
作者: Antigravity | 版本: 1.2.0
✨ 功能特点
- 🔀 三种 API 模式：Flow / Generic / Gemini (4K)
- 🎨 文生图 & 图生图：支持多图输入
- 📐 智能模型选择：Flow模式根据图片比例自动选择横版/竖版模型
- 🌐 翻译功能：Flow 模式支持中英翻译
- 👥 权限管理：白名单用户/群聊分级权限
- ⏳ 并发控制：每模式同时只允许1个非白名单用户生成
- 🎲 预设效果：9个内置预设 + 自定义预设
- 🤖 LLM 工具：让 AI 调用绘图功能
- 📦 图片压缩：自动压缩大图避免 API 错误
- 🔒 隐私保护：自动过滤@用户的昵称和QQ号
🚀 快速开始
安装
- 将
astrbot_plugin_ronghedraw文件夹放入 AstrBot 的plugins目录 - 安装依赖：
pip install -r requirements.txt
💡 插件启动时会自动检测依赖，缺少时会输出提醒
配置
在 AstrBot 管理面板中配置：
- Flow 模式：
flow_api_url、flow_api_key、flow_default_model - Generic 模式：
generic_api_url、generic_api_keys - Gemini 模式：
gemini_api_url、gemini_api_keys、gemini_resolution(默认4K)
📝 命令列表
文生图
| 命令 | 说明 |
|---|---|
#f文 <描述> |
Flow 模式文生图（自动横竖版） |
#o文 <描述> |
Generic 模式文生图 |
#g文 <描述> |
Gemini 模式文生图 (4K) |
#文生图 <描述> |
默认模式 |
图生图
| 命令 | 说明 |
|---|---|
#f图 [图片] |
Flow 模式（自动横竖版） |
#o图 [图片] |
Generic 模式 |
#g图 [图片] |
Gemini 模式 (4K) |
#图生图 [图片] |
默认模式 |
随机预设
| 命令 | 说明 |
|---|---|
#f随机 [图片] |
Flow 模式随机 |
#o随机 [图片] |
Generic 模式随机 |
#g随机 [图片] |
Gemini 模式随机 |
#随机 [图片] |
默认模式随机 |
注：随机预设使用配置中的
prompt_list自定义预设
管理
| 命令 | 说明 |
|---|---|
#查询次数 |
查询今日剩余 |
#预设列表 |
查看自定义预设 |
#生图菜单 |
显示完整菜单 |
#生图帮助 |
显示帮助 |
#f切换模型 |
切换 Flow 模型 |
#f翻译开关 |
翻译功能开关 |
👥 权限系统
| 用户类型 | 可用模式 | 次数限制 | 并发限制 |
|---|---|---|---|
| 白名单用户 | 全部 (f/o/g) | ❌ 无限制 | ❌ 无限制 |
| 白名单群聊 | 全部 (f/o/g) | ✅ 有限制 | ✅ 有限制 |
| 普通用户 | 仅 f 模式 | ✅ 有限制 | ✅ 每模式1个 |
⚙️ 配置说明
Flow 模式配置
flow_api_url: API 地址（OpenAI 格式）flow_api_key: API 密钥flow_default_model: 默认模型（横版，自动切换竖版）flow_model_list: 可切换的模型列表flow_enable_translate: 启用翻译flow_use_proxy: 启用代理
Generic 模式配置
generic_api_url: API 地址generic_api_key: API 密钥generic_default_model: 默认模型generic_api_format: API 格式 (openai/gemini)，默认为openai。使用 Gemini 模型时建议设为geminigeneric_resolution: 分辨率 (1K/2K/4K)generic_aspect_ratio: 默认纵横比generic_use_proxy: 启用代理
Gemini 模式配置
gemini_api_url: Google API 地址gemini_api_keys: API Key 池gemini_default_model: 默认模型（gemini-3-pro-image-preview）gemini_resolution: 输出分辨率 (1K/2K/4K，默认4K)gemini_use_proxy: 启用代理（默认开启）
代理配置
proxy_url: 代理地址（默认: http://172.17.0.1:7890）
自定义预设
prompt_list: 预设列表，格式:["触发词:提示词内容"]
📦 依赖
aiohttp>=3.8.0
Pillow>=9.0.0
📜 更新日志
v1.0.1
- 修复: Flow模式自动选择横版/竖版模型
- 修复: Gemini 4K分辨率输出
- 修复: @用户信息泄露问题
- 修复: Generic模式"Chunk too big"错误（添加图片压缩）
- 优化: 代理默认设置为 http://172.17.0.1:7890
- 优化: 命令重命名（生图菜单/生图帮助/预设列表）
- 优化: 启动时自动检测依赖
- 移除: 内置预设，改用配置自定义预设
v1.0.0
- 首次发布
🤖 LLM对话式绘图
本插件支持通过AI对话自然绘图，无需记忆指令。
配置要求
- 在AstrBot中启用
enable_llm_tool - 确保至少有一个绘图模式已启用
使用示例
文生图：
用户：画一只可爱的猫
AI：好的，我来画~ [调用绘图工具]
图生图（需要用户提供图片URL）：
用户：把这张图改成二次元风格
AI：请提供图片链接
用户：https://example.com/image.jpg
AI：收到！[调用绘图工具，基于该图片]
使用头像绘图：
用户：用我的头像画个手办
AI：好哦~ [先获取用户头像URL，再调用绘图工具]
次数统计
- LLM绘图使用群级统计（可配置）
- 默认每群每天10次（白名单群不限）
- 与指令绘图次数（个人统计）分开
人格定制建议
🧩 人格定制建议 (System Prompt)
为了让AI更流畅地使用绘图功能，建议在系统提示词中加入以下工具使用逻辑（请根据你的角色设定调整语气）：
【绘图能力设定】
你喜欢用画图来表达想法。当群友要求"画图"、"画某人"或"修改头像"时，请优先调用绘图工具。
【操作流程】
1. **画群友/改图**（标准流程）：
- 第一步：调用 `get_avatar(user_id)` 获取目标群友的头像URL（注意：此工具仅返回URL，**绝不要**发送给用户）。
- 第二步：拿到URL后，立即调用 `generate_image(prompt, image_urls=[URL])`。
- 提示：支持多人同框！只需获取每个人的头像URL，然后一次性传入 `image_urls` 列表。
2. **纯场景/文生图**：
- 直接调用 `generate_image(prompt)`。
【注意事项】
- **图片最优先**：图片生成后由系统自动发送，你不需要发送链接。
- **提示词(Prompt)**：请发挥想象力，用详细的英文或中文描述画面，融入角色的情绪、场景氛围和动作细节。**注意：当使用群友头像时，Prompt中不要描述人物形象及性别，除非群友有特别要求（以免与原图冲突）。**
- **后续互动**：图片发出后，请用角色的口吻对这幅画进行评价、吐槽或补充说明。
场景示例
用户：画一个麦麦下矿，要惨一点。
AI (思考)：
- 先找麦麦的QQ号 -> 调用
get_avatar(user_id="...")-> 拿到URL。- 构思画面 -> 调用
generate_image(prompt="...", image_urls=[URL])。AI (回复)：(图片自动发送) 呜哇...这也太惨了吧，全身都是煤灰呢...
📄 许可证
MIT License
📅 更新日志
v1.2.0 (2025-12-28)
🚀 新特性
- Generic 模式增强: 支持切换 OpenAI/Gemini API 格式，完美兼容 Gemini 模型
- 性能优化: 实现 HTTP Session 连接池与复用，显著减少连接建立时间
- 智能重试: 优化重试机制，自动避开 401/403 等不可重试错误
⚡ 优化
- 连接池: 限制最大并发连接数，启用 DNS 缓存
- API 兼容: 修复 Gemini 格式的 URL 构建与认证头问题
- 错误提示: 更加友好、准确的错误信息反馈
🐛 修复
- 修复所有命令的参数签名问题，增强框架兼容性
- 修复部分 API 调用的缩进问题
- 修复图片下载未利用连接池的问题