酒馆图文入门指南

先看这里

01 从这里开始

先接通文字，再使用角色卡，最后添加智绘姬插图。无需一次设置完全部功能。

本教程适合第一次接触 SillyTavern 的电脑用户。基础截图采用 SillyTavern 1.19.0 与智绘姬 3.1.7；2026 年 10 月 29 日新增配套插件、脚本与变量卡指引。具体核对版本和范围见 版本、资料与阅读范围。按钮译名可能随版本变化，鼠标停在图标上可查看名称。

这是一个独立 HTML 文件：电脑下载后用浏览器打开，手机可保存后使用支持本地 HTML 的浏览器查看。目录、搜索、图片放大均可离线使用。聊天 App 的文件预览器若不能展开目录或图片，请改用浏览器打开。参考链接和实际模型请求需要联网。

留意　本教程不内置角色卡、世界书、预设下载。它们作为附赠资料单独交付；文件名和配套要求以实际收到的说明为准。截图中的“海风书店”等名称只展示控件位置，不要求你拥有同名文件。

先看这里

02 酒馆、模型、API 与费用是什么

酒馆负责组织对话，模型服务负责生成内容。你看到的是同一个聊天页面，背后可以连接不同服务。

使用远程 API 时，模型运行在服务端，通常不需要为文字聊天和远程绘图准备本地大显卡。本机仍需要能运行酒馆、浏览器，并能访问相应服务。自己在电脑上运行模型是另一条路线，不在本教程的基础步骤中。

购买教程或附赠文件不会自动获得 API 额度。服务可能按输入、输出、缓存、请求或图片计费，以服务商说明为准。重复生成、继续、自动配图以及额外总结，都可能再发起请求。

留意　网页聊天产品的会员与开发者 API 通常是不同服务。先确认你拿到的是可用于 API 的凭据和额度；不要把登录密码粘贴进 API 密钥栏。

先看这里

03 附赠资源如何分类与导入

先读附件中的说明，再按类型导入。相同后缀不表示相同用途。

1. 先把附赠压缩包完整解压，保留原始文件和说明。PNG 角色卡使用下载原图，不用截图、缩略图或经过聊天软件压缩的图片。
2. 先用内置角色或一张简单角色卡确认文字连接。随后加入该角色要求的预设、世界书、正则；每导入一类就检查当前选择，避免一次打开多套互相冲突的配置。
3. 附赠角色若依赖特定扩展、快速回复或变量框架，按作者说明补齐。只有角色卡、世界书和预设，不保证包含它所需要的全部扩展。

留意　不要把角色文件放进酒馆源码目录，也不要把资源包直接覆盖 data。正常使用通过页面里的导入按钮即可。遇到同名覆盖提示时，先保留现有版本。

看到“酒馆助手 / 小白X / MVU / EJS / 鸡尾酒”等要求，先看 先判断这张卡需要什么。脚本 JSON、循环任务 JSON 与原生快速回复 JSON 也不能混用入口。

安装与启动

04 Windows 安装酒馆

使用 Windows 10 或 11。已经装好酒馆的读者跳过本节；不要把新安装覆盖到正在使用的文件夹。

1. 从 Node.js 官网选择当前 LTS，在页面下方预编译下载区选 Windows，下载 Windows Installer (.msi)。普通 Intel 或 AMD 电脑选 x64，ARM 电脑选 ARM64。再从 Git for Windows 官网安装 Git。本版酒馆要求 Node.js 20 或更新版本。

2. 在文件资源管理器中打开自己的普通文件夹，例如 D:\AI。不要选 Program Files 或系统目录。在顶部地址栏输入 cmd，按回车。
3. 复制下面一行，粘贴到黑色命令窗口，按回车。等下载结束，再打开新出现的 SillyTavern 文件夹。

留意　安装 Node.js 与 Git 时先沿用标准选项。装好后重新打开命令窗口；若 node 或 git 仍提示不存在，先检查安装结果，不要反复运行下载命令。Git 下载结束前不要关闭窗口。

git clone https://github.com/SillyTavern/SillyTavern -b release

4. 双击 Start.bat。扩展名隐藏时，它可能只显示 Start。首次会下载依赖，请保留命令窗口。正常启动后浏览器会打开酒馆。
5. 没有自动打开时，查看命令窗口里的访问地址，通常是 http://127.0.0.1:8000。把地址复制到浏览器地址栏，不要放进搜索框。

留意　按普通用户运行 Start.bat，不要使用“以管理员身份运行”。下载失败时先检查网络和报错；若提示文件夹已存在，换一个新的安装位置，不要直接删除旧目录。

安装与启动

05 macOS 与 Linux 安装酒馆

macOS 在“应用程序 → 实用工具”中打开“终端”。Linux 使用自己的终端。以下命令一行一行执行，看到新的输入提示后再执行下一行。

1. 先安装 Node.js 当前 LTS 和 Git。macOS 可使用 Node.js 官网安装包；在终端运行 git --version，若系统提示安装命令行工具，按系统提示完成。Linux 使用发行版支持的安装方式，并确认 Node.js 版本至少为 20。
2. 运行下面两行检查。它们应分别打印版本号；若出现 command not found，先完成相应软件安装。

node --version
git --version

3. 下面示例把酒馆放在用户主目录。若这里已有同名 SillyTavern，先换到另一个新目录，不要覆盖旧安装。

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

首次启动会安装依赖。浏览器没有自动打开时，使用终端显示的本机地址，通常是 http://127.0.0.1:8000。

cd ~/SillyTavern
bash start.sh

安装与启动

06 以后怎么打开、关闭和找回酒馆

安装只做一次；以后先启动酒馆服务，再打开浏览器。保存网页书签不能代替启动。

保留启动窗口，最小化即可。只关闭浏览器标签页，通常不会关闭酒馆服务；关闭服务后，网页会无法连接。要再次使用，重新启动后刷新页面。

127.0.0.1 和 localhost 都指当前这台设备。把电脑上的 127.0.0.1 地址直接发给手机，不会打开电脑里的酒馆。手机阅读本教程与手机访问酒馆是两件事；远程访问需单独配置，本教程不要求开启对外访问。

留意　网页显示空白资料时，先核对启动的安装文件夹、数据路径、端口及账号。不要通过反复安装来“找回”聊天，也不要删除旧 data。出现端口已占用时，先找已经运行的窗口与地址。

文字聊天

07 第一次打开与界面导航

首次打开按引导填写你的显示名称，例如“旅人”。这是聊天中扮演的用户名称，之后可以修改。界面语言不合适时，在用户设置中切换中文。

12345

图中标号：1 调回复参数；2 填文字接口；3 管世界书；4 安装扩展与打开正则；5 导入角色。鼠标停在图标上可以查看名称。

文字聊天

08 填写文字接口

本节适用于服务商明确提供 OpenAI 兼容接口的情况。若使用官方 Claude、Google AI Studio 等服务，应在来源中选择对应服务，按该服务要求填写。

留意　本节配置的是“文字聊天”。绘屿的 draw.20030313.xyz 地址和 nr_ 密钥用于绘图，请看选择绘图服务：绘屿与智绘姬接口；不要填到本节的聊天完成接口。

1. 点击顶部插头。API 选“聊天补全”，聊天补全来源选“自定义（兼容 OpenAI）”。
2. 把服务商给你的基础 URL 填入“自定义端点”，把文字密钥填入“自定义 API 密钥”。
3. 点击左下“连接”。模型选择留到下一节完成。

123

留意　不要把完整 /chat/completions 请求路径粘进去；酒馆会补上它。是否保留 /v1 以服务商给出的基础地址为准。文字密钥不能代替 NovelAI 绘图密钥。

文字聊天

09 选择模型并测试

能列出模型只说明模型列表请求成功。真正可聊天，需要选定一个模型并完成测试。

1. 展开“可用模型”，点击要用的模型。检查上方“输入模型名”是否同步成相同名称。
2. 如果列表为空，但服务商明确支持手动模型 ID，在“输入模型名”中粘贴准确 ID，注意大小写、标点和空格。
3. 点击“发送测试消息”。测试成功后再进入角色聊天。测试可能计费，不要连续重复点击。

12

如果列表显示很多模型，先选择一个服务商确认可用、额度充足的普通聊天模型。某个模型 403、404 或不可用时，换到同一服务商明确支持的模型再测；不要只看名称相似就判断可用。

