From 44c7d42fd0823d118723a2c47ce19037fc213d92 Mon Sep 17 00:00:00 2001 From: Joywayer Date: Thu, 3 Sep 2026 20:16:50 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20CLAUDE.md=20=E6=A0=87=E6=B3=A8=20Game?= =?UTF-8?q?=5FSurface=5F3=20=E4=B8=BA=E5=8E=9F=E5=B7=A5=E7=A8=8B/UI=20?= =?UTF-8?q?=E8=BF=81=E7=A7=BB=E6=BA=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 补充 UI 迁移数据源契约 + 修正索引/类型易踩坑（ObjectList[ObjectID]、 ImageFileList[ImageFileID]、ObjectType 2=Sprite/4=Text）。 Co-Authored-By: Claude Code --- CLAUDE.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 642660c..aadde30 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -25,10 +25,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co 这是友乐（Youle）棋牌游戏平台的前端工作区，核心是「**一套前端模板 + 多个子游戏**」的架构，并正在迁移到 Cocos Creator。三个顶层目录： -- **`projects/`** —— 旧版 HTML5 前端。`projects/Game_Surface_3` 是**前端模板（平台外壳）**，其余目录都是**基于该模板扩展出来的子游戏**，平台层几乎不动，只改子游戏层 + 美术数据。分层结构与关键文件见 `projects/CLAUDE.md`。 +- **`projects/`** —— 旧版 HTML5 前端。`projects/Game_Surface_3` 是**前端模板（平台外壳）**，也是新前端 UI 迁移的**原工程（迁移源）**；其余目录都是**基于该模板扩展出来的子游戏**，平台层几乎不动，只改子游戏层 + 美术数据。分层结构与关键文件见 `projects/CLAUDE.md`。 - **`docs/protocol/`** —— 前端模板框架与服务器收发包的**协议规范**（权威文档，8 篇）。改动任何网络层代码前**必须先读对应章节**，服务器不可改，前端必须严格对齐协议。 - **`cocoscreator_projects/YouleNexus/`** —— 新的 Cocos Creator 3.8+ 前端工程，目标是按 `docs/protocol` 复刻协议契约，做到服务器零改动即可联调。 +### 原工程 `Game_Surface_3` → `YouleNexus` 的 UI 迁移 + +`YouleNexus` 的 UI 资源（`assets/framework/ui/prefabs/`）从**原工程 `projects/Game_Surface_3`** 逐层复刻。数据契约与流程规范： + +- 数据模型（权威）：`docs/superpowers/specs/原工程数据模型.md`；迁移流程：`docs/superpowers/specs/UI-手工迁移规范.md`（9 步 funplay MCP + 8 项验证清单）。 +- 已完成的参照真相源：`assets/framework/ui/prefabs/Login_Layer.prefab`（Layer 2）。 + +> ⚠️ **索引与类型（易踩坑，实测修正）**：源数据索引**直接按 ID**——`gameabc_Object.json` 的 `ObjectList[ObjectID]`、`gameabc_Image.json` 的 `ImageFileList[ImageFileID]`（**不是** `ID - 1`，旧文档的 off-by-one 是错的）；组件类型看 `ObjectType`（`2`=Sprite、`4`=Text），**不是** XML 的 `SpiritType`（那是另一套枚举）。 + ## 网络协议（`docs/protocol/`，新旧前端共同契约） `docs/protocol/` 是权威文档，改任何网络层代码前先读对应章节，**不要凭本文件的转述臆测**。