自由的校园

目标场景：地图编辑器"物品/墙体/地面/房间/人员"调色板弹窗的图片首帧显示 文档目的：沉淀"图片为什么慢、怎么治、发布后玩家体验如何、未来加资源时 preload_groups 怎么取舍"的完整结论，避免重复踩坑。
一句话结论 WASM 下图片"慢"不是单一问题，而是下载 / 解码 / 上传 GPU 三件事全堆在"玩家点弹窗那一刻"做导致的。优化的本质是把这三件事提前到启动期做（让玩家点的时候图

四个原则（数据驱动、组件化、组合优于继承、对象池）确实是系统从"能跑"到"能维护"的分水岭。
先看看你的游戏现状，再说怎么落地。
你的游戏现状分析
你的《自由的校园》不是传统战斗游戏，但已经有大量"对抗性交互"：
已有机制 对应战斗系统概念
主角投掷物品（粉笔、扫把） 投射物 / 技能
行为违规 → 目击 → 怀疑累积 Debuff 叠加
冲突事件 → 保安响应 Boss 技能 / AI 响应链

核心数学原理
缩放前后，鼠标指向的那个世界坐标点必须保持在同一屏幕位置。
已知：旧缩放 oldZoom、新缩放 newZoom、鼠标锚点屏幕坐标 (ax, ay)、当前偏移 (panX, panY)
步骤1：算出旧缩放下鼠标指向的世界坐标
wx = (ax - panX) / oldZoom
wy = (ay - panY) / oldZoom

步骤2：新缩放后反解新偏移，让 wx/wy

问题诊断过程
用户报告：编辑器建好房间 → 保存 → 刷新页面 → 进编辑器 → 数据全没了。
关键线索：用户发现"校园日"模式刷新后能看到房间，但一进编辑器就没了。
这直接指向了编辑器页面自身的初始化逻辑，而非持久化链路。
根因
地图编辑模式.lua 的 EnsureBlankEditorLayout() 设计意图是"首次打开编辑器提供空白画布"，用模块级布尔 editorLayoutClear

一、问题链
用户截图反馈了三个递进的问题：
问题 1：点击地面类型（如食堂地砖），弹窗不关闭，挡住画布无法操作
↓ 修复 v0.10.94
问题 2：地面贴图太大，一块地砖比小人还宽，比例失调
↓ 修复 v0.10.96（改配置值）
问题 3：改了配置值后刷新仍然太大——旧存档的 tileSize=256 优先级高于新 config
↓ 修复 v0.10.97（反转渲染优先级）
二、关键代码

这是一个很好的思路。RND 的核心——用"预测误差"度量新奇度，驱动探索——可以直接映射到校园小人的认知系统上，而且不需要真的跑神经网络。下面是方案讨论。
RND 思想到校园小人的映射
RND 原始结构 vs 校园简化版
RND 组件 原始含义 校园小人对应
目标网络（固定随机） 为每个状态生成固定特征 环境的客观快照：房间类型、物件数、人员密度、卫生度、当前时段
预测网络（可训练） 学习预测目标

经验
下标 = 视觉格子，空槽是合法状态。定长 9 槽，inventory[i]=nil 即第 i 格空着，中间允许空。任何"把物品往前挪/压缩/重排"的操作都会让"你看到的格子"和"数组真实下标"脱节 → 物品消失。渲染直映 inventory[i]，数据层绝不重排。
稀疏表禁用 #。带 nil 洞的表 #inv 是未定义的（可能=0 直接读成空包，或=洞前边界）。所有遍历上界一律 Player

现在我对四份设计文档和当前项目状态有了完整的理解。下面基于设计文档的规划和已实现的代码基础，给出整体实现计划大纲。
自由的校园 — 实现计划大纲
当前基线（v0.10.51）
已落地 状态
地图编辑器（房间/墙门/地板/素材/人员/外围道路） 成熟，待拆分
共享移动内核 + BFS 导航 + 空间服务 已验证
通用任务服务 + 校园活动 + 双适配器 已验证
学生 AI + 个人计划 + 认知/记

一、问题本质
不是平移公式写错，而是 UrhoX UI 库指针事件派发的两个不对称陷阱叠加：
陷阱 现象 根因文件
OnPointerMove 不向父冒泡 右键按下 isPanning_=true，但 move 事件永远到不了 mapView urhox-libs/UI/Core/Widget.lua（OnPointerDown/Up 有 parent 冒泡，OnPointerMove 没有）
H

UI 重建频率 = 事件分发的可靠性上限。 只要有一帧 SetRoot 销毁了正在处理 pointer 事件的控件，跨重建边界的 Down/Up 对就会被吞。高频仿真 tick 必须在 UI 边界按页面过滤。
关键代码（scripts/main.lua HandleUpdate）
四步走：先原地处理人员 → 聚合所有仿真 changed → 地图页强制压制 → 只放行显式/登录态变化。
-- ma

