可视化编辑 + 源码烘焙方法论

05/124 浏览攻略

问题背景

在沙箱/WASM 环境中，运行时文件持久化存在路径不一致问题：

FILE_WRITE 写入 savedata 目录

FILE_READ 从资源路径搜索

两者不是同一位置，导致"写得进、读不出"

三层解决策略

第一层：内存缓存（会话内持久）

解决同一次运行中"写完立刻读"的场景。

写入 → 同时存内存缓存

读取 → 优先查缓存 → 缓存未命中再读文件

适用：页面跳转后仍需读取刚保存的数据。局限：刷新页面后丢失。

第二层：源码烘焙（永久持久）

将调试/调整结果直接写入源代码，随版本控制永久保留。

可视化编辑器调整 → 截图记录坐标 → 修改源码中的硬编码值 → 构建

适用：最终确定的配置值（位置、尺寸、参数）。局限：每次调整需人工介入。

第三层：FileExists 守卫（静默降级）

避免底层引擎因文件不存在打出 ERROR 日志，干扰问题排查。

lua

复制

-- ❌ 直接构造 File，不存在时 C++ 层打 ERROR

local file = File(path, FILE_READ)

-- ✅ 先检查再构造，静默降级

if not fileSystem:FileExists(path) then return {} end

local file = File(path, FILE_READ)

核心工作流

┌─────────────────────────────┐

│ F11 可视化编辑器 │

│ 拖拽/旋转/缩放 → 实时预览 │

└──────────┬──────────────────┘

│ P 键保存

▼

┌─────────────────────────────┐

│ 内存缓存（会话内生效） │

│ 翻页/回退仍保持调整结果 │

└──────────┬──────────────────┘

│ 满意后截图

▼

┌─────────────────────────────┐

│ 截图 → AI 读取坐标 │

│ → 修改源码 → 构建 │

└──────────┬──────────────────┘

│

▼

源码中永久生效

可借鉴的通用原则

1. 分离"调试态"和"发布态"的持久化策略

调试态发布态

目标快速迭代、即时反馈稳定可靠、版本可追溯

方式内存缓存 / 临时文件源码硬编码 / 配置文件

生命周期当次会话永久

2. 编辑器截图即契约

截图包含精确数值（坐标、旋转、尺寸），是人与 AI 之间的无歧义通信协议。比口头描述"往左挪一点"精确得多。

3. 全量同步优于增量补丁

当补丁系统（patch）可靠性存疑时，直接修改源数据比维护一套补丁合并逻辑更简单、更可靠。同一个值只存在一处，不存在"源数据 + 补丁谁优先"的心智负担。

4. 静默降级而非报错崩溃

文件不存在是正常状态（首次运行），应该静默返回默认值，而不是触发 ERROR 日志。FileExists 守卫 + 空对象返回是通用模式。

适用场景

关卡编辑器调参（角色位置、相机参数、触发区域）

UI 布局微调（边距、字号、颜色）

动画时间轴校准（关键帧时间、缓动曲线）

任何"需要反复微调直到视觉满意"的数值

健康问诊模拟经营测试

创意工坊

8.9

前往论坛

可视化编辑 + 源码烘焙 方法论

可视化编辑 + 源码烘焙方法论