触发前置：
  1. 玩家已获得说书人老宅地契（V['fable:deed'] === 1）
  2. 说书人常客度 ≥ 80（自己人级别）
  3. 二十折《未卜书》已全部读完（V['fable:serialDone'] === 1）
  4. 连中七卦里程碑已达成（V['fable:gift7'] === 1）

原来：23 格通往 DoL 世界各地（三页 8/8/6）
变化后：最后一页新增一格「一扇从未见过的门」

门上描述：
  "这扇门你从未注意过——或许它一直不在那里。
   门框上刻着细密的符文，隐约泛着青光。
   门缝间透出一缕不属于这个世界的灵气。"

门图标：自定义"仙门"图标（AI 生成）

第一幕：
  说书人的声音从身后传来——
  "客人，您终于看到了这扇门。"
  他站在堂屋门口，青布长衫在无风中轻轻飘动。
  "我讲了二十折书给您听，每一折都是这个世界的真实。
   现在，您准备好亲自走进去了吗？"

第二幕（选择）：
  [我已经准备好了] → 进入修仙世界
  [我还需要准备] → 返回老宅（可以之后再来）

第三幕（确认后）：
  说书人从怀中取出一枚温润的玉佩，递到你手上。
  "拿着这个。到了那边，它会护住你的神魂。"
  "记住——你在那个世界里的一切，都会真实地影响这里。
   修为、法宝、甚至……道侣。"
  他微微一笑，"毕竟，故事里的人，总觉得自己是醒着的。"

  你推开门。
  青光吞没了一切。

  → 进入「仙缘·开局」序列

示例（首次进入修炼界面时）：
  "修炼这件事，说难也难，说简单也简单。
   您看到那个进度条了？每天打坐，它就往前走一点。
   走到头了，就该冲关了。冲得过去海阔天空，冲不过去……
   嗯，那就再说吧。"

// 跨世界物品桥接
FanrenBridge = {
  // 灵石 ↔ 英镑 汇率
  STONE_TO_POUND: 0.5,

  // 进入修仙世界时：DoL → 修仙
  onEnterCultivation: function() {
    // 自动兑换 £100 → 200灵石（首次进入奖励）
    // 服装同步：DoL衣柜 → 修仙储物袋
    // 属性映射：魅力/体能 → 修仙初始加成
  },

  // 回到DoL世界时：修仙 → DoL
  onReturnToDoL: function() {
    // 灵石 → £ 自动结算（可选比例）
    // 丹药/灵材 → 老宅信箱
    // 法袍 → DoL衣柜
    // 法术/境界/灵力 → 完全保留（不做转换）
  },

  // 物品映射表
  ITEM_MAP: {
    // 修仙物品 → DoL 等价物
    "spirit-robe-01":  { dolSlot: "upper", dolName: "青色法袍", defense: 5 },
    "qingfeng-sword":  { dolSlot: "mainHand", dolName: "青锋剑", attack: 8 },
    "juling-pill":     { dolEffect: "energy", value: 20, name: "聚灵丹" },
    // ...
  },
};

// 仙门入口注入（追加到 fable-home.twee 的 fhome_door 段）
// 在神奇的门的最后一页末尾追加一格

// 条件判定（twee）
<<if V['fable:deed'] and V['fable:audience'] >= 80 and V['fable:serialDone'] and V['fable:gift7']>>
  <<dooricon "open">>[[一扇从未见过的门|fanren_portal_enter]]
<</if>>

// 过渡段 :: fanren_portal_enter
// 包含说书人的送别台词 + 选择 + 进入修仙世界

// 说书人引导系统（fanren-guide.js）
FanrenGuide = {
  // 引导节点注册表
  nodes: {
    spiritualRoot: { shown: false, trigger: "firstEnter" },
    cultivation: { shown: false, trigger: "unlockCultivation" },
    combat: { shown: false, trigger: "firstCombat" },
    sect: { shown: false, trigger: "enterSect" },
    alchemy: { shown: false, trigger: "unlockAlchemy" },
    npc: { shown: false, trigger: "meetFirstNPC" },
  },
  
  // 显示引导文本
  showGuide: function(nodeId) {
    var node = this.nodes[nodeId];
    if (!node || node.shown) return;
    node.shown = true;
    V['fable:guideSeen'] = V['fable:guideSeen'] || {};
    V['fable:guideSeen'][nodeId] = true;
    return GUIDE_TEXTS[nodeId];
  },
};

┌─────────────────────────────────────────────────────────┐
│                      人 界                              │
│                                                         │
│  ┌─────────────┐    ┌─────────────┐    ┌────────────┐  │
│  │  天南地区    │    │  乱星海      │    │  大晋帝国  │  │
│  │             │───→│             │───→│            │  │
│  │ ·越国       │    │ ·外星海      │    │ ·大晋皇城  │  │
│  │ ·元武国     │    │ ·内星海      │    │ ·阴罗宗    │  │
│  │ ·紫金国     │    │ ·妙音门      │    │ ·太真门    │  │
│  │ ·姜国       │    │ ·星宫       │    │            │  │
│  │             │    │             │    │            │  │
│  │ 黄枫谷 ←起点│    │             │    │            │  │
│  └─────────────┘    └─────────────┘    └────────────┘  │
│         │                                      │        │
│         ▼                                      ▼        │
│  ┌─────────────┐                      ┌────────────┐   │
│  │  幕兰草原    │                      │  极西之地   │   │
│  │             │                      │            │   │
│  │ ·幕兰族     │                      │ ·大雷音寺  │   │
│  │ ·游牧部落   │                      │ ·各种蛮荒  │   │
│  └─────────────┘                      └────────────┘   │
│                                                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │  其他区域                                        │    │
│  │  ·乱魔海 ·海底秘境 ·各处上古遗迹 ·各中小国家     │    │
│  └─────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────┘