留意　列表能打开却点不中：先关闭其他覆盖面板，刷新浏览器后重试；也可把列表中的准确 ID 手动填入模型名。每次都以模型名字段和一次实际测试为准。

留意　如果接口没有提供模型列表，但实际聊天支持手动模型 ID，列表为空不一定是密钥错误。“绕过状态检查”只适用于已确认实际请求正常、状态检测仍报错的情况；它不会修复失效密钥。

文字聊天

10 保存常用连接配置

经常换模型或服务时，用连接配置减少重复填写。先确认当前连接能正常使用，再保存。

1. 在插头面板找到“连接配置”。先保存好当前使用的对话预设和格式模板，再点“创建”。
2. 给配置起一个能辨认的名字，例如“常用文字服务”。创建窗口中核对模型、地址及关联项后保存。
3. 切换配置后，检查模型、来源和预设。修改了这些选择，记得点“更新”；要撤回临时选择，可重新加载已保存配置。

留意　连接配置可关联密钥选择和预设。切换后模型或预设“自己变了”，先查连接配置；不要把整份 settings 或连接备份当成普通角色附件分享。它也不会自动保存预设内部尚未保存的改动。

文字聊天

11 导入角色卡与选择开场白

角色卡来自附赠资源或你自行获取的文件。选择你想聊天的角色，不需要与截图中的名字相同。

1. 找到角色卡原始 PNG 或 JSON。压缩包先解压；不要把图片的后缀强行改成 PNG。
2. 点顶部最右侧“角色管理”，再点角色列表工具栏中的“导入角色”。选文件后按提示完成导入。
3. 点击导入的角色进入聊天。若作者提供多个开场白，在新聊天的第一条角色消息上切换候选开场白，再开始对话。

1

部分角色卡内置世界书或局部正则。导入时出现附加内容提示，先看卡的说明；导入结束仍需检查世界书关联和正则启用状态。已经内置的内容，不必再无差别重复导入一份。

留意　改了角色的第一条消息，不会自动改写旧聊天。要看新开场白，创建新聊天；旧聊天仍可在管理聊天中打开。只更换头像也不会更换人物设定。

文字聊天

12 读懂角色说明和配套要求

先看作者写的使用说明，再改人物设定。两类内容的用途不同。

1. 确认作者推荐的预设类型、世界书名称、必需扩展和使用顺序。没有要求的功能先保留默认。
2. 修改卡之前先导出或复制一份。尽量只改你明确理解的字段，避免把作者的格式规则删掉。
3. “我”的名字和身份在用户设定管理中填写。不要为了换自己的称呼，直接重命名 AI 角色。

文字聊天

13 设置你在故事里的身份

用户设定 Persona 决定你是谁；角色卡决定对方是谁。一个账号可以准备多个身份。

1. 打开顶部“用户设定管理”，新建并选中一个用户设定。填写名字和简短描述，头像可选。
2. 描述写与当前故事有关的身份，例如“成年旅人，第一次来到这座城市”。插入位置先保留“故事字符串 / 提示词管理器”；选“无”会停用描述注入。
3. 只想这段聊天使用该身份，关联到“聊天”；希望某张角色卡的聊天自动选中它，关联到“角色”；常用身份可以设为“默认”。

留意　切换身份不会自动重写历史消息的署名。若刷新后身份又变回去，先检查聊天关联和角色关联，而不是重复新建身份。

文字聊天

14 开始聊天与发送消息

选好角色和用户身份后，收起设置面板，在底部输入框写动作、对话或你希望推进的情节。

可以直接用自然语言，例如“我走到窗边，问她接下来准备去哪里”。不需要每次把角色设定重新复制一遍。想换行时通常用 Shift+Enter；是否按 Enter 发送，可在用户设置里调整。

流式传输会在生成中逐步显示文字；非流式会等请求完成后一次显示。生成尚未结束时先等待，想中止就用停止按钮，避免连点发送造成额外请求。

留意　更换文字模型可以保留当前聊天，但不同模型对角色和格式的理解可能不同。卡片开场白很短、历史一直是短回答，也会影响后续回复长度。

文字聊天

15 重试续写与新聊天

先分清这几个操作，避免为了换一句回复把整段聊天删掉。

留意　重新生成和继续通常会再次请求模型并消耗额度。编辑历史消息会影响之后的上下文，重要聊天先导出备份。

文字聊天

16 用分支保存不同剧情

想试另一个选择时，可以从某条消息分出一条聊天，保留原来的故事路线。

1. 找到分歧点那条消息，展开消息右侧“…”菜单。
2. 选择“创建分支”会复制截至该消息的聊天并切换过去；选择“创建检查点”会保存命名的副本，但不自动切换。
3. 继续在分支里聊天。需要回原路线时，用输入框左侧菜单的“回到父聊天”，或在“管理聊天”中选择原记录。

留意　分支不会自动合并回原聊天。JSONL 聊天导出保留可导回的数据结构；TXT 适合阅读，不能当作完整聊天备份。JSONL 也不包含图片和文件附件本体。

预设与回复长度

17 导入、切换与保存对话预设

附赠预设需要匹配当前 API 类型。聊天补全预设、文本补全采样预设和界面主题不能混用。

1. 先在插头面板确认 API 使用“聊天补全”。打开最左侧“AI 响应配置”，从“对话补全预设”旁的导入按钮选择相应 JSON。
2. 导入后确认下拉框选中它。检查模型是否变动，以及回复上限、上下文是否在服务支持范围内。
3. 修改参数或提示词后，点预设旁的保存按钮。想保留原版，先“另存为”一个新名称再修改。

12

留意　连接配置、同名角色与预设的自动选择，或预设关联连接的设置，都可能造成切换后配置变化。新手先用一个清楚命名的预设，暂不启用自己不需要的自动绑定。

预设附带“必需安装”或宏、noass、脚本配置时，仅导入预设还不算完成。按 先判断这张卡需要什么 和 特定预设的配套：Mermaid、ST-Archichat 与旧 JsRunner 补齐；内置正则与 SPreset 的区别见 导入助手脚本、SPreset 与脚本版 QR。

预设与回复长度

18 上下文、回复上限和 token

token 是模型处理文本的计量单位，不等于中文的字数。上下文越大，也不代表角色会永久记住所有聊天。

例如上下文设置为 8192、回复预留 2048 时，可用于输入的空间约为 6144 tokens；角色、用户设定、预设、世界书和历史都要一起占用它。实际还受服务端计算和额外开销影响。

降低输入负担可以减少等待和用量。把上下文解锁到超出服务能力的数值，不会扩容模型；反而可能报错。模型没有看到的早期情节，也不会因为网页仍能翻到它就自动记住。

留意　需要定位上下文构成时，在一条已生成的回复“…”菜单找“提示词明细 / Prompt Itemization”。它帮助检查本轮消耗，回答是否符合设定仍要结合实际输出判断。

安装助手后，聊天补全的上下文若自动变为 2,000,000，先检查 安装酒馆助手：先分清渲染与脚本 的“最大化预设上下文长度”。它减少酒馆侧的截断，并不增加模型容量；要手动限制输入，先关闭这一优化，再重新设置数值。

预设与回复长度

19 希望回复更长时这样调整

觉得回复太短时，先分清两件事：回复上限允许写多长，提示词要求写多详细。角色卡与当前问题也会影响长度。

1. 在导入、切换与保存对话预设所示的 AI 响应配置中调整最大回复长度。再向下找到提示词管理器，编辑 Main Prompt 或预设中的主提示词。
2. 明确写出期望，例如“需要展开场景时，尽量写 800–1200 字；不要为了凑字重复内容”。保存提示词，再保存预设。
3. 重新生成一次或开启新聊天比较。若仍很短，检查角色卡、作者注释和其他提示词中是否写了“简短”“最多两段”等相反要求。

留意　自然地结束但很短：先改写作要求。总在半句话中断：检查最大回复、服务商限制和上下文是否接近上限。某些推理模型还会消耗推理预算，不能按 tokens 与字数固定换算。

留意　部分接口提供“长度 / Verbosity”等额外选项，仅在对应模型支持时有效。它与最大回复预算不同；看得到该控件，不代表当前模型一定接受它。

预设与回复长度

20 温度与其他采样参数怎么处理

第一次使用保留匹配模型的预设默认值。采样参数影响生成的选择方式，不能补回丢失的设定。

