打开与管理项目 — Noea Code 文档

Noea 将意图文档与代码文件夹关联为一个项目。本篇介绍如何打开和切换项目、找到保存位置，以及处理重命名、重新定位和删除。

实现文件夹是代码所在的位置，Agent 在这里读取和修改代码。Noea 项目目录保存意图文档及项目相关数据。两者用途不同，打开项目时应按入口选择对应的文件夹。

默认新项目放在用户主目录下的 NoeaProjects 中，按“实现文件夹名 / 项目名”分组。你也可以在创建项目时指定其他位置。对话和附件另外保存在本机的应用数据中，详见数据、隐私与更新。

选择打开方式

使用“打开实现文件夹”时，如果还没有关联项目，会创建一个；有一个则直接打开；有多个则先选择。普通代码目录并不是现成的 Noea 项目，不要用“打开现有 Noea 项目”尝试初始化它。

三个入口都可以在“文件”菜单找到。侧栏的“打开文件夹…”对应“打开实现文件夹”。

侧栏顶部的项目菜单列出最近使用的项目，并按实现目录分组。切换时，Noea 会确认当前标签页即将关闭；有未保存修改时一并提示。

应用默认在启动时恢复最近成功打开的项目。可以在“设置 → 通用”关闭这一选项，或清理最近项目列表。清理列表不会删除项目本身。

使用“文件 → 关闭项目”可以回到没有项目的工作台。

“项目 → 在此实现上新建项目…”可以为同一代码目录建立另一份 Noea 项目。例如，你可以让不同项目分别关注不同主题。

这些项目共用同一个实现文件夹，不会创建独立的代码副本。如果其他关联项目仍有运行中的对话或任务，打开时会提示；各项目中的代码修改都会影响这份共同的实现。

项目尚未关联实现时，仍可以阅读和编辑意图，并查看已有历史。打开“设置 → 当前项目 → 项目”，选择实现文件夹，确认显示的路径后关联。

关联后，不提供直接更换实现文件夹的操作。如果原位置已经无法访问，设置会提供重新定位入口。请选择原项目代码的新位置，不要用它切换到另一份无关代码。

项目菜单提供重命名、显示项目文件夹和删除操作。项目名称用于本机列表显示，重命名不会同时改掉磁盘文件夹名。

删除项目会将项目文件夹移入废纸篓或回收站，并删除它在本机保存的对话、历史和附件。关联的实现文件夹不受影响。有运行中的对话或任务时，先等待完成或停止，再删除。

先确认选择的是正确目录，再检查应用给出的原因。若项目由更新版本写入，按提示更新应用；若提示配置无效，不要用新建操作覆盖原内容。

数据版本不兼容、目录被移动或访问权限不足的处理，见故障排查。