灵气等级：
  稀薄（凡人城镇）   → 修炼速度 ×0.3
  普通（一般野外）   → 修炼速度 ×0.7
  浓郁（宗门/灵山）  → 修炼速度 ×1.0
  极浓（灵脉/秘境）  → 修炼速度 ×1.5
  仙灵之气（上古遗迹）→ 修炼速度 ×2.0+

// 灵根数据结构
V.fanren = {
  spiritualRoot: {
    type: "dual",          // "five"|"four"|"triple"|"dual"|"single"|"mutant"
    elements: ["metal", "wood"],  // 具体属性
    aptitude: 75,          // 0-100，同类型内的个体差异
  },
  // 灵根决定了修炼速度基础值
  // aptitude 影响突破成功率和领悟功法的速度
};

V.fanren.cultivation = {
  realm: "foundation",     // 当前境界
  stage: "early",          // 初期/中期/后期
  progress: 0,             // 0-100，当前阶段修炼进度
  totalProgress: 0,        // 累计修炼量（用于某些条件判断）
  breakthroughAttempts: 0, // 突破尝试次数
  realmHistory: [],        // 境界历史记录
};

日增长 = 基础速率 × 灵根倍率 × 灵气浓度 × 功法加成 × 丹药加成 × 心境修正

基础速率：由境界决定，越高越慢
  炼气：0.5/天
  筑基：0.3/天
  结丹：0.15/天
  元婴：0.08/天
  化神+：0.04/天

灵根倍率：见灵根表
灵气浓度：见灵气等级表
功法加成：1.0-3.0，取决于功法品级
丹药加成：1.0-2.0，取决于丹药品质
心境修正：0.5-1.5，受 DoL 压力/创伤系统影响

突破成功率 = 基础成功率 × 灵根修正 × 丹药修正 × 心境修正 × 外在条件

基础成功率：
  炼气→筑基：60%
  筑基→结丹：40%
  结丹→元婴：25%
  元婴→化神：15%
  化神→炼虚：10%（需要特殊条件）
  更高境界：逐步递减

灵根修正：天灵根 ×1.5，双灵根 ×1.2，伪灵根 ×0.6
丹药修正：有对应突破丹 ×1.3-2.0
心境修正：无创伤 ×1.2，重度创伤 ×0.5
外在条件：在灵脉上突破 ×1.3，有护法 ×1.1

V.fanren.techniques = {
  main: {                // 主修功法（只能一本）
    id: "qingyuan_01",
    name: "清元剑诀",
    grade: "spirit-upper",
    level: 5,            // 修炼层数
    maxLevel: 12,
    effects: {
      cultivationSpeed: 1.5,
      combatPower: 1.3,
      element: "metal",
    },
  },
  auxiliary: [],         // 辅修功法（可多本）
  secret: [],            // 秘术（一次性或特殊条件触发）
};

V.fanren.spiritBeasts = [
  {
    id: "beast_001",
    name: "啼魂兽",
    species: "啼魂",
    level: 3,
    loyalty: 80,        // 忠诚度
    growth: 0.6,        // 成长度
    skills: ["soul_attack", "fear_aura"],
    evolution: null,     // 进化条件
  },
];

原版 DoL 战斗：
  攻击 / 防御 / 逃跑 / （物品）

修仙传扩展：
  物理攻击（保留原版）
  法术攻击（新增）
  法宝攻击（新增）
  灵兽攻击（新增）
  防御/护体灵光（扩展原版）
  符箓使用（新增）
  逃跑/遁术（扩展）
  投降/求饶（保留，增加修仙世界特有后果）

V.fanren.combat = {
  spiritualPower: 100,     // 灵力（MP），上限由境界决定
  spiritualPowerMax: 100,
  hp: V.tiredness,         // 复用 DoL 体力系统
  hpMax: V.fitness,        // 复用 DoL 体质
  
  // 战斗状态
  activeBuffs: [],         // 当前增益法术
  activeDebuffs: [],       // 当前减益
  formationActive: null,   // 激活的阵法
};

战斗开始
  ↓
判断先手（灵觉/速度属性）
  ↓
┌─── 玩家回合 ───┐
│ 选择行动：       │
│ ·物理攻击        │
│ ·施放法术（消耗灵力）│
│ ·使用法宝        │
│ ·灵兽攻击        │
│ ·使用符箓        │
│ ·防御            │
│ ·使用物品（丹药等）│
│ ·逃跑            │
└────────┘
  ↓
┌─── 敌人回合 ───┐
│ AI 决策：        │
│ ·物理攻击        │
│ ·法术攻击        │
│ ·特殊技能        │
│ ·防御            │
│ ·逃跑（部分敌人） │
└────────┘
  ↓