某些模型会忽略或拒绝特定采样参数。遇到 unsupported parameter 一类报错，查看服务说明，恢复它支持的值或停止发送该参数。换预设、模型和参数后，一次只比较一项变化。

预设与回复长度

21 提示词条目、开关和两次保存

预设不只有参数，下面的提示词管理器还决定哪些内容被组织进本轮请求。不要为了精简而把角色、世界书或聊天历史条目全部关掉。

1. 在“AI 响应配置”向下找到提示词管理器。Main Prompt 一般用于主要写作要求，其他条目可能放角色描述、世界书、用户身份与历史。
2. 点条目铅笔编辑，保存编辑窗口；回到上方再保存整个预设。仅关窗口或只保存其中一处，切换预设后可能丢失改动。
3. 启用开关决定条目是否参与；新增条目还需要加入当前列表。入门先保留作者排列与插入位置，不随意拖动复杂预设。

留意　角色高级定义里的主提示词覆盖、作者注释、世界书和历史消息，都可能带有相反指令。改了主提示词仍没效果时，检查是否被其他来源覆盖或干扰。

预设与回复长度

22 提示词后处理什么时候需要改

它整理的是发给接口的消息格式，在模型生成之前执行。它与用正则清理回复的显示效果不同。

正常连接时先保留当前默认。若明确报“只允许一条 system”“第一条必须是 user”“消息必须交替”，再按服务商说明选相应方式。普通的 401、额度不足或超时，不靠调整后处理解决。

留意　标为“无工具”的变体不支持工具调用。依赖工具的卡或扩展需要同时核对后处理选项、预设中的函数调用开关以及模型能力。

预设与回复长度

23 作者注释：给当前剧情加提醒

聊天菜单里的 Author’s Note 是发给模型的额外指令；角色页的 Creator’s Notes 则是作者写给读者的说明。两者不要混淆。

1. 点输入框左侧三横线，打开“作者注释”。在当前聊天的输入框写简短、明确的提醒，例如当前地点、必须保持的语气。
2. 检查插入频率。0 表示不插入，1 表示每次用户请求都插入；位置和深度先保留作者或默认设置。
3. 切换到新聊天后重新核对。当前聊天的注释不自动搬过去；下方的默认注释才用于新聊天。

留意　角色卡已有完整格式规则时，避免再塞入一套互相冲突的长指令。作者注释也占上下文，常用来补充少量当前剧情事实。

预设与回复长度

24 思考区、正文和空回复

部分模型会推理，但是否返回可见推理文本、如何计入预算，由模型和接口决定。折叠思考区不会自动停止模型推理。

“AI 回复格式化”中的推理设置负责解析和展示支持的内容；预设中的“请求模型推理”“推理强度”等是请求参数。没有服务支持时，打开开关并不能强行得到推理文本。

如果出现 <think> 一类标签或正文被整段隐藏，先查是否同时启用了内置解析与第三方隐藏正则。使用与实际标签相匹配的一套规则，不要直接删除全部聊天。

留意　只出现思考、正文很短或空白时，检查回复预算、服务返回错误和参数支持。某些模型的推理也占输出额度；应在其允许范围内调整，不能固定按中文字数换算。

世界书与正则

25 导入世界书并辨认条目

世界书把符合条件的背景资料加入提示词。先导入，再明确它对哪个角色或聊天生效。

1. 打开顶部“世界书”，点击导入按钮，选择附赠或作者指定的世界书 JSON。
2. 在编辑下拉框选择这本书，展开一条条目。阅读正文、关键词、触发方式和启用状态。
3. 确认书名与角色说明中的配套书相符，再按下一节完成关联。只在编辑器里选中一本书，不会自动把它设为当前角色使用。

123

留意　条目标题和关键词帮助管理与触发，真正给模型的设定主要写在正文里。不要只在条目标题写重要设定。

世界书与正则

26 世界书的四种作用范围

优先采用角色作者指定的关联方式。同一本资料“导入成功”与“在当前聊天生效”是两步。

1. 在角色页点击世界书图标，选择对应的主世界书并确认。已经绑定后，普通点击可能直接打开编辑器；可从“更多 → 关联世界书”再次打开关联窗口。
2. 有额外配套书时按作者说明添加；不需要让全部附赠世界书都全局开启。
3. 换角色或新建聊天后，核对该范围是否仍适用。导出角色时通常只嵌入主世界书，额外书要另行保留。

12

世界书与正则

27 世界书为什么没有生效

关键词命中只是其中一个条件。先检查绑定与条目开关，再检查触发条件和预算。

从关联书中选一条明确的事实，检查正文和关键词是否匹配当前对话。中文关键词不匹配时，留意“匹配完整单词”及条目自己的覆盖设置。复杂卡的递归、延迟、黏性和冷却条件先按作者说明保留。

留意　把所有条目都改蓝灯，可能挤占聊天历史，还会让本不相关的设定同时出现。模型答对一句话也不等于已证明触发；必要时结合提示词明细和世界书溢出提示定位。

世界书全局设置在重载后被恢复时，检查 安装酒馆助手：先分清渲染与脚本 的“强制使用推荐的世界书全局设置”。需要自己调整扫描或预算时，先关闭这一项，再设置所需的值；不要反复只改世界书面板。

世界书与正则

28 看懂角色卡配套文件的关系

同一张角色卡可能同时使用预设、世界书和正则。按“文件进入哪里、对谁生效”来检查，比反复重新导入更容易找出问题。

一条典型路径是：角色设定、当前生效的世界书与聊天历史按对话预设组织 → 发送给文字模型 → 得到回复 → 显示用正则处理页面 → 智绘姬识别绘图标记并请求绘图。不同正则也可能作用在发给模型的文本上，不能把所有正则都当成纯显示设置。

1. 第三方卡优先遵守作者给出的配套说明，核对预设类型与世界书名称。
2. 每次只替换一项，再开新聊天测试。这样出现格式错误时能知道是哪项引入的。
3. 同时启用两套隐藏配图标记、替换开场白或修改输出格式的规则，可能互相影响；保留一套匹配的方案。

世界书与正则

29 导入正则并选对作用范围

正则是文本匹配与替换规则。附赠文件没有要求时不必额外安装；卡内置规则也先检查再决定是否重复导入。

1. 先选中相关角色或预设，再打开“扩展程序 → 正则表达式”。点击导入并选择对应 JSON。
2. 按作者说明选范围。局部作用于当前角色，预设范围跟随相应预设，全局则影响所有角色。
3. 确认范围总开关与规则自身开关已开启。若卡内已经有同一规则，不再全局导入一份。

留意　多个规则按顺序执行可能互相影响。发现配图标签消失或正文变空，先停用最近加入的规则，比较变化。

世界书与正则

30 正则显示异常时怎么检查

不用自己编写正则，也可以判断它是否处理了不该处理的内容。

1. 打开规则铅笔，进入“测试模式”，粘贴实际出现问题的一小段文本。
2. 对照输入和输出，检查是否把正文、闭合标签或 image### 标记一起匹配掉。
3. 先临时关闭有疑问的规则，再发送新消息比较；保留原始配置，确认后再修改。

配套插件与脚本

31 先判断这张卡需要什么

普通文字聊天可以不装第三方扩展；带互动界面、变量或自动化功能的资源，要补齐作者明确列出的前置。

这部分按资源需要查阅即可。当前卡没有额外依赖、只想添加插图时，可以直接跳到 安装智绘姬扩展。

先打开资源文件夹中的“必备操作”“使用说明”“配套插件”以及角色的作者说明。区分三件事：安装插件、导入配套文件、启用对应功能。只做第一步，按钮或状态栏仍可能不出现。

以下是本次附赠目录中实际读到的配套要求，不代表每张卡都需要这些插件，也不代表整套资源已逐一实测。以你下载版本的说明为准：

留意　最短顺序：文字连通 → 选好一套角色和预设 → 读配套说明 → 安装要求的扩展 → 导入脚本 / 正则 / 世界书 → 启用并检查。不要把多套预设的自动化功能一起打开。

配套插件与脚本

32 扩展的安装、刷新与更新

Windows、macOS 的浏览器操作基本一致；Git 和酒馆运行在你的电脑或托管服务器上。

12

