File Operations ko

파일 작업

Unifyl Basic은 효율성과 안전성을 위해 설계된 종합적인 파일 작업 기능을 제공합니다. 이 페이지는 모든 파일 작업, 작업 큐, 실행 취소/다시 실행 시스템, 그리고 클라우드 및 원격 파일에 대한 특수 처리까지 자세히 다룹니다.

---

목차

• 핵심 작업 개요
• 복사 (F5)
  • 복사 워크플로
  • 복사 확인 다이얼로그
  • 복사 동작 상세
• 이동 (F6)
  • 이동 워크플로
  • 이동 vs. 복사 후 삭제
• 삭제 (F8)
  • 삭제 워크플로
  • 휴지통 vs. 영구 삭제
• 새 폴더 (F7)
• 이름 변경 (Shift+Return)
  • 단일 파일 이름 변경
  • Multi-Rename 도구
  • 정규식 이름 변경
  • 일괄 확장자 변경
• 열기 및 편집
• 압축 및 해제
  • ZIP으로 압축
  • 아카이브 해제
  • 아카이브 탐색
• 클립보드 작업
  • 클립보드로 파일 복사
  • 파일 잘라내기
  • 파일 붙여넣기
  • 클립보드 기록
• 드래그 앤 드롭
• 실행 취소 및 다시 실행
  • 실행 취소 가능한 작업
  • 실행 취소 동작
• 작업 큐
  • 큐 동작
  • 일시 정지 및 재개
  • 진행률 모니터링
  • 충돌 해결
• 파일 권한
• 정보 가져오기
• 클라우드 및 원격 파일 처리
• selectedOrCursorItems 로직

---

핵심 작업 개요

작업	단축키	대체 단축키	설명
복사	F5	Cmd+D	항목을 반대편 패널로 복사
이동	F6	Cmd+Shift+D	항목을 반대편 패널로 이동
삭제	F8	Cmd+Delete	항목을 휴지통으로 이동
새 폴더	F7	Cmd+Shift+N	새 디렉터리 생성
이름 변경	Shift+Return	--	커서 항목 이름 변경
열기	Cmd+O	Return (파일에서)	기본 응용 프로그램으로 열기
편집	F4	--	기본 텍스트 편집기로 열기
압축	Shift+F5	--	ZIP 아카이브 생성
해제	Shift+F9	--	아카이브를 폴더로 추출
정보 가져오기	Cmd+I	--	상세 파일 정보 표시

파일을 수정하는 모든 작업(복사, 이동, 삭제, 이름 변경)은 이 페이지 하단에 설명된 selectedOrCursorItems 로직을 사용합니다.

---

복사 (F5)

복사 워크플로

1. 활성 패널에서 원본 파일을 선택합니다 (또는 단일 파일에 커서를 둡니다).
2. 비활성 패널이 원하는 대상 디렉터리로 이동되어 있는지 확인합니다.
3. F5 (또는 Cmd+D)를 누릅니다.
4. 다음을 표시하는 복사 확인 다이얼로그가 나타납니다:
   • 복사할 파일 목록
   • 원본 경로
   • 대상 경로
   • 전체 크기
5. Return을 누르거나 Copy를 클릭해 진행합니다.

복사 확인 다이얼로그

확인 다이얼로그는 다음을 제공합니다:

요소	설명
파일 목록	복사되는 모든 항목의 이름과 크기
원본 경로	파일이 복사되는 출발 디렉터리
대상 경로	파일이 복사될 디렉터리 (편집 가능)
전체 크기	모든 항목의 합산 크기
Copy 버튼	확인 후 작업 시작
Cancel 버튼	변경 없이 중단

팁: 비활성 패널의 현재 디렉터리가 아닌 다른 위치로 복사하려면 확인 다이얼로그에서 대상 경로를 직접 편집할 수 있습니다.

복사 동작 상세

• 디렉터리: 디렉터리를 복사하면 내부 디렉터리 구조를 유지한 채 전체 내용이 재귀적으로 복사됩니다.
• 심볼릭 링크: 심볼릭 링크는 (타깃이 아닌) 링크 그 자체로 복사됩니다. 단, 타깃이 존재하지 않는 경우는 예외입니다.
• 파일 속성: POSIX 권한, 생성일, 수정일이 사본에 보존됩니다.
• 대용량 파일: 설정 가능한 임계값을 초과하는 파일은 속도와 ETA를 표시하는 진행률 표시기를 트리거합니다.
• 동일 볼륨: 동일 볼륨 내 복사는 FileManager.copyItem을 사용하며, 파일시스템에 의해 최적화됩니다 (가능한 경우 APFS clone-on-write).
• 볼륨 간: 볼륨 간 복사는 데이터를 스트리밍하며 실시간 진행률을 보여줍니다.

