---
title: "行为与自动化"
description: "行为是给 AI 会做错的那些时刻用的：什么时候该用行为而不是词条，哪些触发真正重要，以及已发布的世界在用的模式。"
---
<div v-pre>

# 行为与自动化

平台上大多数世界根本不用行为，这没问题。创作者只在有那么几件非常具体、信不过 AI 能做得稳定的活时，才会拿起它。

触发、条件、效果、优先级、冷却和最大触发次数的基础在[行为](/zh/creator/automation)。这一页讲的是什么时候用它们，以及已发布的世界是怎么用的。

---

## 行为什么时候值得用（什么时候不值得）

新创作者在行为上最常犯的错是过度设计。他们看到 **＋ 行为** 按钮，想着「我该把一切都自动化」。然后做了 30 条行为，复刻的全是写得好的词条本来就能搞定的事，世界读起来就像机器。

**行为是用来求精确的。** 它们解决的是 AI 的不稳定会毁掉体验的问题：

| 问题 | 为什么行为能解决 |
|---------|-------------------|
| 「玩家应该在好感正好到 75 时收到一条通知」 | AI 不知道确切的数字，引擎知道 |
| 「进入竞技场时切换到战斗音乐」 | AI 有一半时候会忘掉音频指令 |
| 「每 3 回合增加饥饿」 | AI 有时候第 2 回合就做了，有时候完全忘掉 |
| 「HP 归零的那一刻必须出现死亡画面」 | 这件事 AI 一次都错不起 |

**词条是用来讲故事的。** 它们解决的是需要灵活和细腻的问题：

| 问题 | 为什么词条能解决 |
|---------|---------------------|
| 「随着信任增长改变一个 NPC 的说话方式」 | 条件设定给 AI 的是行为上的引导，不是死板的脚本 |
| 「玩家到某个地点时揭示设定」 | 关键词设定自然地流进 AI 的上下文 |
| 「进入地牢时转变基调」 | 词条描述氛围；行为只能递给 AI 一两句话 |

**经验法则：** 如果你在往一条行为的 **告诉 AI** 效果里写一整段叙事文字，那你多半应该写一条词条。行为像开关和旋钮；词条装的是真正的内容。

### Sakura Season 怎么两者都用

Sakura Season 是行为和词条配合的好例子。它有 9 条行为，干的都是同一件基本的活：盯着好感阈值。

*词条*描述每个女主角在不同好感等级下的表现（戒备、回暖、脆弱）。*行为*负责那些精确的时刻：25 时一条通知（「看来你引起了 Hina 的注意……」），50 时给 AI 新的引导，让它写出矛盾的欲拒还迎，75 时一条成就提示，触发告白线。

重活是词条干的。行为保证里程碑落在正好的那一刻。

---

## 触发类型详解

触发（**什么时候触发**）决定引擎*什么时候*检查一条行为。

### 你真正会用到的

**变量越过阈值。** 最常用的触发。它在一个数字变量越过某条线的*那一刻*触发。

这和每回合检查「生命值是否低于 20」不一样。越过触发只触发*一次*，就在值真正跨过阈值的时候。生命值已经是 10 并且一直是 10，它不会再触发。

你设三样东西：哪个变量，哪个方向（**上升到以上** 或 **下降到以下**），以及值。

Wandering Diary 用三条这个来实现地区切换：`distance` 变量越过 50 时玩家进入县城；150 进山；200 到省城。每个阈值设一个新的 `region` 变量并显示一条通知。

**变量变化。** 变量一变就触发。你可以挑一个变量盯着，也可以不指定，任何变化都触发，再用条件收窄。

你想对变量等于某个具体值做出反应，而不是对它越过阈值做出反应的时候用它。比如：「每当 location 变化，检查 location 是否等于 dark_forest，是的话播放阴森的音乐。」值每变一次，行为就重新检查一次，不管是什么引起的。

**每 N 回合。** 按计划触发：设成 3，就在第 3、6、9、12…… 回合触发。只在某一个回合触发一次的话，把 N 设成那个回合，**最大触发次数** 设成 1。