目标场景：地图编辑器"物品/墙体/地面/房间/人员"调色板弹窗的图片首帧显示 文档目的：沉淀"图片为什么慢、怎么治、发布后玩家体验如何、未来加资源时 preload_groups 怎么取舍"的完整结论，避免重复踩坑。
一句话结论 WASM 下图片"慢"不是单一问题，而是下载 / 解码 / 上传 GPU 三件事全堆在"玩家点弹窗那一刻"做导致的。优化的本质是把这三件事提前到启动期做（让玩家点的时候图

四个原则（数据驱动、组件化、组合优于继承、对象池）确实是系统从"能跑"到"能维护"的分水岭。
先看看你的游戏现状，再说怎么落地。
你的游戏现状分析
你的《自由的校园》不是传统战斗游戏，但已经有大量"对抗性交互"：
已有机制 对应战斗系统概念
主角投掷物品（粉笔、扫把） 投射物 / 技能
行为违规 → 目击 → 怀疑累积 Debuff 叠加
冲突事件 → 保安响应 Boss 技能 / AI 响应链

核心数学原理
缩放前后，鼠标指向的那个世界坐标点必须保持在同一屏幕位置。
已知：旧缩放 oldZoom、新缩放 newZoom、鼠标锚点屏幕坐标 (ax, ay)、当前偏移 (panX, panY)
步骤1：算出旧缩放下鼠标指向的世界坐标
wx = (ax - panX) / oldZoom
wy = (ay - panY) / oldZoom

步骤2：新缩放后反解新偏移，让 wx/wy

问题诊断过程
用户报告：编辑器建好房间 → 保存 → 刷新页面 → 进编辑器 → 数据全没了。
关键线索：用户发现"校园日"模式刷新后能看到房间，但一进编辑器就没了。
这直接指向了编辑器页面自身的初始化逻辑，而非持久化链路。
根因
地图编辑模式.lua 的 EnsureBlankEditorLayout() 设计意图是"首次打开编辑器提供空白画布"，用模块级布尔 editorLayoutClear

一、问题链
用户截图反馈了三个递进的问题：
问题 1：点击地面类型（如食堂地砖），弹窗不关闭，挡住画布无法操作
↓ 修复 v0.10.94
问题 2：地面贴图太大，一块地砖比小人还宽，比例失调
↓ 修复 v0.10.96（改配置值）
问题 3：改了配置值后刷新仍然太大——旧存档的 tileSize=256 优先级高于新 config
↓ 修复 v0.10.97（反转渲染优先级）
二、关键代码

这是一个很好的思路。RND 的核心——用"预测误差"度量新奇度，驱动探索——可以直接映射到校园小人的认知系统上，而且不需要真的跑神经网络。下面是方案讨论。
RND 思想到校园小人的映射
RND 原始结构 vs 校园简化版
RND 组件 原始含义 校园小人对应
目标网络（固定随机） 为每个状态生成固定特征 环境的客观快照：房间类型、物件数、人员密度、卫生度、当前时段
预测网络（可训练） 学习预测目标

经验
下标 = 视觉格子，空槽是合法状态。定长 9 槽，inventory[i]=nil 即第 i 格空着，中间允许空。任何"把物品往前挪/压缩/重排"的操作都会让"你看到的格子"和"数组真实下标"脱节 → 物品消失。渲染直映 inventory[i]，数据层绝不重排。
稀疏表禁用 #。带 nil 洞的表 #inv 是未定义的（可能=0 直接读成空包，或=洞前边界）。所有遍历上界一律 Player

现在我对四份设计文档和当前项目状态有了完整的理解。下面基于设计文档的规划和已实现的代码基础，给出整体实现计划大纲。
自由的校园 — 实现计划大纲
当前基线（v0.10.51）
已落地 状态
地图编辑器（房间/墙门/地板/素材/人员/外围道路） 成熟，待拆分
共享移动内核 + BFS 导航 + 空间服务 已验证
通用任务服务 + 校园活动 + 双适配器 已验证
学生 AI + 个人计划 + 认知/记

一、问题本质
不是平移公式写错，而是 UrhoX UI 库指针事件派发的两个不对称陷阱叠加：
陷阱 现象 根因文件
OnPointerMove 不向父冒泡 右键按下 isPanning_=true，但 move 事件永远到不了 mapView urhox-libs/UI/Core/Widget.lua（OnPointerDown/Up 有 parent 冒泡，OnPointerMove 没有）
H

UI 重建频率 = 事件分发的可靠性上限。 只要有一帧 SetRoot 销毁了正在处理 pointer 事件的控件，跨重建边界的 Down/Up 对就会被吞。高频仿真 tick 必须在 UI 边界按页面过滤。
关键代码（scripts/main.lua HandleUpdate）
四步走：先原地处理人员 → 聚合所有仿真 changed → 地图页强制压制 → 只放行显式/登录态变化。
-- ma