1. 先点“管理扩展程序”，搜索或查看是否已有同一扩展。整合包可能已预装；不要在“所有用户”和“当前用户”各装一份。
2. 没有安装时，返回并点“安装扩展程序”。复制下文给出的完整仓库地址，只填地址，不带中文说明或多余引号。
3. 版本 / 分支栏没有作者要求就留空。安装范围优先遵循资源作者说明；未指定且独自使用时选“只给我安装”。“给所有人安装”放在全用户扩展目录，托管酒馆可能只有管理员可选。
4. 若弹出第三方来源提示，核对仓库所有者和名字，再确认安装。等待成功提示，然后刷新酒馆页面。
5. 展开新插件的设置，按对应章节打开需要的功能。有些插件还要另导入脚本、配置或回复集。

123

Git 报错或一直安装中：先看酒馆启动窗口的报错，确认安装酒馆的机器能访问仓库且已安装 Git。浏览器能打开 GitHub，不等于运行酒馆的终端或云服务器也能下载。云酒馆没有安装按钮时，交由该服务管理员处理。

更新前先按 保存聊天与更新前备份 备份，记录目前能用的版本。再到“管理扩展程序”使用更新入口，完成后刷新并检查当前卡。作者要求固定版本时，先核对其升级说明；不要同时更新所有组件后才排错。直接复制 ZIP 安装的扩展通常不能靠 Git 自动更新，需按作者说明手动替换。

留意　本章的普通前端扩展不要求连接 localhost:5100，不需要为了它们安装已停止维护的 Extras，也不需要开启服务器插件开关。单独涉及后端的增强版另看作者说明。

配套插件与脚本

33 安装酒馆助手：先分清渲染与脚本

酒馆助手既能显示交互式前端，也能运行配套脚本。这是两条不同的功能路径。

https://github.com/N0VI028/JS-Slash-Runner

1. 按 扩展的安装、刷新与更新 安装并刷新。作者要求 SillyTavern 1.13.0 或更高；本章界面核对使用 1.19.0。已有助手时先检查版本。
2. 在“扩展 → 酒馆助手”展开设置。如果卡需要 HTML 前端，进入“渲染”并确认“启用渲染器”开启。
3. 如果资源给的是“酒馆助手脚本-….json”，转到“脚本”按下一节导入。渲染开关不能代替脚本开关。
4. 回到该角色，按作者指定的开场和操作检查面板。已显示为可交互界面，说明这一部分渲染成功；变量能否更新仍取决于脚本和世界书。

12

安装后再看一次“酒馆助手 → 优化”。核对的 4.11.3 中，下面三项默认开启，会改变酒馆原有设置；它们不是单纯加速界面的按钮。若当前资源作者要求这些行为，按其说明保留；需要自己控制相关设置时，先关闭对应优化，再回到原面板调整并保存。

123

留意　关闭优化不等于自动还原安装前的值，仍需回到对应面板检查。上下文数字变大也不是免费额度增加；若实际发出的内容更多，可能增加用量，超过接口限制还会报错。

前端仍是一大段代码时，先检查配套正则是否启用、代码块是否完整、当前楼层是否在渲染深度内。先等本次文字生成结束，再判断显示结果；“允许流式渲染”属于实验功能，不是所有卡的必需项。

留意　酒馆助手与小白 X 可以承担不同任务。若同一代码块出现重复界面、空白或按钮异常，按作者推荐保留对应渲染路径，再逐个停用重叠功能对照。不要为了停用助手渲染，连带关闭仍被 MVU 等依赖的整个助手。

配套插件与脚本

34 导入助手脚本、SPreset 与脚本版 QR

“扩展已安装”不等于“脚本已运行”。导入位置、库开关和单个脚本开关都要对应。

1. 先打开要使用的角色，并选中相应对话预设，再进入“扩展 → 酒馆助手 → 脚本”。
2. 点“导入”，选择目标脚本库，再选择作者提供的助手脚本 JSON。也可从指定库内操作；不同版本按钮排列会变化。
3. 没有特殊说明时：只属于这张卡的功能放角色脚本；只属于这套预设的放预设脚本；作者明确要求常驻的功能才放全局脚本。
4. 本次核对的助手 4.11.3 会把新导入脚本设为关闭。核对名称和说明后，启用所属脚本库以及脚本本身；如在文件夹内，还检查上级文件夹是否启用。
5. 回到聊天，检查作者说明中的按钮、面板或状态是否出现。导入卡自带脚本时也可能弹出启用确认；已内置的脚本不再额外导入同一份。

12

SPreset 处理的是按该脚本约定打包的预设正则，并不保证识别任意预设文件。若作者另附正则，先检查是否已自动装入，避免手动再加一套。手动导入后按资源要求绑定与保存。

留意　脚本会在浏览器中运行，可能读写当前角色、聊天，或发起请求。只启用你信任且确实需要的脚本；按钮没有显示时，先查作用范围与启用状态，不要连续重复导入。

配套插件与脚本

35 小白 X：渲染、循环任务与配套按钮

一些预设明确要求 LittleWhiteBox。酒馆助手不是它的通用替代品，应使用资源作者指定的组件。

https://github.com/RT15548/LittleWhiteBox

1. 按 扩展的安装、刷新与更新 安装。作者当前文档还提供 GitCode 下载源，GitHub 无法访问时从下方作者文档进入，不自行拼接陌生镜像。
2. 先确认作者要求哪一款渲染器。需要小白 X 显示界面时，打开“扩展 → 小白X → 渲染交互”，确认“启用小白X”和“渲染开关”已勾选。若同时装有助手，检查它的渲染开关；只有任务需要小白 X 时，不必同时开启它的渲染。
3. 按作者要求导入配套正则。小白 X 的基础渲染处理代码围栏中的 HTML、!DOCTYPE、script 内容；输出不是完整的此类代码块时，不会按预期呈现。配套正则可能负责把回复整理成这类代码块。
4. 资源明确带“沉浸式模板”时，在当前角色的模板设置中编辑或导入作者提供的模板，再启用该功能。普通 HTML 渲染不要求随便选一套模板。
5. 如果说明要求任务、四次元壁或剧情总结，到对应“循环任务”“数据互动”页配置。任务 JSON 从循环任务自己的导入入口进入，再核对全局 / 角色 / 预设范围。

某些旧说明提到“封装函数”。当前 3.2.2 界面已不单列同名复选框；不要照旧截图四处寻找。STscript 等桥接函数、模板格式和变量系统要以资源对应版本为准，旧脚本报错不能靠打开所有功能解决。

留意　只有当前资源确实要求的模块才启用。额外总结、任务和自动画图可能另发模型请求；看到两个自动生成入口时，先确认各自用途和触发条件。

配套插件与脚本

36 快速回复：导入后还要加入使用范围

QR 是快捷按钮的常见叫法，但原生回复集、助手脚本按钮和小白 X 任务不是同一种文件。

1. 使用原生回复集时，打开“扩展 → 快速回复”，勾选“启用快速回复”。这是酒馆内置扩展，无需另找下载仓库。
2. 在“编辑快速回复”一行点击导入图标，选回复集 JSON。导入后在编辑下拉框能看到它，只说明文件已载入，还要做下一步。
3. 在“聊天快速回复集”或“角色快速回复集”旁点“+”，选中该集合；确需所有聊天使用时才加入“全局快速回复集”。
4. 确认对应集合的 Buttons / 显示按钮已勾选，回到输入框查看按钮。先读按钮内容或说明，确认它会填字、发送、执行命令，还是发起额外生成。

123

按钮点一次就自动发送，通常是该集合的行为；希望先填入输入框，查看“禁用发送（插入输入字段）”，但带脚本命令的集合仍应遵循作者要求。自动执行、消息后触发等选项不要在不了解用途时全开。

配套插件与脚本

37 MVU 变量卡：把框架、世界书与界面配齐

状态栏出现了，不等于变量框架已经正常更新。MVU 通常通过酒馆助手脚本运行，不是填进“安装扩展”的独立插件。

1. 先安装助手，再导入角色。检查角色脚本中是否已经带 MVU、变量框架或运行核心；已有的按提示启用，不再全局额外加载另一份。
2. 作者另附助手脚本 JSON 时，按 导入助手脚本、SPreset 与脚本版 QR 导入到指定范围。只有作者明确给出新建脚本和代码的方式，才按其完整步骤操作。不要把 bundle.js 当作 JSON 导入。
3. 导入并关联该卡配套世界书、正则和指定预设；若说明要求 EJS，再装提示词模板。保持作者给出的变量更新格式。
4. 在保留旧聊天的前提下，用该卡的新聊天和指定开场检查初始化。完成一轮正常回复后，观察应当变化的状态项；必要时在助手变量工具查看当前聊天或消息变量，常见数据字段为 stat_data。

