这个网站使用 Astro 框架构建，采用了 Firefly 模板，Firefly 是基于 Fuwari 的二次开发。
Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。
🖥️在线预览： Firefly - Demo site
📝Firefly使用文档： https://docs-firefly.cuteleaf.cn
⭐Firefly开源地址：https://github.com/CuteLeaf/Firefly
⭐Fuwari开源地址：https://github.com/saicaca/fuwari
]]>宏是写在卡里的占位符。酒馆在发给 AI 之前（以及显示消息时）把它们换成实际内容。最常用的是 {{user}} 和 {{char}}。
| 宏 | 换成什么 | 例子 |
|---|---|---|
{{user}} | 玩家当前用的名字 | 「{{user}}推开门」→「小明推开门」 |
{{char}} | 当前角色的名字 | 「{{char}}抬起头」 |
{{random::晴::雨::雪}} | 每次随机取一个 | 天气随机 |
{{pick::晴::雨::雪}} | 随机取一个，但同一个聊天里固定不变 | 开局随机身份 |
{{roll::1d20}} | 掷骰子 | 判定 |
{{getvar::名字}} | 读聊天变量 | 好感度 |
{{time}}、{{date}} | 现在的时间、日期 | 现实时间问候 |
{{// 这是注释}} | 什么都不输出 | 给自己写备注 |
MVU 变量卡还会用 {{get_message_variable::stat_data.路径}} 读变量，见 mvu-statusbar。
角色卡是给所有人用的。如果你在卡里写死「小明」，别人用时 AI 就会管他叫小明。所以：
{{user}}；{{char}}。多角色卡（一张卡里好几个人）里 {{char}} 只是卡名，具体人物还是写名字更清楚。<USER>、<BOT>、<CHAR>（不分大小写）当成旧式宏，自动换成名字。你在界面代码里写了 <user> 这类标签，会被吃掉，见 pit-macro-escape。\{、\} 前面的反斜杠删掉（这是给「想原样写出双花括号」准备的转义）。代码里的 \{ 会变成 {。{{a:1}} 这种嵌套写法），可能被当成宏处理。中间加个空格最保险。{{user}}，通常是卡里示例写法教坏了它。现象：界面里的 <user> 标签变成了玩家名字；规则里写的「{{user}}」示例被替换掉了；代码里的双花括号莫名其妙变了样。
酒馆会在很多地方做宏替换：角色描述、开场白、世界书、预设，以及正则替换后的结果。除了 {{user}}、{{char}} 这类宏，还有几个老写法也会被替换：
| 写法（不分大小写） | 被替换成 |
|---|---|
<USER> | 玩家名 |
<BOT>、<CHAR> | 角色名 |
<GROUP>、<CHARIFNOTGROUP> | 群聊成员 / 角色名 |
所以界面标签起名叫 <user>、<char>，会被直接换成名字。
<User>...</User> 这样的标签：标签名被换掉，正则匹配不到；{{user}} 这个写法」：AI 看到的是名字；{{random::...}} 却希望每次结果固定：random 每次都重新抽，固定的要用 {{pick::...}}。<玩家>、<主角>、<player_info> 等；\{\{user\}\}，酒馆会去掉反斜杠，保留花括号；{ { 或拆开写，最保险；{{user}} 会变成名字，这通常是想要的，但写在代码里就要小心；EJS 是一种「带条件的文字」写法：同一个世界书条目，可以根据变量输出不同的内容。比如好感度低时发「她对你很戒备」，高了才发「她开始信任你」。
酒馆本身不认识 EJS，要装提示词模板扩展（ST-Prompt-Template）。没装的话，<% %> 会原样发给 AI，既没效果又浪费 token。
1<% if (getvar('stat_data.沈清.好感度') >= 60) { %>2沈清已经把{{user}}当成可以托付的人，会主动说起家里的事。3<% } else { %>4沈清对{{user}}仍有防备，只谈铺子里的事。5<% } %><% %> 里写判断，不会输出；getvar('路径') 读变量，MVU 卡的变量在 stat_data 下，见 mvu-schema。%> 少一个，整条内容都会出问题。改完一定在酒馆里试；「AI 味」就是一读就知道是 AI 写的那种文风。卡里的文字会成为 AI 模仿的范本，所以卡本身没有 AI 味，聊天时 AI 味才会少。
| 毛病 | 例子 |
|---|---|
| 高频套话 | 「仿佛」「不禁」「一丝」「嘴角勾起一抹弧度」「眼中闪过一丝」 |
| 比喻堆砌 | 一段话三个「像……一样」 |
| 总结升华 | 每段结尾都来一句「这一刻，他终于明白了……」 |
| 对话工整 | 每个人说话都是完整书面句，没有口头禅、没有打断 |
| 情绪直说 | 「她感到非常难过」而不是写她做了什么 |
| 结构八股 | 环境描写 → 动作 → 对话 → 心理，每段都一样 |
| 万能温柔 | 不管什么人设，最后都变得体贴、包容、治愈 |
「创作者的注释」是写给玩家看的，不会发给 AI。玩家导入卡后在角色信息里能看到。好的说明能省掉一大半「怎么用不了」的提问。
1【简介】民国经营 + 慢热恋爱，你扮演沈家铺子新来的账房。2【需要】酒馆助手（状态栏、选项按钮）。3【导入后】41. 弹窗问是否允许正则、脚本时选「是」；52. 弹窗问是否导入世界书时选「是」；63. 开新聊天，左右滑动第一条消息可以选开局。7【推荐】Claude / Gemini，预设不要禁止覆盖主要提示词。8【更新】v1.1 修复状态栏不显示，请开新聊天。角色描述是卡里最重要、每轮都发的部分。它决定 AI 把这个角色演成什么样。
| 项目 | 写什么 | 例子 |
|---|---|---|
| 基本信息 | 姓名、年龄、身份 | 沈清，二十二岁，沈家绸缎庄的大小姐 |
| 外貌 | 两三个有辨识度的特征 | 总穿旧了的月白旗袍，左手戴一只银镯 |
| 性格 | 用行为表现，写清矛盾面 | 嘴上刻薄，但伙计生病会偷偷塞钱 |
| 说话方式 | 语气、口头禅、句子长短 | 说话短，爱用反问；生气时反而更客气 |
| 过去 | 只写影响现在行为的部分 | 父亲破产后自杀，她不信任任何「好心人」 |
| 和 {{user}} 的关系 | 怎么认识、现在怎么看对方 | 认为{{user}}是债主派来的眼线 |
| 目标 / 动机 | 角色现在想要什么 | 想在年底前保住铺子 |
有的卡把人设也全放进世界书（常驻条目），描述留空或只放一句摘要。效果差不多，关键是不要两边各写一遍，重复内容既占 token 又可能前后矛盾。
{{user}}，见 macros；示例对话是给 AI 看的「说话样本」：角色在什么情况下会怎么说话。比起在描述里写「说话刻薄」，给两段真实对话效果好得多。
每一段以 <START> 开头，下面一行一句，用 {{user}}: 和 {{char}}: 标出谁在说：
1<START>2{{user}}: 账我对完了，去年少了三百块。3{{char}}: 少了？（她终于抬起头）你知道上一个这么说的人现在在哪吗？4<START>5{{user}}: 你吃饭了吗？6{{char}}: ……关你什么事。（停顿）厨房还有半碗粥，自己去热。<START> 表示「这是一段新的示例」，酒馆发送时会换成对应的分隔格式。
酒馆的「用户设置 → 聊天/消息处理 → 示例消息行为」有三个选项：
| 选项 | 效果 |
|---|---|
| 逐渐推出（默认） | 上下文够就发；聊天记录长了会把示例挤出去 |
| 始终包含 | 一直发 |
| 永不包含 | 不发 |
所以默认情况下，示例对话主要影响开头的几十轮，后面聊天记录本身就成了样本。
角色卡的「高级定义 → 提示词覆盖」里有两个框：
卡里写了主要提示词，酒馆默认会用它替换预设的主要提示词。但以下任一情况，卡里的就不生效：
很多流行预设会禁止覆盖或者干脆不用主要提示词，所以别把关键设定只放在这里，见 pit-char-prompt。
在卡的主要提示词里写 {{original}}，会在那个位置放回预设原来的主要提示词。这样你可以在预设的基础上追加，而不是整个替换：
1{{original}}2本卡为多人群像，每次回复聚焦一到两个角色。<options> 标签」「不要替{{user}}说话」。角色卡有两种通行格式：V2 和 V3。你平时不用管它们的区别，但遇到「导入失败」「导入后内容不对」时，知道一点会好排查。
chara_card_v2）：用得最久、最通用。所有内容放在 data 里，卡内世界书叫 character_book。chara_card_v3）：在 V2 基础上扩展，加了资源列表、多语言创作者注释等。新版酒馆都能读。两者的核心字段（描述、开场白、世界书……）基本一样，V3 卡在不支持它的旧工具里通常也能当 V2 读。
PNG 图片除了像素，还能带「文字附件」（技术上叫文本块）。角色卡把整份内容编码后放进文字附件：
chara；ccv3。酒馆读卡时优先读 ccv3，没有才读 chara。酒馆自己保存卡时两个都写。
chara 没改 ccv3，酒馆读的是 ccv3，于是「怎么改了不生效」。用正规工具重新导出一次即可。卡片页「更多操作」里有 「往返校验」：把卡导出再读回来，逐个字段对比，见 app-export。
聊天里的状态栏、选项按钮、信息面板、彩色对白，统称「卡片前端」。它们不是 AI 画出来的，而是酒馆用正则把 AI 输出的文字「换装」成界面。
<options> 列出三个行动选项」；所以一个前端功能通常由「一条说明条目 + 一条显示正则 + 一条清理正则」组成。
| 方式 | 是什么 | 需要什么 |
|---|---|---|
| 直接替换成 HTML | 正则把标签换成带样式的文字，酒馆直接显示 | 只要允许这张卡的正则 |
| HTML 代码块 | 正则换成一个包含完整网页的代码块，酒馆助手把它渲染成小窗口 | 还要装酒馆助手，并且开着「启用渲染器」 |
酒馆助手只渲染内容里含有 <html、<head> 或 <body 的代码块。代码块里没有这些标记，它就原样显示成代码。
stat_data）、文字状态栏或酒馆变量，见 mvu-statusbar；<body> 之类的标记，或者开了「在响应中显示标签」，见 pit-show-tags；' 这类写法被酒馆提前还原了，见 pit-code-entity；开场白是聊天的第一条消息。它的作用远不止「打个招呼」：AI 会照着开场白的文风、人称、篇幅往下写。开场白写成什么样，后面的聊天大概就是什么样。
一张卡可以有很多条开场白，玩家在聊天第一条消息上左右滑动切换。用途：
MVU（MagVarUpdate）是运行在酒馆助手上的变量框架。有了它，角色卡能「记住」好感度、金钱、时间、位置、物品这些数值和状态，而不是全靠 AI 从聊天记录里猜。
AI 只能从聊天记录推断状态。聊久了，旧消息被挤出上下文，AI 就忘了「现在几点」「身上还有多少钱」，数值也会前后矛盾。
有了 MVU，状态被明确存起来，每轮都告诉 AI 当前是多少，AI 只需要说「变了多少」。
stat_data）；变量是按楼层存的：每条 AI 消息都带着那一刻的变量。所以删掉、重新生成一条消息，变量会跟着回到上一楼的状态。
详细见 mvu-install。
zod 版（有变量结构校验）和经典版（没有校验），见 mvu-zod-vs-classic。
只是聊天陪伴、没有数值玩法的卡，不需要 MVU，加了反而让 AI 每轮多写一段命令。
MVU 卡比普通卡多依赖几样东西。缺一样，变量就不动、状态栏就不出来。
酒馆顶部「扩展程序」→「安装扩展程序」，填入酒馆助手的仓库地址：
1https://github.com/N0VI028/JS-Slash-Runner装好后刷新页面，扩展面板里出现「酒馆助手」，确认它是开着的。
导入 MVU 卡后会弹两个窗口：
点错了也能补救，见 pit-allow-scripts。
MVU 本体和变量结构工具不在卡里，卡里只有一行「去这个地址加载」。地址一般在 jsdelivr 上，加载失败 MVU 就不工作，见 pit-cdn。
MVU 在聊天开始时读取初始变量。旧聊天、没有 MVU 时开的聊天，变量是空的。
zod 版 MVU 卡多一个「变量结构」脚本，规定每个变量是什么类型、取值范围、默认值。每次 AI 更新变量后，MVU 都按它校验，写错的会被修正或拦下。
1const Schema = z.object({2 沈清: z.object({3 好感度: z.coerce.number().transform(v => _.clamp(v, 0, 100)).prefault(20),4 当前心情: z.string().prefault('戒备'),5 }).prefault({}),6 主角: z.object({7 金钱: z.coerce.number().prefault(0),8 背包: z.array(z.string()).prefault([]),9 }).prefault({}),10})| 写法 | 作用 |
|---|---|
z.object({...}) | 一组变量 |
z.coerce.number() | 数字；AI 写成 “12” 这样的文字也能转成数字 |
z.string() | 文字 |
z.boolean() | 真假 |
z.array(...) | 列表 |
z.enum(['上午','下午','夜晚']) | 只能是这几个值之一 |
.transform(v => _.clamp(v, 0, 100)) | 超出范围自动拉回 0～100 |
.prefault(值) | 缺这个变量时用的默认值 |
以 _ 开头的变量约定为只读，更新规则会告诉 AI 不要改，比如 _最大体力。
z.number() 不带 coerce：AI 偶尔写成字符串就校验失败；初始变量就是开局时变量的值。MVU 在聊天开始时读取它，存进第一条消息。
一条世界书条目，标题里带 [initvar]，内容用 YAML 写：
1沈清:2 好感度: 203 当前心情: 戒备4主角:5 金钱: 3006世界:7 时间: 第一天 上午开场白里可以写一段 <initvar> 块，只写需要不同的部分，覆盖条目里的初始值：
1<initvar>2世界:3 时间: 第三天 夜晚4沈清:5 好感度: 506</initvar>这样「初遇」和「重逢」两条开场白，就有各自的初始好感度。
[值, "说明"] 的形式，说明会一起给 AI 看。好感度: 二十 不是数字，后面的加减就会出错；AI 每轮在回复末尾输出一段更新命令，告诉 MVU 哪些变量变了。现在推荐的写法是 JSONPatch。
1<UpdateVariable>2<Analysis>3- time passed: half a day4- 沈清.好感度: user helped with accounts, +35</Analysis>6<JSONPatch>7[8 { "op": "delta", "path": "/沈清/好感度", "value": 3 },9 { "op": "replace", "path": "/世界/时间", "value": "第一天 下午" }10]11</JSONPatch>12</UpdateVariable><Analysis>：AI 先分析哪些变量该变，提高准确率；<JSONPatch>：真正的命令，一个 JSON 数组。| op | 作用 | 例子 |
|---|---|---|
| replace | 设成新值 | 时间改成「下午」 |
| delta | 数字加减，负数是减 | 金钱 -50 |
| insert | 加一个新键，或往列表里加一项 | 背包里加「钥匙」 |
| remove | 删掉一个键或列表里的一项 | 用掉了「钥匙」 |
| move | 把一个值挪到另一个路径 | 物品从背包移到仓库 |
/ 开头，一级一级写变量名：/沈清/好感度；/主角/背包/0；-：/主角/背包/-。1_.set('沈清.好感度', 20, 23);//帮忙对账意思是「从 20 改成 23」。还能用，但容易写错，新卡建议用 JSONPatch。注意结尾的分号不能少。
更新规则告诉 AI 每个变量什么时候变、变多少。它是一条常驻的世界书条目，标题常带 [mvu_update]。规则写得越具体，AI 改得越稳。
1变量更新规则:2 沈清.好感度:3 范围: 0~1004 含义: 0~30 戒备，31~60 熟悉，61~85 信任，86 以上 依赖5 增加: 被认真倾听、帮她解决铺子的麻烦 +1~36 减少: 被敷衍、被冒犯、提起她父亲 -2~57 check: 只看本轮发生的事，单轮变化不超过 58 世界.时间:9 格式: 第N天 上午/下午/夜晚10 check: 按剧情推进，睡觉后进入下一天| 项目 | 为什么 |
|---|---|
| 范围 | 防止越界 |
| 含义 | 让 AI 知道数值对应的状态，演得出差别 |
| 增加 / 减少的条件 | 什么事件会改变它 |
| 幅度 | 防止一轮涨爆 |
| 格式 | 文字类变量要写清格式，不然每次写法都不一样 |
这几条最好放在 @D 浅深度，或者顺序设大，保证不被预算挤掉。
先设计变量表，再依次写变量结构、初始变量、更新规则、状态栏，全部直接写进卡，中间不停。适合想快速出一个能玩的版本。
变量表、规则、状态栏写完后先停下给你确认：在清单里点开看、可以改，满意再采用，见 app-drafts。变量结构和初始变量直接由变量表生成，不再问模型。适合变量多、想每步把关。
状态栏是显示在 AI 回复末尾、展示当前变量的小面板。
<StatusPlaceHolderImpl/>（MVU 会自动补上）；所以状态栏刚出来时会先显示「正在读取变量……」，一两秒后变成真实数值。
| 类型 | 原理 | 优点 | 需要 |
|---|---|---|---|
| 网页状态栏 | 代码块 + 脚本读变量 | 好看、能做进度条和标签页 | 酒馆助手 |
| 文字状态栏 | 正则直接用宏显示变量 | 简单、不依赖脚本渲染 | 只要正则 |
文字状态栏里用 {{get_message_variable::stat_data.沈清.好感度}} 这样的宏读值。
开场白（第 0 楼）末尾也要写 <StatusPlaceHolderImpl/>，否则第一屏没有状态栏。
' 这类写法提前还原，破坏代码，见 pit-code-entity；MVU 卡通常带这几条正则，分工明确：
| 正则 | 作用 | 选项 |
|---|---|---|
| 状态栏 | 把消息末尾的占位换成状态栏界面 | 仅影响显示 |
| 隐藏占位 | 发给 AI 时去掉占位 | 仅影响后端提示词 |
| 隐藏更新命令 | 发给 AI 时去掉历史里的更新命令 | 仅影响后端提示词 |
| 折叠更新（生成中） | 显示时把正在输出的命令折起来 | 仅影响显示 |
| 折叠更新（已完成） | 显示时把命令折成可展开的小块 | 仅影响显示 |
每条 AI 回复末尾都有一段更新命令，聊几十轮就是几十段。全发给 AI：
有的卡会把历史里的更新命令全部删掉（也有卡用最大深度只处理最近几楼）。当前变量已经由变量列表条目每轮发给 AI，不需要靠历史。
更新命令是给程序看的，玩家看到一大段 JSON 很出戏。折叠后玩家想看可以点开。
标题带 [mvu_plot] 的条目放「根据变量推进剧情」的内容。变量只是数字，剧情推进条目让数字真正改变故事。
不需要额外扩展，直接写清条件，让 AI 看着当前变量决定：
1剧情推进:2 - 当 沈清.好感度 >= 60 且尚未发生时，安排她主动提起父亲的死3 - 当 主角.金钱 < 0 时，下一个场景债主上门简单可靠，但 AI 偶尔会忘记或提前触发。
装了提示词模板扩展后，可以用 EJS 让不满足条件的内容根本不发出去，见 ejs：
1<% if (getvar('stat_data.沈清.好感度') >= 60) { %>2沈清已经信任{{user}}，会在深夜主动说起父亲的事。3<% } %>更精准、更省 token，但玩家必须装扩展。
<% 代码；变量设计好了，后面的规则、状态栏都顺；设计乱了，AI 改错、状态栏对不上、检查报一堆错。动手前花几分钟想清楚。
只做会影响剧情或玩法的变量：
一张卡 5～15 个变量比较合适。超过 20 个，AI 每轮分析都很吃力。
1沈清:2 好感度: 203 信任: 104 当前心情: 戒备5主角:6 金钱: 3007 体力: 1008世界:9 日期: 民国二十三年 三月初一10 时间: 上午11 地点: 沈家铺子_ 开头表示只读：比如 _最大体力，规则会告诉 AI 不要改。| 类型 | 适合 | 注意 |
|---|---|---|
| 数字 | 好感度、金钱、体力 | 写清范围，比如 0～100 |
| 文字 | 心情、地点、时间 | 写清可选值或格式，比如「上午 / 下午 / 夜晚」 |
| 真假 | 是否已结识、任务是否完成 | 写清什么时候变 |
| 列表 | 背包物品、已知线索 | 写清怎么加、怎么删 |
MVU 卡出问题，按「从外到内」查：先看框架有没有跑起来，再看 AI 有没有输出命令，最后看命令对不对。
MVU 本体没加载起来。依次检查：
| 现象 | 原因 | 办法 |
|---|---|---|
| 回复末尾没有更新命令 | 输出格式条目没发出去 | 确认它常驻、没被预算挤掉 |
| 改了又被改回去 | 变量结构的范围或类型拦下了 | 放宽结构，或在规则里写清范围 |
| 只有部分变量更新 | 规则太笼统 | 写具体的触发条件 |
<initvar> 写错：它会覆盖条目里的值。| 按钮 | 用途 |
|---|---|
| 重新处理变量 | 重新读最新一条回复的命令 |
| 重新读取初始变量 | 按当前初始变量重置 |
| 重试额外模型解析 | 用额外模型解析时重来一次 |
| zod 版 | 经典版 | |
|---|---|---|
| 写法 | 多一个「变量结构」脚本：const Schema = z.object({...}) | 只有初始值和规则 |
| 校验 | 每次更新后按 Schema 校验，类型不对会被拦下 | 不校验，写错了就错着 |
| 数值钳制 | Schema 里可写范围（如好感度 0~100），超出自动修正 | 只能靠规则里叮嘱模型 |
| 缺省值 | 初始值缺的键由 Schema 默认值补 | 全靠初始值写全 |
| 兼容性 | 需要较新的 MVU 与酒馆助手 | 老版本也能用 |
| 适合谁 | 新卡、变量多、在意稳定 | 改老卡、变量很少 |
两种都要求模型用 mvu-jsonpatch 输出更新。
registerMvuSchema：zod 版；[值, "说明"]：多半是经典版。[值, "说明"] 会被当成列表，类型对不上；卡做完了，发出去之前在酒馆里走一遍这个清单。大部分「别人用不了」的问题都能提前发现。
现象：卡里写了系统提示（主要提示词）或历史后置指令，但点「提示词」按钮一看，发出去的还是预设里的内容。
卡里的系统提示是用来替换预设里「主要提示词」的。替换要同时满足这几个条件，缺一个就不替换：
| 条件 | 在哪看 |
|---|---|
| 用户设置开着「角色卡提示词优先」 | 用户设置 → 角色处理（默认开） |
| 预设的主要提示词没有勾「禁止覆盖」 | 预设的提示词列表，编辑主要提示词 |
| 预设的主要提示词是开着的 | 预设的提示词列表，开关状态 |
历史后置指令同理：对应「首选角色卡指令」设置，以及预设里的历史后置指令块。
很多流行预设为了保证自己的效果，会关掉主要提示词或勾上禁止覆盖，这时卡的系统提示就白写了。
玩家：在预设里取消「禁止覆盖」，或换一个不禁止的预设。
写卡时：
{{original}} 保留预设原来的内容，只在前后补充自己的，见 card-system-prompt；点 AI 回复上的「提示词」按钮，找最前面的系统消息，看是卡里的内容还是预设的。
现象：状态栏不出来、标签和更新命令全露在外面、美化不生效、输入框上方没有 MVU 的按钮。
卡里自带的正则和脚本有安全风险，酒馆和酒馆助手默认不会自动运行，导入时会弹窗问：
| 弹窗 | 管什么 |
|---|---|
| 酒馆：是否启用这张卡的局部正则 | 卡里的正则 |
| 酒馆助手：「是否现在就启用它们?」 | 卡里的脚本（MVU、按钮等） |
点了「否」就不生效。正则的弹窗每个角色只问一次，群聊里不弹。
正则：
脚本：
改完后刷新页面或重新进入聊天。
现象：MVU 卡状态栏一直「正在读取变量……」，输入框上方没有 MVU 的按钮；有的界面一片空白。同一张卡，有人能用、有人不能用。
有些代码不在卡里，而是卡里写了一个网络地址，用的时候临时下载：
如果玩家的网络访问不了这个地址（网络限制、地址被墙、服务临时故障），代码就没下载下来，功能直接失效，而且通常不会有明显的报错提示。
现象：状态栏、面板在 App 里预览一切正常，导入酒馆后却卡在「正在读取变量……」，或者一片空白；打开浏览器控制台能看到脚本语法错误。
酒馆助手渲染的界面，代码是放在消息的代码块里的。酒馆在把消息转成网页时，会把代码块里的 HTML 转义写法提前还原一层：
| 代码里写的 | 被还原成 |
|---|---|
' | ' |
" | " |
< / > | < / > |
& | & |
如果代码里本来就有这些写法（比如一个 JS 字符串 '''），还原后变成 '''，整段脚本语法错误，什么都不执行。
常见来源：转义函数、拼 HTML 的代码里经常需要写 <、'。
'&' + '#39;'，或者 '\x26#39;'；'，就写 &#39;。SyntaxError；现象：正则替换后，「$100」变成了空白或奇怪的数字；状态栏里的价格消失；界面代码里有一段莫名其妙变成了整段消息原文。
在正则的「替换为」里，$ 加数字表示捕获组：$1 是第一个括号里的内容，见 regex-groups。酒馆会把替换内容里所有 $数字 和 $<名字> 都当成捕获组处理：
$100 被当成第 100 个捕获组，不存在，变成空；$$ 不会变成一个 $。'$1' 这样的字符串，比如 JS 的字符串替换 s.replace(/(a)/, '$1')；$ 开头的变量名，后面紧跟数字。${...}、$(...) 这类写法不受影响，因为 $ 后面不是数字。
$ 写成 $，网页显示出来就是 $；＄ 或「美元」；$ 紧跟数字，比如 JS 字符串替换改用函数写法 s.replace(/(a)/, (m, a) => a)；$：在查找规则里 $ 表示「结尾」，要匹配美元符号本身得写 \$。现象：导入卡后，设定好像都没起作用；打开世界书面板，找不到这张卡的世界书，或者角色没有绑定世界书。
卡里自带的世界书，导入时酒馆会弹窗问要不要导入。点了「否」或者直接关掉，世界书就没有导入。而且这个弹窗每张卡只问一次，之后不会再问。
另外：
打开这个角色 → 角色面板上的「…」更多菜单 → 「导入角色卡的世界书」。导入后，酒馆会生成一本同名世界书，并绑成这个角色的主要世界书。
导入后检查：
玩家导入新版卡时，如果已经有同名世界书，酒馆会提示将覆盖同名世界书，选是就用新版替换旧版。所以：
现象：开场白或美化里引用的网络图片显示不出来，或者顶部提示「外部媒体被禁用」；用网络字体、背景图的样式没生效。
酒馆的用户设置里有「禁止外部媒体」，默认开着。开着时：
url(https://...) 的背景图、字体）被去掉。这是为了防止卡片借图片偷偷访问外部网站（比如记录你的 IP）。
现象：开场白或正则里写的 HTML 排版全乱：多出空白、一半变成代码框、文字变成斜体、点击按钮没反应、样式不生效。
消息显示前，酒馆会先把文字当 Markdown 处理，再做安全过滤。直接写在消息里的 HTML 会被这两步改动：
| 写法 | 结果 |
|---|---|
| HTML 中间有空行 | 被拆成几段，结构断开 |
| 行首缩进 4 个空格 | 变成代码框 |
文字里有 *、_ | 可能变成斜体、粗体 |
<script> | 被删掉 |
onclick 这类事件属性 | 被删掉 |
<style> 里的规则 | 被限制在消息范围内，body 这类选择器不按预期生效 |
| 外部图片、字体 | 默认被拦截，见 pit-external-media |
另外酒馆默认开着「自动修复 Markdown」，可能给没配对的星号补上配对。
简单的装饰（颜色、边框、折叠块）：
style="..."，不要依赖脚本。需要交互的界面（按钮、标签页、读变量）：
<html>、<head> 或 <body>，由酒馆助手渲染成独立的小网页；现象：改了开场白、初始变量、状态栏，导入酒馆后，在原来的聊天里还是旧的样子。
聊天开始时，有些内容会复制一份存进聊天记录，之后和卡就没关系了；有些内容则是每次发送时现读卡里的。
| 内容 | 旧聊天里会不会变 |
|---|---|
| 角色描述、性格、情景、示例对话 | 会，每次发送都现读 |
| 系统提示、历史后置指令 | 会 |
| 开场白 | 不会，开局时已经存成第一条消息 |
| 初始变量 | 不会，开局时已经读进第一条消息 |
| 世界书 | 看你改的是哪份，见下文 |
| 正则、脚本 | 重新导入并刷新后会 |
| 已经存在的消息、变量 | 不会，按当时的样子存着 |
导入后的世界书是独立文件。重新导入卡时，如果世界书没有跟着更新，用角色面板「…」→「导入角色卡的世界书」再导入一次，会覆盖同名的旧书。
现象：你发出去的卡，别人导入时报错，或者导入后只有一张图、什么设定都没有。
角色卡的所有内容（描述、开场白、世界书、正则、脚本）都藏在 PNG 图片的附加数据里，图片本身只是封面。
很多软件发送、保存图片时会压缩或转格式，附加数据就被扔掉了：
现象：消息里出现 <options>...</options>、<UpdateVariable> 这类标签原文，或者整段 HTML、代码以文字形式显示，而不是变成界面。
| 表现 | 最可能的原因 |
|---|---|
| 所有卡、所有美化都变成代码文字 | 「在响应中显示标签」开着 |
| 只有这张卡的标签露出来 | 局部正则没被允许 |
| 大部分时候正常，偶尔露出来 | AI 这次把标签写错了 |
| 生成过程中露出来，生成完就好 | 流式输出时标签还没闭合，正常现象 |
| 显示一整块代码框 | 酒馆助手没装或「启用渲染器」没开 |
用户设置里的这个选项（默认关）打开后，酒馆会把消息里的所有尖括号都当文字显示。正则生成的 HTML 也一起变成了代码文字。玩家关掉它就好。
见 pit-allow-scripts。
正则只认它规定的写法，AI 稍微写偏一点就匹配不到：
<Options> 和 <options>；＜options＞；办法：
i 标志忽略大小写，见 regex-flags；<user> 当标签名：会被替换成玩家名字，见 pit-macro-escape；现象：条目明明是常驻的，或者关键词明明出现了，可「提示词」里就是找不到它；有时生效，有时不生效。
世界书有预算，默认最多占上下文的 25%。这一轮触发的条目按「顺序」从大到小排队进预算，满了之后的全部丢掉，见 worldbook-budget。
很多人以为常驻条目一定会发，其实常驻也要排队。下面几种情况最容易超预算：
按「玩家的上下文只有 16k」来估算：世界书常驻部分控制在 2000～3000 token 以内，比较安全。在简介里写明推荐的上下文长度。
现象 A：一个按关键词触发的条目，几乎每轮都在。
现象 B：一个条目，聊天里明明提到了，就是不触发。
| 原因 | 说明 |
|---|---|
| 用了角色名、玩家名当关键词 | 酒馆扫描时会把说话人的名字一起扫（「包括名称」默认开），每条消息都带名字 |
| 关键词太短太泛 | 单个汉字、「他」「门」「刀」这种词处处都有 |
| 关键词出现在开场白或 AI 的口头禅里 | AI 自己每轮都说，自己触发自己 |
| 递归 | 别的条目内容里提到了它，见 worldbook-recursion |
| 原因 | 说明 |
|---|---|
| 玩家用的词和关键词不一样 | 只写了全名「沈清」，玩家说「清儿」「沈小姐」 |
| 英文名被「匹配整个单词」拦住 | 关键词 Tom 匹配不到 Tommy，新装酒馆默认开着这个选项 |
| 关键词之间用了全角逗号 | 「沈清，清儿」被当成一个关键词 |
| 扫描深度太小 | 提到的那句已经不在扫描范围里，见 worldbook-scan-depth |
| 条目被禁用，或世界书没导入 | 见 pit-embedded-book |
| 次要关键词逻辑设错 | 比如「与所有」要求次要关键词全都出现 |
/.../ 后完全按正则匹配，写错了不会报错，只是不触发。写卡时常纠结：文风要求、输出格式该写在卡里，还是让玩家的预设来管？原则是：和这张卡有关的写进卡，通用的留给预设。
| 内容 | 放哪 | 原因 |
|---|---|---|
| 人设、世界观、配角、地点 | 卡（描述 + 世界书） | 只属于这张卡 |
| 开场白、示例对话 | 卡 | 只属于这张卡 |
| 变量规则、状态栏输出格式 | 卡（世界书常驻或 @D 条目） | 卡的功能靠它，不能指望玩家预设 |
| 选项、面板等界面标签的输出要求 | 卡（世界书） | 同上 |
| 这张卡特有的文风（古风、公文体、日记体） | 卡 | 是卡的特色 |
| 通用文风（少用比喻、不要总结） | 预设 | 每张卡都适用 |
| 破限 | 预设 | 和模型有关，不和卡有关 |
| 回复长度、人称 | 预设为主，卡里可以建议 | 玩家各有偏好 |
| 思维链格式 | 预设 | 和模型有关 |
玩家用的预设千差万别。卡里的系统提示可能被预设禁止覆盖，见 card-system-prompt。而世界书条目只要世界书块没被关，都会发出去，最稳。
所以常见做法是把 MVU 规则、界面说明都放在世界书条目里，而不是系统提示里。
<options>」，这类要求写在世界书里，不依赖预设；用 OpenAI、Claude、Gemini、DeepSeek 这类接口聊天时，用的是「对话补全」模式。这时预设决定了：
预设在酒馆左上角第一个图标「AI 响应配置」里切换、导入、导出。
一句话：角色卡管「演谁」，预设管「怎么演」。
同一张卡换个预设，效果可能天差地别。详细分工见 preset-vs-card。
| 块 | 作用 |
|---|---|
| 主要提示词 | 告诉模型「你在写一个角色扮演故事」 |
| 文风 / 写作要求 | 人称、篇幅、描写方式 |
| 破限 | 让模型放开写的提示词 |
| 思维链 | 要求模型先在标签里思考再回复 |
| 历史后置指令 | 紧贴最新消息的最终提醒 |
如果你用的是文本补全接口（本地跑的模型、KoboldCpp、部分中转），酒馆不会用对话补全预设，而是用下面两种模板。用 OpenAI、Claude 这类对话补全接口的话，可以跳过这条。
规定角色卡各部分怎么拼成开头的一大段文字：描述放哪、性格放哪、示例对话怎么标记。
规定每一条消息怎么包起来。不同模型有不同的格式，比如：
1<|im_start|>user2你好<|im_end|>3<|im_start|>assistant模板选错，模型分不清谁在说话，会出现自问自答、输出乱码标记、停不下来等问题。
<|im_start|>，换个模型就乱了。卡里只写普通文字。对话补全预设的面板底部有一个「提示词」列表，列出组成提示词的每一块。这个列表的顺序和开关，就是预设里的 prompt_order。
内置的块：
再加上预设作者自己添加的各种块（文风、破限、思维链……）。
越靠后（越接近聊天记录末尾）的内容，模型越重视。所以：
预设面板最上面是一排参数。大部分保持默认就行，下面几个最常需要调。
每次最多发多少 token 给模型。
一般 32k～64k 对角色扮演够用。
模型一次最多写多少。
控制随机程度。
| 温度 | 效果 |
|---|---|
| 低（0.3～0.7） | 稳定、保守，容易重复 |
| 中（0.8～1.0） | 常用范围 |
| 高（1.2 以上） | 更有创意，也更容易胡说、崩格式 |
MVU、状态栏这类要求固定格式的卡，温度别太高，否则变量更新容易写错。
| 参数 | 一句话 |
|---|---|
| Top P / Top K | 另一种控制随机的方式，一般不用动 |
| 频率惩罚 / 存在惩罚 | 减少重复用词，太大会让文字变怪 |
| 流式传输 | 回复一个字一个字出来 |
| 请求思维链 / 推理强度 | 让支持的模型先思考，更聪明也更慢 |
| 压缩系统消息 | 把连续的系统消息合成一条，部分接口需要 |
写卡最常用的几条正则，直接抄，改改标签名就能用。每条都写明了该勾哪些选项。
模型在 <think> 标签里思考，不想看到也不想发回给 AI。
/<think>[\s\S]*?<\/think>\s*/g新版酒馆会把很多模型的思考过程单独放进「推理」区，这时不需要这条。
/<think>([\s\S]*?)<\/think>/g<details><summary>思考</summary>$1</details>再配一条「仅影响后端提示词」的第 1 条，把它从历史里删掉。
/「([^」\n]+)」/g<span style="color:#c86">「$1」</span>心理活动用其他括号的话，把两处「」换成对应的符号。
AI 输出了 <options>...</options>，显示时变成按钮，但不希望它留在历史里。
/<options>[\s\S]*?<\/options>/g/<StatusBlock>[\s\S]*?<\/StatusBlock>/g最近两条的状态还在，AI 知道当前状态；更早的删掉省 token。见 regex-depth。
/\n{3,}/g玩家用「（旁白：……）」给 AI 下指令，不想在聊天里看到。
/（旁白：[^）]*）/g$ 后面跟数字会被当成捕获组，见 pit-dollar；正则设置里有一组「表层替换」选项，决定这条正则改的是什么。这是正则最重要、也最容易弄错的设置。
| 设置 | 你看到的 | 发给 AI 的 | 聊天记录原文 |
|---|---|---|---|
| 仅影响显示（markdownOnly） | 改了 | 不改 | 不改 |
| 仅影响后端提示词（promptOnly） | 不改 | 改了 | 不改 |
| 两个都勾 | 改了 | 改了 | 不改 |
| 两个都不勾 | 改了 | 改了 | 永久改掉 |
「两个都不勾」时，正则在消息生成或发送的那一刻直接改写消息本身，原文就没了。
| 需求 | 选哪个 |
|---|---|
| 状态栏、选项按钮、美化 | 仅影响显示 |
| 从历史里删掉界面标签、旧的变量命令 | 仅影响后端提示词 |
| 显示和发送都要去掉某个内容 | 两个都勾 |
| 真正改写消息（很少需要） | 都不勾 |
一个卡片前端功能通常是一对正则：一条「仅显示」把标签变成界面，一条「仅提示词」把标签从 AI 看到的历史里删掉。
正则设置里的「最小深度 / 最大深度」让正则只对某几层消息生效。深度从最新消息往回数：最新一条是 0，前一条是 1，以此类推。
| 需求 | 设置 |
|---|---|
| 只在最新消息显示状态栏，旧消息显示简版 | 状态栏正则「仅显示」+ 最大深度 0；另一条简版正则最小深度 1 |
| 发给 AI 时只保留最近几条的详细内容 | 「仅提示词」+ 最小深度 3，把更早的长内容删掉或换成摘要 |
| 删掉很早以前的变量更新命令 | 「仅提示词」+ 最小深度 5 |
用深度可以大幅省 token：最近几条保留完整信息，更早的只留正文。
「查找正则表达式」一栏推荐写成两边带斜杠、后面跟标志的形式：
1/要找的内容/gs| 标志 | 作用 | 什么时候要 |
|---|---|---|
g | 替换所有匹配，不加只换第一处 | 几乎总是要 |
s | 让 . 也能匹配换行 | 要匹配跨多行的内容时 |
i | 不区分大小写 | 匹配英文标签时可选 |
m | ^、$ 匹配每一行的开头结尾 | 按行处理时 |
不写斜杠时，整行被当成规则本身，没有任何标志，也就只替换第一处。
| 写法 | 意思 |
|---|---|
. | 任意一个字符（不含换行，除非加 s） |
[\s\S] | 任意一个字符，包括换行 |
* / + / ? | 前一个出现 0 次以上 / 1 次以上 / 0 或 1 次 |
*? / +? | 同上，但尽量少匹配（非贪婪） |
[^」] | 除了「」」以外的任意字符 |
\d / \s | 数字 / 空白 |
^ / $ | 开头 / 结尾 |
\ | 转义，让 .、(、/、* 这些符号表示它本身 |
另外，竖线表示「或」：/你好|您好/ 两个都能匹配。
消息里有两段 <a>1</a> 中间 <a>2</a>：
/<a>[\s\S]*<\/a>/ 会从第一个 <a> 一直吃到最后一个 </a>，把中间全吞了；/<a>[\s\S]*?<\/a>/g 才是分别匹配两段。匹配标签内容时，几乎总是用 *?。
g：只有第一处被替换，后面的原样留着；.*：匹配不到。用 [\s\S]*? 或加 s 标志；/.../ 形式里写结束标签要写 <\/tag>；查找里用圆括号 ( ) 圈出的部分叫捕获组。替换时用 $1、$2 引用它们，第几个括号就是几号。
/<think>([\s\S]*?)<\/think>/g<details><summary>思考</summary>$1</details>([\s\S]*?) 抓住了标签中间的内容，替换时用 $1 放回去。
/「([^」]+)」/g<span style="color:#d4a">「$1」</span>| 写法 | 意思 |
|---|---|
$1～$9 | 第 1～9 个捕获组 |
$0 或 {{match}} | 整个匹配到的内容 |
$<名字> | 命名捕获组，查找里写成 (?<名字>...) |
只是为了分组、不需要引用的括号，写成 (?: )，不占编号：
/(?:你好|您好)，(\S+)/ 里，$1 是名字，不是问候语。
{{user}} 会变成名字。酒馆正则就是「自动查找替换」：在消息显示前或发给 AI 前，按规则把一段文字换成另一段。卡片的美化、状态栏、隐藏思维链，基本都靠它。
酒馆顶部的扩展图标（三个方块）→「正则」。里面分三组：
| 分组 | 存在哪 | 作用范围 |
|---|---|---|
| 全局正则 | 你的酒馆设置 | 所有角色、所有聊天 |
| 局部正则 | 角色卡里 | 只对这张卡，需要允许才生效，见 pit-allow-scripts |
| 预设正则 | 预设里 | 用这个预设时 |
写卡时做的正则都是局部正则，会跟着卡导出。
| 设置 | 意思 |
|---|---|
| 查找正则表达式 | 要找的文字规则，见 regex-flags |
| 替换为 | 换成什么，可以用 $1 引用捕获组，见 regex-groups |
| 修剪掉 | 替换前先从匹配内容里删掉的文字 |
| 作用范围 | 对哪些内容生效：用户输入、AI 输出、快捷命令、世界书、推理 |
| 仅影响显示 / 仅影响后端提示词 | 只改看到的，还是只改发给 AI 的，见 regex-scope |
| 在编辑时运行 | 手动编辑消息后也执行 |
| 最小深度 / 最大深度 | 只对某几层消息生效，见 regex-depth |
| 正则表达式查找时的宏 | 查找内容里的 {{user}} 等要不要先替换 |
常用写法直接抄 regex-cheatsheet。
g 标志时只换第一处，见 regex-flags；现象：正则在测试模式里明明能匹配，实际聊天里就是不生效；或者只对一部分消息生效。
正则的「作用范围」决定它处理哪些内容，没勾的就不会处理：
| 作用范围 | 处理的内容 |
|---|---|
| 用户输入 | 玩家发的消息 |
| AI 输出 | AI 的回复，包括开场白 |
| 快捷命令 | 斜杠命令产生的文字，一般用不到 |
| 世界书 | 世界书条目发给 AI 前的内容 |
| 推理 | 模型的思考过程（单独显示的那块） |
现象：
正则的「仅影响显示」「仅影响后端提示词」两个都不勾时，这条正则会在消息生成（或发送）的那一刻直接改写消息本身，而且改了就回不去了，见 regex-scope。
界面类的正则（状态栏、选项、美化）如果这样设置：
| 正则用途 | 正确设置 |
|---|---|
| 把标签变成界面 | 仅影响显示 |
| 把标签从发给 AI 的历史里删掉 | 仅影响后端提示词 |
| 显示和发送都不要 | 两个都勾 |
已经被改坏的旧消息只能手动编辑恢复，或者开新聊天。
角色卡就是一份「给 AI 看的设定包」。你把它导入 SillyTavern（大家叫它「酒馆」），AI 就会照着里面的设定扮演角色、陪你聊天或跑剧情。
打个比方：AI 是演员，角色卡是剧本，预设是导演的要求，聊天记录是已经演过的戏。每次你发消息，酒馆会把这三样拼成一大段文字发给 AI，AI 接着往下演。具体怎么拼见 basics-prompt-assembly。
| 部分 | 作用 | 什么时候发给 AI |
|---|---|---|
| 角色描述 | 角色是谁、长什么样、什么性格、和 {{user}} 什么关系 | 每轮都发 |
| 性格摘要、情景 | 补充性格关键词、当前所处的场景 | 每轮都发（很多卡留空） |
| 开场白 | 聊天的第一条消息，可以有好几条备选 | 作为聊天记录的第一条 |
| 示例对话 | 给 AI 看「这个角色说话是什么样」 | 按设置发，见 card-example-dialogue |
| 世界书 | 地点、配角、规则等补充设定 | 常驻的每轮发，其余被关键词触发才发 |
| 系统提示、历史后置指令 | 卡作者给 AI 的额外指示 | 每轮都发，见 card-system-prompt |
| 正则 | 改写消息的显示或发给 AI 的内容 | 不发给 AI，是酒馆自己执行的 |
| 脚本 | 酒馆助手执行的代码，MVU 变量卡靠它 | 不发给 AI |
| 创作者注释 | 写给玩家看的说明 | 不发给 AI，见 card-creator-notes |
从零开始写一张卡，看 basics-first-card；看到不懂的词，查 basics-glossary。
第一次写卡，不知道从哪下手？按这个顺序来，每一步都有对应的词条可以细看。
先用一两句话回答三个问题：
「玩什么」最容易被忽略。只有人设没有玩法的卡，聊几句就没话说了。
外貌、性格、说话方式、过去、和 {{user}} 的关系。重点是能指导 AI 怎么演的信息，而不是简历，见 card-description。
开场白决定第一印象，也决定 AI 后面的文风和篇幅。从一个具体场景切入，给 {{user}} 留出回应的空间，见 greeting-forms。
地点、配角、组织、物品……一条一条写，设好关键词。只有核心规则用常驻，见 worldbook-constant 和 worldbook-keywords。
导出 PNG，导入酒馆，开新聊天，聊十几轮。看看：
遇到问题按 pit-checklist 一项项查。
你每发一条消息，酒馆都会把一大段文字拼好发给模型。模型并不「记得」之前聊过什么，它每次都是从头读这一大段，然后写下一条回复。所以理解「这一大段里有什么、按什么顺序」，是写好卡的基础。
用对话补全（OpenAI、Claude、Gemini、DeepSeek 这类接口）时，酒馆默认预设的顺序是：
另外：
模型对靠近末尾的内容最敏感。所以：
| 位置 | 适合放 |
|---|---|
| 角色描述 | 角色是谁、外貌、性格、说话方式、和 {{user}} 的关系 |
| 世界书（关键词触发） | 地点、配角、物品、事件等「提到才需要」的细节 |
| 世界书（常驻） | 世界观核心规则、MVU 变量规则与输出格式 |
| 示例对话 | 说话风格样本 |
| 开场白 | 第一个场景，定下文风和篇幅 |
| 历史后置指令 | 简短但必须每次遵守的要求 |
酒馆里 AI 回复右上角有一排小按钮，其中「提示词」（柱状图标，有时要先点「…」展开）能看到这一轮实际发出去的内容和每部分占多少 token。排查「AI 为什么不照设定来」时非常有用：先确认设定真的发出去了。
相关：tokens、preset-vs-card
写卡圈常见说法，按拼音和字母大致排序。不懂的词先查这里。
| 说法 | 意思 | 详见 |
|---|---|---|
| 酒馆 / ST | SillyTavern，最常用的角色卡聊天前端 | what-is-card |
| 酒馆助手 / TH | 酒馆扩展 JS-Slash-Runner，能运行卡里的脚本、渲染界面 | pit-allow-scripts |
| 角色卡 / 卡 | 给 AI 扮演用的设定包，通常是 PNG | what-is-card |
| 世界书 / WI / 知识书 | 按关键词触发的补充设定 | worldbook-entry |
| 角色书 | 嵌在角色卡里的世界书 | pit-embedded-book |
| 蓝灯 / 绿灯 | 世界书条目的常驻 / 关键词触发 | worldbook-constant |
| 预设 | 规定提示词怎么拼、参数怎么设的配置 | preset-chat |
| 破限 | 预设里让模型放开写的提示词 | preset-chat |
| 开场白 / first_mes | 聊天的第一条消息 | greeting-forms |
| 楼层 | 聊天里的一条消息，第 0 楼是开场白 | |
| 深度 / @D | 从最新消息往回数第几条 | worldbook-position |
| token | 模型计算长度的单位 | tokens |
| 上下文 | 每次发给模型的全部内容 | tokens |
| 宏 | {{user}} 这类占位符 | macros |
| 正则 | 查找替换规则，用来美化或清理消息 | regex-tavern |
| 局部正则 | 存在角色卡里的正则，需要允许才生效 | pit-allow-scripts |
| MVU | 变量框架，让卡有好感度、金钱等数值 | mvu-what |
| stat_data | MVU 存变量的地方 | mvu-schema |
| InitVar | MVU 的初始变量 | mvu-initvar |
| 状态栏 | 显示在回复里的变量面板 | mvu-statusbar |
| 前端 / 卡片前端 | 卡自带的按钮、面板、美化界面 | card-frontend |
| OOC | 出戏，不像这个角色了 | |
| 抢话 | AI 替 {{user}} 说话或做决定 | card-system-prompt |
| AI 味 | 套话多、比喻堆砌的文风 | de-ai |
| 思维链 / CoT | 模型正式回复前的思考过程 | regex-cheatsheet |
| 流式 | 回复一个字一个字蹦出来 | preset-params |
| 温度 | 控制回复随机程度的参数 | preset-params |
| V2 / V3 | 角色卡格式版本 | card-v2-v3 |
| EJS | 能按变量条件输出不同内容的模板写法 | ejs |
模型不是按「字」算长度，而是按 token（可以理解为「词块」）算。粗略换算：
酒馆里很多地方会显示 token 数，比如角色卡编辑页底部、世界书条目右上角。
上下文就是「每次发给模型的全部内容」，有长度上限（比如 32k、128k token）。每次你发消息，酒馆都要把这些塞进去：
前面几项占得越多，能塞进去的聊天记录就越少，AI 就越「健忘」。
世界书（也叫 World Info、知识书）是一本「设定字典」。里面每一条叫条目，平时不发给 AI，聊天里出现了关键词才把这条内容塞进提示词。这样大量设定只在需要时出现，省 token。
| 字段 | 酒馆里叫 | 作用 |
|---|---|---|
| 标题 | 标题 / 备注 | 给人看的名字，不发给 AI |
| 关键词 | 主要关键字 | 聊天里出现这些词就触发，见 worldbook-keywords |
| 次要关键词 | 可选过滤器 | 配合逻辑做更精细的条件 |
| 内容 | 内容 | 触发后插入提示词的正文，见 worldbook-format |
| 触发方式 | 蓝灯 / 绿灯 | 常驻（每轮都发）或关键词触发，见 worldbook-constant |
| 位置 | 插入位置 | 插在提示词的哪里，见 worldbook-position |
| 深度 | 深度 | 位置选「@D」时，插在倒数第几条消息处 |
| 顺序 | 顺序 | 同一位置里谁前谁后，也影响预算优先级，见 worldbook-order |
| 概率 | 触发概率 % | 触发后再掷一次骰子决定发不发，默认 100 |
| 递归选项 | 不可递归 / 防止进一步递归 / 延迟到递归 | 见 worldbook-recursion |
| 包含组 | 包含组 / 组权重 | 同组只取一条，见 worldbook-order |
| 时间效果 | 黏性 / 冷却 / 延迟 | 触发后持续几轮、多久不再触发、第几轮后才能触发，见 worldbook-timed |
| 扫描深度 | 扫描深度 | 本条单独设置往回看几条消息，见 worldbook-scan-depth |
新建条目的默认值：顺序 100、位置「角色定义前」、深度 4、概率 100。
条目内容怎么写，AI 都能读。但写得有结构，AI 更容易分清「这是哪个设定」，不会把两个配角的特征搞混。
外面用一对标签包住，里面用「名称: 内容」的条目式写法：
1<地点_北城>2名称: 北城3氛围: 潮湿、霓虹、永远在下雨4势力: 青帮控制码头，巡捕房只管租界5要点:6 - 夜里十一点宵禁7 - 外地人进城要查良民证8</地点_北城>好处：
<角色_沈清>、<地点_北城>、<规则_宵禁>；<options>）。如果角色的设定已经完整放进世界书（常驻条目），角色卡的「描述」字段可以留空或只放一句摘要。这是很多大型卡的做法。
要点是不要重复：同一段设定在描述和世界书里各写一遍，既浪费 token，改的时候又容易只改一边，造成矛盾。
{{char}} 永远是卡的名字，配角要写名字；关键词决定条目什么时候触发。设得好，设定在需要时准时出现；设得不好，要么永远不触发，要么每轮都触发。
世界书设置里有「匹配整个单词」，新装酒馆默认开着。开着时：
Tom 不会匹配 Tommy；条目还可以设「可选过滤器」（次要关键词），配合逻辑使用：
| 逻辑 | 意思 |
|---|---|
| 与任意 | 主关键词命中，且次要关键词任意一个也出现 |
| 与所有 | 主关键词命中，且次要关键词全都出现 |
| 非任何 | 主关键词命中，且次要关键词一个都没出现 |
| 非所有 | 主关键词命中，且次要关键词没有全部出现 |
例子：主关键词「沈清」，次要关键词「生气、吵架」，逻辑「与任意」，就能做出「只在和沈清吵架时触发」的条目。
关键词写成 /北城|城北/ 这样两边带斜杠的形式，就按正则匹配，更灵活。正则关键词不受「匹配整个单词」「区分大小写」影响，大小写用末尾的 i 控制。
条目触发后插在提示词的哪里，由「插入位置」决定。位置不同，AI 对它的重视程度也不同：越靠近最新消息，影响越强。
| 酒馆里的名字 | 插在哪里 | 适合 |
|---|---|---|
| 角色定义前（↑Char） | 角色描述前面 | 世界观、背景设定（默认） |
| 角色定义后（↓Char） | 角色描述后面 | 对角色的补充设定 |
| 示例消息前（↑EM） / 示例消息后（↓EM） | 示例对话前后 | 很少用 |
| 作者注释前（↑AN） / 作者注释后（↓AN） | 作者注释的前后 | 配合作者注释使用 |
| 插入深度 @D | 聊天记录里倒数第 N 条消息处 | 必须遵守的规则、输出格式 |
| 锚点 | 只在预设或其他地方用对应宏引用时出现 | 高级用法 |
选「插入深度」时还要填深度数字，从最新消息往回数：
@D 还可以选这段内容以什么身份插入：系统、用户、AI。一般用系统。
每条条目有一个「顺序」数字，默认 100。它管两件事：
同一插入位置的多条条目，数字小的排在前面，数字大的排在后面。
例如三条都在「角色定义后」：顺序 10、50、200，发出去的顺序就是 10 → 50 → 200。数字大的离聊天记录更近，对 AI 的影响通常更强。
世界书总长度有上限（见 worldbook-budget）。酒馆会先处理数字大的条目，预算满了，数字小的就被挤掉。
所以：越重要的条目，顺序数字设得越大。
给几条条目填上同一个「包含组」名字，它们同时触发时只会发其中一条。适合互斥内容：
扫描深度决定酒馆往回看几条消息来找关键词。
| 设置 | 结果 |
|---|---|
| 太小（1～2） | 话题刚提过一句，下一轮就不触发了，AI 突然「忘了」 |
| 太大（10 以上） | 很久以前提过的东西还一直触发，占着预算 |
递归：已经触发的条目，它的内容也会被拿去匹配别的条目的关键词。
例子：玩家说「去北城」，触发了「北城」条目；北城条目的内容里写着「青帮控制码头」，于是又触发了「青帮」条目。这就是一次递归。
| 选项 | 效果 | 用在哪 |
|---|---|---|
| 不可递归 | 本条不会被别的条目内容触发，只能被聊天触发 | 不想被连带出来的大段设定 |
| 防止进一步递归 | 本条的内容不再去触发别的条目 | 内容里提到很多名词的总纲、长条目 |
| 延迟到递归 | 本条只能被递归触发，聊天里直接提到不算 | 「提到 A 时顺带带出 B」的配套条目 |
世界书不能无限往提示词里塞，有一个预算上限。超出预算的条目，即使触发了也不会发出去。
世界书面板顶部有两个设置：
两者取较小的那个。
酒馆把这一轮所有触发的条目排队，顺序数字大的先进，一直加到预算满为止，后面的全部丢掉。
世界书条目有两种触发方式，在条目上用一个小灯表示：
| 方式 | 适合 | 例子 |
|---|---|---|
| 常驻 | 每轮都必须知道的核心内容 | 世界观总纲、主角关系、MVU 变量规则和输出格式、文风要求 |
| 关键词 | 提到才需要的细节 | 地点、配角、物品、组织、历史事件、招式 |
问自己：如果这一轮 AI 不知道这条，会出错吗？
常驻条目每轮都占上下文，加起来越多，能放的聊天记录越少。经验值：
酒馆里的世界书是独立的文件，要绑定到某个地方才会生效。同一本世界书可以绑在不同地方，作用范围不一样。
| 绑定方式 | 在哪设置 | 作用范围 |
|---|---|---|
| 全局世界书 | 世界书面板「已启用的世界书（全局有效）」 | 所有角色、所有聊天 |
| 角色世界书 | 角色面板的地球图标：主要世界书 + 附加世界书 | 只在和这个角色聊天时 |
| 聊天知识 | 角色面板上的护照图标（长按打开绑定窗口） | 只在这一个聊天里 |
| 用户设定世界书 | 用户设定面板 | 用这个人设时 |
角色卡里自带的世界书，导入时会生成一本同名世界书文件，并绑成这个角色的「主要世界书」，见 pit-embedded-book。
酒馆会把所有绑定的世界书合在一起扫描。排序看世界书设置里的「插入策略」：
预算是所有世界书共用的，见 worldbook-budget。
条目设置里的「黏性 / 冷却 / 延迟」三个数字，都以消息条数为单位，用来控制条目在时间上的表现。默认都是空（不生效）。
条目被触发后，接下来 N 条消息里不管还有没有关键词都保持触发。
条目触发（黏性结束）后，接下来 N 条消息里即使出现关键词也不触发。
聊天记录不到 N 条时，这条怎么都不触发。
| 需求 | 设置 |
|---|---|
| 进入某地后设定持续一阵 | 关键词「北城」+ 黏性 5 |
| 偶尔下雨，别天天下 | 常驻 + 概率 20 + 冷却 8 |
| 聊久了才揭露的身世 | 关键词「父亲」+ 延迟 30 |