프로젝트 열기와 관리

Noea 프로젝트는 의도 문서와 코드 폴더를 연결합니다. 이 안내에서는 프로젝트 열기와 전환, 데이터 위치 확인, 이름 변경, 위치 재지정, 삭제를 설명합니다.

두 폴더 구분하기

구현 폴더에는 에이전트가 읽고 수정하는 코드가 있습니다. Noea 프로젝트 폴더에는 의도 문서와 프로젝트 관련 데이터가 있습니다. 사용하는 열기 방식에 맞는 폴더를 선택하세요.

새 프로젝트는 기본적으로 홈 디렉터리의 NoeaProjects 아래에 “구현 폴더 이름 / 프로젝트 이름”으로 저장됩니다. 프로젝트를 만들 때 다른 위치를 선택할 수 있습니다. 채팅과 첨부 파일은 로컬 앱 데이터에 별도로 저장됩니다. 데이터, 개인정보 보호 및 업데이트를 참고하세요.

프로젝트를 여는 방법 선택하기

구현 폴더 열기는 연결된 프로젝트가 없으면 만들고, 하나 있으면 바로 열며, 여러 개면 선택하도록 안내합니다. 일반 코드 폴더는 기존 Noea 프로젝트가 아닙니다. 기존 Noea 프로젝트 열기로 초기화하지 마세요.

세 동작 모두 파일 메뉴에 있습니다. 사이드바의 폴더 열기…는 구현 폴더를 엽니다.

프로젝트 전환 및 복원하기

사이드바 위쪽 프로젝트 메뉴는 최근 프로젝트를 구현 폴더별로 보여 줍니다. 전환하기 전에 현재 탭이 닫힌다는 것을 확인하고, 저장하지 않은 편집이 있으면 경고합니다.

기본적으로 앱은 시작할 때 마지막으로 정상적으로 연 프로젝트를 복원합니다. 설정 → 일반에서 이를 끄거나 최근 프로젝트 목록을 지울 수 있습니다. 목록을 지워도 프로젝트는 삭제되지 않습니다.

파일 → 프로젝트 닫기를 선택하면 프로젝트를 열지 않은 작업 공간으로 돌아갑니다.

여러 프로젝트에서 같은 코드 사용하기

프로젝트 → 이 구현에 새로운 프로젝트 만들기…는 같은 코드 폴더에 연결된 또 다른 Noea 프로젝트를 만듭니다. 각 프로젝트는 서로 다른 주제에 집중할 수 있습니다.

구현 폴더는 공유하며, Noea가 독립된 코드 복사본을 만들지는 않습니다. 같은 폴더에 연결된 다른 프로젝트에서 채팅이나 작업이 실행 중이면 열 때 경고합니다. 어느 프로젝트에서든 코드를 변경하면 공유 구현에 영향을 줍니다.

구현 연결 또는 위치 재지정하기

구현을 연결하지 않아도 의도를 읽고 편집하며 기존 기록을 볼 수 있습니다. 연결하려면 설정 → 현재 프로젝트 → 프로젝트에서 구현 폴더를 선택하고 경로를 확인하세요.

한 번 연결한 폴더는 다른 폴더로 바로 바꿀 수 없습니다. 원래 위치에 접근할 수 없으면 설정에 위치 재지정 기능이 나타납니다. 원래 코드 폴더가 이동한 위치를 선택하세요. 관련 없는 코드로 바꾸는 용도로 사용하지 마세요.

프로젝트 이름 변경 또는 삭제하기

프로젝트 메뉴에서 이름 변경, 폴더 표시, 삭제를 할 수 있습니다. 이름 변경은 로컬 목록에 표시되는 이름만 바꾸며, 디스크의 폴더 이름은 바꾸지 않습니다.

프로젝트를 삭제하면 프로젝트 폴더를 휴지통으로 옮기고, 로컬에 저장된 채팅, 기록, 첨부 파일을 삭제합니다. 연결된 구현 폴더에는 영향을 주지 않습니다. 실행 중인 채팅이나 작업이 끝날 때까지 기다리거나 중지한 다음 삭제하세요.

프로젝트가 열리지 않을 때

선택한 폴더를 확인한 다음 앱의 안내를 읽으세요. 더 최신 앱 버전에서 작성한 데이터라면 안내에 따라 업데이트합니다. 설정이 유효하지 않다면 같은 위치에 새 프로젝트를 만들어 덮어쓰지 마세요.

데이터 버전 호환성, 폴더 이동, 접근 문제는 문제 해결을 참고하세요.