ROM (disco.db, 只读)
  ├── temp_table   111166 个对话节点（台词 + conditionstring + userscript）
  ├── dialogues     1428 个场景
  ├── dlinks       134491 条跳转边
  ├── checks         235 个掷骰检查
  ├── modifiers      921 个修正
  ├── alternates    2843 条备选台词
  ├── variables    10513 个全局变量
  └── actors         421 个角色

引擎层
  ├── RomDb          SQLite 封装（node:sqlite 零依赖）
  ├── parser.ts      递归下降 Lexer + Parser（conditionstring + userscript）
  ├── eval.ts        ConditionEvaluator + ScriptRunner + FunctionRegistry
  ├── CheckResolver  2d6 + 技能 + 修正 vs 难度
  ├── Engine         主循环：节点→条件→选项→dlinks→脚本→掷骰→存档
  └── WorldState     variables + inventory + party + time + reputation + skills

适配层
  └── DiscoFunctions  85 个游戏函数注册（IsKimHere/CheckItem/SetVariableValue...）

服务层
  ├── MCP server      disco.start/play/status/history/save/load/scenes（远程 HTTP transport）
  └── WebSocket       实时推送台词/掷骰/选项/变量变化给浏览器观察页

npm install
npm run demo          # 引擎端到端验证（控制台输出）
npm run play          # 启动完整服务（MCP + 观察页）

{
  "mcpServers": {
    "disco": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

# VPS 上
git clone <repo> && cd disco-engine
npm install
# 把 disco.db 放到 data/ 目录
DISCO_PORT=3000 DISCO_MODE=both npm run play

# 用 pm2 守护
pm2 start "npx tsx src/index.ts" --name disco

{ "mcpServers": { "disco": { "url": "https://your-vps:3000/mcp" } } }

disco.start({sceneId: 142})     → 看到开场台词 + 2 个选项
disco.play({choices: [0]})      → 选"试着开锁"，看到后续剧情 + 4 个选项
disco.play({choices: [2]})      → 选"砸门"，看到掷骰结果 + 后续
disco.play({})                  → 不选，继续 auto-advance 到下一个决策点
disco.status()                  → 查看当前状态
disco.save({slot: "ch1"})       → 存档