From 84546cd7be0caa4aa61ff4e3d1096fabac559c2b Mon Sep 17 00:00:00 2001 From: Joywayer Date: Sun, 30 Aug 2026 00:04:45 +0800 Subject: [PATCH] =?UTF-8?q?docs(projects):=20=E8=AE=B0=E5=BD=95=20Cocos=20?= =?UTF-8?q?=E5=9C=BA=E6=99=AF/=E8=B5=84=E6=BA=90=E5=88=9B=E5=BB=BA?= =?UTF-8?q?=E4=BF=9D=E5=AD=98=E5=BF=85=E9=A1=BB=E8=B5=B0=20MCP=20=E7=9A=84?= =?UTF-8?q?=E5=9D=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- projects/CLAUDE.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/projects/CLAUDE.md b/projects/CLAUDE.md index 3e8323d..64b5425 100644 --- a/projects/CLAUDE.md +++ b/projects/CLAUDE.md @@ -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 编辑态。