西风逍遥游
f7962f43fe
- devlab: flagship --debug example (console/snapshot/AI panel/pause/hot reload/error slice), make devlab target with RUN_ARGS support - ai-game: agent-drivable live game + agent_demo.py (pause/read/mutate/ verify/snapshot/restore/screenshot loop) - ai-editor: headless eve mcp editor host demo (JSON View + ViewModel MVVM) - examples: fill all missing READMEs + config.nut, add examples/ index - load.nut: add key_just_pressed/clampf/persist helpers; dedupe 19 examples - rpg/cardgame: move JSON definitions to data files - fix eve mcp crash: ModuleManager::requireAll() instantiates modules in the headless host (IEditorHost etc. were null) - graphics: actionable screenshot error when readback was just enabled - CI: smoke all examples (devlab with --debug) + DevLab hot-reload test Fixes surfaced by the new CI smoke (examples had never been smoke-tested): - scene_director kit: camera slot doubled as function + instance and was nulled by reset(); move the live Camera3D into cameraObj - readTextFile used non-existent readn()/len(); use file.read() (rpg/cardgame/hex-levels) - daynight used non-existent keyboard.wasPressed() -> key_just_pressed - outline passed ints to float-only drawSolidRect; linear-structures slider passed an int value - scene-ecs beginNode() requires (id, name); ai-stage guarded compilestring - smoke_examples.sh: timeout -k 3 so SIGTERM-ignoring hosts cannot hang CI
2.3 KiB
2.3 KiB
DevLab — 开发者体验实验室
把 EVEngine「运行时即编辑器」的开发循环浓缩成一个 5 分钟可跑的示例。
必须用 --debug 运行（make devlab 已带该参数），否则 DevTools 不加载。
运行
make devlab
# 等价于：make run/<platform>-debug GAME=examples/devlab RUN_ARGS=--debug
体验路线（按顺序）
- F4 运行时控制台 / REPL：启动时脚本已写入日志（
eve.dev.console.info）。 按 F4 打开控制台，输入eve.dev.console.eval("lab.count")回车，可读到当前帧计数； 也可以在控制台直接改状态，比如eve.dev.console.eval("lab.vx = -200.0")，小球立刻反向。 - 热重载：打开
main.nut，改bounceDir的返回值（例如0.85→1.0），保存。 控制台与 HUD 都会显示script hot-reloaded，小球运动立即按新逻辑变化——不用重启引擎。 - F6/F7 状态快照：按 F6 保存当前脚本状态；让小球继续跑几秒；按 F7 恢复。 帧计数与小球位置会回到保存点——这是 AI 测试和「改代码→复位→重跑」闭环的基础。
- Pause 暂停循环：按 Pause 暂停游戏循环（HUD 显示
[PAUSED]），F8 单帧、F10/F11 语句级单步、F5 继续。 - 错误切片：按空格或点「触发运行时错误」。
--debug下错误会停在抛出点 （break on error），并在控制台 / DAP / MCP 生成错误切片，指出是哪一行、哪个调用路径导致的。 - F9 AI / MCP 面板：按 F9 打开面板，可看到本示例写入的 session note。
配合
eve run --debug --mcp-port=7529，Cursor / Claude 等 Agent 可以像人一样暂停、求值、 截图、改场景、复位状态（见docs/dev/AI与MCP支持.md）。
它展示了什么
| 设计目标 | 对应体验 |
|---|---|
| 开发系统 = 游戏运行时 | 调试器、控制台、快照与游戏共用同一个进程 |
| 内置热重载 | 改脚本函数保存即生效，C++ 实体不重建 |
| 暂停游戏循环调试 | Pause / F5 / F8 / F10 / F11 与 DAP |
| 运行快照 | F6 保存 / F7 恢复，供人机闭环测试 |
| AI 原生控制面 | F9 面板 + MCP 工具（求值、快照、截图、场景操作） |