Версія документа v2026.10.17.0

Порівняння двох ревізій плати (Board Diff)¶

У цьому проході перевірено лише вхід бібліотеки Compare Revisions…. Описаний нижче процес порівняння 2026-09-11 повторно не виконувався. Не сприймайте цю сторінку як повний запис приймання Diff для поточної збірки.

Мета сторінки¶

Допомогти запустити Board Diff із ревізій бібліотеки, зрозуміти напрямок Before / After, перевірити зміни по об'єктах і експортувати JSON або PNG для повторного перегляду.

Підтримувані платформи¶

macOS 14 або новіша: основний широкоформатний досвід і перша платформа приймання Board Diff на сьогодні.
iOS / iPadOS 17.0 або новіша: вхід надається разом із застосунком. Краще альбомна орієнтація або ширше вікно; окрема оптимізація вузького екрана ще в подальшій роботі.

Для кого¶

Проєктувальники, виробничий або рецензійний персонал, яким потрібно порівняти дві ревізії однієї PCB
Тестувальники, яким потрібно приймати Diff за напрямком, шаром, об'єктом і підказками ризику

Передумови¶

Виберіть пару плат, вміст яких відрізняється, але фактично розібрані формати збігаються:

Вхід	Поточний стан
DSN	Підтримується
Окрема плата KiCad `.kicad_pcb`	Підтримується
Тека або архів Gerber + Excellon	Підтримується
SES	Підтримується лише коли обидва боки можна перевірити й вони вказують на той самий базовий проєкт
ODB++, IPC-2581, Altium PCB / бібліотека, повний KiCad Project	Зараз явно не підтримується для Board Diff

Before і After мають напрямок:

Added: існує лише в After.
Removed: існує лише в Before.
Modified: об'єкти з обох боків можна спарити, але атрибути або геометрія відрізняються.
Unchanged: однакове з обох боків, показується лише як контекст.

Однакове розширення файла не гарантує однаковий формат. PCBAtlas розбирає кожен бік окремо, потім вирішує, чи можливе порівняння.

Кроки¶

Порівняння двох ревізій у бібліотеці¶

У бібліотеці знайдіть документ із принаймні двома ревізіями.
Відкрийте меню додаткових дій на картці документа.
Натисніть Compare Revisions….
У Before і After виберіть дві різні ревізії того самого формату.
Натисніть Compare.

Якщо в поточної ревізії є батьківська, сторінка надає перевагу parent як Before і current як After. Будь-який бік усе одно можна змінити вручну.

Завершене розміщене порівняння зберігає перевірений артефакт. Наступного разу, коли ви зайдете на сторінку порівняння того самого документа, можна скористатися Reopen Saved Comparison.

Підтвердження неоднозначного спарювання шарів¶

Якщо PcbCore знаходить кілька сумісних кандидатів, порівняння зупиняється на Layer pairing needs confirmation:

Для кожного шару Before перевірте назву, роль, порядок і кількість об'єктів.
Праворуч виберіть правильний After layer.
Переконайтеся, що для кожного пункту є вибір.
Натисніть Confirm and Compare, щоб запустити знову.

PCBAtlas не вгадує шар, коли спарювання неоднозначне, і не вирівнює дві плати примусово автоматичним translate / rotate. Зсув або обертання всієї плати зберігається як справжня зміна.

Очікування або скасування порівняння¶

Порівняння показує прогрес через перевірку входу, імпорт Before / After, спарювання шарів, знімок, геометричне зіставлення, аналіз ризиків, Diff scene і збереження.

Після натискання Cancel зачекайте, доки завершиться Cancelling comparison…. Сторінка дозволяє безпечну повторну спробу лише після звільнення обох native-сесій і тимчасових 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.
Якщо змінилися вміст ревізії, формат, політика або спарювання шарів, старий артефакт вважається недійсним замість того, щоб мовчки показувати застарілий результат.

Широка та вузька оболонки¶

Обидва компонування входять у порівняння з меню дій документа в бібліотеці. Не використовуйте звичайний Viewer Split замість Board Diff. Звичайний Split проєкту — це подвійне полотно PCB і схеми; Diff Split — це Before і After. Якщо в вузькому вікні панелі налаштувань порівняння або результатів тісні, збільште вікно, щоб їх прочитати. У цьому проході компонування Diff у вузькій оболонці не перевірялося.

Контрольний список приймання¶

Поточні явні обмеження¶

Порівнюються лише входи того самого формату; міжформатне порівняння не підтримується.
ODB++, IPC-2581, Altium PCB / бібліотека, повний KiCad Project, Diff схеми та 3D Diff не підтримуються.
Немає автоматичного злиття, прийняття змін або зворотної зміни вихідних файлів.
Немає автоматичного alignment; зсув і обертання всієї плати залишаються видимими відмінностями.
Пікселі зображення, bbox або текст файла не використовуються як запасний варіант точного геометричного Diff.

Часті запитання¶

Чому кнопка `Compare` недоступна?¶

Перевірте, що обидва боки вибрано, що вміст відрізняється і що вони розбираються як той самий підтримуваний формат. Для Gerber / Excellon віддайте кожному боку повну теку або архів пакета; два довільні одношарові файли не можуть замінити повну плату.

Чому те саме розширення все одно повідомляє про невідповідність формату?¶

Формат визначається фактичними результатами розбору, а не лише іменем файла. Каталоги, архіви, базові проєкти SES і фактичний board entry беруть участь у перевірці.

Чому після скасування не можна одразу порівнювати знову?¶

Сторінка чекає, поки PcbCore звільнить обидві сесії Before / After і тимчасові дані, щоб нове завдання не займало ресурси одночасно зі старим. Повторіть спробу після зникнення Cancelling comparison….

Чому після Swap змінилися також кількість змін або ризики?¶

Added / Removed і підказки ризику мають напрямок. Swap не просто міняє мітки відображення; він перераховує зі зворотними Before / After.

Результат¶

Після порівняння можна в одній робочій області знайти точні зміни з обох боків, перевірити напрямкові ризики та експортувати JSON / PNG. Порівняння ревізій бібліотеки також можна зберегти й повторно відкрити після перевірки.

Дата останньої перевірки¶

2026-07-30 (запис початкового процесу); 2026-09-11 перевірено вхід бібліотеки, порівняння не запускалося повторно.