---
title: "动态切换 AI 的叙事风格"
description: "让玩家点一下就在普通、喜剧和恐怖之间切换 AI 的叙事风格，靠的是只在某个模式开着时才生效的设定。"
---
<div v-pre>

# 动态切换 AI 的叙事风格

> 几个按钮，切换 AI 讲故事的风格：普通、喜剧、恐怖。玩家点一下，AI 的下一条回复就换成那种风格。风格的说明写在设定里，只有变量对上的时候才发给 AI，所以不用写代码。

---

## 你要做的东西

- **三种模式**：普通、喜剧、恐怖
- **点一下就切换**：下一条回复用新风格，对话照常接着往下走
- **看得到当前模式**：玩家知道现在开的是哪一种
- **切回去很干净**：模式一变，旧风格的说明就不再发给 AI

### 怎么运作

```
Player taps "Comedy"
  → The button sets the variable Mode to "comedy"
  → The lore entry "Comedy style" only goes to the AI while Mode = comedy, so it's in
  → The lore entry "Horror style" only goes while Mode = horror, so it's out
  → The AI's next reply is written in the comedy style
```

每种风格都是一条普通的设定，只是挂了一个条件。不用手动关掉哪一条，因为同一时间只会有一个条件成立。

---

## 一步一步来

### 第 1 步：建变量

点卡底下 **还可以加** 里的 **＋ 变量**。

| 字段 | 值 |
|-------|-------|
| 名称 | Mode |
| 类型 | 文字 |
| 初始值 | `normal` |

展开 **AI 怎么用它**，把 **AI 权限** 设成 **AI 只读**。模式由玩家的按钮来改，AI 只负责照着写。这是引擎强制的，行为规则里就不用再写「别动这个」。

想在聊天里显示当前模式，点 **放到玩家界面上**。

---

### 第 2 步：每种风格写一条设定

加两条设定（**角色和世界** 右上角的 **＋**）。

#### 设定：喜剧风格

```
[Narration style: Comedy]
Narrate everything in a humorous, comedic tone. You may:
- Use exaggerated metaphors and absurd comparisons
- Now and then break the fourth wall with an aside to the reader
- Give NPCs badly timed lines
- Describe serious scenes in a light voice for contrast
Keep the story moving. Humour goes into the narration; it doesn't replace it.
```

#### 设定：恐怖风格

```
[Narration style: Horror]
Narrate everything with a dark, unsettling atmosphere. You should:
- Slow the pacing down in scene descriptions and dwell on sounds, smells and textures
- Hint that something is watching from the shadows, without ever showing it
- Make the surroundings feel wrong: doors that close by themselves, shadows that move the wrong way, a reflection half a beat late
- Give NPCs lines that are slightly off, as if they know something they shouldn't
- Sometimes describe the character's body in second person: the hair on the neck rising, the heartbeat speeding up
Keep the tension building, but don't put a monster in every paragraph. Leave the worst of it unknown.
```

普通模式不用写设定。两条风格设定都不在的时候，AI 就按你的角色和世界设定本来的写法来写。

#### 给每条设定挂上条件

把 **Mode** 变量拖到「喜剧风格」这条设定上。它们之间会出现一根线，点这根线，把条件设成 Mode **等于** `comedy`。「恐怖风格」也一样，填 `horror`。

这两条设定会挪进条件设定那一块：只有条件成立的时候才发。（也可以打开设定，点最下面的 **什么时候发给 AI** 来设。）

::: tip 风格说明放在哪
设定会和你的其它设定一起放进 AI 的提示里。如果 AI 老是滑回原来的写法，就打开这条设定，把 **注入到** 设成 **放在最后**：这段文字会排在整段对话之后、AI 回复之前，那里是 AI 最上心的位置。
:::

---

### 第 3 步：加按钮

点顶栏中间的 **玩家界面**。在对话页上加三个 **按钮** 部件（**加一个部件** → **按钮**），分别写上普通、喜剧、恐怖。在 **按下时，依次做** 里，每个按钮都排这两步：

1. **改变量**：Mode，**设为**，`normal` / `comedy` / `horror`
2. **弹出提示**：`Switched to Comedy mode`（换成对应的模式）

想让当前的那个按钮亮起来：把按钮复制一份，给复制出来的换个样子，再用 **什么时候显示** → **变量满足条件时**，让它只在 Mode 等于那个值的时候出现。普通样子的那个叠在它上面，条件反过来（Mode **不等于** 那个值）。

关掉 **编辑**，点点这些按钮。这里的预览不会调用 AI，但能看到 Mode 在变。

::: info 换成用行为来做
如果想把切换的逻辑留在画布上，就每种模式建一条行为：**什么时候触发**：**玩家点了某个按钮**，按钮 `mode-comedy`；**效果**：**修改变量** Mode 设为 `comedy`，**显示通知** `Switched to Comedy mode`。这样每个按钮只要一步：**让一条行为生效**。界面代码也能用 `api.executeAction("mode-comedy")` 触发同一条行为。
:::

---

### 第 4 步：试玩

点顶栏的 **试玩**。

1. 在普通模式下聊几回合
2. 点 **喜剧**。提示弹出来，Mode 变成 comedy
3. 发一条消息。回复变得好笑，可能还会打破第四面墙
4. 点 **恐怖**，再发一条。回复变得阴暗、紧绷
5. 点 **普通**，再发一条。叙述回到你这张卡原本的风格

试玩右边的 **这回合** 会列出 AI 拿到了哪些设定，可以看看是不是只进了一条风格设定。

**如果出了问题：**

