docs(projects): 记录 Cocos 场景/资源创建保存必须走 MCP 的坑

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-08-30 00:04:45 +08:00
parent 9539ee93e0
commit 84546cd7be
1 changed files with 12 additions and 0 deletions
@@ -17,3 +17,15 @@
 - 另需补充：`gamemain.js`（扩展对局初始化）、专用算法模块（牌型/出牌等）、美术数据 `output/gameabc_data.min.js`。

 **状态归属：** 平台层维护 `Desk`（房间/座位）、`C_Player`（自己）、`GameData`（连接/资产）；子游戏维护对局态（手牌、出牌历史、轮次、分数）于自身命名空间，并需可序列化为 `deskinfo` 以支持断线重连。
+
+## Cocos 迁移工作台：场景/资源创建与保存走 MCP（不要用户手动保存）
+
+> 迁移到 `cocoscreator_projects/YouleNexus` 期间踩过的坑，供后续在此工作区操作时参考。
+
+**场景与资源（`.scene` / `.prefab` / `.anim` / `.meta`）的创建和保存必须由 Claude 通过 MCP 工具完成，全程不要求用户手动 Ctrl+S。** 否则编辑器重启后，停留在临时场景 `scene-2d` 上建的内容全部丢失。
+
+- **先建场景再建内容**：用 `cocos_scene { action: "create", sceneName: "Xxx", savePath: "db://assets/scenes" }` 建新场景（自动建 Camera + Canvas 并打开），再在其 Canvas 下建节点 / 实例化 prefab。有 `db://` 路径的场景才能登记进 build settings、被 content 模式截图、并随工程持久化。
+- **保存当前场景**：`cocos_scene { action: "save" }`（无参数，保存到当前场景已有路径）。`save` 不接受 `savePath`/`sceneName`，带了不生效——曾误以为 `save` 能另存为，结果返回 success 却没落盘。
+- **打开已有场景**：`cocos_scene { action: "open", scenePath: "db://assets/scenes/Xxx.scene" }`。
+- **实例化 prefab**：`cocos_prefab { action: "instantiate", prefabPath: "db://.../X.prefab", parent: "Canvas" }`。
+- 编辑 prefab 用 `cocos_prefab` 的 `edit_enter` → 改组件 → `edit_save` → `edit_exit`，改完必须 `edit_exit` 回到场景，别停在 prefab 编辑态。