名含 [InitVar] 的世界书条目可以由框架读取作为初始值，即使它在世界书中是关闭状态。不要因为看见灰色开关，就把初始化和所有变量条目都改成常驻。是否启用、何时执行，以这张卡的框架版本为准。

留意　旧卡与新卡可能使用不同变量更新语法和数据结构。不要只把框架换成“最新”却保留旧更新规则，也不要同时跑两套写入同一变量的框架。不要直接重置旧聊天的变量，这可能丢失已有进度；先导出备份，再按作者的迁移说明操作。

配套插件与脚本

38 EJS 提示词模板：让动态设定真正执行

角色或世界书若使用 <% … %>、<%= … %>、<%- … %> 等动态模板，通常还需要 Prompt Template。助手渲染与 EJS 处理不是同一功能。

https://github.com/zonde306/ST-Prompt-Template

1. 按 扩展的安装、刷新与更新 安装并刷新，在扩展面板找到“提示词模板”。
2. 确认“是否启用扩展”开启；需要处理发送给模型的动态设定时，检查“生成时执行 EJS”。其余注入、楼层渲染、兼容模式等按资源说明设置。
3. 选择对应角色和世界书，发起正常对话后，用酒馆的提示词查看功能，或资源作者指定的日志入口检查发送内容。应该得到具体文本或变量值，而不是未处理的模板代码。
4. 如果报某变量不存在，先回查 MVU / 其他变量框架是否完成初始化和世界书是否关联，再检查模板；不是看到 EJS 报错就删掉所有模板标签。

“允许处理代码块”不是新手必开项：作者提示它可能与其他渲染扩展冲突。带 [GENERATE:BEFORE]、[GENERATE:AFTER] 等条目的卡，还可能依赖兼容模式所决定的世界书启用规则，按原说明核对，不把所有条目一律打开。

留意　“先处理原始内容”会把处理结果写回聊天记录，永久改变消息内容，而不只是改变显示。作者说明推荐开启，但实际使用前先导出聊天，并核对当前卡是否要求它；关闭开关不能撤销已经改写的消息。EJS 运行的是 JavaScript，只使用可信来源的模板，也不要为了修复某张卡无差别开启每个执行选项。

配套插件与脚本

39 特定预设的配套：Mermaid、ST-Archichat 与旧 JsRunner

这些扩展承担不同工作。旧说明里的名称或地址可能已变化，不能看到“脚本插件”就全部换成酒馆助手。

Mermaid：本次附赠“蛾摩拉”的说明指向这个官方扩展。按通用流程安装下面地址并刷新；它将标记为 mermaid 的代码块显示成图表。若只看到原始图表代码，检查扩展是否启用以及内容格式是否正确。它不负责运行酒馆助手脚本或更新 MVU 变量。

https://github.com/SillyTavern/Extension-Mermaid

Acheron：旧说明写 ST-Diff，要求分别导入 ST-Diff-macros.json 和 ST-diff-noass-acheron-gmn3.0.json。核对时该旧仓库已重定向到 ST-Archichat；作者把 noass 和自定义宏功能保留在新名称下，世界书对比功能另行拆分。寻找的是宏和 noass 功能，不能只凭旧名字选一个“世界书对比”插件。

https://github.com/il1umi/ST-Archichat

1. 仅在该预设明确要求时，安装 ST-Archichat 并刷新，打开“扩展 → 对话规则构筑扩展”面板。已有旧版时先备份配置并查看迁移说明。
2. 将附带的宏 JSON 从“宏”模块的“导入配置”导入；将 noass JSON 从“noass → 配置模板 → 导入”导入。两份都不是聊天补全预设。
3. 选中导入的配置，按原说明启用对应模块并保存。旧配套配置不保证与每次更新完全兼容；出现导入失败时，先找作者对应版本，不用空白配置替代后宣称完成。

1

1

留意　noass 会处理发送给模型的对话结构。切换到不需要这套规则的预设时，也检查并停用对应全局模块，避免规则继续影响其他聊天。

旧 JsRunner：本次“明月秋青”和“CRYCHIC”的配套文档指向下面 bincooo 的项目。它与 N0VI028/JS-Slash-Runner 是两个项目。按原说明安装后，在它自己的 Add / 新建脚本入口粘贴附带“插件脚本.txt”的完整内容，再 Save / 保存。不要把这份文本直接导入助手的 JSON 导入器。

https://github.com/bincooo/SillyTavernExtension-JsRunner

留意　上述旧 JsRunner 配套文档自行标注“没更新”，本教程未验证它们的整套运行兼容性。另有 Liminal 旧说明指向 o7xYU/carrot，2026-10-29 核对时原地址无法取得可用仓库；请向资源作者寻找新版说明，不随意改用同名 fork。

配套插件与脚本

40 数据库、记忆与整合包：按文件类型拆开导入

这里的“数据库”常指故事记忆或表格管理功能，不等于要在电脑上另装数据库服务器。

附赠“酒馆助手脚本-星河璀璨·数据库.json”“数据库-v2.json”在本次检查中属于助手脚本格式。另一些整合包还同时带世界书、正则、运行核心和检查器；文件都叫 JSON，入口仍然不同。

1. 完整解压同一版本的整合包，先找说明列出的文件清单。不要把几个不同作者、不同日期的“数据库”拼成一套。
2. 按说明先装运行环境，再导入功能脚本，最后导入配套世界书与正则。需要手动初始化时，只对指定的新聊天执行。
3. 打开数据库或表格面板，确认当前角色和聊天正确；再检查作者说明中的读写功能是否工作。能打开空面板并不代表模型已经在持续填写。

留意　自动总结、自动填表可能额外调用模型并改写记忆。先按作者设置触发频率，不与另一套记忆脚本重复处理同一聊天。重置或清空表格前导出当前数据；不会使用的整合包可以暂时跳过。

没有明确原作者地址和版本要求时，本教程不指定一个通用“数据库必装插件”。确切依赖应以该包说明和实际文件结构为准，不能仅凭“数据库”“AVS”名称推断兼容。

配套插件与脚本

41 鸡尾酒：需要时再加的性能优化

本教程核对的是 Lianues/cocktail。它改善部分界面操作，不能替代助手、变量框架，也不会增加模型额度或保证更快生成。

https://github.com/Lianues/cocktail

需要时可按 扩展的安装、刷新与更新 使用仓库地址安装。作者也提供手动安装方法：把完整 cocktail 文件夹放入 SillyTavern/public/scripts/extensions/third-party/，目录中应直接有 manifest.json、index.js、modules 和 style.css，再刷新并启用。两种方式选一种，避免重复目录。

1. 先确认角色的基础功能正常，再添加性能优化。管理扩展里保留内置 Regex 启用，鸡尾酒的清单声明了此依赖。
2. 打开“扩展 → 鸡尾酒”，按需要查看启动加载、聊天渲染、正则刷新等模块。当前版本还有面板与拖拽相关选项；截图展示模块位置。
3. 一次只调整一类优化并回到聊天检查。前端卡显示异常、正则改了未刷新或旧楼层加载不正常时，先停用对应优化模块；必要时停用整个扩展并刷新作对照。

留意　鸡尾酒+ 包含独立前端和可选服务器插件，后端功能可能涉及服务器文件、配置和重启。新手完成当前卡的基础体验不需要它；不要为了解决 API 连接或变量错误而安装 Plus。

配套插件与脚本

42 插件问题按这张表排查

先确定是“没装好”“没启用”“没配齐”还是“功能重叠”。每次只改一个因素，保留原聊天。

1. 保留当前聊天和配置，在新聊天中复现一次。先确认普通文字连接正常，再查这张卡要求的组件。
2. 记下刚安装或刚更新的插件，暂时关闭它的相关模块；必要时到“管理扩展程序”停用该项并刷新。若依赖它的卡无法运行，改用简单角色检查基础连接。
3. 需要求助时提供酒馆版本、插件版本、角色 / 预设名称、操作步骤与第一条相关报错。Windows 可用 F12 或 Ctrl+Shift+J 打开浏览器控制台；macOS Chrome 可用 ⌘+⌥+J。先遮住密钥、私人聊天和完整鉴权请求。

