企业官网建设流程全解析

DSH Tavern（基于 DSH 的 Agent 酒馆）内置了完整的场景生图能力：一次点击，就能为任意一轮正文生成对应的剧情插画。它统一接入ComfyUI、NovelAI、OpenAI、Gemini、Grok、Seedream、Qwen-Image、SD WebUI等 9 种 AI 生图渠道，人物卡导入即玩，插画自动贴合剧情、画风与人物状态，手机、桌面都能用。本文是一份面向新手的多渠道 AI 生图清单与实战教程。

1️⃣ DSH Tavern 场景插画是什么？

简单说：文字负责讲故事，插画负责把故事画出来。

• 读完一段正文，在操作栏点「生图」，后台的文字 Agent 会先"读懂"这一轮：谁在场、穿什么、什么天气、什么地点，然后提交一份画面方案，再调用你配置的 AI 生图服务出图；
• 图片挂在对应正文段落下方，刷新、重启、换设备后依然保留；
• 不满意可以「重画」或填一句意见「按意见重画」，比如"改成雨夜、镜头拉近"；
• 不自动每轮生成，一次一图，有文字模型任务和生图费用，不会偷偷每轮画图。

功能默认关闭。只有完成「渠道配置 → 保存 → 打开开关」后，每轮正文下方的操作栏才会出现图片图标。关闭后图标隐藏，但已有插画照常可看、可下载。

2️⃣ 九渠道 AI 生图清单：该选哪个？

DSH Tavern 统一拥有九种单图渠道的协议、配置与只读鉴权，渠道实现集中在 tavern-plugin/packages/dsh-image-gen/src/。各渠道独立保存配置和密钥，切换只是预览，点「保存并启用」后才生效。

九种协议均已通过本地协议与真实 DSH 子任务测试；实际画质、模型名与地域端点以你自己账号为准。验证进度见 docs/specs/scene-illustration-delivery.md。

3️⃣ 快速上手：五分钟配好你的第一条 AI 生图渠道

进入「设置 → 场景生图」，按官方顺序走五步：

1. 选提供商：官方渠道会自动填入默认地址与模型，自定义服务请填自己的地址与模型；
2. 填 API 根地址与 API Key：Key 保存在 DSH 凭据库，普通设置文件不存密钥。也可以通过环境变量提供，如DSH_TAVERN_IMAGE_API_KEY、DSH_TAVERN_IMAGE_GEMINI_API_KEY，ComfyUI / WebUI 的 Basic 密码分别用DSH_TAVERN_IMAGE_COMFYUI_PASSWORD、DSH_TAVERN_IMAGE_WEBUI_PASSWORD；
3. 测试连接与鉴权：最多等 5 秒，不生成图片、不保存配置、不收费；
4. 选生图模型：支持「获取模型列表」的渠道走只读 GET，不会试画；
5. 保存并启用，然后打开「开启场景生图」总开关。

💡 几个容易踩的坑：

• 连接成功 ≠ Key 有效 ≠ 能出图。只读鉴权接口不保证余额和模型权限；
• 改地址后必须重新填 Key，旧密钥不会自动发到新地址；
• 保存配置本身不会试画，"保存成功"不等于出图已验证；
• 官方渠道地址自动填入，但账号可用模型、地域端点可能不同，必要时按供应商修改。

4️⃣ 主流渠道实战配置

Gemini 原生渠道

官方地址与gemini-3.1-flash-image默认填好，只需贴入 API Key。可设置图片尺寸（如 1K）、画面比例与画风。Gemini 系列还是目前唯一支持造型参考图的渠道，后面会讲。

NovelAI：动漫党的最爱

默认官方地址 + V5 Full + 832×1216 竖版单张，高级设置可换 V5 Curated、V4.5、V4、Anime V3。V4 及以上会把场景和各人物描述分开提交，重画只换随机种子、不再跑文字任务。第三方服务需支持相同的/ai/generate-imageJSON→ZIP 协议，不是任意 OpenAI 兼容接口。

NovelAI 还有专属的画师串库：可存多套画师/风格标签、附预览图、点选切换，选中后拼进提示词的 artist 段——换画风不用再手敲标签。

ComfyUI：自托管工作流玩家

ComfyUI 渠道面向自托管服务（不是 Comfy Cloud）。你只需：

1. 填维护者给的服务根地址（"localhost"指运行 Tavern 的服务器，不是手机）；
2. 点「导入工作流」选择维护者验证过的单图 API 格式JSON 文件，界面没有 JSON 编辑器；
3. 默认无需鉴权，有反向代理时可选用户名密码或 Bearer Token。

简单工作流（KSampler → VAEDecode → SaveImage）可自动识别正向提示词、种子与输出；复杂流程由维护者提供映射文件指定positive/seed/batch/outputNode。每次请求先落盘任务编号再提交，断线重启后查询原任务、不重复入队，不会为同一幕重复付 GPU。详细规则见 docs/comfyui-scene-images.md。

