运作原理
Yumina 里每一次玩家发送信息，都会发生下面这一系列事情，只要理解了，你就知道你写下的每个字、配置的每条规则会被引擎在什么时候用到。
循环
玩家输入（消息或 UI 交互）
↓
① 引擎组装 prompt：条目 + 变量 + 对话历史
↓
② AI 生成回复：叙事文本 + [状态指令]
↓
③ 引擎：提取状态指令 → 更新变量 → 评估规则 → 触发规则结果（变量变化，音效触发）
↓
玩家看到：故事 + 更新后的 UI + 音效
↓
进入下一回合作为创作者，你可以决定要在这个循环里放什么** —— AI会看到什么（条目）、追踪什么（变量）、什么自动发生（变量）、以及怎样呈现给玩家（前端）。
一个具体的回合
玩家在恐怖生存游戏里输入「我喝下药水」。下面是这一回合发生的事。
① 引擎组装的 prompt
引擎把你写的东西、变量、对话历史拼成一份 prompt 发给 AI：
// —— 你写的世界设定 ——
[system]
你扮演这场生存恐怖游戏的叙述者。文风冷峻克制，
多用感官细节，绝不替玩家决定行动。
[system]
废弃多年的松崎疗养院，封闭于 1987 年冬。
玩家是上山搜寻失踪友人的大学生。
// —— 你定义的变量（引擎自动转成 AI 看得懂的格式）——
[system]
<behavior-rules>
[health] 玩家的血量，受伤时减少 10-30 点，休息时增加5-15点
[sanity] 看到恐怖事物时减少 5-15 点，休息时增加5-10点
</behavior-rules>
// —— 对话历史 ——
[user]
我推开门
[assistant]
一只手抓住了你的手腕，皮肤异常冰冷...
[user]
我喝下药水
// —— 当前状态（每回合会根据ai发出的指令更新，引擎会持续记录最新的各个变量）——
[system]
<game-state>
health: 45
sanity: 30
day: 3
</game-state>② AI 的原始输出
药水滚烫地流过喉咙，但你感觉好多了。
[health: +20]（ai输出的[状态指令])③ 玩家最终看到
药水滚烫地流过喉咙，但你感觉好多了。
❤️ health 45 → 65
引擎从 AI 输出末尾抠出 [health: +20]、应用到状态、检查相关规则（满血时该触发什么吗？）、把指令从文本里删掉，只把干净的叙事呈现给玩家。
AI 不会改数据 —— 它会写出指令，由引擎做执行。
每张卡的组成
1. 条目 —— AI 读到的内容
条目是 AI 在生成回复时会看到的东西，完全由你来决定和书写，可能有角色描述、世界设定、写作风格指南 —— 这些都是条目。
条目可以始终生效（比如你世界的背景故事），也可以做成关键词触发 —— 由对话中的关键词触发。比如你可以给一个酒馆设置关键词，“酒”，当玩家或者ai提到「酒」时，你写的酒馆知识条目就会自动加入，如果没有，则不会发送给ai。
条目越精炼，AI 越听话。 每条 AI 每回合都会读一遍 —— 多写一条不必要的，等于让真正重要的那条更容易被忽略。
→ 了解更多关于条目
2. 变量 —— AI 追踪的状态
变量就是游戏状态 —— 生命值、金币、位置、好感度、背包等等。AI 每回合读取当前值，并在回复中用简单的指令来更新它们：
匪徒的刀锋划过你的手臂。
[health: -15]
[location: set "黑暗森林"]玩家看到的是叙事文本。引擎在后台悄悄提取这些方括号指令，更新游戏状态。只要你的世界里有变量，引擎就会自动教 AI 指令格式，你只要写好这个变量代表着什么，应该如何变化就可以( •̀ ω •́ )✧。比如「受到物理伤害时减少 10-30 点生命值，单回合最多不超过 30 点。」。
变量最好也不要太多。 每个变量每回合都会塞进 prompt 占一行 —— 加一个你不真用的变量，就是浪费 AI 的注意力。
→ 了解更多关于变量
3. 行为 —— 完全由引擎自动操控的事情
行为为可以用来处理那些 AI 容易忘记或做得不够一致的事情。不需要 AI 参与：
- 当生命值低于 10 → 显示一个「你快死了！」的警告
- 当好感度超过 75 → 注入一条恋爱方向的指令到 AI 的提示中
- 每 5 回合 → 播放一段雷声环境音效
每条行为都有一个「何时」触发器、一个可选的「如果」条件、和一个「那么」动作。
行为是可选的。但如果你想做精确阈值的游戏机制，行为能让游戏更加一致。
4. 视觉与音频 —— 表现层（可选）
默认情况下，玩家看到的是一个简洁的聊天界面，对大多数世界来说已经足够了。
但如果你想走得更远，可以加入自定义 UI 和音频来塑造你的世界的视觉和听觉体验。自定义 UI 让你构建从风格化消息气泡到完整游戏界面（血条、地图、背包）的一切。音频则添加背景音乐、音效和环境声效，AI 会在叙事中自然触发它们。
你不需要会写代码。 点击进入工作室，里面的AI助手可以根据描述帮你生成自定义界面。只需描述你想要什么（请给我制作个符合我这个世界的主题的超级无敌吊炸天的3A级别制作的前端），它就帮你搭建好。
AI看到的顺序
下面是每回合组装到 AI 提示中的内容的确切顺序。AI 对开头和结尾的内容关注度最高 —— 中间的内容关注度较低。理解这一点有助于你把内容放在最能发挥作用的位置：
| 顺序 | 内容 | 在哪里配置 |
|---|---|---|
| 1 | 你的常驻条目（角色、世界、叙事指令） | 条目 → 系统预设区 |
| 2 | 玩家的当前人设（名字、外貌、背景） | 玩家的设置，和创作者无关 |
| 3 | 变量行为规则 + 当前值 | 变量标签页 |
| 4 | 示例对话 | 带有「示例」角色的条目 |
| 5 | 对话历史 | 自动处理 |
| 6 | 关键词触发条目（注入到相关消息附近） | 条目 → 关键词触发区 |
| 7 | 后置指令（最终强调、风格约束） | 条目 → 后置指令区 |
使用ai的创建方式
使用 Studio AI（推荐）
打开 Studio 编辑器，描述你想要什么，内置的 AI 助手就会帮你创建条目、变量和自动化规则。它对平台了如指掌 —— 正确的语法、成熟的模式、引用完整性。
「创建一个生存恐怖世界，有生命值、理智值和饥饿度。玩家被困在一座废弃医院里。看到恐怖的东西时理智值会下降。理智值归零时，AI 应该描写幻觉。」
Studio AI 会生成条目、带有行为规则的变量、以及在理智值归零时触发的规则 —— 全部正确地连接在一起。（当然，最后这些条目里的内容由你来人工审核修改一遍会让世界精彩很多哦╰(°▽°)╯）
使用你自己的 AI + World Spec
如果你更习惯在 Claude Code、Cursor 或 ChatGPT 中工作，可以下载 World Spec —— 一份专为 AI 工具设计的完整技术参考。你的 AI 读取规格说明，你描述想要什么，它就能生成有效的世界 schema 供你导入。
准备好了吗？
打开编辑器创建一个新世界，或者继续阅读，深入了解每个构件的细节。