AI

每张卡默认就有一个 AI，叫 旁白：玩家说一句，它回一句。绝大多数卡有它就够了。

想让地窖里的老鼠王用自己的脾气说话，或者让一个小精灵每五回合在幕后记一次账，就再加一个 AI。

每多一个 AI，就是每次多调用一次模型，会多花额度。 加之前想一想它是不是真的需要单独一个 AI，很多时候多写一条设定就够了。

AI 住在哪里

卡和每个情境的最底下都有一行 AI，一行一个 AI，写着名字和类型。AI 住在哪，就在哪里生效：

• 住在 卡上：一直都在
• 住在 某个情境里：那个情境开着的时候才在
• 还没放进哪里：不生效，先放着

它知道的东西也看它住在哪：住在卡上就读卡的设定，住在情境里就读卡的加上那个情境的。想要某几条设定只有这一个 AI 知道、别的 AI 都不知道，就放进它设置里的 只有它知道。

AI 行可以直接拖到另一个情境或者卡上，等于给它搬家。

加一个 AI

加东西 → 一次 AI 调用。它会加到你正在看的情境里（没选情境就是卡上），右边同时打开它的设置，最上面先选它是哪种 AI。以后想改，点这一行，右边就会再打开。

四种 AI

类型	它什么时候跑
回合型	跟着玩家的回合跑：玩家每说一句它回一句；或者每隔几回合在幕后跑一次；或者等另一个 AI 回复完再跑
界面型	等玩家界面里的按钮叫它
代码型	自己看时机：某个数值满足条件时、某个情境结束时、冷场一段时间后
自定义	表单做不出来的那种。你先在画布上占个位，代码来实现（见下面）

在设置的 它什么时候运行 里细选：

• 玩家每次说话后，由它回复：就是普通的「旁白」那种
• 每隔几回合，在幕后跑一次：不对玩家说话，适合写总结、记账
• 某个 AI 回复之后：等你指定的那个 AI 回完，它接着跑。比如旁白讲完故事，一个「吐槽役」接一句
• 在玩家界面里给一个按钮叫它：做好以后到玩家界面里，给按钮加一步 叫一个 AI
• 某个数值满足条件时：条件从「不成立」变成「成立」的那一刻跑一次，一直成立不会反复跑
• 某个情境结束时：副本打完，它读一遍，写给下一个地方看。这是幕后 AI 最常用的时机
• 冷场一段时间后，它可能插一句：玩家开着游戏、这么多秒没人说话，它会自己判断要不要插一句。没什么可说就不出声，但每次判断都算一次调用

自定义：给代码留一个位置

有些 AI 不是表单能配出来的：舞台上两个角色各有一套只有代码才管得了的规矩，或者一个要看着房间里发生了什么才开口的导演。这种就选 自定义。

选了之后这个 AI 就是一个占位：它有名字、住在某个情境里、情境里的设定归它读，但它自己不会跑，要靠代码来跑。你不用会写，可以贴张便签说清楚它该干什么，创作助手或者你用「连接你的 AI」接进来的外部 AI 会来写。

写好了，点这一行就能看到实现在哪个文件第几行；还没写，这里就是空的，写着「还没有实现」。

群聊

同一个地方有两个以上会回复玩家的 AI，就成了 群聊 · 依次回复：玩家说一句，它们一个接一个地回，每个人一个气泡，气泡上写着是谁在说。

• 在 卡上：旁白先说，然后卡上的其它 AI 依次接
• 在 情境里：情境有自己的 AI 时，默认是它们替旁白说话，旁白那一行会变淡，右边有个 卡的 AI 也在 按钮，点一下旁白就留下来一起说。旁白在的时候，那里换成 卡的 AI 不在这里，点它让旁白让出位置

玩家重新生成的时候，群聊里后面的人也是同一个 AI 重说，不会张冠李戴。

Context：AI 每回合读到什么

卡和每个情境的底下都有一块 Context。点它，右边会列出这里的 AI 每回合拿到的东西，其中几样你可以自己定：

