Project Workspace

프로젝트와 작업 환경

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

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

항목	설명
folders	탐색기 루트 폴더(프로젝트 파일 기준 상대 경로)
selected	탐색기에서 마지막으로 고른 항목
tabs	편집기 탭 순서대로 — 파일 탭은 경로만, 이름 없는 스크립트 탭은 본문까지(1 MB 이하) · 탭마다 캐럿 위치 + 그 줄의 본문/앞뒤 문맥(외부에서 파일이 바뀌어도 같은 줄을 찾는 fuzzy 재탐색)
active	활성 탭
bookmarks	북마크 전부(프로젝트가 열려 있으면 북마크는 이 파일에만 저장)
expanded	프로젝트 탐색기에서 펼쳐 둔 폴더(상대 경로)
panel	보이던 좌측 패널(project · bookmarks · search · ext)
search	파일 검색 패널의 검색어
bm_collapsed	북마크 패널에서 접어 둔 그룹
profiles	마지막에 붙어 있던 접속 프로필 이름 — 표식만입니다. 다시 열 때 자동으로 접속하지 않고 로그·토스트로 알려 주므로 직접 접속하세요

탭 항목의 preview: true는 미리보기 탭(북마크·탐색기 한 번 클릭으로 연 것)이었다는 뜻이고 복원도 미리보기로 됩니다.

저장은 언제나 지금 작업 환경을 담습니다 — Project ▸ 저장 · 새 프로젝트 저장 · 다른 이름으로 · 폴더 추가/제거 · 자동 저장 · 종료(자동 저장이 켜져 있을 때) 전부 같은 길입니다. 열기는 작업 환경을 교체합니다 — 열려 있던 탭 가운데 복원 목록에 없는 것은 닫힙니다(직전 프로젝트가 있었으면 그 파일과 스냅숏에 이미 담긴 상태 · 프로젝트 없이 쓰던 미저장 탭은 남깁니다). 같은 프로젝트를 다시 고르거나 저장할 때는 복원이 돌지 않아 탭이 겹쳐 늘지 않습니다.

파일 탭의 미저장 편집은 원본에도 프로젝트 파일에도 쓰지 않습니다. 대신 사용자 설정 폴더의 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 아이콘 · 향상 모드에서는 꺼짐). 켜면 OS의 셸 아이콘 캐시가 프로세스에 한 번 올라와 약 2 MB를 더 쓰고, 조회 스레드는 조회가 끝난 뒤 5초면 스스로 거둡니다

종료(창 닫기·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.