문서 버전 v2026.08.31.0

PDF 다운로드

두 보드 리비전 비교하기(Board Diff)¶

페이지 목표¶

관리 리비전에서 Board Diff를 시작하고, Before / After 방향을 이해하며, 객체 단위 변경을 검사하고 검토 가능한 JSON 또는 PNG를 내보냅니다.

지원 플랫폼¶

macOS 14 이상: 현재 주요 와이드 화면 Board Diff 경험과 첫 검수 플랫폼입니다.
iOS / iPadOS 17.0 이상: 앱에 진입점이 포함됩니다. 가로 방향 또는 넓은 창을 권장하며 좁은 화면 전용 최적화는 계속 개선됩니다.

대상 사용자¶

같은 PCB의 두 리비전을 비교하는 설계, 제조 및 검토 사용자
방향성 변경, 레이어 쌍, 객체 및 위험 힌트를 검증하는 테스터

사전 조건¶

내용은 다르지만 실제로 같은 형식으로 해석되는 두 보드를 선택합니다.

입력	현재 상태
DSN	지원
단일 KiCad `.kicad_pcb`	지원
Gerber + Excellon 폴더 또는 압축 파일	지원
SES	양쪽에서 검증된 동일한 기본 설계를 식별할 때만 지원
ODB++, IPC-2581, 전체 KiCad Project	Board Diff에서 명시적으로 미지원

Before와 After에는 방향이 있습니다.

Added: After에만 존재.
Removed: Before에만 존재.
Modified: 양쪽 객체가 짝을 이루지만 속성 또는 형상이 다름.
Unchanged: 양쪽이 같고 문맥으로만 표시.

확장자가 같다고 형식이 같은 것은 아닙니다. PCBAtlas는 양쪽을 독립적으로 해석한 뒤 비교 가능 여부를 결정합니다.

작업 단계¶

관리되는 두 리비전 비교¶

두 개 이상의 리비전이 있는 라이브러리 문서를 찾습니다.
문서 카드의 추가 작업 메뉴를 엽니다.
Compare Revisions…를 선택합니다.
Before와 After에서 서로 다른 같은 형식의 리비전을 선택합니다.
Compare를 선택합니다.

현재 리비전에 부모가 있으면 parent가 Before, current가 After로 우선 선택됩니다. 양쪽 모두 변경할 수 있습니다.

완료된 관리 비교는 검증된 artifact로 저장됩니다. 같은 문서의 비교 페이지에서 Reopen Saved Comparison으로 다시 열 수 있습니다.

모호한 레이어 쌍 확인¶

PcbCore가 호환 후보를 여러 개 찾으면 Layer pairing needs confirmation에서 비교가 멈춥니다.

각 Before 레이어의 이름, 역할, 순서, 객체 수를 확인합니다.
올바른 After layer를 선택합니다.
모든 모호한 항목이 선택되었는지 확인합니다.
Confirm and Compare를 선택합니다.

모호한 레이어를 추측하지 않고 자동 평행 이동 / 회전으로 보드를 강제로 맞추지 않습니다. 보드 전체 이동이나 회전은 실제 차이로 남습니다.

비교 대기 또는 취소¶

입력 검증, Before / After 가져오기, 레이어 쌍, 스냅샷, 형상 매칭, 위험 분석, 정확한 Diff scene 및 저장 진행률이 순서대로 표시됩니다.

Cancel을 선택한 뒤 Cancelling comparison…이 끝날 때까지 기다립니다. 두 native session과 임시 staging 데이터가 모두 해제된 뒤 안전하게 다시 시도할 수 있습니다.

비교 작업 공간 읽기¶

표시 모드¶

Overlay: 정확한 변경을 하나의 복합 장면에 겹치며 Context로 변경되지 않은 문맥의 강도를 조절합니다.
Split: 왼쪽 Before, 오른쪽 After; 기본적으로 Sync Camera가 켜지며 끄면 양쪽을 독립적으로 확인할 수 있습니다.
Blink: 같은 카메라로 Before / After를 자동 전환하여 미세 이동을 찾습니다.
Fit: 현재 장면을 보이는 영역에 다시 맞춥니다.

