本地項目

讓 EvoX 使用電腦上的指定目錄，處理已有資料或代碼，並把結果保存到明確位置。本頁專門説明文件範圍和工作副本；會話歸屬與項目整理見項目和聊天。

何時使用

多次任務需要讀取同一批文件時，在協作項目中連接文件夾。需要終端、測試與差異檢查時，在編碼模式選擇目錄或 Git 倉庫。只處理一份臨時文件時，直接添加會話附件即可。

選擇文件入口

文件範圍與輸出位置

項目是組織會話、規則和成果的容器；本地文件夾是實際資料所在的位置。連接文件夾不會搬遷文件，也不等於允許 EvoX 修改電腦上其他目錄。將只讀資料、可編輯文件和輸出位置寫清楚，避免任務根據文件名猜測範圍。

確定產物保存位置

協作項目按以下順序選擇產物目錄：

新項目自帶託管目錄，連接已有文件夾用於增加可用資料，不是開始工作的前提。增加或移除文件夾後，重新檢查項目顯示的產物位置；不要默認新增成果仍會落在原目錄。

重命名與移動目錄

重命名項目只修改顯示名稱，託管目錄不會跟着改名。在設置 > 協作 > 新項目位置更改默認根目錄，隻影響之後創建的項目，已有項目保留原位置；平台默認根目錄是用户文檔目錄下的 EvoX。

需要遷移已有項目時，使用項目託管目錄行的移動。該操作移動實際目錄，成功後才更新項目路徑。目標已存在、目標位於源目錄內部或跨磁盤移動時會拒絕，保留源目錄；先選擇同一磁盤上不存在的目標位置，再重試。

使用流程

1. 在協作中選擇項目，進入項目詳情的文件夾區域，連接需要使用的本地目錄；編碼任務則選擇主要工作區。
2. 核對顯示的路徑。需要跨目錄工作時，明確添加相關目錄；編碼附加目錄只屬於當前本地會話。
3. 核對項目顯示的產物目錄；連接多個文件夾時，明確指定成果保存位置。請求中給出準確輸出路徑不會自動授予該目錄的訪問權限。
4. 先請求列出相關文件並確認輸入，再允許修改。已有個人改動應明確要求保留。
5. 完成後打開實際文件，檢查內容與保存位置；代碼任務再查看差異並運行相關檢查。

例如：

閲讀項目已連接的 interviews 文件夾中本週的三份訪談。先列出文件名，缺少材料時告訴我。僅生成 outputs/客户反饋摘要.md，按主題列出結論和對應訪談來源；沒有依據的信息標為待確認。不要修改原始訪談，也不要覆蓋已有摘要，遇到同名文件先説明。

確認輸入後再繼續，完成時核對三項結果：

• 內容有依據：摘要能追溯到具體訪談，缺失信息沒有被補造成事實。
• 文件在預期位置：打開實際保存的文件，確認不是隻在對話中顯示了文本。
• 改動符合範圍：原始資料保持完整；若另存了版本，確認後續使用哪一份。

下一次處理新的訪談時，重新指出本次材料和輸出文件。項目連接可以複用，每一批任務都要重新選擇正確的輸入文件。

在代碼倉庫中工作

編碼任務以選中的目錄或 Git 倉庫為主要工作區。相關目錄可以附加到當前本地會話，但不要據此推斷其他會話也已獲得相同目錄範圍。

開始修改前，要求檢查當前分支、工作區狀態和相關源文件，保留已有個人改動。任務應説明修改目標、允許涉及的目錄及完成標準，例如“只修復導出文件名問題，運行相關測試，不提交代碼”。完成後查看實際差異和檢查結果，而不是隻看完成説明。在本地改動視圖中展開文件閲讀差異，用文件勾選框確定提交範圍；展開文件只記錄閲讀進度，不代表代碼已通過審查。工作區在加載差異後發生變化時，先刷新再提交。

需要並行改動時，可使用受管 Git worktree 隔離工作副本。它解決不同任務的文件改動互相干擾，不是備份；定時編碼任務也不會自動為每次運行創建 worktree，會使用已保存的所選目錄。

多個任務怎樣避免互相覆蓋

同一組原始資料可以作為多個任務的輸入，但應給每個任務明確的輸出文件。例如，訪談摘要寫入客户反饋摘要，行動項另存行動清單。如果兩個任務都需要修改同一份文件，按順序執行並讓後一個任務讀取前一個任務的最新結果。

代碼任務需要獨立修改同一倉庫時，先確定各自工作副本與整合方式。文件修改隔離後，仍需要審查差異、解決衝突並驗證整合結果。

路徑變化與工作副本清理

清理受管工作副本前，保存需要保留的文件和改動，並檢查是否有啓用的定時任務仍引用它。執行清理前核對將刪除的工作副本及其 EvoX 任務分支；強制清理未提交改動會丟失這些改動。不要把清理當作歸檔或備份。

限制與注意事項

• 連接目錄不會讓 EvoX 自動讀完其中全部內容，當前任務仍需明確材料範圍。
• 項目歸屬不等於文件授權，也不等於可以讀取其他會話的全部歷史。
• 複製、覆蓋和刪除是不同操作。要求修改已有文件時，明確要原地修訂還是另存版本。

下一步

瞭解處理文件中的預覽、版本和導出；需要持續共享工作規則時閲讀項目和聊天。