判断胜负 → 继续/结束

// 敌人等级缩放
function generateEnemy(zone, playerRealm) {
  const realmIndex = REALM_ORDER.indexOf(playerRealm);
  const enemyLevel = clamp(realmIndex + random(-1, 1), 0, MAX_REALM);
  // 敌人可能比玩家低1级到高1级
  
  // 某些区域有固定强敌（BOSS）
  if (zone.bosses && random() < 0.05) {
    return pick(zone.bosses);
  }
  
  return generateGenericEnemy(enemyLevel, zone.enemyPool);
}

1. 获取丹方（配方）
2. 收集灵材
3. 在丹炉中炼制
4. 判定成功率（受炼丹等级、灵材品质、丹炉品质影响）
5. 获得丹药（品质有波动）

1. 获取器方（图纸）
2. 收集灵材（矿石、妖兽材料等）
3. 在炼器炉中熔炼
4. 锻造成型
5. 刻录阵法
6. 判定品质

// NPC 自主行为示例
V.fanren.npcAI = {
  hanLi: {
    currentLocation: "outer-sea",
    cultivationGoal: "nascent-soul",
    relationshipWithPlayer: "neutral",
    // 韩立会自己修炼、探索、做任务
    // 玩家可以在某些地点偶遇他
    // 关系好时会分享情报/资源
    // 关系差时可能在某些场景冲突
  },
};

V.fanren.relationships = {
  "npc_hanli": {
    friendship: 50,      // 友情 0-100
    trust: 30,           // 信任 0-100
    romance: 0,          // 感情 0-100（仅部分NPC可发展）
    respect: 40,         // 敬重 0-100
    hostility: 0,        // 敌意 0-100
    // 综合关系等级由以上维度计算
  },
};

双修效果 = 基础修炼量 × 双方功法契合度 × 关系亲密度 × 环境灵气

功法契合度：
  互补属性（如阴阳互补）：×2.0
  同属性：×1.5
  相克属性：×0.8（但可以提升亲密度）

V.fanren.sect = {
  id: "yellow-maple",
  rank: "outer-disciple",  // 外门弟子/内门弟子/核心弟子/长老/掌门
  contribution: 0,         // 贡献点
  reputation: 50,          // 宗门声望 0-100
  tasks: [],               // 可接任务
  unlockedAreas: ["outer"], // 已解锁区域
  unlockedTechniques: [],   // 已解锁功法
};

V.fanren.world = {
  // 时钟
  day: 0,                    // 世界天数（从玩家首次进入起算）
  lastSimDay: 0,             // 上次模拟推进到的天数
  playerPresent: false,      // 玩家当前是否在修仙世界
  enteredDay: 0,             // 玩家首次进入的天数（=0）
  
  // 跨世界同步
  lastDepartDay: 0,          // 玩家上次离开修仙世界的天数
  returnGap: 0,              // 本次回归时计算出的离开天数差
};

V.fanren.worldState = {
  // NPC 状态快照（每个重要NPC一份）
  npcs: {
    hanLi: {
      alive: true,
      realm: "qi",           // 当前境界 id
      stage: 6,              // 炼气6层
      location: "yellow-maple-outer",  // 当前位置 id
      hp: 100,               // 当前生命比例
      status: "cultivating", // 状态：cultivating/traveling/fighting/idle/dead
      timelineIdx: 3,        // 时间线执行到第几条
      relationship: 0,       // 与玩家的关系值 -100~100
      lastSeenByPlayer: -1,  // 上次与玩家同地点的天数（-1=从未）
      known: false,          // 玩家是否知道此人存在
      metadata: {},           // NPC 特有字段
    },
    // ... 更多 NPC
  },
  
  // 势力状态
  factions: {
    "yellow-maple": {
      power: 100,             // 综合实力（动态变化）
      territory: ["yellow-maple-mountain"],  // 控制区域
      alliances: ["spirit-beast-mountain"],   // 盟友
      enemies: ["ghost-gate"],                // 敌对
      leader: "yueyan",       // 掌门 NPC id
      eventHistory: [],       // 该势力经历的大事
    },
    // ... 更多势力
  },
  
  // 区域状态
  zones: {
    "blood-forbidden": {
      open: false,            // 血色禁地是否开启
      nextOpenDay: 100,       // 下次开启天数
      explored: false,        // 是否已被探索
      secrets: [],            // 已发现的秘密
    },
    // ...
  },
  
  // 世界事件日志（永久记录）
  eventLog: [
    // { day, type, actor, action, detail, playerInvolved }
  ],
  
  // 玩家造成的世界改变（永久记录）
  playerImpact: {
    kills: [],        // 玩家杀死的NPC/势力成员
    saves: [],        // 玩家救过的NPC
    gifts: [],        // 玩家赠送过的重大物品
    battles: [],      // 玩家参与的重大战斗
    discoveries: [],  // 玩家的发现（秘境、宝物等）
    reputation: {},   // 在各势力中的声望变化
    karma: 0,         // 因果值（善行/恶行累计）
  },
};

// 事件定义格式
{
  id: "blood-forbidden-open-1",
  type: "scheduled",        // scheduled/conditional/npc/faction/random/chain
  day: 100,                 // scheduled 类型专用
  condition: function(),    // conditional 类型专用
  actor: null,              // npc/faction 类型专用
  priority: 1,              // 同天多事件时的执行顺序
  once: true,               // 是否只触发一次
  execute: function(day, worldState) { ... },
}

