dsh-tavern-image

🏁 最后一个版本（v3.0.0），不再独立更新

本仓库停在 v3.0.0，不再发布新版本、不再加新功能。以后的一切更新都在 Tavern 本体里。

⚠️ 本插件已内嵌到 DSH Tavern 本体

从 DSH Tavern 3.0 起，剧情生图作为内置插件随本体一起安装与更新，不再需要单独安装 dsh-tavern-image。

• 安装：装好 Tavern 本体就有。设置里那一节叫「本地生图」。
• 更新：跟 Tavern 本体一起更新，不用管插件版本。
• 反馈：功能问题、bug、新需求请到 flizzywine/dsh-tavern 提，本仓库不再作为主要反馈渠道。
• 本仓库的用途：保留源码与历史版本。旧版本仍可下载安装（给还在用 Tavern < 3.0 的人），但不会再独立发新功能。

本仓库的最后一个独立版本是 v3.0.0，内容与 Tavern 本体内置的一致。

DSH Tavern Image

📖 从旧版插件升级过来？ 看 MIGRATION.md：怎么把角色库、世界书、渠道配置搬到新版。

💾 换机 / 备份？ 面板里有「导出全部数据」和「导入全部数据」，一键打包六份数据成一个 JSON。

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

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

插件的长处

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

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

安装与第一次出图

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

Windows 安装

安装器默认使用 %USERPROFILE%\.dsh 下的 tavern Profile；可通过 -Profile 指定另一个已经存在的 Profile。安装器只安装插件源码，不运行仓库脚本；它调用 DSH 官方 CLI 的 plugin add，附带 --ignore-scripts，由 DSH 将 dsh-tavern-image 依赖、node_modules 链接和 bundle 一起登记。若目标目录或 Profile 中已有 canonical 注册，或 Profile 仍登记旧包名 dsh-tavern-comfy，安装器会停止，不覆盖已有内容或制造双重加载；更新已安装插件请用插件自己的更新页，旧注册迁移见下文。

已发布的离线安装包可从 GitHub 发布页下载。解压后双击 Install-DshTavernImage.cmd，安装器直接使用包内源码，不必再从 GitHub 下载。发布页也提供独立源码包和 SHA-256 校验文件。请核对发布版本；需要最新的 2.5.3 修复时，可用下方的源码 ZIP 安装方式。

也可以在 GitHub 仓库页选择 Code → Download ZIP，解压后双击 scripts\Install-DshTavernImage.cmd（同目录有 install-plugin.ps1）。浏览器下载 GitHub Archive ZIP 或 codeload ZIP 后，可以在 PowerShell 中指定文件：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\install-plugin.ps1" -SourceArchive "$env:USERPROFILE\Downloads\dsh-tavern-image-master.zip"

ZIP 顶层即使多套几层目录也能识别。

一键包 / 改版 DSH 的安装位置

有些一键包或改版把 DSH 数据放在别处，而且根目录下面直接就是 profiles 文件夹（没有 .dsh 这一层），例如 D:\dsh\profiles\tavern。安装器会自己找：

• 依次尝试：-DshHome（别名 -Root）→ 环境变量 DSH_HOME → %USERPROFILE%\.dsh、%USERPROFILE%\dsh、%LOCALAPPDATA%\dsh、%APPDATA%\dsh → 各固定磁盘根下的 .dsh / dsh / DSH / dsh-tavern
• 找不到时会把找过的位置全部列出来，并给出可直接复制的命令；安装开始时会打印最终选定的数据目录
• 手动指定时下面三种层级任选，都能自动识别成同一个数据目录：

# 三种写法等价
powershell -NoProfile -ExecutionPolicy Bypass -File ".\install-plugin.ps1" -DshHome "D:\dsh"
powershell -NoProfile -ExecutionPolicy Bypass -File ".\install-plugin.ps1" -Root "D:\dsh\profiles"
powershell -NoProfile -ExecutionPolicy Bypass -File ".\install-plugin.ps1" -Root "D:\dsh\profiles\tavern"
# 指定另一个已存在的 Profile
powershell -NoProfile -ExecutionPolicy Bypass -File ".\install-plugin.ps1" -DshHome "D:\dsh" -Profile other

如果那个环境不用标准 DSH CLI 管理插件，加 -NoRegister：安装器只把源码放进 profile-data\<profile>\data\tools\dsh-tavern-image，不再调用官方 CLI，由你按该环境自己的方式启用（登记 link、加进插件清单等），然后完整重启 DSH。

powershell -NoProfile -ExecutionPolicy Bypass -File ".\install-plugin.ps1" -DshHome "D:\dsh" -NoRegister

安装器只复制插件包白名单，不复制 Git 历史、测试、config.json、definitions.json、世界书、缓存、任务记录或用户工作流。若已解压仓库，也可以传入 -SourceDirectory，安装器仍会逐个筛选允许的包文件。

有网络时，不带来源参数会先试官方 codeload，再试 GitHub Archive：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\install-plugin.ps1"

若下载失败，可先用浏览器下载 ZIP 再传入 -SourceArchive；也可以克隆源码到单独的临时目录并用 -SourceDirectory 安装：

git clone https://github.com/weixinlll/dsh-tavern-image.git "$env:TEMP\dsh-tavern-image-source"
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\dsh-tavern-image-source\scripts\install-plugin.ps1" -SourceDirectory "$env:TEMP\dsh-tavern-image-source" -Profile tavern

运行 scripts\Package-DshTavernImage.ps1 可生成可离线携带的 ZIP；解压后双击其中的 Install-DshTavernImage.cmd。插件 设置 → 配图 → 插件更新页的“本机安装包”入口也可导出源码 ZIP，拷贝到目标电脑后用 -SourceArchive 安装。这个入口用于下载和转移安装包；当前 DSH Desktop 的插件清单页没有经验证的 GitHub URL/ZIP 安装输入框，不要在该页粘贴仓库网址。

安装器会显示插件版本和 ZIP 的 SHA-256，发布页也提供 SHA256SUMS.txt，下载后可以比对文件是否完整。安装后完整退出并重新打开 DSH Desktop，刷新网页不能替代宿主重启。

旧版目录迁移

已有旧包名 dsh-tavern-comfy 的安装不要再并排装一份。先完整退出 DSH（包括托盘进程）并备份整个插件目录。若旧目录仍叫 dsh-tavern-comfy，仅在确认 tools 下没有另一份 dsh-tavern-image 后改名为 dsh-tavern-image；不要覆盖或合并两个目录。Profile 的旧依赖由 DSH 官方 CLI 移除，不能手工编辑 bundle 列表：

$plugin = Join-Path $env:USERPROFILE '.dsh\profile-data\tavern\data\tools\dsh-tavern-image'
$source = 'C:\path\to\dsh-tavern-image-candidate'
$backup = Join-Path $env:USERPROFILE 'dsh-tavern-image-backup-before-canonical-migration'
if (-not (Test-Path -LiteralPath $plugin -PathType Container)) { throw "找不到旧插件目录：$plugin" }
if (Test-Path -LiteralPath $backup) { throw "备份目录已存在，请先检查：$backup" }
if (-not (Test-Path -LiteralPath (Join-Path $source 'package.json') -PathType Leaf)) { throw "候选源码目录无效：$source" }
Copy-Item -LiteralPath $plugin -Destination $backup -Recurse

[Read the full README on GitHub →](https://github.com/weixinlll/dsh-tavern-image)