本地项目

让 EvoX 使用电脑上的指定目录，处理已有资料或代码，并把结果保存到明确位置。本页专门说明文件范围和工作副本；会话归属与项目整理见项目和聊天。

何时使用

多次任务需要读取同一批文件时，在协作项目中连接文件夹。需要终端、测试与差异检查时，在编码模式选择目录或 Git 仓库。只处理一份临时文件时，直接添加会话附件即可。

选择文件入口

文件范围与输出位置

项目是组织会话、规则和成果的容器；本地文件夹是实际资料所在的位置。连接文件夹不会搬迁文件，也不等于允许 EvoX 修改电脑上其他目录。将只读资料、可编辑文件和输出位置写清楚，避免任务根据文件名猜测范围。

确定产物保存位置

协作项目按以下顺序选择产物目录：

新项目自带托管目录，连接已有文件夹用于增加可用资料，不是开始工作的前提。增加或移除文件夹后，重新检查项目显示的产物位置；不要默认新增成果仍会落在原目录。

重命名与移动目录

重命名项目只修改显示名称，托管目录不会跟着改名。在设置 > 协作 > 新项目位置更改默认根目录，只影响之后创建的项目，已有项目保留原位置；平台默认根目录是用户文档目录下的 EvoX。

需要迁移已有项目时，使用项目托管目录行的移动。该操作移动实际目录，成功后才更新项目路径。目标已存在、目标位于源目录内部或跨磁盘移动时会拒绝，保留源目录；先选择同一磁盘上不存在的目标位置，再重试。

使用流程

1. 在协作中选择项目，进入项目详情的文件夹区域，连接需要使用的本地目录；编码任务则选择主要工作区。
2. 核对显示的路径。需要跨目录工作时，明确添加相关目录；编码附加目录只属于当前本地会话。
3. 核对项目显示的产物目录；连接多个文件夹时，明确指定成果保存位置。请求中给出准确输出路径不会自动授予该目录的访问权限。
4. 先请求列出相关文件并确认输入，再允许修改。已有个人改动应明确要求保留。
5. 完成后打开实际文件，检查内容与保存位置；代码任务再查看差异并运行相关检查。

例如：

阅读项目已连接的 interviews 文件夹中本周的三份访谈。先列出文件名，缺少材料时告诉我。仅生成 outputs/客户反馈摘要.md，按主题列出结论和对应访谈来源；没有依据的信息标为待确认。不要修改原始访谈，也不要覆盖已有摘要，遇到同名文件先说明。

确认输入后再继续，完成时核对三项结果：

• 内容有依据：摘要能追溯到具体访谈，缺失信息没有被补造成事实。
• 文件在预期位置：打开实际保存的文件，确认不是只在对话中显示了文本。
• 改动符合范围：原始资料保持完整；若另存了版本，确认后续使用哪一份。

下一次处理新的访谈时，重新指出本次材料和输出文件。项目连接可以复用，每一批任务都要重新选择正确的输入文件。

在代码仓库中工作

编码任务以选中的目录或 Git 仓库为主要工作区。相关目录可以附加到当前本地会话，但不要据此推断其他会话也已获得相同目录范围。

开始修改前，要求检查当前分支、工作区状态和相关源文件，保留已有个人改动。任务应说明修改目标、允许涉及的目录及完成标准，例如“只修复导出文件名问题，运行相关测试，不提交代码”。完成后查看实际差异和检查结果，而不是只看完成说明。在本地改动视图中展开文件阅读差异，用文件勾选框确定提交范围；展开文件只记录阅读进度，不代表代码已通过审查。工作区在加载差异后发生变化时，先刷新再提交。

需要并行改动时，可使用受管 Git worktree 隔离工作副本。它解决不同任务的文件改动互相干扰，不是备份；定时编码任务也不会自动为每次运行创建 worktree，会使用已保存的所选目录。

多个任务怎样避免互相覆盖

同一组原始资料可以作为多个任务的输入，但应给每个任务明确的输出文件。例如，访谈摘要写入客户反馈摘要，行动项另存行动清单。如果两个任务都需要修改同一份文件，按顺序执行并让后一个任务读取前一个任务的最新结果。

代码任务需要独立修改同一仓库时，先确定各自工作副本与整合方式。文件修改隔离后，仍需要审查差异、解决冲突并验证整合结果。

路径变化与工作副本清理

清理受管工作副本前，保存需要保留的文件和改动，并检查是否有启用的定时任务仍引用它。执行清理前核对将删除的工作副本及其 EvoX 任务分支；强制清理未提交改动会丢失这些改动。不要把清理当作归档或备份。

限制与注意事项

• 连接目录不会让 EvoX 自动读完其中全部内容，当前任务仍需明确材料范围。
• 项目归属不等于文件授权，也不等于可以读取其他会话的全部历史。
• 复制、覆盖和删除是不同操作。要求修改已有文件时，明确要原地修订还是另存版本。

下一步

了解处理文件中的预览、版本和导出；需要持续共享工作规则时阅读项目和聊天。