CHAPTER 01 // FOUNDATION
概览与五维涌现架构
为什么涌现式游戏需要一层专门的“胖 Runtime 内核中间件”，以及五维公式如何映射为工程代码。
1.1 什么是 Cyberpsychosis 涌现引擎
在传统内容驱动游戏中，玩家体验到的是设计师一笔一画预设的关卡与剧情；而在涌现式游戏（Emergent Gameplay，如 Noita、Baba Is You、Dwarf Fortress、Factorio）中，乐趣来自于简单原子规则在运行时碰撞出的意外结果。
Cyberpsychosis 旨在填补开源界“通用涌现式游戏引擎中间件”的空白。我们不重复造底层的渲染轮子，而是专注于提供一层薄而强大的确定性涌现内核（cyberpsychosis-core）与六大可插拔模拟器插件（cyberpsychosis-plugins）。
- 五维显式建模：Vocabulary、Grammar、Semantics、Runtime、Renderer 各自对应独立模块；
- 规则即实体（Rule-as-Entity）：模拟规则本身存储在 ECS 世界中，支持运行时实时重编译；
- 跨模态因果溯源：内置有向无环因果图（Causal DAG），自动回答“为什么会发生这件事”；
- 零绑定双端渲染：同一套世界快照流同时驱动终端 ASCII/TUI 与 Web 涌现实验室工作台。
1.2 真涌现设计公式与代码映射
根据《涌现式游戏标准定义与概念指南》，高杠杆涌现系统遵循核心公式：瘦 Vocabulary × 极简 Grammar × 瘦 Semantics × 胖 Runtime × 清晰 Renderer。
| 维度 (Dimension) | 理论定义 | Cyberpsychosis 对应模块 | 核心职责 |
|---|---|---|---|
| Vocabulary | 玩家能操作的原子单元 | VocabularyRegistry | 注册正交 Tag、标量属性上下界与 Prefab 原型 |
| Grammar | 单元怎么组合才合法 | GrammarMatcher | 支持 2D 网格邻接、连续空间半径、图拓扑边、三连句法匹配 |
| Semantics | 组合意味着什么状态变化 | SemanticsExecutor | 执行原子属性增减、标签赋予、实体派生与因果记录 |
| Runtime | 世界怎么运行与跨系统模拟 | EmergenceKernel + 6 Plugins | 确定性 Tick 调度、Rule-as-Entity 重编译、快照回放与平行分叉 |
| Renderer | 玩家如何清晰读懂涌现结果 | WorldSnapshot + Causal DAG | 零耦合输出 JSON 快照流，驱动 TUI 与 Web 多图层工作台 |
1.3 四层解耦架构全景
整个系统自底向上分为四层：Layer 1 涌现内核（cyberpsychosis-core）、Layer 2 可插拔模拟器插件（cyberpsychosis-plugins）、Layer 3 极简综合验证沙盒（cyberpsychosis-demo）、以及 Layer 4 零绑定渲染与调试端（cyberpsychosis-tui / cyberpsychosis-web）。
// TEXT
CYBERPSYCHOSIS SDK
Layer 4: Renderers & Inspectors (cyberpsychosis-tui / cyberpsychosis-web)
▲ WorldSnapshot / CausalLineageReport / REST & CLI Commands
Layer 3: Verification Scenario (cyberpsychosis-demo: 16x12 Micro Outpost)
▲ Declarative DSL & Prefab Assembly
Layer 2: Pluggable Simulators (cyberpsychosis-plugins: Chemistry/Physics/Logic/Logistics/Social/Semantic)
▲ Shared Scalar Properties (temp, integrity, panic) + Causal Event Bus
Layer 1: Emergence Kernel (cyberpsychosis-core: ECS, RuleEngine, SpatialIndex, CausalTracker, WorldFork)