---

이동 (F6)

이동 워크플로

1. 활성 패널에서 원본 파일을 선택합니다.
2. 비활성 패널이 대상 위치를 표시하는지 확인합니다.
3. F6 (또는 Cmd+Shift+D)을 누릅니다.
4. 이동 확인 다이얼로그에서 확인합니다.

이동 vs. 복사 후 삭제

• 동일 볼륨: 이동은 이름 변경 작업으로 구현되어, 파일 크기와 무관하게 거의 즉시 완료됩니다 (디스크상 데이터는 이동하지 않고 디렉터리 엔트리만 변경됨).
• 볼륨 간: 이동은 복사 후 삭제로 구현됩니다. 파일을 먼저 대상 볼륨으로 복사한 뒤, 복사가 성공한 경우에만 원본이 삭제됩니다.
• 오류 처리: 볼륨 간 이동의 복사 단계에서 실패하면 부분적으로 복사된 파일이 정리되며 원본은 그대로 유지됩니다.

경고: 볼륨 간 이동(예: 내장 SSD에서 외장 드라이브로) 시에는 데이터가 물리적으로 전송되어야 하므로 복사와 동일한 시간이 소요됩니다. 대용량 볼륨 간 이동에는 진행률 다이얼로그가 표시됩니다.

---

삭제 (F8)

삭제 워크플로

1. 삭제할 파일을 선택합니다 (또는 단일 파일에 커서를 둡니다).
2. F8 (또는 Cmd+Delete)을 누릅니다.
3. 삭제 대상 모든 파일이 나열된 확인 다이얼로그가 나타납니다.
4. 확인하여 진행합니다.

휴지통 vs. 영구 삭제

기본적으로 Unifyl은 파일을 영구 삭제하지 않고 macOS 휴지통 (~/.Trash) 으로 이동합니다:

• 휴지통의 파일은 Finder에서 복구할 수 있습니다.
• 휴지통의 파일은 삭제 직후 Unifyl의 실행 취소 (Cmd+Z) 로도 복구할 수 있습니다.
• 파일이 디스크에서 영구히 제거되려면 (Finder에서) 휴지통을 비워야 합니다.

참고: 원격 파일시스템(FTP, SFTP 등)이나 휴지통을 지원하지 않는 볼륨의 파일은 영구 삭제될 수 있습니다. 이러한 경우에는 경고가 표시됩니다.

---

새 폴더 (F7)

1. F7 (또는 Cmd+Shift+N)을 누릅니다.
2. 다이얼로그가 새 폴더 이름을 입력하도록 안내합니다.
3. 원하는 이름을 입력하고 Return을 누릅니다.
4. 활성 패널의 현재 디렉터리에 폴더가 생성됩니다.
5. 커서가 새로 생성된 폴더로 이동합니다.

같은 이름의 폴더가 이미 존재하면 오류 메시지가 표시되며 작업은 취소됩니다.

---

이름 변경 (Shift+Return)

단일 파일 이름 변경

1. 이름을 변경할 파일로 커서를 이동합니다.
2. Shift+Return을 누릅니다.
3. 파일명이 인라인으로 편집 가능해집니다.
4. 이름을 편집합니다 (확장자도 편집 텍스트에 포함됩니다).
5. Return을 눌러 새 이름을 확정합니다.
6. Escape를 누르면 원래 이름이 유지된 채 취소됩니다.

이름 변경 규칙:

• 파일명은 비울 수 없습니다.
• 파일명에는 / (경로 구분자) 를 포함할 수 없습니다.
• 새 이름의 파일이 이미 존재하면 오류가 표시됩니다.
• 이름 변경은 모든 파일 속성, 권한, 타임스탬프를 보존합니다.

Multi-Rename 도구

Opt+Cmd+R을 눌러 일괄 이름 변경용 Multi-Rename 도구를 엽니다:

• 검색 및 치환: 파일명의 텍스트 패턴을 치환합니다.
• 번호 매기기: 순차 번호를 추가합니다 (예: Photo_001.jpg, Photo_002.jpg).
• EXIF 기반: EXIF 메타데이터 (촬영 일시, 카메라 모델) 를 이용해 이름을 변경합니다.
• AI Rename: AI로 파일 내용(이미지, 문서) 기반의 의미 있는 파일명을 생성합니다.
• 프리셋: 반복 사용을 위해 이름 변경 프리셋을 저장하고 불러옵니다.
• 미리보기: 적용 전에 변경 전/후 파일명을 확인합니다.
• 실행 취소: 모든 multi-rename 작업은 Cmd+Z로 되돌릴 수 있습니다.

정규식 이름 변경

Tools 메뉴나 명령 팔레트에서 사용 가능한 정규식 이름 변경 도구는 정규식으로 파일명을 변경할 수 있게 해줍니다:

• 매치 패턴: 파일명과 매칭할 정규식 패턴.
• 치환 패턴: 캡처 그룹 참조 ($1, $2 등) 를 포함한 치환 문자열.
• 미리보기: 적용 전 이름 변경 결과의 라이브 프리뷰.

일괄 확장자 변경

여러 파일의 확장자를 한 번에 변경합니다:

• 확장자를 변경할 파일을 선택합니다.
• (명령 팔레트나 메뉴를 통해) 일괄 확장자 도구를 엽니다.
• 새 확장자를 입력합니다.
• 미리보기 후 확정합니다.

---

열기 및 편집

단축키	동작	설명
Cmd+O	열기	커서/선택 항목을 기본 응용 프로그램으로 엽니다
Return	열기/진입	파일은 기본 앱으로 열고, 디렉터리는 진입합니다
F4	편집	커서 항목을 기본 텍스트 편집기로 엽니다
Opt+Cmd+O	반대편 패널에서 열기	반대편 패널을 항목의 디렉터리로 이동시킵니다

열기는 macOS의 기본 응용 프로그램 연결을 사용합니다 (Finder에서 더블 클릭했을 때 열리는 것과 동일한 앱).

편집은 텍스트 편집기로 파일을 명시적으로 열어, 기본 연결과 관계없이 설정 파일, 스크립트 등 텍스트 기반 파일을 빠르게 편집할 때 유용합니다.

---

압축 및 해제

ZIP으로 압축

1. 압축할 파일 및/또는 폴더를 선택합니다.
2. Shift+F5를 누르거나 File > Compress 메뉴를 사용합니다.
3. 다음을 설정하는 다이얼로그가 나타납니다:
   • 아카이브 이름
   • 아카이브 포맷 (ZIP이 기본값)
   • 선택적으로 암호화 아카이브용 비밀번호
4. 확인하여 아카이브를 생성합니다.

지원되는 아카이브 생성 포맷:

• ZIP (선택적 AES-256 암호화)
• 7-Zip
• TAR, TAR.GZ, TAR.BZ2, TAR.XZ

아카이브 해제

단축키	동작
Shift+F9	지정한 폴더로 해제
(미지정)	현재 디렉터리에 해제

지원되는 해제 포맷: ZIP, 7-Zip, TAR, GZ, BZ2, XZ, RAR, ZSTD.

아카이브 탐색

Unifyl은 아카이브를 가상 폴더로 탐색할 수 있습니다:

• 아카이브 파일을 더블 클릭하거나 Return을 눌러 디렉터리처럼 진입합니다.
• 아카이브 내부의 디렉터리 구조를 탐색합니다.
• 아카이브 밖의 실제 디렉터리로 파일을 복사합니다 (드래그 또는 F5).
• 경로 바에는 아카이브 경로와 내부 하위 경로가 표시됩니다.
• 아카이브 내부에서 상위로 이동하려면 Backspace를 누릅니다 (아카이브 전체에서 나가는 데에도 사용).

지원되는 탐색 포맷: ZIP, 7-Zip, TAR, GZ, BZ2, XZ, RAR, ZSTD.

참고: 아카이브 내부 수정(엔트리 편집, 이름 변경, 삭제)은 해제, 수정, 재압축이 필요합니다. Unifyl은 지원 포맷에 대해 이를 투명하게 처리합니다.

---

클립보드 작업

클립보드로 파일 복사

