西风逍遥游
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
38 lines
2.3 KiB
Markdown
38 lines
2.3 KiB
Markdown
# DevLab — 开发者体验实验室
|
||
|
||
把 EVEngine「运行时即编辑器」的开发循环浓缩成一个 5 分钟可跑的示例。
|
||
**必须用 `--debug` 运行**（`make devlab` 已带该参数），否则 DevTools 不加载。
|
||
|
||
## 运行
|
||
|
||
```bash
|
||
make devlab
|
||
# 等价于：make run/<platform>-debug GAME=examples/devlab RUN_ARGS=--debug
|
||
```
|
||
|
||
## 体验路线（按顺序）
|
||
|
||
1. **F4 运行时控制台 / REPL**：启动时脚本已写入日志（`eve.dev.console.info`）。
|
||
按 F4 打开控制台，输入 `eve.dev.console.eval("lab.count")` 回车，可读到当前帧计数；
|
||
也可以在控制台直接改状态，比如 `eve.dev.console.eval("lab.vx = -200.0")`，小球立刻反向。
|
||
2. **热重载**：打开 `main.nut`，改 `bounceDir` 的返回值（例如 `0.85` → `1.0`），保存。
|
||
控制台与 HUD 都会显示 `script hot-reloaded`，小球运动立即按新逻辑变化——不用重启引擎。
|
||
3. **F6/F7 状态快照**：按 F6 保存当前脚本状态；让小球继续跑几秒；按 F7 恢复。
|
||
帧计数与小球位置会回到保存点——这是 AI 测试和「改代码→复位→重跑」闭环的基础。
|
||
4. **Pause 暂停循环**：按 Pause 暂停游戏循环（HUD 显示 `[PAUSED]`），F8 单帧、F10/F11 语句级单步、F5 继续。
|
||
5. **错误切片**：按空格或点「触发运行时错误」。`--debug` 下错误会停在抛出点
|
||
（break on error），并在控制台 / DAP / MCP 生成错误切片，指出是哪一行、哪个调用路径导致的。
|
||
6. **F9 AI / MCP 面板**：按 F9 打开面板，可看到本示例写入的 session note。
|
||
配合 `eve run --debug --mcp-port=7529`，Cursor / Claude 等 Agent 可以像人一样暂停、求值、
|
||
截图、改场景、复位状态（见 [`docs/dev/AI与MCP支持.md`](../../docs/dev/AI与MCP支持.md)）。
|
||
|
||
## 它展示了什么
|
||
|
||
| 设计目标 | 对应体验 |
|
||
|---|---|
|
||
| 开发系统 = 游戏运行时 | 调试器、控制台、快照与游戏共用同一个进程 |
|
||
| 内置热重载 | 改脚本函数保存即生效，C++ 实体不重建 |
|
||
| 暂停游戏循环调试 | Pause / F5 / F8 / F10 / F11 与 DAP |
|
||
| 运行快照 | F6 保存 / F7 恢复，供人机闭环测试 |
|
||
| AI 原生控制面 | F9 面板 + MCP 工具（求值、快照、截图、场景操作） |
|