先看连接提示出现的位置：“（已弃用）扩展 API”区域的“未连接…”属于旧 Extras 服务；聊天输入框的“未连接到 API”才提示文字接口未连通。变量卡不工作也不一定是模型不支持，应按具体功能定位。

智绘姬插图

43 安装智绘姬扩展

文字聊天已经正常后，再加智绘姬。它负责把画面描述交给绘图服务，不会自动赠送绘图额度。

1. 打开“扩展程序”，点击“安装扩展”。把下面作者仓库地址填入安装窗口。
2. 选择只为当前用户安装，等待完成后刷新酒馆。若之前已经安装，去“管理扩展”检查版本，不要再复制一份。
3. 刷新后通过智绘姬入口或画笔悬浮按钮打开设置。首次出现欢迎引导时按界面完成；可选的 AI 助手设置可以先关闭。

https://github.com/damoshen123/st-chatu8

留意　首次引导里的“AI 助手 API”与“NovelAI 绘图 API”不是同一处。下一节先进入主要设置，再到 NovelAI 页填绘图凭据。只安装自己信任来源的扩展。

智绘姬插图

44 先启用最少的功能

本教程先使用 NovelAI 绘图，保持手动点击生成，便于确认哪一步成功。

1. 进入智绘姬“主要设置”，打开“启用插件”。模式选择 NovelAI。
2. 客户端先保留“浏览器”，视频渠道选择“无”。
3. 往下找到自动化设置，先关闭“自动点击生成”“自动 LLM 请求生图”和“流式预生成”。先成功得到一张图后，再按自动配图与每次配图数量开启需要的自动化。

浏览器客户端会从浏览器发起请求。若服务出现跨域错误，先核对服务是否支持这种接入方式；“酒馆”客户端的要求需按扩展说明确认，不能通过关闭浏览器安全功能来解决。

智绘姬插图

45 选择绘图服务：绘屿与智绘姬接口

绘屿已提供 NovelAI 兼容绘图接口。智绘姬只需填写 https://draw.20030313.xyz/api 和 nr_ 密钥；下面按网页体验、插件接入、脚本调用三种用法说明。

A. 先认识绘屿：网页即用，也能让酒馆自动插图

本店可选绘图服务 · 推广

无限制创作，让酒馆剧情有画面

为角色画一张立绘，为剧情配一幅插画。网页即用、免部署，画廊配方一键载入；随用随充，1 元起体验，付款自动发密钥。

打开绘图网站 ↗千寻购买点数 ↗闲鱼购买点数 ↗查看网站使用指南 ↗

1 元 / 100 点 · API 点数另购
网页绘图与智绘姬直连已可用；先手动测试，再开启自动插图。

留意　这是本店可选的绘图服务推广。酒馆入门资料与绘屿点数分别购买；不购买绘屿也可以继续学习本教程。绘屿是独立服务，不代表 NovelAI 官方。按实际请求扣点，“无限制创作”不表示无限张免费出图。

1. 打开上方“千寻购买点数”或“闲鱼购买点数”，选需要的套餐。1 元为 100 点，高档套餐含加赠（80 元为 10,000 点）；每笔订单获得一个新的 nr_ 开头站内密钥。请保存密钥，不要发在公开群里。
2. 打开绘图网站，进入“点数与密钥”，粘贴完整密钥，点“使用此密钥”。先确认显示了余额，再进入绘图页面。
3. 到“画廊”挑选喜欢的画风卡片，查看配图和参数后载入配方；画廊会继续增加内容，不限于当前展示的几组。
4. 填写主体描述，例如“成年女探险家，蓝色披风，在海边书店读信，暖色夕阳，竖构图”。配方负责画风，主体描述负责画什么。
5. 第一次选 V4.5、832×1216、28 步、不加图片参考。点击前核对本次点数报价，确认后生成；等待期间不要连续重复提交。
6. 生成完成后下载 PNG 原图。在酒馆打开目标聊天，通过输入框附近的图片/附件入口选择这张 PNG 并发送。部分主题把入口收在左侧菜单中；如看到“附加文件”和“嵌入图片”，选择图片入口。图片只是插入聊天，不会自动变成角色卡或让后续回复自动出图。

当前套餐：随用随充，高档加赠

上表为到账点数，已包含加赠，闲鱼与千寻额度一致；点数不等于固定出图张数，实际费用以提交前报价为准。

离线完整指南：余额与密钥合并 →

B. 在智绘姬直连绘屿：只填地址和密钥

https://draw.20030313.xyz/api

7. 打开智绘姬的主要设置，绘图渠道选择 NovelAI。
8. 站点选择第三方/其他站点，客户端选择浏览器端。把上表 API 地址粘贴到站点地址框，把 nr_ 密钥粘贴到 API Key 框。地址不要加 /v1，不要选择官方登录。
9. 模型先选 V4.5 Full；设置 832×1216、28 步、1 张，关闭人物参考、氛围参考和 SMEA。
10. 按第 51 节手动出一张普通风景或角色图，确认图片出现在聊天里。本站“我的作品”也会留下记录，普通 V4.5 此设置扣 1 点。
11. 手动成功后再配置 LLM 连接和提示词预设，让它读取剧情；然后按第 52 节设置触发方式与自动生成数量。LLM 费用由你的文字模型服务计费，绘屿点数只用于图片。

留意　插件直接按本站规则扣点，不弹出网页的报价确认。普通 ≤1MP、28 步内、无图片参考时 V4.5 为 1 点，V5 为 5 点。高步数、图生图、人物参考明显更贵；首次使用这些参数请先在网页查看同参数报价。批量、多于 1MP、SMEA 和局部重绘尚不支持，会在扣点前报错。

留意　网络超时后先看“我的作品”。10 分钟内相同密钥、参数和固定种子的成功请求会复用原图，不重复扣点；想画新图请换种子。智绘姬种子 0 每次可能换成新的随机数，因此连续重新发送可能被视为新图。密钥余额不足时先充值或合并额度。

以下三步仅适用于改用 NovelAI 官网账户或其他服务商。使用绘屿时保持上面的第三方站点与 nr_ 密钥，不要切到官网。

12. 点击智绘姬左侧 NovelAI。使用 NovelAI 官网账户时选“官网”，在账户设置中按官方说明取得持久 API Token。
13. 使用明确提供 NovelAI 兼容绘图服务的其他站点时，选“其他站点”，填写它给出的绘图地址与绘图密钥。不要把文字接口地址复制过来。
14. 云端队列先保持关闭。密钥输入后保持隐藏显示。

留意　不要把 API 密钥发给售后群、放进角色卡或一起打包出售。导出设置前检查是否包含密钥；教程中的截图不包含任何密钥。

C. 进阶：服务端脚本的异步 API（插件用户可跳过）

本段给需要脚本调用的人；只用网页出图可以跳过。基础地址为 https://draw.20030313.xyz。密钥放在 Authorization 请求头，格式为 Bearer nr_你的密钥，不能放进公开链接。本段保留报价后确认的异步流程；智绘姬直接使用 B 部分的兼容接口，不需要自己轮询任务。

本文件夹的“09_绘屿Studio_绘图服务”中附有 huiyu-example.mjs。电脑已安装 Node.js 20 或更新版本后，在该文件所在文件夹打开终端，运行下面这一行。程序会让你粘贴密钥（不显示输入）、输入画面描述，然后显示报价；只有输入 yes 才会生成。默认最多接受 1 点，避免误用付费参考或高步数。

node huiyu-example.mjs

// 绘屿 Studio：Node.js 20+ 单张绘图示例。默认只接受不超过 1 点的报价。
// 这是独立的站内 API 示例，不是 SillyTavern / 智绘姬插件。
import { writeFile } from 'node:fs/promises';
import { createInterface } from 'node:readline/promises';
import { Writable } from 'node:stream';
import { pathToFileURL } from 'node:url';
import { randomUUID } from 'node:crypto';

export const exampleRequest = {
  model: 'nai-diffusion-4-5-full',
  prompt: 'a small lighthouse on a quiet ocean at sunrise, watercolor illustration, no people',
  negative: 'lowres, blurry, text, watermark',
  width: 832, height: 1216, steps: 28, scale: 5, cfg_rescale: 0.2,
  sampler: 'k_euler_ancestral', noise_schedule: 'karras',
  quality: 'none', negative_preset: 'none', seed: null,
};

