Project Workspace

프로젝트와 작업 환경

프로젝트 파일(<이름>.nsql-project · JSON · 어디에나 · VCS에 올려도 됨)이 폴더 목록 + 작업 환경을 담습니다. 프로젝트를 열면 마지막 작업 상태가 그대로 돌아옵니다.

프로젝트 파일에 들어가는 것

항목	설명
folders	탐색기 루트 폴더(프로젝트 파일 기준 상대 경로)
selected	탐색기에서 마지막으로 고른 항목
tabs	편집기 탭 순서대로 — 파일 탭은 경로만, 이름 없는 스크립트 탭은 본문까지(1 MB 이하) · 탭마다 캐럿 위치 + 그 줄의 본문/앞뒤 문맥(외부에서 파일이 바뀌어도 같은 줄을 찾는 fuzzy 재탐색)
active	활성 탭
bookmarks	북마크 전부(프로젝트가 열려 있으면 북마크는 이 파일에만 저장)

파일 탭의 미저장 편집은 원본에도 프로젝트 파일에도 쓰지 않습니다. 대신 사용자 설정 폴더의 backups/files/에 스냅숏을 남기고, 다음에 프로젝트를 열 때 파일이 그대로면 스냅숏을 올리고(미저장 표시 ●) 파일이 밖에서 바뀌었으면 디스크 본문을 쓰고 로그에 남깁니다(스냅숏은 보관).

자동 저장 · 종료

설정 Project 분류:

키	기본	뜻
project.autosave	on	30초마다(바뀐 것이 있을 때만) + 탭을 열고 닫고 옮긴 뒤 2초 + 종료 때 프로젝트 파일을 저장
project.autosave_secs	30	주기(초 · 5~3600)
project.backup_days	7	미저장 스냅숏 보관 일수
project.auto_reveal	off	탭을 고르면 탐색기가 그 파일까지 펼치고 스크롤(끄면 펼치지 않고 선택 표시만)
project.icons	on	탐색기 파일/폴더 아이콘(OS 아이콘 · 향상 모드에서는 꺼짐)

종료(창 닫기·File ▸ Exit): 자동 저장이면 프로젝트를 저장하고 종료 → 아니면 "프로젝트 저장 후 종료 / 저장 없이 종료 / 취소" → 그 다음 미저장 파일 탭마다 저장할지 묻습니다(이름 없는 스크립트 탭은 프로젝트에 본문이 보존되므로 묻지 않음 · 프로젝트가 없으면 전부 묻습니다).

프로젝트 탐색기(활동 막대 ▸ 프로젝트)

• OPEN FILES(맨 위): 열린 탭 순서 · ● = 미저장 · 활성 탭 강조 · 동시 편집 칸의 탭은 외곽선 · 클릭 = 그 탭 · 머문 행의 × = 닫기.
• 파일 필터: 틀 안 토글 Aa(대소문자) · ab(단어) · (.*)(정규식) · 경로 포함(켜면 폴더/이름 경로에 일치) · 틀 오른쪽 = 숨김 파일 · 점 파일(Windows) 표시 토글(파일 대화상자와 같은 설정).
• 트리: 셰브론 · OS 아이콘 · 가로 스크롤 · 루트 우클릭 = Remove Folder from Project · 빈 곳 클릭 = 선택 해제(마지막 행은 테두리만 남아 ↑/↓의 시작점).
• 편집기 탭 우클릭 ▸ Reveal in Project Explorer(프로젝트 폴더 안 파일만 활성).
• 필터가 많이 열거해야 하면 "N개에서 열거를 멈췄습니다"(project.scan_max · 새로 열거할 폴더가 남았을 때만 표시).

명령

Project 메뉴: 새 프로젝트 저장(파일 모드에서도) · 열기 · 전환(최근 목록) · 저장 · 다른 이름으로 · 닫기 · 폴더 추가. CLI에서 프로젝트 안 북마크: nsql bookmark list --project x.nsql-project.