File Inspection ko

파일 검사

Unifyl은 파일 구조 점검, 무결성 검증, 상세 메타데이터 조회를 위한 강력한 파일 검사 도구를 제공합니다. 이 도구들은 Finder의 "정보 가져오기"가 제공하는 수준을 넘어, 파일 내부를 깊이 들여다볼 수 있도록 합니다.

---

목차

1. File X-Ray
   • File X-Ray 열기
   • Structure 탭
   • Hex Dump 탭
   • 매직 디스크립션
   • 메타데이터 트리
2. 체크섬 검증
   • 체크섬 뷰 열기
   • 지원 알고리즘
   • 체크섬 계산
   • 알려진 해시와 대조 검증
   • 여러 파일
3. 파일 정보 (Get Info)
4. 기능 등급
5. 스크린샷
6. 문제 해결

---

File X-Ray

File X-Ray는 Unifyl의 심층 파일 검사 도구입니다. 파일의 내부 구조를 분석하여 탐색 가능한 메타데이터 트리로 보여주며, 일반적으로 숨겨져 있는 세부 정보 — 이미지의 EXIF 데이터, 미디어 파일의 코덱 정보, TIFF 태그, 컬러 프로파일 등 — 를 드러냅니다.

File X-Ray 열기

1. 메뉴: Tools > File X-Ray
2. 명령 팔레트: Cmd+Shift+P를 누른 뒤 "File X-Ray" 입력
3. 컨텍스트 메뉴: 파일을 우클릭 > "File X-Ray"

X-Ray 뷰는 헤더에 파일명이 표시된 독립 플로팅 패널로 열립니다: "File X-Ray: example.jpg"

Structure 탭

기본 탭에는 파일에서 추출된 메타데이터의 계층적 트리가 표시됩니다. 트리의 각 노드는 다음을 표시합니다:

요소	설명
아이콘	노드 유형을 나타내는 시스템 심볼 아이콘, 카테고리별 색상 적용
레이블	메타데이터 키 이름 (고정폭 글꼴, 예: "PixelWidth", "ColorModel")
값	메타데이터 값 (고정폭 캡션 글꼴, 우측 정렬, 보조 색상)

트리는 중첩된 메타데이터 그룹의 펼치기/접기를 지원합니다. 일반적인 최상위 그룹은 다음과 같습니다:

이미지 파일

• Image Info: 픽셀 크기, DPI, 색 공간, 비트 깊이, 알파 채널
• EXIF: 카메라 모델, 노출 시간, 조리개, ISO, 초점 거리, 촬영 일시, GPS
• TIFF: 방향, 압축, 소프트웨어, 제조사/모델
• JFIF: 버전, 밀도 단위, 썸네일 크기
• ICC Profile: 컬러 프로파일 이름, 색 공간, 렌더링 인텐트

미디어 파일

• Video Track: 코덱, 프레임 속도, 해상도, 비트레이트, 길이
• Audio Track: 코덱, 샘플레이트, 채널, 비트 깊이, 비트레이트
• Container: 포맷명, 길이, 생성일

PDF 파일

• Document Info: 제목, 저자, 작성자, 생성기, 생성/수정일
• Page Info: 페이지 수, 페이지 크기, 미디어 박스

아카이브 파일

• Archive: 엔트리 수, 압축 방식, 전체 비압축 크기

Hex Dump 탭

"Hex Dump" 탭으로 전환하면 파일 첫 바이트의 원시 헥스 덤프를 볼 수 있습니다. 전체 Hex Editor를 열지 않고도 파일 헤더를 빠르게 살펴볼 수 있습니다. 헥스 덤프는 Hex Editor와 동일한 3열 형식(오프셋, 헥스 바이트, ASCII)을 사용합니다.

매직 디스크립션

X-Ray 헤더의 우측 상단에는 캡슐 모양 배지가 파일의 매직 디스크립션을 표시합니다 — 확장자가 아닌 콘텐츠 기반의 사람이 읽을 수 있는 파일 유형 식별입니다. 예시:

• "JPEG image data, JFIF standard"
• "PDF document, version 1.7"
• "Mach-O 64-bit executable arm64"
• "Zip archive data"

메타데이터 트리

메타데이터 트리는 Apple 프레임워크 API를 사용해 파일을 분석하여 채워집니다:

• 이미지: CGImageSource와 CGImageSourceCopyPropertiesAtIndex로 모든 EXIF, TIFF, IPTC, GPS, ICC 프로파일 데이터 추출
• PDF: PDFDocument API로 문서 속성과 페이지 정보 추출
• 미디어 파일: AVAsset이 트랙 정보, 코덱 세부 정보, 컨테이너 메타데이터 제공
• 아카이브: Unifyl의 ArchiveEngine이 아카이브 헤더를 읽어 엔트리 수와 압축 정보 추출
• 모든 파일: 기본 URLResourceValues가 파일시스템 메타데이터(크기, 날짜, 권한, 타입 식별자) 제공

각 메타데이터 딕셔너리는 재귀적으로 XRayNode 객체로 변환되어 트리 구조를 형성합니다. 노드의 구성 요소는 다음과 같습니다:

• 레이블 (키 이름)
• 선택적 값 (포맷된 메타데이터 값)
• 선택적 자식 노드 (중첩 딕셔너리용)
• 메타데이터 카테고리에 따른 아이콘 및 아이콘 색상

---

체크섬 검증

체크섬 검증 도구는 하나 이상의 파일에 대해 암호학적 해시 값을 계산하며, 선택적으로 알려진 해시와 대조하여 검증할 수 있습니다.

체크섬 뷰 열기

1. 파일 목록에서 하나 이상의 파일 선택
2. 메뉴: Tools > Checksum
3. 컨텍스트 메뉴: 선택한 파일을 우클릭 > "Checksum"
4. 명령 팔레트: Cmd+Shift+P를 누른 뒤 "Checksum" 입력

체크섬 뷰는 플로팅 패널(최소 600x360 픽셀)로 열립니다.

지원 알고리즘

Unifyl은 (UnifylCore 패키지의) ChecksumEngine을 통해 7가지 체크섬 알고리즘을 지원합니다:

알고리즘	출력 길이	속도	사용처
CRC32	8자 헥스	가장 빠름	빠른 오류 검출, 암호학적 용도 아님
MD5	32자 헥스	빠름	레거시 호환 (보안 용도 비권장)
SHA-1	40자 헥스	빠름	레거시 호환 (보안 용도로는 폐기됨)
SHA-256	64자 헥스	보통	범용 무결성 검증 (기본값)
SHA-512	128자 헥스	보통	더 높은 보안 여유
SHA3-256	64자 헥스	보통	모던 표준, 양자 내성 설계
Blake3	64자 헥스	가장 빠름	모던, 병렬화 가능, 우수한 성능

알고리즘은 세그먼트 피커로 선택합니다. SHA-256이 기본값입니다.

체크섬 계산

1. 세그먼트 피커에서 원하는 알고리즘을 선택합니다
2. Compute 버튼(돋보이는 테두리 스타일)을 클릭합니다
3. 계산 중에는 진행률 바가 백분율과 함께 표시됩니다
4. 결과는 파일별로 아래에 나타납니다:
   • 중간 굵기 부제목 글꼴의 파일명
   • 고정폭 글꼴의 해시 값
   • 해시를 클립보드에 복사하는 Copy 버튼

계산은 비동기로 실행되어 UI를 차단하지 않습니다. 작업 중에는 도구 모음에 "Computing..." 텍스트와 진행률 표시기가 나타납니다.

알려진 해시와 대조 검증

단일 파일만 선택된 경우, 결과 아래에 추가 "Verify" 섹션이 나타납니다:

1. 검증 텍스트 필드에 기대되는 해시 값을 붙여넣거나 입력합니다
2. 도구가 계산된 해시와 제공된 값을 (대소문자 구분 없이) 비교합니다
3. 결과:
   • 일치: 녹색 체크마크 표시
   • 불일치: 빨간색 X 표시