레이어와 변경¶

왼쪽 Layer Pairs에 레이어 쌍과 각 변경 수가 표시됩니다.
All layers로 전체 보드를 보거나 한 쌍을 선택해 범위를 좁힙니다.
오른쪽 Changes에서 Added / Removed / Modified를 켜고 끄며 객체 유형 또는 Net으로 필터링합니다.
변경 행을 선택하면 위치와 강조가 바뀌고 Viewer 객체 선택으로도 해당 변경을 역조회합니다.
Previous / Next는 현재 필터 결과를 순회합니다. macOS 단축키는 ⌘[ 및 ⌘]입니다.
Risks는 방향성 힌트를 심각도별로 필터링합니다. DRC나 제조 승인을 대체하지 않습니다.

방향 교환, 내보내기 및 다시 열기¶

Swap은 반대 방향 요청을 새로 만들어 계산합니다. Added / Removed, 통계, 위험, 상세 정보의 방향이 바뀝니다.
JSON은 안정적이고 버전이 지정된 의미 결과를 내보내며 iOS에서는 파일을 다른 앱에 전달합니다.
PNG는 현재 Diff 보기를 내보내며 iOS에서는 Photos에 직접 저장하고 macOS에서는 시스템 파일 전달 인터페이스를 계속 사용합니다.
관리 리비전 비교는 Reopen Saved Comparison으로 다시 열 수 있습니다.
리비전 내용, 형식, 정책 또는 레이어 쌍이 바뀌면 오래된 artifact는 무효화되며 조용히 표시되지 않습니다.

검수 체크리스트¶

현재 명확한 경계¶

같은 형식의 입력만 비교하며 형식 간 비교는 지원하지 않습니다.
ODB++, IPC-2581, 전체 KiCad Project, 회로도 Diff 및 3D Diff는 지원하지 않습니다.
자동 병합, 변경 수락 또는 소스 파일 역수정을 하지 않습니다.
자동 alignment가 없으므로 보드 전체 평행 이동과 회전도 보이는 차이입니다.
정확한 형상 Diff의 대체 수단으로 이미지 픽셀, bbox 또는 파일 텍스트를 사용하지 않습니다.

자주 묻는 질문¶

`Compare`가 비활성화된 이유는 무엇입니까?¶

양쪽이 선택되고 내용이 다르며 같은 지원 형식으로 해석되는지 확인합니다. Gerber / Excellon은 임의의 단일 레이어 파일 두 개가 아니라 양쪽에 완전한 package 폴더 또는 압축 파일을 제공합니다.

확장자가 같은데 형식 불일치가 발생하는 이유는 무엇입니까?¶

형식은 파일명뿐 아니라 실제 해석 결과로 결정됩니다. 디렉터리, 압축 파일, SES 기본 설계 및 해석된 board entry도 검증에 포함됩니다.

취소 직후 다시 시도할 수 없는 이유는 무엇입니까?¶

새 작업과 이전 작업의 리소스가 겹치지 않도록 PcbCore가 Before / After 두 세션과 임시 데이터를 해제할 때까지 기다립니다. Cancelling comparison…이 사라진 뒤 다시 시도합니다.

Swap 후 변경 수나 위험도 바뀌는 이유는 무엇입니까?¶

Added / Removed와 위험 힌트에는 방향이 있습니다. Swap은 레이블만 바꾸지 않고 반대 Before / After로 다시 계산합니다.

결과¶

한 작업 공간에서 양쪽의 정확한 변경을 찾고 방향성 위험을 검토하며 JSON / PNG를 내보낼 수 있습니다. 관리 비교는 검증된 상태로 저장하고 다시 열 수 있습니다.

최근 검증일¶

2026-07-30