SD WebUI / Forge：本地显卡直连

只需填已开启 API 的 WebUI 服务根地址，程序自动追加/sdapi/v1/txt2img。默认 512×512 单张、沿用服务端当前模型，不改服务端全局设置、不装模型、不调用全局 interrupt 接口。本地显卡出图 = 零边际成本，适合长期挂机跑图。

Seedream（火山方舟）与百炼 Qwen-Image 则是"填地址 + 贴 Key"即可，国内用户注意密钥需与 API 地域端点匹配；Banana / Gemini 聊天兼容渠道需自行填写支持/chat/completions生图的服务地址，不是任意文字聊天接口。

5️⃣ 画风控制：自动连续 vs 锁定画风

在「绘图选项」里，画风只有两种模式：

• 自动（默认）：每张图由生图 Agent 按剧情写这张的画风。第一张按人物卡题材定，之后参考本局上一张的画风保持连续，可随剧情自然变化（白天转夜晚、晴转雨都不会违和）；
• 锁定画风：每张原样使用你填写的画风，Agent 不改。留空等同自动。

下方选填的「画风偏好」会把你的要求（如"偏日系、低饱和、柔和光线"）交给 Agent 参考。保存后跨对话、跨重启保留。

高级绘图参数（选填）

负面提示词直接作为供应商参数提交，不混进正面提示词、不交文字 Agent 改写。步数更高通常更慢也可能更贵，不保证画质更好。

6️⃣ 实战：重画、版本与画廊管理

重画三种玩法

点开「重画」后：

• 同方案重画：相同表达配置下复用原方案、只换随机种子，不调用文字模型，费用最低；
• 重新构思画面：交给本局共用的生图 Agent 重新选时刻、写构图，替换本轮方案；
• 按意见重画：填一句"改成雨夜、镜头拉近"，只带原方案与修改要求生成新图，不是像素级修图。

旧图始终保留：同一轮的多张图可用左右箭头翻版本，切换插画版本不会影响剧情。

查看画面方案，调试提示词

点开大图可展开「画面方案」：这张图选了哪个时刻、构图、画风（自动模式下就是 Agent 现写的）与最终提示词全在里面，还能直接「改提示词重画」——不经过文字模型，也不改人物资料，是调提示词效率最高的入口。

画廊：本局插画一屏尽览

对话区顶部的「画廊」标签页只列本局对话的插图：按轮次从小到大、同轮多图横排，支持方向键翻页、悬停删除与批量删除。关闭生图功能后画廊依然可翻看、下载旧图。

造型参考：让外貌跨图更一致

在支持参考图的 Gemini 渠道，可对已保存插图选「用作造型参考」：选择图中人物、确认接收服务后，后续生图会把这张图整张发给模型作为该人物的外貌参考（不会自动裁剪）。单张最多 8 MiB、每次最多四张；这是"尽量维护外貌"，不保证锁脸，地址、渠道或模型变化需重新确认授权。

7️⃣ 费用与失败处理：不重复扣费的细节

DSH Tavern 对生图费用的边界处理相当克制，新手可以重点记住这几点：

• 不自动重试收费请求：超时、断线、5xx 或响应丢失会标记「结果未确认，服务可能已计费」，再次请求需要你明确确认，授权只绑定那一次原失败；
• 收到图片但保存失败：显示「重试保存」，直接恢复这份图，不再调用文字模型和图片渠道；
• 取消只中止本地等待，不保证供应商停止生成或计费；
• 请求前配置已变化则拒绝旧请求，已发出的请求固定使用原地址与 Key；
• 每个游戏最多保留 100 次生图尝试日志，对话上方「日志」可下载scene-images/diagnostics.json详细诊断，含渠道、模型、耗时、HTTP 状态，不含密钥与图片字节。

8️⃣ 深入阅读

• 功能总览与渠道细节：docs/scene-images.md
• ComfyUI 工作流准备与恢复：docs/comfyui-scene-images.md
• 产品规格（一键生成、按需调整）：docs/specs/scene-illustration.md
• 内置生图模块源码：tavern-plugin/packages/dsh-image-gen/src/module.js
• 端到端测试（真实 DSH Agent loop + 本地生图服务）：tests/scene-image-native.test.mjs、tests/scene-image-comfy.test.mjs

🖼️ 总结：DSH Tavern 的场景插画把"读懂剧情 → 写画面方案 → 多渠道出图 → 版本与画廊管理"整条链路封装进一次点击。选一个你已有的渠道（云 API 或自托管 ComfyUI / SD WebUI），贴 Key、测连接、保存启用，然后点正文下方的图片图标——你的文字冒险，现在有了画面。