function simulateDay(day) {
  // 1. 推进所有NPC时间线
  for (var npcId in V.fanren.worldState.npcs) {
    advanceNPC(npcId, day);
  }
  
  // 2. 执行当天定时事件
  var scheduled = EVENT_TABLE.filter(function(e) {
    return e.type === "scheduled" && e.day === day;
  });
  scheduled.forEach(function(e) { e.execute(day, V.fanren.worldState); });
  
  // 3. 检查条件事件
  CONDITIONAL_EVENTS.forEach(function(e) {
    if (e.condition(day, V.fanren.worldState)) {
      e.execute(day, V.fanren.worldState);
    }
  });
  
  // 4. 势力演化
  advanceFactions(day);
  
  // 5. 随机事件（按区域 roll）
  generateRandomEvents(day);
  
  // 6. 记录日志
  logDaySummary(day);
}

NPC_TIMELINES = {
  hanLi: {
    // 韩立的完整人生轨迹（基于小说）
    // 每条 = { day, action, location, duration, condition?, effect? }
    entries: [
      { day: 0,   action: "cultivate",   location: "yellow-maple-outer", duration: 30,
        note: "在黄枫谷外门修炼" },
      { day: 30,  action: "mission",     location: "yellow-maple", duration: 10,
        note: "执行宗门任务" },
      { day: 50,  action: "travel",      destination: "inner-sea", duration: 30,
        note: "离开黄枫谷前往乱星海" },
      { day: 100, action: "explore",     location: "outer-sea", duration: 50,
        note: "在外星海历险" },
      { day: 150, action: "breakthrough",realm: "core", location: "outer-sea",
        note: "在乱星海结丹" },
      // ... 数百条，覆盖韩立整条小说线
    ],
    
    // 韩立的性格参数（影响对玩家行为的反应）
    personality: {
      caution: 0.9,        // 谨慎度（极高）
      greed: 0.3,          // 贪心度（低）
      loyalty: 0.7,        // 忠诚度（高）
      curiosity: 0.5,      // 好奇心（中）
      trustBaseline: 20,   // 初始信任值
    },
    
    // 对玩家反应规则
    reactionRules: [
      // 例：如果玩家偷了韩立的东西
      { condition: "playerStoleFrom", threshold: 1,
        effect: "relationship -50, mark as enemy" },
      // 例：如果玩家救过韩立
      { condition: "playerSaved", threshold: 1,
        effect: "relationship +30, may gift item" },
      // 例：如果在同一地点且关系>50
      { condition: "sameLocation && relationship > 50",
        effect: "trigger encounter event" },
    ],
  },
  
  nanGongWan: {
    entries: [
      // 南宫婉自己的轨迹
      // ...
    ],
    personality: { /* ... */ },
    reactionRules: [ /* ... */ ],
  },
  
  // ... 更多 NPC
};

function advanceNPC(npcId, day) {
  var state = V.fanren.worldState.npcs[npcId];
  var timeline = NPC_TIMELINES[npcId];
  if (!state || !timeline || !state.alive) return;
  
  var entry = timeline.entries[state.timelineIdx];
  if (!entry) return; // 时间线已走完
  
  // 检查是否到了执行时间
  if (day >= entry.day) {
    // 执行该条
    executeNPCEntity(npcId, entry, day);
    
    // 推进到下一条
    state.timelineIdx++;
    
    // 执行效果（修炼突破、位置变更等）
    applyNPCEffect(npcId, entry, day);
  }
  
  // NPC 日常修炼（即使在等待期间也在修炼）
  if (state.status === "cultivating" || state.status === "idle") {
    npcDailyCultivation(npcId);
  }
}

function checkNPCCEncounters(locationId) {
  var encounters = [];
  for (var npcId in V.fanren.worldState.npcs) {
    var state = V.fanren.worldState.npcs[npcId];
    if (state.location === locationId && state.alive) {
      // 根据关系值和NPC性格决定是否出现
      var chance = calculateEncounterChance(npcId, state);
      if (Math.random() < chance) {
        encounters.push(npcId);
      }
    }
  }
  return encounters;
}

V.fanren.worldState.factions["yellow-maple"] = {
  power: 100,              // 综合实力值（动态）
  powerHistory: [],         // 每天的实力快照（用于趋势计算）
  territory: [],            // 控制区域列表
  alliances: [],            // 盟友势力 id
  enemies: [],              // 敌对势力 id
  leader: "yueyan",         // 掌门
  elderCount: 5,            // 长老数量
  discipleCount: 200,       // 弟子数量
  morale: 70,               // 士气 0-100
  treasury: 10000,          // 灵石储备
  eventHistory: [],         // 经历的大事
};

function advanceFactions(day) {
  for (var fid in V.fanren.worldState.factions) {
    var f = V.fanren.worldState.factions[fid];
    
    // 1. 实力自然变化（弟子修炼/陨落影响）
    f.power += calculateFactionGrowth(fid);
    
    // 2. 检查势力关系临界
    checkFactionRelations(fid, day);
    
    // 3. 资源消耗（维持弟子/阵法等）
    f.treasury -= f.discipleCount * 0.5;
    if (f.treasury < 0) f.morale -= 5; // 穷→士气降
    
    // 4. 记录历史
    f.powerHistory.push({ day: day, power: f.power });
  }
}

