Cyberpsychosis (cyberpsychosis*)

通用涌现式游戏引擎内核中间件、双端可视化工作台与官方宣传文档站

真涌现设计公式： 瘦 Vocabulary × 极简 Grammar × 瘦 Semantics × 胖 Runtime × 清晰 Renderer

Cyberpsychosis 旨在填补“通用涌现式游戏引擎中间件”的空白。通过组合高性能确定性 ECS 底座与自研的 cyberpsychosis-core（涌现内核），向下统一调度六大可插拔模拟器插件（化学/元素、物理、逻辑/规则重编译、网络/物流、社会/Agent、语义/LLM），向上通过零绑定的状态快照与因果事件协议，同时驱动 终端字符界面（cyberpsychosis-tui） 与 Web 涌现实验室工作台（cyberpsychosis-web）。

---

核心特性

1. 五维框架一等公民建模
   • VocabularyRegistry：声明式定义原子标签（Tag）、正交标量属性（Property）与实体原型（Prefab）。
   • GrammarMatcher：统一支持 2D 网格邻接、连续空间半径、有向图连接以及 [NOUN] [IS] [PROPERTY] 句法序列匹配。
   • SemanticsExecutor：声明式反应矩阵与原子状态重写算子，支持 JSON/DSL 热重载与 TypeScript API 扩展。
2. 内核级“规则即实体”（Rule-as-Entity）动态重编译
   • 模拟规则本身作为 ECS 中的特殊实体存在；空间词块移动或 DSL 注入可实时重编译当前帧的全局/局部物理、化学与逻辑规则。
3. 跨模态解耦通信：共享属性黑板 + 因果事件总线（Causal DAG）
   • 各模拟器插件零直接依赖，通过共享通用标量组件（如 temp、integrity、panic）与携带 causeId 的因果事件总线联动。
   • 内置一等公民有向无环因果图（Causal Lineage DAG），支持任意结果实体的完整起因链回溯与故事生成。
4. 严格确定性、增量快照（Copy-on-Write Delta）、回放分享与 Lockstep 帧同步
   • 基于固定步长（Fixed-Tick）、受控种子 PRNG（Mulberry32）与 32-bit FNV-1a 状态指纹（stateHash）。
   • 内置 周期关键帧 + 写时复制增量帧（CoW Delta Snapshot） 环形缓冲区（压缩比达 4.2x~6.2x），支持任意帧倒带回放（rewindTo）与后台 forkAndPredict(ticks) 平行世界推演。
   • 内置 ReplayTape Base64URL 故事分享（< 150 字符 URL 复现整局涌现链）与带延迟自动回滚重演的 LockstepCoordinator 多人帧同步协调器。
5. 六大模拟器插件、刚体物理/Rapier2D 桥接与综合验证场景
   • 内置 化学/元素（CA）、物理（2D 刚体动量碰撞、可断裂桁架关节 joint、爆炸冲击波，并提供 ExternalRigidBodyAdapter 对接 @dimforge/rapier2d-deterministic-compat）、逻辑/规则（Baba式重编译）、网络/物流（有向流与背压）、社会/Agent（效用AI与情绪传染）、语义桥接（LLM $\rightarrow$ 受限 DSL $\rightarrow$ ECS，自带离线确定性编译器）。
   • 支持 WorldBundle 声明式世界 JSON 热重载，并提供 cyberpsychosis-demo（微缩生态站 Micro Outpost），在同一张 16×12 沙盒中完整串联六大涌现机制。
6. Renderer 零绑定：双官方渲染端（TUI + Web Workbench）与可视化内容工具链
   • cyberpsychosis-tui：终端 ANSI/ASCII 实时交互沙盒与因果检查器。
   • cyberpsychosis-web：浏览器端多图层 Canvas 画布、时间轴控制器、Prefab 画笔、可视化规则构建器（Visual Rule Builder）、WorldBundle JSON 导入导出与 URL 故事分享。
7. 官方宣传与多章节文档站（website/）—— 浏览器内直跑真内核
   • 托管于 Cloudflare Workers（Worker 名称：cyberpsychosis），全站复用 plutokeating.beer 设计系统与模块化 *.i18n.ts 中英双语架构（构建期强制零硬编码视觉参数与零硬编码页面文案校验），首页 H5 沙盒直接挂载编译后的真实 cyberpsychosis-core + cyberpsychosis-demo ES 模块（支持浏览器内直接推词块、单步推演、CoW 回退、实时计算 stateHash 与一键复制 ?replay= 故事链接）。

---

仓库目录结构

Project.Cyberpsychosis/
├── AGENTS.md                        # Agent 工程开发规范
├── REQUIREMENTS.md                  # 需求背景与现有开源方案盘点
├── LICENSE                          # Apache-2.0 开源许可证
├── README.md                        # 项目总览
├── .env.example                     # 环境变量模板
├── package.json                     # Monorepo 工作区与脚本入口
├── tsconfig.base.json               # TypeScript 严格编译基线
├── .github/workflows/               # CI/CD 与 npmjs 自动化发版流水线
├── docs/
│   ├── 涌现式游戏标准定义与概念指南.md # 涌现式游戏五维理论指南
│   ├── ARCHITECTURE.md              # 全局系统架构设计文档
│   ├── API.md                       # 核心模块、DSL 与渲染协议 API 手册
│   └── QUICK_START.md               # 快速启动、测试、网站构建与发版指南
├── packages/
│   ├── core/                        # [cyberpsychosis-core] 涌现内核中间件
│   ├── plugins/                     # [cyberpsychosis-plugins] 六大可插拔模拟器插件
│   ├── demo-minimal/                # [cyberpsychosis-demo] 极简综合验证场景
│   ├── renderer-tui/                # [cyberpsychosis-tui] 终端 ASCII/TUI 沙盒端
│   ├── renderer-web/                # [cyberpsychosis-web] Web 涌现实验室工作台
│   └── cyberpsychosis/              # [cyberpsychosis] 一站式聚合 SDK 与 CLI 主包
└── website/                         # 官方宣传与多章节文档网站 (Cloudflare Worker: cyberpsychosis)

---

快速体验

详见 docs/QUICK_START.md：

# 1. 安装依赖
npm install

# 2. 运行全量类型检查、设计系统校验与单元测试
npm test

# 3. 启动终端 ASCII/TUI 涌现沙盒 (自动剧本模式)
npm run demo:tui

# 4. 启动 Web 涌现实验室工作台 (默认 http://localhost:4173)
npm run start:web

# 5. 运行四档位实体规模与增量快照性能基准测试 (32 ~ 5,000 实体)
npm run bench

# 6. 构建并预览官方宣传与文档网站
npm run site:build

---

开源许可

本项目采用 Apache License 2.0 开源许可协议。