| 现象 | 可能的原因 | 怎么改 |
|---------|-------------|-----|
| 点了按钮没反应 | 按钮没有 **改变量** 这一步 | 选中按钮，看看 **按下时，依次做** |
| Mode 变了，风格没变 | 设定的条件和值对不上 | 按钮设的是 `comedy`，条件也必须一字不差地查 `comedy` |
| 两种风格都发给了 AI | 有一条设定在每回合都发的那一块里 | 两条设定都看一下 **什么时候发给 AI** |
| 几回合后风格就淡了 | 风格说明离提示的末尾太远 | 把 **注入到** 设成 **放在最后** |

---

## 写代码的做法：最后一条消息下面的模式按钮

如果你自己写界面，就自己画按钮，改的还是同一个变量。第 2 步的设定不用动。

**面板 → 界面代码** → 打开 `index.tsx`，把默认的 `return <Chat />` 换掉：

```tsx
export default function MyWorld() {
  const api = useYumina();
  const currentMode = String(api.variables["Mode"] || "normal");
  const msgs = api.messages || [];

  const modes = [
    { id: "normal", label: "Normal", color: "#94a3b8", activeColor: "#e2e8f0",
      activeBg: "rgba(148,163,184,0.2)", border: "#475569", activeBorder: "#94a3b8" },
    { id: "comedy", label: "Comedy", color: "#fbbf24", activeColor: "#fef3c7",
      activeBg: "rgba(251,191,36,0.2)", border: "#a16207", activeBorder: "#fbbf24" },
    { id: "horror", label: "Horror", color: "#f87171", activeColor: "#fecaca",
      activeBg: "rgba(248,113,113,0.2)", border: "#991b1b", activeBorder: "#f87171" },
  ];

  const switchTo = (mode) => {
    api.setVariable("Mode", mode.id);
    api.showToast("Switched to " + mode.label + " mode", "info");
  };

  return (
    <Chat renderBubble={(msg) => {
      const isLastMsg = msg.messageIndex === msgs.length - 1;
      return (
        <div>
          <div
            style={{ color: "#e2e8f0", lineHeight: 1.7 }}
            dangerouslySetInnerHTML={{ __html: msg.contentHtml }}
          />

          {isLastMsg && (
            <div style={{ display: "flex", gap: "8px", marginTop: "16px", flexWrap: "wrap" }}>
              {modes.map((mode) => {
                const isActive = currentMode === mode.id;
                return (
                  <button
                    key={mode.id}
                    onClick={() => { if (!isActive) switchTo(mode); }}
                    style={{
                      padding: "8px 16px",
                      background: isActive ? mode.activeBg : "transparent",
                      border: `2px solid ${isActive ? mode.activeBorder : mode.border}`,
                      borderRadius: "8px",
                      color: isActive ? mode.activeColor : mode.color,
                      fontSize: "13px",
                      fontWeight: isActive ? "700" : "500",
                      cursor: isActive ? "default" : "pointer",
                      opacity: isActive ? 1 : 0.7,
                      transition: "all 0.2s ease",
                    }}
                  >
                    {isActive ? "● " : ""}{mode.label}
                  </button>
                );
              })}
            </div>
          )}
        </div>
      );
    }} />
  );
}
```

**代码做了什么：**

- `api.variables["Mode"]` 按变量名读这个变量
- `api.setVariable("Mode", mode.id)` 写它。挂了条件的设定在 AI 下一次回复时就会用上新值
- `api.showToast(text, "info")` 弹一个提示（一共三种：`"success"`、`"error"`、`"info"`）
- 当前的按钮带一个圆点并且高亮，再点它不会有反应
- 想跑一条行为而不是直接改变量，就调用 `api.executeAction("mode-comedy")`

**面板 → 界面代码** 里文件旁边的状态应该是绿色的 **正常**。

::: tip 不想自己写代码？
点画布右上角的 **创作助手**，说说你想要什么样的按钮。
:::

---

## 更多玩法

### 再加几种模式

再加一条设定（比如「诗意风格」），条件是 Mode 等于 `poetic`，再加一个把 Mode 设成 `poetic` 的按钮。

### 只管一回合

只该持续一条回复的东西，比如「角色这一句话一直在打嗝」，用一条效果是 **告诉 AI** 的行为。它会给 AI 塞一句玩家看不到的话，只管下一条回复。想持续几回合的话，用一个数值变量来倒数：按钮把它设成 `3`，一条 **每回合** 的行为每次减 1，设定的条件写「Countdown 大于 0」。

### 切换语言

同样的做法也能切换回复的语言：一条设定写「只用日语回复」，条件是 Language 等于 `ja`，每种语言一条。

### 让 AI 自己换模式

把 **AI 权限** 保持在 **AI 可读可写**，再在行为规则里写清楚什么时候该换模式（「队伍进了地下墓穴就切到恐怖」）。这样 AI 会自己去改 Mode，那几条设定也会跟着它走。

---

## 速查

| 你想要 | 怎么做 |
|---------------|-------------|
| 某个模式开着的时候，改变 AI 的写法 | 一条挂了变量条件的设定（条件设定） |
| 用按钮切换模式 | 玩家界面的按钮：**改变量** |
| 不让 AI 改模式 | **AI 权限**：**AI 只读** |
| 把风格说明放在 AI 最上心的位置 | 在这条设定上，**注入到**：**放在最后** |
| 只管下一条回复的提示 | 行为效果：**告诉 AI** |
| 让当前模式亮起来 | 按钮做两个版本，各自用 **什么时候显示** → **变量满足条件时** |
| 从界面代码里切换 | `api.setVariable("Mode", "comedy")` 或 `api.executeAction("mode-comedy")` |

---

::: tip 这是食谱 #11
同样的做法（一个变量，加上几条有条件才发给 AI 的设定）也能用来做难度档位、第一人称和第三人称叙述的切换，或者一个心情随剧情慢慢变化的角色。
:::

</div>