function checkFactionRelations(fid, day) {
  var f = V.fanren.worldState.factions[fid];
  
  // 检查所有敌对势力
  f.enemies.forEach(function(eid) {
    var enemy = V.fanren.worldState.factions[eid];
    if (!enemy) return;
    
    // 实力差距 + 随机因素 → 战争概率
    var powerDiff = Math.abs(f.power - enemy.power);
    var aggression = calculateAggression(fid, eid);
    var warChance = aggression * (1 - powerDiff / 200) * 0.01; // 每天1%基础
    
    if (Math.random() < warChance) {
      // 爆发冲突！
      triggerFactionWar(fid, eid, day);
    }
  });
}

玩家在修仙世界（第50天）
  → 通过仙门回到 DoL 世界
  → lastDepartDay = 50
  → playerPresent = false

玩家在 DoL 世界过了 20 天（DoL dayPassed 触发 20 次）
  → 每次 dayPassed 调用 simulateDay(world.day)
  → world.day: 51, 52, 53, ... 70
  → NPC 推进、事件发生、势力变化，全部在后台跑

玩家再次通过仙门回到修仙世界
  → returnGap = world.day - lastDepartDay = 70 - 50 = 20
  → 生成「离开期间大事记」
  → 玩家落地时看到新闻摘要

// 在 fanren-world.js 中
jQuery(document).on(":dayPassed", function() {
  if (!V.fanren || !V.fanren.world) return;
  
  if (!V.fanren.world.playerPresent && V.fanren.world.entered) {
    // 玩家不在修仙世界但已开启 → 推进一天
    var world = V.fanren.world;
    simulateDay(world.day + 1);
    world.day++;
    world.lastSimDay = world.day;
  }
});

【离开的这20天里……】

· 第53天：黄枫谷一名内门弟子突破筑基，宗门上下庆贺
· 第58天：商业街坊市传来消息，有散修在幕兰草原发现上古遗迹入口
· 第62天：越国京城发生修士斗法，半条街被毁，凡人死伤数十
· 第65天：韩立已抵达乱星海内星海， reportedly 正在寻找洞府
· 第68天：鬼灵门与灵兽山在边境发生小规模冲突
· 第70天：血色禁地将在30天后再次开启

（详细记录可在「世界大事记」中查看）

function generateNews(fromDay, toDay) {
  var news = [];
  
  // 从事件日志中提取 fromDay~toDay 的事件
  var logs = V.fanren.worldState.eventLog.filter(function(e) {
    return e.day >= fromDay && e.day <= toDay;
  });
  
  // 按重要性排序，取前 N 条
  logs.sort(function(a, b) { return b.importance - a.importance; });
  
  // 转化为新闻文本
  logs.slice(0, 8).forEach(function(e) {
    news.push(formatNewsLine(e));
  });
  
  return news;
}

function formatNewsLine(event) {
  // 根据事件类型生成不同风格的新闻
  var templates = {
    "npc-breakthrough": [
      "第{day}天：{name}成功突破至{realm}，天降异象，方圆百里灵气震荡",
      "传闻{location}一带有天降瑞兆，疑似有人突破{realm}",
    ],
    "npc-death": [
      "第{day}天：{name}在{location}陨落，死因不明",
      "{name}的遗体在{location}被发现，修仙界震动",
    ],
    "faction-war": [
      "{factionA}与{factionB}在{location}爆发冲突，双方死伤惨重",
      "第{day}天：{factionA}与{factionB}正式宣战，天南局势骤然紧张",
    ],
    "random-event": [
      "有修士在{location}发现异常灵光，疑似秘境出世",
      "{location}附近的凡人报告看到御剑飞行之人",
    ],
  };
  // ...
}

V.fanren.worldState.playerImpact = {
  // 杀业
  kills: [
    { day: 15, name: "张三", faction: "ghost-gate", realm: "qi-8",
      consequence: "ghost-gate reputation -10, 鬼灵门弟子见到玩家会敌对" },
  ],
  
  // 善行
  saves: [
    { day: 22, name: "李四", method: "从妖兽口中救下",
      consequence: "李四 relationship +40, 李四的师门对玩家好感+10" },
  ],
  
  // 馈赠
  gifts: [
    { day: 30, to: "王五", item: "聚灵丹×3",
      consequence: "王五 relationship +20" },
  ],
  
  // 重大战斗
  battles: [
    { day: 40, location: "yellow-maple-outer", 
      result: "击败外门大比第一名",
      consequence: "yellow-maple reputation +20, 内门长老注意到玩家" },
  ],
  
  // 发现
  discoveries: [
    { day: 35, type: "secret-realm", location: "forest-deep",
      consequence: "记录在地图，可再次进入" },
  ],
  
  // 各势力声望
  reputation: {
    "yellow-maple": 65,    // 0-100，默认50
    "ghost-gate": 30,      // 被杀业拉低
    "spirit-beast": 55,
  },
  
  // 因果值
  karma: -5,  // 正=善，负=恶。影响突破成功率、NPC初始态度、天劫难度
};

