|
|
|
|
|
|
|
|
# 私聊机器人
插件商店
# 搜索并安装 "AI 创作" 插件# 1. 克隆或下载插件
git clone <repository-url>
# 2. 放入插件目录
mv zhenxun-plugin-ai_creation zhenxun/plugins/
# 3. 重启机器人
python bot.py插件通过 Playwright 驱动豆包网页版。建议按照下列步骤配置 Cookie，以提升成功率。
Tip
建议配置 Cookie
⚠️ 游客模式易触发风控- 📊 单账号日配额约 100 次
- 🔄 支持配置多个 Cookie 轮询
📖 点击展开详细步骤
-
登录豆包
访问 https://www.doubao.com/chat/ -
打开开发者工具
按F12键，切换到 Network 标签页 -
触发请求
在聊天框发送任意内容 -
过滤请求
在过滤框输入completion，选择最新请求 -
复制 Cookie
在 Headers → Request Headers 中找到并复制Cookie完整内容 -
写入配置
将 Cookie 写入data/config.yaml的DOUBAO_COOKIES字段
配置示例：
# 单个 Cookie
DOUBAO_COOKIES: "your_long_cookie_string_here..."
# 多个 Cookie（推荐）
DOUBAO_COOKIES:
- "cookie_value_1"
- "cookie_value_2"
- "cookie_value_3"| 🐛 问题 | 💡 解决方案 |
| 无法登录 / 人机验证 | 将 HEADLESS_BROWSER 设为 False，观察浏览器流程并手动处理 |
| 频繁触发风控 | 配置多个有效 Cookie，启用轮询机制 |
| 生成失败 | 检查 Cookie 是否过期，尝试重新获取 |
使用命令 draw -e api ... 即可切换到 API 引擎。
Note
推荐配置
- 🎯 推荐模型：
Gemini/gemini-2.5-flash-image-preview - 💰 成本控制：可使用第三方中转服务
- 🔐 需配置：
API Base URL+API Key
| 指令 | 说明 | 示例 |
|---|---|---|
draw [描述] |
根据文本生成图片 | draw 一只可爱的猫 |
draw [描述] [图片] |
图文结合创作 | draw 换成油画风格 [附带图片] |
[引用图片] draw [描述] |
回复图片并附加描述 | 引用消息后 draw 增加夕阳背景 |
Tip
💡 使用 @用户 可自动获取对方头像作为输入，支持多用户或多图
| 参数 | 说明 | 可选值 |
|---|---|---|
-e, --engine |
选择绘图引擎 | doubao / api |
-t, --template |
应用预设模板 | 模板名称或序号 |
-o, --optimize |
开/关提示词优化 | on / off |
| 指令 | 作用 | 示例 |
|---|---|---|
绘图模板 list |
查看全部模板 | 绘图模板 list |
绘图模板 info <模板> |
查看模板详情 | 绘图模板 info 手办 |
绘图模板 create [图片] |
🤖 AI 智能创建模板 | 绘图模板 create [附带图片] |
绘图模板 optimize <名称> [指令] |
🤖 AI 智能优化模板 | 绘图模板 optimize 监狱风格照 白色标牌 |
绘图模板 add <名> <提示词> |
手动新增模板 | 绘图模板 add 油画 古典油画风格 |
绘图模板 del <名1> [名2]... |
删除模板 | 绘图模板 del 油画 水彩 |
绘图模板 edit <名> <新提示词> |
更新模板内容 | 绘图模板 edit 手办 新的提示词 |
绘图模板 reload |
从文件重载模板 | 绘图模板 reload |
绘图模板 clear |
清空全部模板 | 绘图模板 clear |
Important
AI 驱动的模板生成器
通过 AI 分析图片自动生成绘图模板，无需手动编写复杂提示词。
📚 使用流程
-
上传图片
发送绘图模板 create+ 附带图片（或引用包含图片的消息） -
AI 分析
AI 自动识别风格、元素、特征，生成模板名称 + 详细提示词 -
交互会话
- ✅ 回复
确认/yes保存模板 - ❌ 回复
取消/no放弃操作 - 📝 直接发送修改指令，AI 继续优化
- ✅ 回复
📸 实际效果展示
上传"监狱风格照"图片，AI 自动生成包含场景、光影、构图要求等专业提示词
Important
AI 驱动的模板迭代器
对现有模板进行智能优化，支持交互式修改，直到达到理想效果。
📚 使用流程
-
选择模板
发送绘图模板 optimize <模板名称> -
提供指令（可选）
添加具体优化要求，如：白色标牌上写有文字 -
交互会话
- ✅ 回复
确认更新模板 - ❌ 回复
取消保持原样 - 🔄 继续发送新指令进行多轮优化
- ✅ 回复
📸 实际效果展示
对"监狱风格照"模板添加"白色标牌上写有文字"指令，AI 智能融合生成更精准的提示词
# 基础文生图
draw 一只可爱的猫
# 切换 API 引擎
draw 一只可爱的猫 -e api
# 使用模板 + 用户头像
draw -t 手办 @用户
# 模板 + 额外描述 + 多用户
draw -t 巨物手办 场景是夜晚 @用户1 @用户2
# 图生图 + 提示词优化
draw [附带图片] -o on 换成赛博朋克风格
# 引用图片 + 模板
[引用图片] draw -t 油画 添加温暖滤镜
| 🚫 错误信息 | 🔍 可能原因 | 🛠️ 解决方案 |
|---|---|---|
图片生成失败 |
• 内容触发敏感词分类 • 豆包页面人机验证 • Cookie 已过期 |
• 修改描述，避免敏感词 • 设置 HEADLESS_BROWSER=False 手动验证• 重新获取 Cookie • 启用 DOUBAO_AUTO_SOLVE_CAPTCHA 配置项自动处理验证码
|
队列超时 |
高并发任务堆积 | 稍后重试，或考虑切换到 API 引擎 |
API 调用失败 |
• API Key 无效 • 配额不足 • 模型不支持图像生成 |
• 检查 API 配置 • 确认账户余额 • 更换支持图像的模型 |
Note
所有配置可通过 data/configs/config.yaml 或 WebUI 调整。
🛠️ 点击展开完整配置说明
| 配置项 | 默认值 | 说明 |
|---|---|---|
default_draw_engine |
"doubao" |
默认绘图引擎：doubao / api |
enable_api_draw_engine |
True |
是否允许非管理员使用 API 引擎 |
api_draw_model |
"Gemini/gemini-2.5-flash-image-preview" |
API 引擎使用的模型 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
DOUBAO_AUTO_SOLVE_CAPTCHA |
True |
是否在豆包绘图时启用AI自动解决拖拽验证码。关闭后，遇到验证码将导致绘图失败。 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
enable_draw_prompt_optimization |
False |
是否默认开启提示词优化（-o 可覆盖） |
auxiliary_llm_model |
"Gemini/gemini-2.5-flash" |
提示词优化所用的 LLM |
| 配置项 | 默认值 | 说明 |
|---|---|---|
DOUBAO_COOKIES |
[] |
豆包 Cookie 列表，支持多账号轮询 |
ENABLE_DOUBAO_COOKIES |
True |
是否启用 Cookie（强烈建议开启） |
HEADLESS_BROWSER |
True |
是否使用无头模式（调试时设为 False） |
browser_cooldown_seconds |
60 |
浏览器关闭后的冷却时长（秒） |
| 配置项 | 默认值 | 说明 |
|---|---|---|
draw_cd |
120 |
绘图命令冷却时间（秒） |