DSH Tavern Image

给 DSH Tavern 用的剧情配图插件。它读取已经完成的正文，挑选适合画成插图的场景，再交给你配置的生图服务生成，按剧情位置插回消息里。

可以用本地 ComfyUI、SD WebUI / Forge，也可以接 NovelAI、OpenAI Images、Gemini 等在线服务。人物资料、画风、提示词规则和图片记录在同一个面板里管理，适合给长篇角色扮演和故事配图。

2.1.0 更新

仓库、插件 ID 和主接口前缀统一为 dsh-tavern-image，旧接口保留兼容。旧版安装需要迁移目录，步骤见下。

cd "$env:USERPROFILE\.dsh\profile-data\tavern\data\tools\dsh-tavern-comfy"
git remote set-url origin https://github.com/weixinlll/dsh-tavern-image.git
git pull --ff-only origin master

插件的长处

• 图片跟着正文走。 配图可以插在对应句子后面，并与这版正文绑定。切换回复版本时，显示的是对应版本的图，方便重写和回看剧情。
• 少画没有必要的图。 智能选图允许规划模型跳过没有独立画面的回合。想给某轮补图时，手动生图仍然可用。
• 人物资料可以反复使用。 外貌和服装集中维护，按当前卡片筛选角色；长篇中明确发生的永久外貌变化可以另存历史，减少前后提示词不一致。
• 写故事和画图可以用不同的模型。 正文模型负责剧情，规划模型负责画什么、插在哪里、怎么写提示词，生图渠道负责出图。三者可以分别选择。
• 本地和在线服务都能用。 ComfyUI 可以直接选模型，也可以导入自己的工作流；换到在线渠道后，人物库、画风和正文配图流程仍可使用。

这些功能主要解决配图位置、资料维护和操作流程的问题。角色一致性和最终画质仍受生图模型、提示词、种子、LoRA 等因素影响，人物库不能保证每张图都完全一样。

安装与第一次出图

需要已经能使用的 DSH Tavern，以及本地生图服务或在线平台的 API 地址和密钥。

安装插件

Windows PowerShell：

cd "$env:USERPROFILE\.dsh\profile-data\tavern\data\tools"
git clone https://github.com/weixinlll/dsh-tavern-image.git

其他系统在对应的 ~/.dsh/profile-data/tavern/data/tools 目录安装。下载源码安装时，也要把插件文件放在 tools/dsh-tavern-image 中，避免多套一层目录。

安装后完整退出并重新打开 DSH Desktop。只刷新页面不能替代宿主重启。

配置生图服务

打开 设置 → 本地生图 → 生图规划，选择提供商，填写地址、模型和鉴权信息并保存。

• ComfyUI：填写服务地址，默认是 http://127.0.0.1:8188。有鉴权时选择 Bearer 或 Basic，再测试连接。到「画风」页选择简单模式，或导入 API 格式工作流并设为默认。
• 在线平台：新增渠道，填写平台提供的 API 根地址、模型名和 API Key。中转服务需要选择它实际支持的协议。
• SD WebUI / Forge：服务端需要开启 API，地址要能从运行 DSH 的设备访问。

“测试连接”不会提交生图任务。部分平台没有合适的只读探测接口，会显示“已配置”；这表示配置已填好，实际出图还需要确认模型权限、额度和服务端支持情况。

配置规划模型

在「生图规划」选择规划模型。留空时跟随 Tavern 配置的后台模型，也可以单独指定渠道、模型和推理等级。

保存后，先用消息下方的「生图」按钮测试一轮，确认提示词、人物和图片位置是否合适，再使用每轮自动规划。使用参考图设计角色时，还需要配置支持视觉的看图模型。

自动配图与生成速度

后台配图由 每轮自动规划配图（前台只写正文） 控制。它在 Tavern 的轮次结算事件到达后启动，读取正文和可用的角色资料，生成图片计划，再把图片挂到对应句子后面。

开启 智能决定是否配图 后，“一轮几张”是图片数量上限，规划模型可以少画，也可以整轮跳过。例如只有简短对话、整理信息或过渡内容的回合，可以不生成图片。判断是否合适仍由规划模型完成，手动生图可以绕过自动跳过决定。

生成任务在后台运行，结算通知不需要等模型和图片全部完成。多张图各自完成后显示，较慢的一张不会挡住已经完成的图片。外部渠道默认同时生成 2 张，可以调整为 1–4 张；ComfyUI 的实际执行速度和顺序由它自己的队列决定。

