项目与工作区
PinK 打开的文件夹既是代码工作区，也是游戏项目能力的作用域。项目根目录包含版本声明、COCOS 设置、场景、脚本和资源；只打开 assets 会丢失必要的项目上下文。
项目启动过程
打开项目后，PinK 会读取 package.json 和项目设置，连接项目声明的 COCOS 环境，初始化资源数据库，再启用场景、Inspector、预览和构建能力。
初始化期间可能出现这些正常现象：资源树短暂为空、场景命令不可用、脚本诊断尚未完成。只有长时间没有进展或出现错误通知时，才进入排障。
判断“已经就绪”不要只看窗口是否出现。至少确认资源树能够看到项目自己的场景和资源，相关命令可用，状态栏没有持续运行的初始化任务。首次建立资源缓存会比之后打开更慢。
切换项目
切换前保存场景和脚本，停止预览与构建任务，再打开新目录。切换后不要假设上一项目的场景、输出通道和终端仍适用。
切换后用两个信号交叉确认：标题中的工作区名应与目标项目一致，资源根目录也应显示该项目的入口场景。如果二者不一致，先停止修改，避免把脚本或构建产物写进另一个项目。
工作区约定
- 源码与资源：
assets/。 - 项目和引擎声明：
package.json、settings/。 - PinK 与编辑器设置：
.pink/、.vscode/。 - 本机派生结果：
library/、temp/、local/、build/，不提交。
assets/**/*.meta 属于资源身份的一部分，应与资源一起移动和提交；library 中的同名文件只是可重新生成的缓存，不能拿来替代源资源。团队协作时还应固定 package.json 中的 COCOS 与 PinK 版本，减少“同一个场景在不同机器表现不同”的问题。
遇到问题时先确认“当前窗口打开的是哪个根目录”，这是最便宜也最容易忽略的检查。