打开已有 COCOS 项目

已有项目不需要重新创建。PinK 应打开包含项目配置和 assets 的根目录，而不是只打开某个场景、脚本目录或 assets 子目录。

PinK 目前只支持 COCOS 3.8.8 引擎版本工程。

打开前检查

• 为项目保留可恢复的版本控制状态或副本。
• 阅读项目自己的 README、依赖和构建说明。
• 确认项目支持的引擎版本。
• 暂时不要删除 library、temp 或其他缓存；先保留故障现场。

打开项目

1. 在欢迎区域选择“打开文件夹”，或者使用“文件 → 打开文件夹”。
2. 选择同时包含 package.json 和 assets 的项目根目录。
3. 等待项目、资源和脚本初始化结束。
4. 打开项目的入口场景，检查资源树、问题面板和输出面板。

大型项目第一次打开时需要扫描资源和建立索引。入口暂时不可用时先等待初始化完成，不要连续重复打开场景或切换项目。

使用 Pink Demo 跟随教程

Pink Demo 是本手册配套的 2D 点击得分示例，不包含在 PinK 安装包中。项目在独立的官方仓库中维护。

可以在 Pink Demo 官方仓库选择 Code → Download ZIP 下载 ZIP，或使用以下命令克隆：

git clone https://github.com/SUD-GLOBAL/pink-game-demo.git

解压或克隆后，打开同时包含 package.json 和 assets 的项目根目录。Git 克隆的默认目录名是 pink-game-demo，ZIP 解压的目录名可能带有 -main 后缀。

打开 Pink Demo

1. 在 PinK 中选择“打开文件夹”。
2. 选择下载后的 pink-game-demo 项目根目录。
3. 等待初始化状态结束。
4. 展开资源树并打开 assets/main.scene。

资源树出现 main.scene、ClickGame.ts、目标图片和动画后，才能继续 Demo 教程

Pink Demo 的已验证 COCOS 版本列在第一次 AI 修改的前置条件中。打开后确认资源完整、状态栏不再初始化，并从问题和输出面板处理最早出现的错误。

项目准备好后，继续第一次 AI 修改：Pink Demo。