智能选图会等规划结果完整并通过校验后再提交，避免模型最后决定跳过时已经发出生图请求。关闭智能选图后，流式规划一旦输出完整画面块，就可以提前提交这一张，后面的规划与出图重叠进行。

当前 Tavern 的公开事件是在轮次结算后触发。插件能减少规划和出图之间的等待，但不能把启动时机提前到正文生成中，也不会加速 Tavern 本身的结算。

自动规划和正文标记有什么区别

插件还保留了另一种方式：让前台模型在正文里输出 image###提示词### 标记，再按标记生成图片。

后台规划默认开启，正文标记默认关闭。只想手动生图时，可以关闭后台自动规划；若也不需要自动记录角色外貌历史，可以同时关闭角色自动更新，避免结算后继续调用规划模型记录外貌。

生图渠道

同一个提供商可以配置多条渠道，分别保存名称、地址、模型和鉴权。可以在自己的服务和不同中转之间切换，无需把原配置删掉再重新填写。复制渠道后，需要给副本填写自己的密钥。

这里接的是平台 API，网页登录账号不能代替 API Key。第三方服务只有在兼容相应协议时才能使用；单有网址和密钥，并不代表所有平台都能接入。

渠道密钥在设置界面中不回显。留空保存会保留原密钥，明确清除后再保存才会删除。下载服务返回的图片链接时，不会把 API Key 发送给图片服务器。

生图请求遇到网络错误时不会自动重发。如果服务端已接收任务但响应丢失，先查看任务记录，再决定是否手动重试，避免重复创建付费任务。

人物库与角色设计

人物库用来保存角色的稳定外貌和服装。规划模型知道正文中出现了谁，插件再把对应资料补到绘图提示词里；同一个人物不用每轮从零写描述。

外貌按角色特征、正背面、上下半身及常规 / 裸露版本分块保存。出图时根据视角和画面选择可见部分，减少近景里塞进全身细节、背面图仍强调正脸等冲突。服装可以保存多套，也可以使用通用服装资料。

角色较多时，界面用搜索和下拉框选择当前角色，一次只展开一个编辑区。支持按中文名和触发名筛选、收起编辑、复制角色，以及批量修改外貌字段、说明、启用状态和卡片绑定。

批量修改会先留在编辑区，检查后点击 保存人物库。切换角色会保留当前编辑草稿；后台刷新和异步设计返回时，会尽量保留期间的手动修改。复制角色会生成独立编号，修改副本不会改动原角色。

角色可以绑定卡片，未绑定的角色可供所有卡片使用。不同故事里有同名角色时，绑定卡片有助于减少误用资料。

设计角色可以使用文字需求、当前卡片上下文或参考图，也能让模型改进已有角色。参考图需要看图模型支持视觉；识别结果仍需检查，尤其是服装、发色、背面等图中看不清的部分。

角色随剧情变化与历史

人物库保存你维护的基础设定，角色历史保存某条剧情线中发生的外貌变化。两份数据分开，剧情更新不会直接改写全局人物库。

例如正文明确写出角色永久留疤、剪短头发或失明，插件可以为人物库里已知的角色记录这次变化，并在后续配图中使用。衣着、姿势和临时状态不会作为永久外貌变化写入。

历史按剧情线、轮次和正文版本保存。回退或切换正文版本时，插件读取宿主提供的对应快照；在「角色历史」面板可以查看变化，并把某个字段恢复到变化前。恢复会写入一条新的记录，不会把已有记录直接删掉。

这项功能需要 Tavern 插件接口 v2。接口 v1 下角色历史不可用，其他配图功能仍按宿主可用接口工作。历史记录有容量上限，异常或不完整输出会提示并沿用已有快照，不能当作无限容量的剧情档案。

提示词与画风预设

「画风」页同时提供画风预设和提示词预设：

• 画风预设保存画师串、固定风格词和负面词，可以调整放在提示词前面还是后面。
• 提示词预设给规划和出图提供构图、光线、材质、色彩与画面重点的指导。内置杂志人像、电影叙事、动漫角色、东方幻想和氛围场景，也可以自己新增。

提示词表达可选择自动、标签、自然语言或混合模式。自动模式会按生图渠道和 ComfyUI 模板选择表达方式：例如 NovelAI 更适合标签，OpenAI Images、Gemini 等渠道使用自然语言描述。

预设在现有规划调用中使用，不会为应用预设再额外调用一次模型。正面指导和负面约束分开保存，切换渠道时也可以继续使用自己整理的风格资料。

想保持一个故事的整体画风，可以固定一套预设；要改变某张图的镜头或气氛，则在这张图的提示词里单独修改。

ComfyUI 简单模式