• 对话历史：预算内全部（默认，尽量都给，装不下才丢最早的）、最新 N 条（更省，但 AI 会忘掉更早的事），或者 摘要 + 最新 N 条：滚出去的回合会压成一段摘要放在前面。选它还能填 摘要要点，比如「记住每一个承诺，以及谁欠谁什么」。摘要在后台用便宜的模型更新，玩家每次通常花不到 1 蘑菇
• 置顶提醒：一句话，每回合都贴在对话末尾附近，AI 在那里最听话。文风提醒、长期规则放这里正合适
• 上下文预算：AI 每回合最多读多少，默认 按玩家设置。打开 锁定为本卡设置，就以你这张卡的为准
• 这一回合 AI 读到什么：按实际顺序列出常驻设定、历史、等关键词的词条、变量，后面是大概多少 token。AI 老忘事、或者说着说着跑偏了，先来这里看一眼
• 高级 里还有 触发词往回看几条、级联触发深度，以及 变量给 AI 的方式：全部、只给有变化的、不给

智能追踪 的开关在卡的设置里，点卡的 AI 那一行也能看到它，两边是同一个开关。

它记得什么

每个 AI 设置里都有记忆和「接进来」的部分：

• 记得整段对话、只记得在这里说过的、和某某共用记忆：和情境的记忆是同一套
• 读最近几条对话：比如战斗场景的 AI 只看最近 10 条就够了，省钱，也不容易被三百回合前的闲聊带跑
• ＋ 接一条进来：把别的地方的东西接给它读。可以接某个情境的经历、某个幕后 AI 写出的东西、某个情境的变量、某个情境的原话。接进来的经历可以当 亲历（主角自己经历过的）或 档案（查到的记录，不是亲身经历）。原话很贵，能用经历就别用原话

幕后 AI 写出来的东西，就是靠这里交给别的 AI 读的。画布上会写成「写给某某」「收到某某写的」。

界面型 和 冷场后插一句 的 AI 没有「接进来」这一块。界面型看什么，全在下面 回答格式 的 它看得到 里选；冷场插话的那个自己会读最近的对话。

模型

模型 默认是 跟随玩家选的。也可以给某个 AI 指定一个，比如老鼠王用一个话痨一点的模型。玩家那边用不了你指定的模型时，会自动回落到他自己选的，不会把卡卡死。

回答格式：让 AI 回答得规规矩矩

AI 设置里，它在哪 下面有一块折起来的 回答格式。大多数时候用不到，但做小游戏的时候特别好用。

比如酒馆里的「算命蘑菇」：玩家点按钮，它要回答两样东西，运势（只能是 大吉 / 吉 / 小凶 之一）和 幸运数字（1 到 9）。运势说给玩家听，幸运数字存进变量。

• 它看得到：挑几个变量给它看、读最近几条对话、要不要 记得自己说过的
• 提示词片段（满足条件才加上）：比如「当 醉意 ≥ 5 时，加上：算命蘑菇今晚喝多了，说话颠三倒四」
• 回答：默认只回一段文字。加上字段就会回 JSON，每个字段选类型（文字 / 数字 / 几选一 / 列表），再选它去哪：它说的话、变量（设为 / 加上 / 追加进列表）、一个剧情事件，或者 只返回
• 说在哪：进故事（默认）、只回给界面、界面频道
• 出错时：最多等几秒、重试几次、冷却几秒、写几句备用的话（随机选一句）。勾上 还是失败就从选项里随机挑一个，那「几选一」的字段就算模型罢工了也能给出一个合法答案

模型回来的东西会被检查：几选一只能在选项里，数字会被夹在范围里，不对就带着提示重问一次，再不行就用备用句子。

会写代码的话，卡的界面代码里可以用 api.callAi("算命蘑菇", 输入) 直接叫它，拿回 { text, fields }。细节见进阶：API 参考。

AI 分工表

卡里不止一个 AI 的时候，视图 → AI 分工表 会列一张大表：每一条设定、每一个变量，哪个 AI 看得到、哪个 AI 能改。AI 一多容易乱，这张表能帮你确认老鼠王不会知道它不该知道的事。

接不上的时候

AI 的设置没配完整，画布会在 这样接跑不起来 下面告诉你哪里不对，比如：

• 没选「它什么时候运行」，所以它永远不会跑
• 幕后 AI 什么都没接进来，它写出来的东西只能是编的，还要花钱
• 它等的那个 AI 不回复玩家，所以它永远等不到

照着提示改就好。改完记得试玩一下，试玩的时间线上每个 AI 有自己的一条，谁说了话、谁被叫醒了但没出声，都看得到。