适合生存机制（饥饿一点点涨）、节奏事件（第 20 回合警告时间快到了），或者周期性的提醒。

**每回合。** 每次玩家和 AI 往来之后触发。省着用：每回合都跑、每回合都做点看得见的事的行为会烦到玩家。最好配上能滤掉大多数回合的条件，或者用来做安静的后台记账。

**会话开始。** 新游戏开始时触发一次。适合初始化：设起始值、显示欢迎消息，或者播放开场音乐。

**玩家点了某个按钮。** [玩家界面](/zh/creator/player-view)里的按钮执行 **让一条行为生效** 时触发，或者你的界面代码调用 `api.executeAction(id)` 时触发。按钮还可以传值进来；见[从按钮传一个值](/zh/creator/automation#passing-a-value-from-a-button)。

### 不那么常用的触发

**玩家说出关键词。** 玩家的消息里含有你的某个词时触发。和关键词设定一样的匹配选项都适用：可选的整词匹配、正则（关键词写成 `/.../flags` 时），以及辅助关键词过滤（AND_ANY、AND_ALL、NOT_ANY、NOT_ALL）。

**AI 说出关键词。** 同上，但扫描的是 AI 的回复。适合对 AI 写出的东西做反应，比如「AI 提到『战斗开始』时切换音乐」。

**每隔几秒。** 按真实时钟触发，但只在玩家开着游戏的时候。适合在玩家读或者想的时候也该走的东西，比如倒计时，或者一个会不耐烦的 NPC。任何该跟着故事节奏走的东西，用 **每 N 回合**。

---

## 条件：「如果……」检查

**如果……** 用的是和条件设定一样的条件系统：同样的 7 个运算符（`eq`、`neq`、`gt`、`gte`、`lt`、`lte`、`contains`；显示为 是 / 不是 / > / ≥ / < / ≤ / 包含），同样的 全部/任一 组合逻辑。完整的运算符参考见[写出好词条：由状态驱动的词条](/zh/creator/advanced/entries-deep#state-driven-entries)。

条件留空的话，触发一匹配行为就触发。

触发匹配了但条件不成立时，**条件不满足时告诉玩家** 给玩家显示一条提示。没有它的话，什么都不会发生，玩家也不知道为什么按钮没反应。

### 拿一个变量和另一个变量比

默认一个条件拿变量和一个固定的数字或词比：「好感 ≥ 50」。但右边有一个 **常量** / **变量** 切换。切到 **变量**，条件就改成比较两个实时的变量：

- `affinity > wariness`：只在好感此刻压过戒备时触发
- `gold >= price`：一个「买得起吗？」检查，不用把价格写死

阈值本身不固定、会随游戏变动的时候用它。同一套系统还有两个细节：

- 左边接受进入 JSON 变量的**点路径**：`inventory.gold >= 100`。
- `contains` 除了子串也匹配**数组成员**，所以 `flags` 是一个包含那一项的列表时，`flags contains "met-king"` 为真。

### 停止条件

**停止条件** 是「如果……」的反面：任何一条停止条件成立时，行为都不触发。用它做「触发到 X 为止」，比如一条每 5 回合的提醒，好感到 100 就该安静下来。值掉回去的话，行为恢复。想在固定次数之后停下，用 **最大触发次数**。

---

## 已发布世界里的真实模式

### 好感阈值（Sakura Season）

经典用法。Sakura Season 有 9 条行为，分在三位女主角上，每位都是同样的 3 档模式：

**好感 25。** 一条不起眼的信息通知。「看来你引起了 Hina 的注意……」，再把 `story_phase` 设成「daily」。一次性（**最大触发次数** 1）。

**好感 50。** 一条通知。「Hina 开始把你当成特别的人……」，再给 AI 新的引导，描述她矛盾的欲拒还迎，再把 `story_phase` 设成「deepening」。一次性。

**好感 75。** 高潮触发。通知，给 AI 安排告白场景的引导，`story_phase` 设成「climax」。一次性。

每条行为都用 **变量越过阈值** + **上升到以上**，只触发一次，把给玩家的通知、给 AI 的引导和一个阶段变量更新合在一起。今天要做同样的东西，把每个阶段的引导放进一条待命设定，用 **启用词条** 打开它。

### 地区切换（Wandering Diary）

Wandering Diary 记一个 `distance` 变量，玩家一路走它一路涨。三条 **变量越过阈值** 行为在距离 50、150 和 200 时切换 `region` 变量，各显示一条通知：「你终于离开了荒野，进入县境」「过了县城，眼前是绵延不绝的山脉」「远处出现了省城的轮廓」。

AI 从来不用记距离，也不用记地区边界。

### 死亡触发

Wandering Diary 和生存套件模板用的是同一个模式：**变量越过阈值**，生命值下降到 1 以下，配一条 **错误** 样式的通知。关键细节：

- **优先级 100。** 死亡应该比其他任何东西先判
- **最大触发次数 1。** 死亡通知只触发一次（不过大多数世界懒得设，因为你不可能两次掉到零以下）
- 有时配上 **告诉 AI** 来描述角色的死亡

### 地牢激活链

RPG 世界里常见的模式：行为 A 监听进入地牢（关键词触发，或 **变量变化** + 一个条件），然后用 **启用/禁用行为** 打开行为 B（**每回合** 的怪物遭遇，带冷却）。第三条行为监听离开，把 B 关掉。

这样怪物遭遇就限定在特定区域里，AI 不用记玩家在不在地牢。地牢是一个[情境](/zh/creator/modules)的话，可以跳过这条链：把行为 B 放进情境里，它只在情境开着的时候触发。

---

## 引擎怎么处理行为

有事发生时（一回合结束、一条消息到达、一个变量变化、一个按钮被按下、时钟走了一格），引擎把所有行为过一遍，优先级高的先来。对每一条，它问：启用了吗？它的情境开着吗？触发和这个事件匹配吗？「如果……」条件过了吗？有没有停止条件成立？在冷却吗？到 **最大触发次数** 了吗？有 **发生概率** 的话，这次掷中了吗？全部通过，它的效果按顺序执行。改变量的效果可以引发更多行为，最多 5 层深，防止无限循环。

玩家只看到结果：一条通知、一次音乐切换、一次变量更新。想看一条行为为什么触发了或没触发，[试玩](/zh/creator/playtest)并查看 **这回合**。

---

## 常见错误

**词条够用的时候拿行为过度设计。** 发现自己在 **告诉 AI** 里写长篇叙事文字，你多半想要的是条件设定。行为递一两句引导。词条提供成段的上下文。

**想要变量越过阈值，却用了变量变化。** **变量变化** 在变量每次变化时都触发。你想要「生命值低于 20 时通知我」，用 **变量越过阈值**，它在越过点触发一次。**变量变化** + 一个检查 `health < 20` 的条件，会在*生命值低于 20 期间后续的每一次变化*都触发，多半不是你想要的。

**频繁触发忘了设冷却。** 没有冷却的 **每回合** 行为每一回合都触发。它显示通知的话，玩家就被刷屏。永远先问：「玩家到底应该多久看到一次这个？」

**给一个只需要 3 条行为的世界做了 30 条。** Sakura Season 有 9 条行为：3 位女主角，每位 3 个阈值。大多数世界需要的更少，很多热门世界一条都没有。从词条和变量开始。只在抓到 AI 在某件具体的事上不稳定时才加行为。

**不测试阈值。** 你的行为在 `health < 10` 触发，但生命值从来没真正那么低过（因为你的词条告诉 AI「生命值低于 30 时把玩家描写成受伤」），它就永远不会触发。确保阈值和你的世界实际运行的方式对得上。

---

## 另见

- [写出好词条](/zh/creator/advanced/entries-deep)：对叙事上的变化，条件设定常常比行为更合适
- [音频设计](/zh/creator/advanced/audio-deep)：行为里的音频效果，以及什么时候用它们、什么时候用 AI 指令
- [设计游戏状态](/zh/creator/advanced/variables-deep)：设计你的行为要响应的变量

完整的规则 schema 和求值流程 → [世界规格：规则与响应](/zh/world-spec/rules)

</div>
