项目介绍

Script Graph 是一款专为 Cocos Creator 3.8.x 设计的可视化脚本编辑插件。它把游戏逻辑拆成节点和连线，让你不写代码也能高效搭建组件行为、事件响应、资源加载、UI 交互、物理控制和常见玩法系统。

项目定位

Script Graph 不替代 Cocos Creator，而是把 Cocos Creator 的脚本开发变成更直观的节点操作：你在编辑器里创建 .sgw 工作流，通过节点表达事件、变量、函数、类、结构体、枚举、Cocos 节点、Cocos 组件和资产管理逻辑，最终接入可运行的 TypeScript 组件。

适合这些使用场景：

• 不想手写大量脚本：用节点连接完成中小型游戏逻辑。
• 已经熟悉 Cocos Creator：把重复玩法逻辑封装成函数、类、结构体和自定义节点。
• 教学、原型和小团队协作：用可视化图快速解释执行顺序、数据流和状态变化。

核心能力

能力	说明	典型用途
工作流节点	用执行流和数据流组织逻辑	生命周期、输入事件、分支、循环、延迟、调试
TypeScript 组件	工作流可以接入标准 TypeScript 组件	让节点逻辑在 Cocos Creator 项目中运行
高性能执行路径	对性能敏感逻辑提供更高效的执行方式	正式项目打包前优化关键逻辑
多文件类型	支持组件、函数库、类、接口、枚举、结构体	组织中小型项目的领域模型
资产和 Cocos API 节点	覆盖资产包、图片、音频、Prefab、Node、组件和物理查询	完整搭建 UI、音效、动画、场景交互
自定义与插件化节点	支持把常用能力封装成自己的节点	复用团队专属玩法节点
检查与调试	运行前检查节点、连线、变量和类型	快速定位错误节点，减少反复试错

当前规模

节点手册覆盖 2704 个可用节点，按事件、流程控制、变量、函数、类、结构体、枚举、资产、语言基础、数学运算、Cocos 节点、Cocos 组件、物理查询、对象池、缓动和音频系统等节点族组织。你可以先按节点族定位能力，再查看每个节点的用途、引脚、组合方式和注意事项。

从哪里开始

1. 先完成 Hello World：打印第一条消息，确认 .sgw 能创建、编译、挂接和运行。
2. 再读 创建、打开和挂接工作流，理解工作流文件、面板和组件挂接关系。
3. 接着读 节点、引脚和连线 与 事件、执行流和数据流，掌握节点图最核心的执行模型。
4. 然后做 按钮开始游戏和场景切换 或 资产、音效和 Prefab 加载。
5. 遇到问题时先查 编译、运行和日志排查，再按节点手册定位具体节点。
6. 需要封装团队能力时，继续读 自定义节点完整指南 和 插件节点和关联插件完整指南。

文档结构

• 项目介绍：说明项目定位、能力边界和阅读路线。
• 快速开始：从 Hello World 到创建、打开、编译和挂接工作流。
• 基础概念：解释 .sgw、Flow、节点、引脚、执行流、数据流、变量和类型系统。
• 实战教程：覆盖 UI 按钮、场景切换、资产加载、音效、Prefab 和打砖块案例拆解。
• 问题诊断：按现象排查编译、运行、日志、类型、事件和资产问题。
• 高阶教程：讲解自定义节点、插件节点、关联插件、原生代码编译和批量编译。
• 更新日志：按开发期数梳理功能演进，并汇总视频记录。
• 节点手册：按游戏逻辑场景组织节点，每个节点包含用途、引脚、使用场景和注意事项。
• 术语表：统一解释工作流文档中的核心概念。