运作原理
Yumina 中的每一次互动都遵循同一个循环：
玩家发送消息或与 UI 交互
↓
引擎把 AI 需要知道的一切组装起来
↓
AI 生成叙事回复 + 状态变更
↓
引擎提取变更并更新游戏状态
↓
玩家看到故事、更新后的 UI，并听到音效就是这么简单。作为创作者，你要做的就是决定这个循环里放什么 —— AI 读到什么、追踪什么、什么自动发生、以及怎样呈现给玩家。
基本构件
1. 词条 —— AI 读到的内容
词条是 AI 在生成回复时会看到的文本片段。角色描述、世界设定、写作风格指南 —— 这些都是词条。
有些词条始终生效（比如你世界的背景故事），另一些只在相关时出现 —— 由对话中的关键词触发。比如玩家提到「酒馆」时，你写的酒馆知识词条就会自动加入。
→ 了解更多关于词条
2. 变量 —— AI 追踪的状态
变量就是游戏状态 —— 生命值、金币、位置、好感度、背包等等。AI 每回合读取当前值，并在回复中用简单的指令来更新它们：
匪徒的刀锋划过你的手臂。
[health: -15]
[location: set "dark forest"]玩家看到的是叙事文本。引擎在后台悄悄提取这些方括号指令，更新游戏状态。只要你的世界里有变量，引擎就会自动教 AI 指令格式 —— 你不需要自己写任何格式说明。
你通过编写 AI 指令来教 AI 何时以及如何更新每个变量 —— 就是自然语言的指导，比如「受到物理伤害时减少 10-30 点生命值，单回合最多不超过 30 点。」这和下面说的自动化触发器是两回事。
→ 了解更多关于变量
3. 规则与行为 —— 回合之间发生的事
规则处理那些 AI 容易忘记或做得不够一致的事情。它们是事件驱动的触发器，在回合之间自动执行，不需要 AI 参与：
- 当生命值低于 10 → 显示一个「你快死了！」的警告
- 当好感度超过 75 → 注入一条恋爱方向的指令到 AI 的提示中
- 每 5 回合 → 播放一段雷声环境音效
编辑器里这些叫行为，但工作原理一样 —— 每条规则都有一个「何时」触发器、一个可选的「如果」条件、和一个「那么」动作。
规则是可选的。很多优秀的世界完全不用规则 —— AI 通过写得好的词条和 AI 指令就能处理一切。但如果你想做精确阈值的游戏机制，规则能让体验更加紧凑和一致。
4. 视觉与音频 —— 表现层（可选）
默认情况下，玩家看到的是一个简洁的聊天界面，对大多数世界来说已经足够了。
但如果你想走得更远，可以加入自定义 UI 和音频来塑造你的世界的视觉和听觉体验。自定义 UI 让你构建从风格化消息气泡到完整游戏界面（血条、地图、背包）的一切。音频则添加背景音乐、音效和环境声效，AI 会在叙事中自然触发它们。
你不需要会写代码。 Studio AI 可以根据描述帮你生成自定义界面。只需描述你想要什么，它就帮你搭建好。音频也一样 —— AI 在写故事的同时写出音频指令，引擎播放对应的声音。
这些都是纯粹的表现层。它们读取游戏状态，但不会改变状态。所有状态变更仍然通过 AI 的指令来完成。
AI 实际看到什么
下面是每回合组装到 AI 提示中的内容的确切顺序。AI 对开头和结尾的内容关注度最高 —— 中间的内容关注度较低。理解这一点有助于你把内容放在最能发挥作用的位置：
| 顺序 | 内容 | 在哪里配置 |
|---|---|---|
| 1 | 你的常驻词条（角色、世界、叙事指令） | 词条 → 系统预设区 |
| 2 | 玩家的当前人设（名字、外貌、背景） | 玩家的设置，不是你的 |
| 3 | 变量 AI 指令 + 当前值 | 变量标签页 |
| 4 | 示例对话 | 带有「示例」角色的词条 |
| 5 | 对话历史 | 自动处理 |
| 6 | 关键词触发词条（注入到相关消息附近） | 词条 → 关键词触发区 |
| 7 | 后置指令（最终强调、风格约束） | 词条 → 后置指令区 |
对话历史上下的内容在每回合保持稳定。对话历史本身会不断增长，当接近上下文限制时，记忆系统会自动进行摘要 —— 所以你设置的框架不会被挤出去。
两种创建方式
使用 Studio AI（推荐）
打开 Studio 编辑器，描述你想要什么，内置的 AI 助手就会帮你创建词条、变量和自动化规则。它对平台了如指掌 —— 正确的语法、成熟的模式、引用完整性。
「创建一个生存恐怖世界，有生命值、理智值和饥饿度。玩家被困在一座废弃医院里。看到恐怖的东西时理智值会下降。理智值归零时，AI 应该描写幻觉。」
Studio AI 会生成词条、带有 AI 指令的变量、以及在理智值归零时触发的规则 —— 全部正确地连接在一起。
使用你自己的 AI + World Spec
如果你更习惯在 Claude Code、Cursor 或 ChatGPT 中工作，可以下载 World Spec —— 一份专为 AI 工具设计的完整技术参考。你的 AI 读取规格说明，你描述想要什么，它就能生成有效的世界 schema 供你导入。
准备好了吗？
打开编辑器创建一个新世界，或者继续阅读，深入了解每个构件的细节。