GodotHub 如何自动扫描与收纳本地项目

为什么需要项目收纳

独立开发者的电脑上常常会有几十个 Godot 项目：正式项目、练手 Demo、社区模板克隆、老项目维护版本——散落在不同的盘符和目录下。找某个项目的位置通常要在文件资源管理器里翻好几分钟。

GodotHub 的项目收纳功能就是解决这个问题的：扫一遍硬盘，把所有包含 project.godot 文件的目录自动找出来，整理成一份统一的项目列表。

扫描过程

首次打开项目管理界面时，GodotHub 会提示你选择扫描范围：

• 全盘扫描（推荐给新项目）
• 指定几个目录扫描（更快，适合已经知道项目在哪里）

扫描过程中，GodotHub 做这些事：

1. 遍历目录树，识别 project.godot 文件
2. 读取每个项目的基本信息：项目名称、Godot 版本、最近修改时间
3. 自动判断项目是 2D 还是 3D（根据 project.godot 里的配置）
4. 把项目加入本地数据库，等待你确认

扫描后的整理

扫描完成后，GodotHub 展示一个项目列表，你可以：

• 确认导入：勾选要管理的项目，批量导入
• 排除不管理的：取消勾选临时练手的 Demo，只留正式项目
• 分组：按项目类型或工作状态分组（正在开发、已暂停、待维护）

导入后，这些项目就在 GodotHub 的项目管理界面里常驻了。后续新增项目时，GodotHub 也会自动感知变化，提示你是否纳入管理。

隐私与安全

扫描过程完全在本地进行，不会把项目信息上传到任何服务器。GodotHub 只记录项目目录的路径、引擎绑定等管理信息，不读取项目文件的内容。