第  0 天：韩立在黄枫谷外门修炼（玩家可能在宗门遇到他）
第 30 天：执行宗门任务（可能在任务中偶遇）
第 50 天：离开黄枫谷，前往乱星海（不管玩家在不在）
第100 天：在外星海历险
第150 天：在乱星海结丹（世界新闻传来消息）
第200 天：返回内星海，建立洞府
第300 天：元婴突破
第500 天：飞升灵界

如果玩家第60天才到乱星海 → 韩立已经走了，只留下传说
如果玩家第40天就和韩立成为好友 → 韩立走前会留信/赠礼
如果玩家从未见过韩立 → 韩立依然是这个世界的传说，但和玩家无关

NPC死亡后：
  · 事件日志记录死因、地点、凶手
  · 世界新闻播报（重要NPC死亡是大新闻）
  · 凶手NPC可能被受害者同门追杀
  · 玩家杀NPC → 因果值下降、相关势力声望降低
  · 该NPC从所有遭遇池中移除——再也遇不到
  · 该NPC的时间线永久停止

// 玩家死亡时调用
FanrenWorld.onPlayerDeath("战斗中陨落");
// → 清空物品/装备/灵兽/灵力
// → 修为回退10%
// → 保留境界/功法/法术/本命法宝
// → 自动回归DoL主世界
// → 记录死亡历史（可查）

fanren-world.js 模块结构：

FanrenWorld（顶层命名空间）
├── init()                     # 初始化，挂事件钩子
├── clock                      # 时钟管理
│   ├── tick()                 # 推进一天
│   ├── getPlayerGap()         # 计算离开天数差
│   └── isPlayerPresent()      # 玩家是否在场
├── simulate                   # 模拟引擎
│   ├── simulateDay(day)       # 模拟一天
│   ├── advanceNPCs(day)       # 推进所有NPC
│   ├── checkEvents(day)       # 检查/执行事件
│   ├── advanceFactions(day)   # 势力演化
│   └── generateRandom(day)    # 随机事件
├── npc                        # NPC 管理
│   ├── advance(id, day)       # 推进单个NPC
│   ├── checkEncounters(loc)   # 检查地点NPC遭遇
│   └── react(id, event)       # NPC对事件反应
├── death                      # NPC 生死系统
│   ├── killNPC(id, cause, killer, day)  # 永久杀死NPC
│   ├── isNPCAlive(id)         # 查询存活状态
│   ├── getDeadNPCs()          # 获取已死亡列表
│   ├── getLifespan(realm)     # 查询境界寿元
│   ├── checkLifespanDeaths(day)  # 每日寿元检查
│   └── npcVsNPCCombat(day)    # NPC互杀判定
├── faction                    # 势力管理
│   ├── evolve(id, day)        # 势力演化
│   └── checkConflicts(day)    # 势力冲突检查
├── news                       # 新闻系统
│   ├── generate(from, to)     # 生成新闻
│   ├── format(event)          # 格式化新闻文本
│   └── getUnread()            # 获取未读新闻
├── impact                     # 玩家影响追踪
│   ├── record(type, data)     # 记录玩家行为
│   ├── getReputation(fid)     # 查询势力声望
│   └── getKarma()             # 查询因果值
├── sync                       # 跨世界同步
│   ├── onDepart()             # 玩家离开修仙世界
│   ├── onReturn()             # 玩家回归修仙世界
│   └── generateReport(gap)    # 生成追赶报告
└── data                       # 数据访问
    ├── getWorldState()        # 获取世界状态
    ├── getNPCState(id)        # 获取NPC状态
    └── getFactionState(id)    # 获取势力状态

// 音频播放（使用 maplebirch 的 Howler 集成）
FanrenAudio = {
  bgm: null,
  
  playBGM: function(trackId) {
    if (this.bgm) this.bgm.stop();
    this.bgm = new Howl({
      src: ['fanren-audio/bgm/' + trackId + '.ogg'],
      loop: true,
      volume: 0.5,
    });
    this.bgm.play();
  },
  
  playSFX: function(sfxId) {
    new Howl({
      src: ['fanren-audio/sfx/' + sfxId + '.ogg'],
      volume: 0.7,
    }).play();
  },
  
  // 按区域自动切换 BGM
  onZoneChange: function(zoneId) {
    var bgmMap = {
      'fanren-town': 'pastoral',
      'fanren-sect-outer': 'sect-calm',
      'fanren-sect-garden': 'sect-calm',
      'fanren-combat': 'battle-low',
      // ...
    };
    if (bgmMap[zoneId]) this.playBGM(bgmMap[zoneId]);
  },
};

// 图片显示（场景图作为 passage 背景）
FanrenScene = {
  showScene: function(imageId) {
    var container = document.getElementById('fanren-scene-bg');
    if (!container) {
      container = document.createElement('div');
      container.id = 'fanren-scene-bg';
      container.style.cssText = 'position:absolute;top:0;left:0;width:100%;height:100%;z-index:-1;opacity:0.3;background-size:cover;background-position:center;transition:opacity 1s;';
      document.getElementById('passage-content').appendChild(container);
    }
    container.style.backgroundImage = 'url(fanren-images/scenes/' + imageId + '.png)';
    container.style.opacity = '0.3';
  },
};

