Chat 常见问题
排障时先把真实结果交给 Chat，不要只说“还是不行”。入口、操作、预期、实际结果和首个错误能够帮助它判断问题属于上下文、代码、资源还是运行环境。
Chat 没有找到相关文件
明确给出工作区内相对路径，例如 assets/scripts/ClickGame.ts，并让它先列出实际找到的文件。确认当前打开的是 pink-game-demo 根目录，而不是 assets 子目录。
生成代码与引擎不兼容
告诉 Chat 项目实际使用的 COCOS 版本，并要求它根据项目现有 API 修正。不要直接采用面向其他大版本的网页示例。
界面正常，但点击和重置都没有反应
场景可以独立显示完整界面，所以能看到按钮并不代表控制脚本已正常启用。先检查 Console 是否出现以下错误：
[ClickGame] Assign Score Label, Target, and Reset Button in the GameController Inspector before running the scene.出现这条错误时，ClickGame 会停用自身。退出预览，在场景中选中 GameController，为 Score Label 绑定 Canvas/ScoreCard/ScoreLabel 的 Label 组件，为 Target 和 Reset Button 分别绑定 Canvas/Target 和 Canvas/ResetButton，保存后重新运行。不要让 Chat 通过新建 Canvas、按钮或备用界面绕过引用问题。
如果三个引用都正常，再让 Chat 检查 onEnable() 中的事件绑定、onDisable() 中的解绑，以及计分和重置方法；附上实际操作和 Console 错误。
改了文字或位置，预览却没有按预期变化
- 按钮文字由场景中的
Canvas/ResetButton/Label决定，应修改 Label 并保存场景。 - 分数文字由脚本更新；仅修改场景里的
Score: 0，会在开始或重置时被覆盖。 - 目标在启动和重置时使用
TARGET_POSITIONS[0]，点击后沿数组移动；仅修改场景里的目标位置不会改变这条路线。
把修改的节点路径、属性和文件一起提供给 Chat，先确认是哪一层决定运行结果。
修改范围太大
停止继续追加需求，要求它列出已经修改的文件，并把任务缩小到一个结果。必要时先撤销无关文件，再重新提出约束明确的提示词。
命令执行失败
提供完整命令、工作目录、退出码和最早的错误信息。不要只复制日志最后一行；最后一行通常只是前面失败的汇总。
运行正常但结果不对
按 0 分、点击后 1 分、目标移动、重置后 0 分逐项描述。这样 Chat 才能判断问题在事件、状态更新、位置序列还是重置逻辑。
AI 能力边界
Chat 不能替代账号权限、平台审核、证书签名和真实设备测试。涉及秘密信息、删除、上传和发布时，必须由开发者确认目标和影响。