简单模式适合已经装好模型、希望直接选模型和参数出图的情况。进入 画风 → ComfyUI 生成方式，选择简单模式，刷新模型列表，再选择模板和模型并保存。

可设置尺寸、步数、采样器、调度器、种子和模板支持的 LoRA。空种子按张随机，填写种子则使用固定值。

模型、节点和参数选项来自当前 ComfyUI 的 /object_info。缺少对应节点或模型时，模板会提示不可用；刷新列表不会提交生成任务。

简单模式只内置这三类模板。需要自定义节点、特殊采样流程或额外节点包时，使用工作流模式。

工作流导入与可视化编辑

工作流模式适合继续使用你在 ComfyUI 中调好的流程。导入的必须是 API 格式 JSON，普通的画布工作流 JSON 不能直接作为生成请求使用。

插件会识别正负提示词、尺寸、采样参数、底模和 LoRA 等绑定。可以保存多份工作流，设定默认流程，按不同画风切换；识别不符合预期时，可以在编辑区调整绑定。

可视化编辑支持查看节点和连线、缩放和平移、拖动节点，在右侧修改已有节点的文字、数字和开关输入。保存时会备份旧文件，并保存节点位置；同一文件已被其他操作修改时，会提示重新打开，避免覆盖。

连线是只读的，增删节点或重新连线仍需在 ComfyUI 中完成后重新导入。自动绑定的提示词、随机种子和尺寸等输入，在出图时会由当前生成设置替换。

工作流库的试跑使用所选工作流，即使当前选的是简单模式或在线渠道，也不会把试跑请求发给另一个渠道。

查看图片与重画

也可以让后台模型按要求改写这张图的提示词，再用修改结果重画。图片概括由 Tavern 显示一处，插件保留替代文本，避免正文下重复出现同一说明。

重画版本链保存在当前浏览器的本地存储中，刷新后仍可使用；它与服务端图片缓存不同，清理浏览器数据或换设备后不能指望自动同步这份版本链。

世界书与图片格式

「世界书」页管理发给规划模型的配图规则，例如场景选择、镜头、角色资料使用和输出格式。可以导入世界书 JSON，也可以粘贴 JSON 或纯文本，逐条编辑和启用；未启用的条目不会进入配图规则。

默认配图规则用于首次初始化，已保存的个人规则不会随插件升级重置。导入的其他引擎宏和包装语法会做清理；只导入适合绘图规划的内容更容易检查结果。

需要减少图片体积时，可以开启 PNG 转 JPEG，质量可设为 50–100。透明区域会按所选背景色铺底。已经是 JPEG 或其他格式的图片不会重复转换；转换失败或超过限制时保留原图并给出说明。默认保持原始格式。

数据、更新与 DSH 接口

插件使用 Tavern 的公开接口处理轮次通知、正文附件、图片显示和消息动作，不需要修改 Tavern 的源码。宿主升级不会覆盖一份额外的源码补丁；如果公开接口本身发生不兼容变化，插件仍需要适配。

图片随正文版本显示，自动规划也会检查版本是否仍有效；正文改写或删除后，不会继续把旧任务的结果挂到新正文上。

主要本地数据如下，均在插件文件夹内：

这些运行数据由 .gitignore 排除，不随正常 Git 提交上传。备份或迁移时保留整个插件文件夹；分享规则时可使用世界书导出，分享工作流前也要检查文件内容。

提示词和生图请求会发送给所选服务，参考图识别也会发送给看图模型。后台规划（包括开启的角色历史更新）和生图服务均可能产生费用，具体额度与数据处理方式以你的服务商说明为准。

在「插件更新」页先检查，再安装已检查到的版本。自动更新要求官方 Git 安装、master 分支和无本地代码改动；提交分叉、目录冲突或远端改动涉及用户数据路径时会停止。下载源码安装的副本需要手动更新。更新后完整重启 DSH。

常见问题

只想少画几张，可以降低数量上限、开启智能选图，或改用手动生成。出图速度主要取决于模型、分辨率、显卡和远端队列，插件不会为了提速绕过服务端的执行规则。

兼容与许可

当前版本 2.1.0。插件清单声明的 DSH 兼容范围为 >=0.1.0-rc.8 <0.2.0；角色历史另外需要 Tavern 插件接口 v2。

为保留现有 DSH 安装的包解析兼容，包名和浏览器模块加载键仍使用 dsh-tavern-comfy；插件 ID、主接口前缀和新安装目录使用 dsh-tavern-image。

界面与功能设计参考了 st-chatu8 和 柏宝绘。

采用 MIT 许可证。随包使用的图片编解码库说明见 第三方声明。