┌──────────────────────┐
│ [角色名]              │
│ 境界：筑基中期        │
│ 灵根：双灵根（金木）   │
│ ─────────────        │
│ 灵力：■■■■■□□□ 65/100 │
│ 体力：■■■□□□□□ 35/100 │
│ 心境：■■■■■■■□ 85     │
│ ─────────────        │
│ 灵石：1,234           │
│ 宗门：黄枫谷·内门弟子  │
│ ─────────────        │
│ [装备栏]              │
│ 法袍：灵级上品 ×      │
│ 法器：青锋剑 ×        │
│ 本命：×               │
│ 灵兽：啼魂兽 ×        │
│ ─────────────        │
│ [功法]                │
│ 主修：清元剑诀 Lv.5   │
│ ─────────────        │
│ 日期：天历3年春       │
└──────────────────────┘

┌──────────────────────────────────┐
│ 修炼                             │
│ ─────────────────────            │
│ 当前境界：筑基中期                │
│ 修炼进度：■■■■■■□□□□ 62%        │
│ 预计突破：约45天                  │
│ ─────────────────────            │
│ [打坐修炼]  [服用丹药]  [查看功法] │
│ [突破尝试] [离开]                 │
└──────────────────────────────────┘

┌──────────────────────────────────┐
│ 炼丹                             │
│ ─────────────────────            │
│ 丹方列表：                        │
│  · 聚灵丹（灵级下品）✓            │
│  · 筑基丹（灵级中品）✓            │
│  · ???                           │
│ ─────────────────────            │
│ 灵材库存：                        │
│  · 聚灵草 ×12                    │
│  · 凝元花 ×5                     │
│  · ...                           │
│ ─────────────────────            │
│ [选择丹方] [开始炼制]             │
└──────────────────────────────────┘

┌──────────────────────────────────┐
│ 法术                             │
│ ─────────────────────            │
│ 攻击法术：                        │
│  · 火球术 Lv.3  灵力:15          │
│  · 剑气术 Lv.5  灵力:20          │
│ ─────────────────────            │
│ 防御法术：                        │
│  · 护体灵光 Lv.4 灵力:10         │
│ ─────────────────────            │
│ 辅助法术：                        │
│  · 轻身术 Lv.2  灵力:8           │
│  · 隐身术 Lv.1  灵力:25          │
│ ─────────────────────            │
│ [装备法术栏位]                    │
└──────────────────────────────────┘

┌──────────────────────────────────┐
│ 修仙世界地图                      │
│ ─────────────────────            │
│ ┌─────────────────────────┐      │
│ │  [天南]  [乱星海]  [大晋] │      │
│ │    ↓                      │      │
│ │  [幕兰]  [极西]          │      │
│ └─────────────────────────┘      │
│                                  │
│ 当前位置：黄枫谷·内门             │
│ 灵气浓度：浓郁                    │
│                                  │
│ [前往...]                        │
│  · 黄枫谷·山门                    │
│  · 黄枫谷·药园                    │
│  · 黄枫谷·任务大厅                │
│  · 越国·京城                      │
└──────────────────────────────────┘

fanren-xiuxian.mod.zip
├── mod.json                  # 模组元信息
├── fanren-main.js            # 主逻辑入口
├── fanren-cultivation.js     # 修炼系统
├── fanren-combat.js          # 战斗扩展
├── fanren-crafting.js        # 炼制系统
├── fanren-npc.js             # NPC 系统
├── fanren-sect.js            # 宗门系统
├── fanren-story.js           # 剧情系统
├── fanren-ui.js              # UI 扩展
├── fanren-ui.css             # 样式
├── fanren-data.js            # 数据定义（功法/丹药/NPC等）
├── fanren-zones.js           # Zone 注册
├── fanren-events.js          # 事件注册
└── passages/                 # Twine 段落（剧情文本）
    ├── fanren-intro.html     # 开场
    ├── fanren-sect/          # 宗门相关段落
    ├── fanren-quests/        # 任务段落
    └── ...

// fanren-main.js
// 模组初始化入口

(function() {
  "use strict";

  // 等待 DoL 框架加载完毕
  document.addEventListener(":init", function() {
    // 注册所有子系统
    FanrenCultivation.init();
    FanrenCombat.init();
    FanrenCrafting.init();
    FanrenNPC.init();
    FanrenSect.init();
    FanrenStory.init();
    FanrenUI.init();
    FanrenZones.init();
    FanrenEvents.init();

    // 初始化玩家修仙数据
    if (!V.fanren) {
      V.fanren = FanrenData.createDefaultPlayer();
    }

    console.log("[凡人修仙传] 模组初始化完成");
  });
})();

V.fanren = {
  // 基础
  spiritualRoot: { ... },
  cultivation: { ... },
  techniques: { ... },
  
  // 战斗
  combat: { ... },
  spells: [ ... ],
  
  // 物品
  inventory: { ... },     // 灵石、灵材、丹药等
  equipment: { ... },     // 装备
  spiritBeasts: [ ... ],  // 灵兽
  
  // 社交
  sect: { ... },          // 宗门信息
  relationships: { ... }, // NPC 关系
  
  // 剧情
  story: {
    currentVolume: 1,
    completedQuests: [],
    activeQuests: [],
    flags: {},            // 剧情标记
  },
  
  // 副职业
  crafting: {
    alchemy: { level: 0, exp: 0 },
    artifactRefining: { level: 0, exp: 0 },
    formation: { level: 0, exp: 0 },
    talisman: { level: 0, exp: 0 },
  },
};