Cmd+C를 눌러 선택/커서 파일을 시스템 클립보드로 복사합니다. 이 파일들은 Unifyl(다른 패널 또는 탭) 이나 Finder에 붙여넣을 수 있습니다.

파일 잘라내기

Cmd+X로 파일을 잘라냅니다. 붙여넣으면 파일이 대상으로 이동됩니다 (복사가 아님).

파일 붙여넣기

Cmd+V로 클립보드의 파일을 활성 패널의 현재 디렉터리에 붙여넣습니다.

• 클립보드에 복사된 파일이 있으면 복제됩니다.
• 클립보드에 잘라낸 파일이 있으면 이동됩니다.

클립보드 기록

Ctrl+H를 눌러 최근 클립보드 항목을 보여주는 클립보드 기록 패널을 엽니다. 항목을 클릭하면 붙여넣어집니다.

---

드래그 앤 드롭

Unifyl은 macOS 네이티브 드래그 앤 드롭을 지원합니다:

• Unifyl 내부: 패널 간, 탭 간, 패널 내부에서 파일을 드래그해 이동/복사할 수 있습니다.
  • 기본 드래그: 동일 볼륨 내에서는 이동, 볼륨 간에는 복사.
  • 드롭 시 Opt 유지: 복사 강제.
  • 드롭 시 Cmd 유지: 이동 강제.
• Finder에서 Unifyl로: Finder의 파일을 Unifyl 패널로 드롭해 복사/이동합니다.
• Unifyl에서 Finder로: Unifyl의 파일을 Finder 창이나 데스크탑으로 드래그합니다.
• Unifyl에서 다른 앱으로: 파일 드롭을 받는 모든 앱으로 드래그할 수 있습니다.

드래그 앤 드롭은 키보드로 시작한 작업과 동일한 충돌 해결 규칙을 따릅니다.

---

실행 취소 및 다시 실행

실행 취소 가능한 작업

Cmd+Z로 가장 최근 파일 작업을 되돌립니다:

작업	실행 취소 동작
복사	대상 위치의 사본을 삭제
이동	파일을 원래 위치로 다시 이동
삭제 (휴지통)	휴지통에서 원래 위치로 복원
이름 변경	원래 이름으로 되돌림
새 폴더	새로 생성된 폴더 삭제

실행 취소 기록은 스택으로 유지됩니다. Cmd+Z를 반복하여 여러 작업을 순서대로 되돌릴 수 있습니다.

실행 취소 동작

• 세션 한정: Unifyl을 종료하면 실행 취소 기록이 비워집니다.
• 휴지통 복원: 삭제 작업의 실행 취소는 macOS 휴지통에서 원래 경로로 파일을 복원합니다.
• 실행 취소 시 충돌: 실행 취소 대상 위치에 같은 이름의 파일이 이미 존재하면 충돌 다이얼로그가 나타납니다.
• 볼륨 간 실행 취소: 볼륨 간 이동의 실행 취소는 다시 볼륨 간 전송을 수행합니다 (데이터가 물리적으로 되돌아가야 함).

팁: 실행 취소 시스템은 원본 경로, 대상 경로, 원래 파일명을 포함한 각 작업의 전체 상태를 기록하므로, 복잡한 일괄 작업에서도 신뢰성을 유지합니다.

---

작업 큐

큐 동작

파일 작업(복사, 이동, 삭제)을 시작하면 작업 큐에 추가됩니다:

• 기본적으로 작업은 한 번에 하나씩 (순차적으로) 실행됩니다.
• 활성 작업은 속도와 예상 남은 시간을 포함한 진행률 바를 표시합니다.
• 대기 중인 작업은 현재 작업이 완료될 때까지 기다립니다.
• 작업이 백그라운드에서 실행되는 동안 계속해서 파일을 탐색하고 선택할 수 있습니다.

일시 정지 및 재개

활성 작업 중:

• 진행률 다이얼로그의 Pause를 클릭해 현재 작업을 일시 정지합니다.
• Resume을 클릭해 멈춘 지점부터 이어서 진행합니다.
• Cancel을 클릭해 작업을 완전히 중단합니다.

일시 정지는 진행 상황을 잃지 않습니다 — 멈췄던 지점에서 정확하게 재개됩니다.

진행률 모니터링

진행률 표시에는 다음이 포함됩니다:

정보	설명
현재 파일	현재 처리 중인 파일의 이름
진행률 바	시각적 백분율 완료
처리된 파일	예: "1,203개 중 145개 파일"
처리된 크기	예: "8.1 GB 중 2.3 GB"
속도	현재 전송 속도 (예: "125 MB/s")
예상 시간	남은 시간 추정

충돌 해결

복사 또는 이동 중 대상에 같은 파일이 이미 존재하면 충돌 해결 다이얼로그가 나타납니다:

옵션	설명
Overwrite	기존 파일을 새 파일로 덮어쓰기
Overwrite All	추가 프롬프트 없이 모든 기존 파일을 덮어쓰기
Skip	이 파일을 건너뛰고 나머지 계속 진행
Skip All	충돌하는 모든 파일을 건너뛰기
Rename	새 파일에 번호를 붙여 둘 다 유지
Compare	기존 파일과 새 파일을 나란히 비교 보기

충돌 다이얼로그는 결정에 도움이 되도록 원본과 기존 파일 모두의 세부 정보(크기, 날짜) 를 표시합니다.

---

파일 권한

File > File Permissions 또는 명령 팔레트에서 접근:

• POSIX 파일 권한(소유자, 그룹, 기타) 을 보고 편집합니다.
• 읽기, 쓰기, 실행 플래그를 개별 설정합니다.
• 숫자 권한 값을 봅니다 (예: 0644).
• 디렉터리 내용에 권한을 재귀적으로 적용합니다.

---

정보 가져오기

Cmd+I를 눌러 커서 항목의 정보 가져오기 패널을 엽니다:

• 파일명과 전체 경로
• 파일 크기 (디스크상)
• 생성일, 수정일, 마지막 접근일
• 파일 유형과 UTI (Uniform Type Identifier)
• POSIX 권한
• 소유자와 그룹
• 확장 속성
• macOS 태그

---

클라우드 및 원격 파일 처리

원격 연결(FTP, SFTP, WebDAV, 클라우드 스토리지) 의 파일을 다룰 때:

• 복사/이동 작업은 네트워크로 데이터를 전송합니다. 진행률에는 네트워크 속도가 표시됩니다.
• 삭제 작업은 영구적일 수 있습니다 (원격 파일시스템에는 휴지통 없음). 경고가 표시됩니다.
• 이름 변경 작업은 가능한 경우 서버 측에서 수행됩니다 (즉시 완료).
• 대용량 파일 전송은 청크 전송으로 스트리밍되며, 프로토콜이 허용하는 경우 일시 정지/재개를 지원합니다.

iCloud Drive 및 기타 macOS 통합 클라우드 스토리지의 경우:

• 파일이 클라우드 전용 상태(로컬 미다운로드) 로 존재할 수 있습니다.
• Unifyl은 클라우드 전용 파일에 접근할 때 다운로드 진행률을 표시합니다.
• 다운로드되지 않은 파일 옆에는 클라우드 아이콘 표시기가 나타납니다.

---

selectedOrCursorItems 로직

Unifyl의 모든 파일 작업에서 사용되는 핵심 패턴입니다:

파일 작업이 트리거될 때:
  1. SELECTED (명시적으로 표시된) 항목이 있는지 확인합니다.
  2. 있으면 -> 모든 선택 항목에 대해 작업합니다.
  3. 없으면 -> CURSOR 항목 (단일 강조 행) 에 대해 작업합니다.

이는 다음을 의미합니다:

• 단일 파일의 경우: 커서를 옮기고 작업 키를 누르기만 하면 됩니다. 명시적으로 선택할 필요가 없습니다.
• 여러 파일의 경우: 먼저 선택한 후 (Insert, Space, Shift+Up/Down, 또는 Cmd+A 사용) 작업 키를 누릅니다.
• .. (상위 디렉터리) 엔트리는 커서가 위에 있더라도 작업 대상에서 항상 제외됩니다.

중요: 파일이 선택된 상태에서 다른 단일 파일에 대해 작업하려면, 먼저 모든 선택을 해제하거나 (Cmd+A 두 번) 원하는 파일만 선택하세요.

이 패턴은 다음에 적용됩니다: 복사 (F5), 이동 (F6), 삭제 (F8), 압축 (Shift+F5), 열기 (Cmd+O), 편집 (F4), 정보 가져오기 (Cmd+I), 그리고 파일을 대상으로 하는 모든 다른 작업.