export async function draw({ key, request = exampleRequest, maxPoints = 1,
  confirm, onJob = () => {}, base = 'https://draw.20030313.xyz',
  fetchImpl = fetch, sleep = ms => new Promise(r => setTimeout(r, ms)), timeoutMs = 10 * 60_000 }) {
  if (!key?.startsWith('nr_')) throw new Error('请使用购买后收到的 nr_ 站内密钥。');
  const headers = { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' };
  async function api(path, body, extra = {}) {
    const response = await fetchImpl(base + path, { method: body === undefined ? 'GET' : 'POST',
      headers: { ...headers, ...extra }, body: body === undefined ? undefined : JSON.stringify(body),
      signal: AbortSignal.timeout(45_000) });
    const data = await response.json();
    if (!response.ok) throw new Error(`请求失败（${response.status}）：${data.error || data.message || '请查看网站任务记录'}`);
    return data;
  }
  const quote = await api('/v1/quote', request);
  if (!Number.isFinite(quote.total) || quote.total > maxPoints) {
    throw new Error(`报价 ${quote.total} 点，超过本示例的 ${maxPoints} 点上限；未提交任务。`);
  }
  if (!await confirm(quote)) return null;
  // 不自动重发提交请求。网络中断时先检查网站任务记录，避免再次购买一张图。
  const job = await api('/v1/generate', { request, quoted_points: quote.total, price_version: quote.version },
    { 'Idempotency-Key': `guide_${randomUUID()}` });
  await onJob(job.id);
  const deadline = Date.now() + timeoutMs;
  let current = job;
  while (current.state !== 'succeeded') {
    if (['failed', 'cancelled', 'unknown'].includes(current.state)) {
      throw new Error(`任务状态：${current.state}。请在网站查看任务与点数记录，不要连续重复提交。`);
    }
    if (Date.now() >= deadline) throw new Error('等待超时，但任务可能仍在运行。请到网站查看；本程序不会重新提交。');
    await sleep(2000);
    current = await api(`/v1/jobs/${job.id}`);
  }
  const image = await fetchImpl(`${base}/v1/jobs/${job.id}/image`, {
    headers: { Authorization: `Bearer ${key}` }, signal: AbortSignal.timeout(60_000),
  });
  if (!image.ok) throw new Error('图片下载失败，请到网站任务记录下载已完成的图片。');
  return { id: job.id, points: quote.total, image: Buffer.from(await image.arrayBuffer()) };
}

async function main() {
  let hidden = false;
  const output = new Writable({ write(chunk, encoding, done) { if (!hidden) process.stdout.write(chunk); done(); } });
  const rl = createInterface({ input: process.stdin, output, terminal: !!process.stdin.isTTY });
  try {
    console.log('绘屿 Studio · 单张 API 示例\n默认 V4.5 / 832×1216 / 28 步。先报价，再确认。');
    let key = process.env.HUIYU_API_KEY;
    if (!key) {
      process.stdout.write('粘贴 nr_ 站内密钥后回车（不显示输入内容）：');
      hidden = true;
      try { key = await rl.question(''); } finally { hidden = false; process.stdout.write('\n'); }
    }
    const prompt = (await rl.question('画面描述（直接回车使用海边灯塔示例）：')).trim();
    const request = { ...exampleRequest, ...(prompt ? { prompt } : {}) };
    const result = await draw({ key: key.trim(), request,
      confirm: async q => (await rl.question(`本次报价 ${q.total} 点。输入 yes 确认生成，其他输入取消：`)).trim() === 'yes',
      onJob: async id => {
        await writeFile('huiyu-last-job.txt', `任务：${id}\n网站：https://draw.20030313.xyz/\n网络中断请先查看任务记录，不要反复重跑。\n`);
        console.log(`任务已提交：${id}，等待出图……`);
      },
    });
    if (!result) { console.log('已取消，未提交绘图任务。'); return; }
    const file = `huiyu-${result.id}.png`;
    await writeFile(file, result.image);
    console.log(`图片已保存：${file}\n本次 ${result.points} 点。可把 PNG 作为图片附件发送到酒馆聊天。`);
  } catch (error) {
    console.error(error.message);
    process.exitCode = 1;
  } finally { rl.close(); }
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) await main();

留意　提交会产生真实绘图任务和对应点数扣费。报价超限、没有输入 yes 时不会提交。遇到超时先去网站查看任务与点数记录；程序保存的 huiyu-last-job.txt 只有任务编号、不含密钥。普通浏览器跨域脚本不是本示例的运行方式。

智绘姬插图

46 选择绘图模型与档位

先选择服务商确认支持的模型，再点“重置当前模型为官网默认”。截图使用 V5 Full，不能把这组参数照搬到所有模型。

智绘姬插图

47 尺寸步数与种子

第一次只生成一张图，用简单场景检查连接。图片大小和生成参数会影响请求耗时与额度消耗。

要比较画风或引导强度，尽量保持模型、尺寸、采样器和固定种子一致，每次只改一项。更换模型后先恢复该模型默认值，避免遗留不兼容参数。

智绘姬插图

48 设置画风与负面提示词

固定提示词适合写每张图都希望保留的画风。每一轮的具体人物、动作和场景应放在当轮画面描述里。

1. 在 NovelAI 页展开“固定提示词”，将下面的正面示例填进“固定正面提示词”。“后置固定正面提示词”先留空。

watercolor illustration, soft lighting, detailed background

2. 把负面示例或作者提供的负面串填入“固定负面提示词”。若当前模型档位不支持自定义负面词，先按选择绘图模型与档位核对能力，再决定是否换档位。

blurry, watermark, extra fingers

留意　长画师串不是越长越好。先用短串通路，再少量加入兼容的标签；正负面不要互相抵消。数值权重语法和负权重支持范围随模型版本变化，复制前先核对。

智绘姬插图

49 保存画风并区分配置档案

把试好的画风保存为独立预设，之后可以切换，也可以导出给自己备份。

1. 点“提示词预设”右侧九宫格按钮，打开“预设操作收纳盒”。
2. 第一次保存选择“另存为”，命名“海风书店画风”。之后修改同一预设时再点“保存”。
3. 切换到其他画风再切回来，确认正负面内容仍然存在。

12

同一页还有“配置档案”，用于保存当前模式的另一组配置。不要把“文字对话预设”“提示词预设”和“配置档案”当成同一份文件。切换后检查实际字段，尤其是模型与凭据。

智绘姬插图

50 让文字回复带出配图标记

智绘姬需要先得到画面描述。本教程采用同一条文字回复携带标记的简单方式，暂时不用额外 LLM 转写。

1. 确认标记仍为图中这组默认值。回到文字模型的主提示词，在原有说明末尾追加下面规则，保存。
2. 保持自动点击关闭，开启一段新聊天，让角色描述书店窗边场景。等文字回复完整结束。

在每次回复正文结束后，额外给出恰好 1 段当前场景的英文绘图标签。
格式必须是 image###英文标签###。
标签写在普通文本中，不要使用代码块，不要解释标签。
每段只描述一个画面，先写场景和光线，再写主体与动作。

image###cozy bookshop, rain outside the window, warm lighting, wooden bookshelves###

留意　角色卡自带配图规则时先核对格式，避免追加一套相互冲突的规则。模型可能漏写标记；“要求 1 段”是提示词约束，不是绝对数量开关。

智绘姬插图

51 手动生成第一张插图

先确认标记被转换成按钮，再点一次“生成图片”，最后等待绘图服务返回图片。三个阶段分别检查。

留意　使用绘屿的读者：先完成第 45 节 B 部分，在智绘姬配置第三方站点 /api 地址与 nr_ 密钥。先用 V4.5、28 步、832×1216、不加图片参考测试一张；成功后再调其他参数。

1

1. 如果只看到 image### 原文，检查总开关、标记拼写、是否误放在代码块内，以及正则是否先隐藏了它。等待新回复完整结束再观察。
2. 看到按钮后确认模型和凭据已填好，点击一次“生成图片”。等待期间不要连点。
3. 成功时聊天中会出现返回的图片。若报错，按配图问题分三段检查检查绘图请求；文字能聊天并不代表绘图接口一定可用。

留意　本版实测中，直接编辑旧消息不一定立即转换标记；一次新回复生成结束后才完成处理。因此首次操作使用新回复。实际出图需要你自己的有效绘图服务与额度，本教程没有代替你验证该服务。

智绘姬插图

52 自动配图与每次配图数量

一张手动图成功后，再逐步自动化。先保留每次回复 1 段配图标记，避免一次产生太多请求。

留意　先确认智绘姬已通过绘屿成功手动出图，再按本节开启自动触发。绘图地址和 nr_ 密钥负责出图；读取剧情并写提示词的 LLM 连接需要另外配置。开启自动触发后会按生成次数扣点，建议先限制每轮 1 张。

1. 想自动提交已经识别的绘图标记时，开启“自动点击生成”，然后用一条新回复测试。
2. 想改为每次 2 张，把让文字回复带出配图标记提示词中的“恰好 1 段”改成“恰好 2 段，每段描述不同画面”。先保持手动模式核对数量，再开启自动。
3. 不希望本轮出图时，可关闭自动点击并不点按钮；若不希望输出标记，暂时停用主提示词中的配图规则。

本路线的图片数量由有效标记段数与实际提交次数决定。模型漏写、多写、服务失败重试都可能改变结果，所以它不等于原生的“每轮固定 N 张”承诺。先用 1 张更容易控制额度。

留意　“自动 LLM 请求生图”是另一条会额外调用文字模型的路线；“流式预生成”可能在回复未结束时请求图片。本教程的基础路线不需要这两项。

日常使用

53 让页面更好读、更少误操作

用户设置主要改变界面体验。字体、背景和主题不会提高模型本身的能力。

1. 打开“用户设置”，调整字号、聊天宽度、背景透明度。导入主题从主题入口操作，改好后保存主题。
2. 输入时容易误发，可调整“Enter 发送”模式；经常误点编辑，可关闭“点击编辑”；保留删除确认有助于避免误删。
3. 聊天很长导致滚动卡顿时，减少一次加载的历史消息条数。它只影响页面绘制，不等于让模型少记或多记。

留意　界面中文不代表模型一定回复中文；这要在角色或提示词中表达。不要为了让某张卡显示图片而统一关闭所有媒体限制，先确认该卡需要什么来源或扩展。

已安装酒馆助手时，还要核对它的“禁用不兼容选项”优化：这一项会自动关闭“禁止外部媒体”等设置。若希望自己决定媒体限制，见 安装酒馆助手：先分清渲染与脚本 的对应说明。

日常使用

54 完成配套后，再考虑额外功能

把当前卡的必要组件配齐即可。主题、美化、记忆增强和性能优化可以逐项增加。

如果还没判断角色需要哪些前置，从 先判断这张卡需要什么 开始。没有明确要求的扩展，不用为了“装全”一次启用。

留意　同一功能优先保持一套明确的处理流程。主题、正则美化与渲染扩展叠加后若异常，先回到原主题，再逐项排查。语音和 Live2D 不属于本教程的必要组件。

日常使用

55 长聊天、失忆与剧情总结

聊天保存在本机，不等于每轮都能全部发送给模型。长对话要兼顾历史、人物设定和背景资料。

1. 先检查当前模型的上下文上限和实际设置，观察是否出现上下文截断或世界书溢出。
2. 把与当前剧情无关的全局世界书、重复规则和过长固定说明减掉。想保留的事实可以整理成短总结，再由你核对名字、时间和关系。
3. 把稳定世界设定放进合适的世界书；临时剧情提醒可用当前聊天的作者注释。需要换新聊天时，先备份原记录，再带入核对过的摘要。

留意　摘要同样会占 token，也可能漏掉细节。自动总结、向量检索等扩展还涉及额外设置或模型请求；基础路线先用简洁的人工核对摘要即可。

排错与备份

56 文字问题按现象排查

每次只改一个设置，再发一条短测试。报错中的 HTTP 状态码通常比“没反应”更有用。

需要别人帮忙时，提供：酒馆版本、系统、服务类型、模型 ID、操作步骤、状态码与已隐藏密钥的截图。聊天内容只提供与问题有关的一小段。

排错与备份

57 配图问题分三段检查

先判断失败发生在标记识别、请求发送还是图片返回，避免只靠更换画师串排错。

新手回退路径：关闭自动化 → 恢复当前模型默认参数 → 用一段简单书店场景标记 → 手动提交一张。成功后再逐项恢复画风与其他功能。

排错与备份

58 附赠文件与界面问题排查

导入失败先辨认文件，不要通过修改后缀或覆盖数据目录强行修复。

排错与备份

59 保存聊天与更新前备份

浏览器里的聊天界面只是入口，实际数据通常在运行酒馆的电脑上。把网页加入书签不能代替数据备份。

日常先保存可迁移文件：聊天优先导出 JSONL，角色、世界书、预设和正则从各自入口导出。JSONL 不能代替图片、附件及全部配置的备份。

1. 更新前停止酒馆，复制实际 data 目录和 config.yaml 到带日期的独立位置。全用户安装的第三方扩展还需保留 public/scripts/extensions/third-party；自定义数据路径以真实路径为准。
2. 使用 Git 安装且没有自己改源码时，Windows 可运行安装目录的 UpdateAndStart.bat；macOS / Linux 在原安装目录执行下面命令，再启动。
3. 遇到本地修改、冲突或更新失败，先停下保留报错，不使用强制重置。恢复备份时也先保留当前数据副本。

git status
git pull --ff-only

ZIP 安装不能直接当 Git 仓库更新。按官方迁移说明把新版放进另一个文件夹，再迁移数据；不要把整个旧 public 目录覆盖过去。智绘姬等扩展的更新也需单独检查。

留意　完整 data 备份可能含密钥与聊天，仅供自己恢复；不作为附赠资料发送。聊天截图展示正常，也不能证明所有扩展图片已经备份，重要插图另存一份。

插件更新前还要导出其自身配置：助手全局脚本、角色 / 预设所带脚本、原生 QR 集、小白 X 任务 / 模板，以及数据库内的重要状态。角色或预设的导出不保证包含全局配置。完整 data 与全用户扩展目录的备份可作为恢复底稿。

资料与版本

60 版本、资料与阅读范围

本教程独立编写，使用自行截取的软件界面；第三方教程用于查漏，技术步骤以官方资料和本版实际界面为依据。

基础部分核对：SillyTavern 1.19.0 / 智绘姬 3.1.7（2026-10-25）。插件增补核对日期：2026-10-29；独立环境中打开并截图了酒馆助手 4.11.3、小白 X 3.2.2、提示词模板 1.17.9、鸡尾酒 0.1.17，并通过扩展安装器验证了 ST-Archichat 的安装及宏 / noass 配置入口；同时核对原生快速回复与扩展管理界面。版本会更新，这些是核对时的记录，不是要求锁定的统一版本。

基础安装器截图来自官方网站；示例 API 地址、demo 模型名只用于展示填写位置，不能直接用作你的服务配置。插件截图来自独立教学环境，不含真实服务密钥。

插件章节结合附赠说明及文件结构、作者仓库与文档、隔离环境的实际控件编写。依赖扫描仅用来找线索，不能证明每份资源都兼容；未逐一执行全部附赠脚本、未验证所有角色与预设的完整效果。旧 JsRunner 套件和失效地址已在对应章节注明。

已核对导入、关联、保存、正则和绘图标记识别等操作。截图中的文本为教学演示；实际付费文字回复和图片生成效果未作服务测试，需要你的有效账号、模型与额度。

参考阅读：中文快速入门帮助安排最短上手路径；Opizontas 教程帮助发现界面讲解缺口。正文没有沿用其中的固定模型名单、统一拉满上下文建议，或将请求后处理解释为回复清理的说法。

附赠角色卡、世界书与预设单独提供，以附件说明为准。本 HTML 不含 API 密钥、私人聊天或附赠文件的内嵌副本。变量框架对相应变量卡可能是必要依赖，已在本章新增指引；Live2D、语音和远程部署仍不属于基础文字与智绘姬插图的必需步骤。

留意　本教程为独立教学资料，非 SillyTavern、NovelAI 或扩展作者的官方出品。界面变化后可沿本节及各章节资料链接核对。

绘屿补充内容更新：2026-10-29，站内服务版本 0.5.0。接口按智绘姬作者公开代码与当前已安装版本核对。/api/ai/generate-image 返回 PNG ZIP，/api/ai/encode-vibe 返回编码；报价、重复请求复用、失败退款和权限边界已测试。在线功能与扣点以绘屿使用指南为准。