이 기능은 소프트웨어 배포자가 게시한 체크섬을 사용해 다운로드한 파일을 검증할 때 유용합니다.

여러 파일

여러 파일이 선택된 경우:

• 각 파일의 해시가 개별적으로 계산되어 표시됩니다
• 파일들은 파일명과 각자의 해시 값으로 나열됩니다
• 검증 섹션은 숨겨집니다 (단일 파일에서만 동작)
• 진행률은 전체 파일에 대한 누적 완료 상태를 반영합니다

---

파일 정보 (Get Info)

Unifyl은 macOS 네이티브 정보 가져오기 패널에 접근할 수 있도록 합니다:

• 단축키: Cmd+I
• 메뉴: File > Get Info

선택한 파일에 대해 표준 Finder "정보 가져오기" 창이 열리며, 다음을 표시합니다:

• 일반 정보 (종류, 크기, 위치, 생성/수정일)
• 추가 정보 (미디어 파일의 경우: 크기, 코덱 등)
• 이름 및 확장자
• 코멘트
• 다음으로 열기 (기본 응용 프로그램)
• 미리보기
• 공유 및 권한

이는 Finder에서 파일을 우클릭하고 "정보 가져오기"를 선택하는 것과 동일합니다. Unifyl은 macOS 동작과의 일관성을 유지하기 위해 이 기능을 시스템에 위임합니다.

---

기능 등급

도구	등급
File X-Ray	Pro
체크섬 검증	Free
파일 정보 (Cmd+I)	Free

---

스크린샷

File X-Ray

JPEG 이미지의 계층적 메타데이터 트리를 보여주는 File X-Ray 뷰입니다. 트리가 펼쳐져 Image Info (PixelWidth: 4032, PixelHeight: 3024), EXIF 데이터 (ExposureTime: 1/120, FNumber: 1.8, ISOSpeedRatings: 50), TIFF 메타데이터를 표시합니다. 헤더의 캡슐 배지에는 매직 디스크립션 "JPEG image data"가 나타납니다. 상단의 세그먼트 컨트롤은 Structure와 Hex Dump 탭을 전환합니다.

체크섬 검증

알고리즘 세그먼트 피커가 SHA-256으로 설정된 체크섬 검증 뷰로, 선택된 파일의 계산된 해시가 고정폭 글꼴로 표시되어 있습니다. 결과 아래의 검증 섹션에는 해시가 붙여넣어진 텍스트 필드와 일치를 나타내는 녹색 체크마크가 보입니다.

---

문제 해결

File X-Ray가 "No structure data available"을 표시할 때

• 해당 파일 형식이 구조적 분석을 지원하지 않을 수 있습니다
• 최소한 원시 바이트라도 확인하기 위해 Hex Dump 탭을 시도해 보세요
• 파일이 읽을 수 있는 상태인지 확인하세요 (권한 점검)

체크섬 계산이 느릴 때

• 큰 파일은 해싱에 더 오래 걸립니다. Blake3가 가장 빠르므로 대용량 파일에는 Blake3로 전환해 보세요
• 계산은 메인 스레드 외부에서 실행되므로 UI는 계속 반응합니다
• SSD vs HDD: 디스크 I/O 속도가 대용량 파일의 주요 병목입니다

검증이 불일치를 보여주지만 파일은 올바를 때

• 참조 해시 생성에 사용된 것과 동일한 알고리즘을 선택했는지 확인하세요
• 붙여넣은 해시 값 끝에 공백이 없는지 확인하세요
• 일부 배포자는 대문자 해시를 사용합니다. Unifyl은 대소문자 구분 없이 비교하지만, 해시 길이가 알고리즘과 맞는지 다시 확인하세요

File X-Ray의 매직 디스크립션이 표시되지 않을 때

• 매직 디스크립션은 파일에 인식 가능한 헤더 바이트가 있어야 표시됩니다
• 빈 파일이나 인식할 수 없는 헤더의 파일은 설명이 표시되지 않습니다
• 이름이 변경된 파일(예: JPEG가 .txt로 변경된 경우)도 헤더 바이트로 올바르게 식별됩니다