// fanren-zones.js
FanrenZones = {
  init: function() {
    // 注册所有 zone
    this.registerZone("fanren-town", {
      name: "青牛镇",
      description: "一个普通的凡人小镇...",
      spiritualEnergy: "thin",
      connections: ["fanren-capital", "fanren-wilderness"],
      events: ["fanren-town-event-01", "fanren-town-event-02"],
      npcs: ["npc_elder", "npc_merchant"],
      dangerLevel: 0,
    });
    
    this.registerZone("fanren-sect-gate", {
      name: "黄枫谷·山门",
      description: "黄枫谷的入口，两座山峰之间...",
      spiritualEnergy: "rich",
      connections: ["fanren-sect-outer", "fanren-town"],
      events: ["fanren-sect-gate-event-01"],
      npcs: ["npc_gate_guard"],
      dangerLevel: 0,
      requires: { realm: "mortal" }, // 凡人可进入
    });
    
    // ... 更多 zone
  },
};

// fanren-combat.js
FanrenCombat = {
  init: function() {
    // 监听战斗开始事件
    document.addEventListener(":combat-start", function() {
      // 注入修仙战斗 UI
      FanrenCombat.injectCombatUI();
    });
    
    // 监听战斗回合
    document.addEventListener(":combat-round", function() {
      // 处理灵力消耗、法术效果等
      FanrenCombat.processRound();
    });
    
    // 监听战斗结束
    document.addEventListener(":combat-end", function() {
      // 处理战利品、经验等
      FanrenCombat.processRewards();
    });
  },
  
  injectCombatUI: function() {
    // 在战斗界面添加法术按钮、灵力条等
    // 使用 AfterLinkZone 或 DOM 注入
  },
};

// fanren-ui.js
FanrenUI = {
  init: function() {
    // 在侧栏添加修仙信息
    this.injectSidebar();
    
    // 定时刷新侧栏显示
    setInterval(function() {
      FanrenUI.updateSidebar();
    }, 1000);
  },
  
  injectSidebar: function() {
    // 在侧栏注入修仙状态面板
    // 使用与 clothesicon 类似的方式
    var sidebar = document.querySelector("#sidebar-stats");
    if (sidebar) {
      var panel = document.createElement("div");
      panel.id = "fanren-sidebar-panel";
      panel.innerHTML = this.buildSidebarHTML();
      sidebar.appendChild(panel);
    }
  },
};

// 注册新的战斗动作（法术/法宝/灵兽攻击）
maplebirch.combat.CombatAction.reg({
  id: 'fanren:fireball',
  actionType: 'leftaction',
  cond: function(ctx) { return V.fanren.combat.spiritualPower >= 15; },
  display: function(ctx) { return '火球术（灵力-15）'; },
  value: function(ctx) {
    V.fanren.combat.spiritualPower -= 15;
    return 'fireball';
  },
  color: '#ff4500',
  order: 50
});

"addonPlugin": [],
"dependenceInfo": [
  { "modName": "maplebirch", "version": ">=5.0.0" },
  { "modName": "fable", "version": ">=0.1.0-draft9.9.5.8" }
]

已完成设计/编码：
  ✅ 完整设计文档（14章 + 附录）
  ✅ boot.json 模组骨架
  ✅ fanren-cultivation.js — 修炼体系（境界/灵根/功法/灵力/修炼公式）
  ✅ fanren-world.js — 活世界引擎（世界时钟/NPC时间线/势力演化/事件调度/
                        跨世界同步/新闻系统/玩家影响追踪/NPC生死系统）
  ✅ fanren-portal.js — 仙门入口（说书人联动/条件检测/DOM注入）
  ✅ fanren-guide.js — 说书人引导系统（6节点/自动触发）
  ✅ fanren-ui.js — 侧栏修仙面板
  ✅ fanren-ui.css — 仙侠主题UI（翡翠金纹/水墨气韵/全套组件）
  ✅ fanren-main.js — 主入口（初始化/跨世界检测）

P0 · 最高优先级（核心体验·必须先有）：
  1. 过渡段落 + 跨世界桥接（Phase 0 剩余）
  2. 修炼系统实装（打坐/突破/进度可视化）
  3. 第一个可玩 Zone（青牛镇 + 黄枫谷山门）
  4. 世界时钟真机验证（:dayPassed 驱动模拟）

P1 · 高优先级（让世界「活」起来）：
  5. NPC 时间线实装（至少韩立+3个NPC完整可运行）
  6. NPC 生死系统真机验证（老死/互杀/玩家击杀）
  7. 回归报告（离开期间大事记）
  8. 基础战斗扩展

P2 · 中优先级（深度内容）：
  9. 宗门系统
  10. 炼丹/炼器
  11. 灵兽系统
  12. 道侣/双修
  13. 跨世界装备互通实装

P3 · 低优先级（锦上添花）：
  14. 完整地图（天南各国/乱星海/大晋/灵界）
  15. 阵法系统
  16. 后期境界内容
  17. 全NPC立绘/全场景图/全BGM