feat(guide): 新增新手引导系统功能

1. 创建了通用引导预制体guide.prefab，包含手势提示节点 2. 实现GuideComp组件，支持引导状态跟踪、点击交互和自动销毁 3. 在角色控制和技能框预制体中接入引导组件，配置默认引导ID 4. 完成引导完成状态的本地记录与节点自动隐藏逻辑
2026-06-11 16:32:05 +08:00
parent 193beb0d24
commit 1c74138334
6 changed files with 2680 additions and 1034 deletions
--- a/assets/resources/gui/role_controller.prefab
+++ b/assets/resources/gui/role_controller.prefab
@@ -22,26 +22,26 @@
        "__id__": 2
      },
      {
-        "__id__": 437
+        "__id__": 445
      },
      {
-        "__id__": 446
+        "__id__": 454
      }
    ],
    "_active": true,
    "_components": [
      {
-        "__id__": 459
+        "__id__": 467
      },
      {
-        "__id__": 461
+        "__id__": 469
      },
      {
-        "__id__": 463
+        "__id__": 471
      }
    ],
    "_prefab": {
-      "__id__": 465
+      "__id__": 473
    },
    "_lpos": {
      "__type__": "cc.Vec3",
@@ -100,17 +100,17 @@
    "_active": true,
    "_components": [
      {
-        "__id__": 430
+        "__id__": 438
      },
      {
-        "__id__": 432
+        "__id__": 440
      },
      {
-        "__id__": 434
+        "__id__": 442
      }
    ],
    "_prefab": {
-      "__id__": 436
+      "__id__": 444
    },
    "_lpos": {
      "__type__": "cc.Vec3",
@@ -9423,36 +9423,140 @@
  },
  {
    "__type__": "cc.Node",
-    "_name": "guide",
    "_objFlags": 0,
-    "__editorExtras__": {},
    "_parent": {
      "__id__": 2
    },
+    "_prefab": {
+      "__id__": 417
+    },
+    "__editorExtras__": {}
+  },
+  {
+    "__type__": "cc.PrefabInfo",
+    "root": {
+      "__id__": 416
+    },
+    "asset": {
+      "__uuid__": "93fda804-b794-4119-a287-952a70be15cb",
+      "__expectedType__": "cc.Prefab"
+    },
+    "fileId": "6dh4o/8p1Cy5An1p6o4Bc3",
+    "instance": {
+      "__id__": 418
+    },
+    "targetOverrides": null
+  },
+  {
+    "__type__": "cc.PrefabInstance",
+    "fileId": "5aJhr6IKBCvr1yjzfuMlha",
+    "prefabRootNode": {
+      "__id__": 1
+    },
+    "mountedChildren": [],
+    "mountedComponents": [
+      {
+        "__id__": 419
+      }
+    ],
+    "propertyOverrides": [
+      {
+        "__id__": 433
+      },
+      {
+        "__id__": 435
+      },
+      {
+        "__id__": 436
+      },
+      {
+        "__id__": 437
+      }
+    ],
+    "removedComponents": []
+  },
+  {
+    "__type__": "cc.MountedComponentsInfo",
+    "targetInfo": {
+      "__id__": 420
+    },
+    "components": [
+      {
+        "__id__": 421
+      }
+    ]
+  },
+  {
+    "__type__": "cc.TargetInfo",
+    "localID": [
+      "cbf1XjyLtM3ptfNNcea20y"
+    ]
+  },
+  {
+    "__type__": "cc.Widget",
+    "_name": "",
+    "_objFlags": 0,
+    "__editorExtras__": {
+      "mountedRoot": {
+        "__id__": 416
+      }
+    },
+    "node": {
+      "__id__": 422
+    },
+    "_enabled": true,
+    "__prefab": {
+      "__id__": 432
+    },
+    "_alignFlags": 44,
+    "_target": null,
+    "_left": 160,
+    "_right": 160,
+    "_top": 0,
+    "_bottom": 275.762,
+    "_horizontalCenter": 0,
+    "_verticalCenter": 0,
+    "_isAbsLeft": true,
+    "_isAbsRight": true,
+    "_isAbsTop": true,
+    "_isAbsBottom": true,
+    "_isAbsHorizontalCenter": true,
+    "_isAbsVerticalCenter": true,
+    "_originalWidth": 400,
+    "_originalHeight": 0,
+    "_alignMode": 2,
+    "_lockFlags": 0,
+    "_id": ""
+  },
+  {
+    "__type__": "cc.Node",
+    "_name": "hand",
+    "_objFlags": 0,
+    "__editorExtras__": {},
+    "_parent": {
+      "__id__": 416
+    },
    "_children": [
      {
-        "__id__": 417
+        "__id__": 423
      }
    ],
    "_active": true,
    "_components": [
      {
-        "__id__": 423
+        "__id__": 429
      },
      {
-        "__id__": 425
-      },
-      {
-        "__id__": 427
+        "__id__": 421
      }
    ],
    "_prefab": {
-      "__id__": 429
+      "__id__": 431
    },
    "_lpos": {
      "__type__": "cc.Vec3",
      "x": 0,
-      "y": 640,
+      "y": -294.238,
      "z": 0
    },
    "_lrot": {
@@ -9484,25 +9588,25 @@
    "_objFlags": 0,
    "__editorExtras__": {},
    "_parent": {
-      "__id__": 416
+      "__id__": 422
    },
    "_children": [],
    "_active": true,
    "_components": [
      {
-        "__id__": 418
+        "__id__": 424
      },
      {
-        "__id__": 420
+        "__id__": 426
      }
    ],
    "_prefab": {
-      "__id__": 422
+      "__id__": 428
    },
    "_lpos": {
      "__type__": "cc.Vec3",
-      "x": 36.036,
-      "y": -354.417,
+      "x": 0,
+      "y": 0,
      "z": 0
    },
    "_lrot": {
@@ -9534,11 +9638,11 @@
    "_objFlags": 0,
    "__editorExtras__": {},
    "node": {
-      "__id__": 417
+      "__id__": 423
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 419
+      "__id__": 425
    },
    "_contentSize": {
      "__type__": "cc.Size",
@@ -9562,11 +9666,11 @@
    "_objFlags": 0,
    "__editorExtras__": {},
    "node": {
-      "__id__": 417
+      "__id__": 423
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 421
+      "__id__": 427
    },
    "_customMaterial": null,
    "_srcBlendFactor": 2,
@@ -9582,7 +9686,7 @@
      "__uuid__": "6165ffc9-a838-4a33-b569-bdbaaab0e6b4@5990a",
      "__expectedType__": "cc.SpriteFrame"
    },
-    "_type": 0,
+    "_type": 1,
    "_fillType": 0,
    "_sizeMode": 1,
    "_fillCenter": {
@@ -9620,16 +9724,16 @@
    "_objFlags": 0,
    "__editorExtras__": {},
    "node": {
-      "__id__": 416
+      "__id__": 422
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 424
+      "__id__": 430
    },
    "_contentSize": {
      "__type__": "cc.Size",
-      "width": 720,
-      "height": 1280
+      "width": 400,
+      "height": 140
    },
    "_anchorPoint": {
      "__type__": "cc.Vec2",
@@ -9640,64 +9744,7 @@
  },
  {
    "__type__": "cc.CompPrefabInfo",
-    "fileId": "50NXlbXx9PHYhb8LT2nDRv"
-  },
-  {
-    "__type__": "cc.Widget",
-    "_name": "",
-    "_objFlags": 0,
-    "__editorExtras__": {},
-    "node": {
-      "__id__": 416
-    },
-    "_enabled": true,
-    "__prefab": {
-      "__id__": 426
-    },
-    "_alignFlags": 45,
-    "_target": null,
-    "_left": 0,
-    "_right": 0,
-    "_top": 0,
-    "_bottom": 0,
-    "_horizontalCenter": 0,
-    "_verticalCenter": 0,
-    "_isAbsLeft": true,
-    "_isAbsRight": true,
-    "_isAbsTop": true,
-    "_isAbsBottom": true,
-    "_isAbsHorizontalCenter": true,
-    "_isAbsVerticalCenter": true,
-    "_originalWidth": 100,
-    "_originalHeight": 100,
-    "_alignMode": 2,
-    "_lockFlags": 0,
-    "_id": ""
-  },
-  {
-    "__type__": "cc.CompPrefabInfo",
-    "fileId": "10DsksGxZDUbKjtrjCTMxF"
-  },
-  {
-    "__type__": "25122z/cnRPhp90+CJYs5+r",
-    "_name": "",
-    "_objFlags": 0,
-    "__editorExtras__": {},
-    "node": {
-      "__id__": 416
-    },
-    "_enabled": true,
-    "__prefab": {
-      "__id__": 428
-    },
-    "hand": {
-      "__id__": 417
-    },
-    "_id": ""
-  },
-  {
-    "__type__": "cc.CompPrefabInfo",
-    "fileId": "1fYnYBrbBNgoLyArRX18hs"
+    "fileId": "8bH6M7VahGk79zZiTESQBG"
  },
  {
    "__type__": "cc.PrefabInfo",
@@ -9707,11 +9754,77 @@
    "asset": {
      "__id__": 0
    },
-    "fileId": "6dh4o/8p1Cy5An1p6o4Bc3",
+    "fileId": "cbf1XjyLtM3ptfNNcea20y",
    "instance": null,
    "targetOverrides": null,
    "nestedPrefabInstanceRoots": null
  },
+  {
+    "__type__": "cc.CompPrefabInfo",
+    "fileId": "6b+8SFUXpKIYA8Q2ep3HVS"
+  },
+  {
+    "__type__": "CCPropertyOverrideInfo",
+    "targetInfo": {
+      "__id__": 434
+    },
+    "propertyPath": [
+      "_name"
+    ],
+    "value": "guide"
+  },
+  {
+    "__type__": "cc.TargetInfo",
+    "localID": [
+      "6dh4o/8p1Cy5An1p6o4Bc3"
+    ]
+  },
+  {
+    "__type__": "CCPropertyOverrideInfo",
+    "targetInfo": {
+      "__id__": 434
+    },
+    "propertyPath": [
+      "_lpos"
+    ],
+    "value": {
+      "__type__": "cc.Vec3",
+      "x": 0,
+      "y": 640,
+      "z": 0
+    }
+  },
+  {
+    "__type__": "CCPropertyOverrideInfo",
+    "targetInfo": {
+      "__id__": 434
+    },
+    "propertyPath": [
+      "_lrot"
+    ],
+    "value": {
+      "__type__": "cc.Quat",
+      "x": 0,
+      "y": 0,
+      "z": 0,
+      "w": 1
+    }
+  },
+  {
+    "__type__": "CCPropertyOverrideInfo",
+    "targetInfo": {
+      "__id__": 434
+    },
+    "propertyPath": [
+      "_euler"
+    ],
+    "value": {
+      "__type__": "cc.Vec3",
+      "x": 0,
+      "y": 0,
+      "z": 0
+    }
+  },
  {
    "__type__": "cc.UITransform",
    "_name": "",
@@ -9722,7 +9835,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 431
+      "__id__": 439
    },
    "_contentSize": {
      "__type__": "cc.Size",
@@ -9750,7 +9863,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 433
+      "__id__": 441
    },
    "_alignFlags": 21,
    "_target": null,
@@ -9786,7 +9899,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 435
+      "__id__": 443
    },
    "home_btn": {
      "__id__": 121
@@ -9835,14 +9948,14 @@
      "__id__": 1
    },
    "_prefab": {
-      "__id__": 438
+      "__id__": 446
    },
    "__editorExtras__": {}
  },
  {
    "__type__": "cc.PrefabInfo",
    "root": {
-      "__id__": 437
+      "__id__": 445
    },
    "asset": {
      "__uuid__": "26bff847-cd29-48a5-bbfa-c3e2dbda688d",
@@ -9850,7 +9963,7 @@
    },
    "fileId": "5a9CMsVQhKP5Y+UJfTKPbx",
    "instance": {
-      "__id__": 439
+      "__id__": 447
    },
    "targetOverrides": null
  },
@@ -9864,19 +9977,19 @@
    "mountedComponents": [],
    "propertyOverrides": [
      {
-        "__id__": 440
+        "__id__": 448
      },
      {
-        "__id__": 442
+        "__id__": 450
      },
      {
-        "__id__": 443
+        "__id__": 451
      },
      {
-        "__id__": 444
+        "__id__": 452
      },
      {
-        "__id__": 445
+        "__id__": 453
      }
    ],
    "removedComponents": []
@@ -9884,7 +9997,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 441
+      "__id__": 449
    },
    "propertyPath": [
      "_name"
@@ -9900,7 +10013,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 441
+      "__id__": 449
    },
    "propertyPath": [
      "_lpos"
@@ -9915,7 +10028,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 441
+      "__id__": 449
    },
    "propertyPath": [
      "_lrot"
@@ -9931,7 +10044,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 441
+      "__id__": 449
    },
    "propertyPath": [
      "_euler"
@@ -9946,7 +10059,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 441
+      "__id__": 449
    },
    "propertyPath": [
      "_active"
@@ -9960,14 +10073,14 @@
      "__id__": 1
    },
    "_prefab": {
-      "__id__": 447
+      "__id__": 455
    },
    "__editorExtras__": {}
  },
  {
    "__type__": "cc.PrefabInfo",
    "root": {
-      "__id__": 446
+      "__id__": 454
    },
    "asset": {
      "__uuid__": "56aee962-4a5e-45ae-a779-999444d06d18",
@@ -9975,7 +10088,7 @@
    },
    "fileId": "cboM54s0hM07XCtrpFp0/b",
    "instance": {
-      "__id__": 448
+      "__id__": 456
    },
    "targetOverrides": null
  },
@@ -9988,29 +10101,29 @@
    "mountedChildren": [],
    "mountedComponents": [],
    "propertyOverrides": [
-      {
-        "__id__": 449
-      },
-      {
-        "__id__": 451
-      },
-      {
-        "__id__": 452
-      },
-      {
-        "__id__": 453
-      },
-      {
-        "__id__": 454
-      },
-      {
-        "__id__": 456
-      },
      {
        "__id__": 457
      },
      {
-        "__id__": 458
+        "__id__": 459
+      },
+      {
+        "__id__": 460
+      },
+      {
+        "__id__": 461
+      },
+      {
+        "__id__": 462
+      },
+      {
+        "__id__": 464
+      },
+      {
+        "__id__": 465
+      },
+      {
+        "__id__": 466
      }
    ],
    "removedComponents": []
@@ -10018,7 +10131,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 450
+      "__id__": 458
    },
    "propertyPath": [
      "_name"
@@ -10034,7 +10147,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 450
+      "__id__": 458
    },
    "propertyPath": [
      "_lpos"
@@ -10049,7 +10162,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 450
+      "__id__": 458
    },
    "propertyPath": [
      "_lrot"
@@ -10065,7 +10178,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 450
+      "__id__": 458
    },
    "propertyPath": [
      "_euler"
@@ -10080,7 +10193,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 455
+      "__id__": 463
    },
    "propertyPath": [
      "_top"
@@ -10096,7 +10209,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 455
+      "__id__": 463
    },
    "propertyPath": [
      "_alignFlags"
@@ -10106,7 +10219,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 455
+      "__id__": 463
    },
    "propertyPath": [
      "_bottom"
@@ -10116,7 +10229,7 @@
  {
    "__type__": "CCPropertyOverrideInfo",
    "targetInfo": {
-      "__id__": 450
+      "__id__": 458
    },
    "propertyPath": [
      "_active"
@@ -10133,7 +10246,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 460
+      "__id__": 468
    },
    "_contentSize": {
      "__type__": "cc.Size",
@@ -10161,7 +10274,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 462
+      "__id__": 470
    },
    "_alignFlags": 45,
    "_target": null,
@@ -10197,7 +10310,7 @@
    },
    "_enabled": true,
    "__prefab": {
-      "__id__": 464
+      "__id__": 472
    },
    "debugMode": false,
    "_id": ""
@@ -10219,10 +10332,13 @@
    "targetOverrides": null,
    "nestedPrefabInstanceRoots": [
      {
-        "__id__": 446
+        "__id__": 454
      },
      {
-        "__id__": 437
+        "__id__": 445
+      },
+      {
+        "__id__": 416
      },
      {
        "__id__": 55