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

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

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

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

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

macOS 14 або новіша: основний широкоформатний інтерфейс і перша платформа приймання.
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.

PCBAtlas не вгадує шар і не примушує плати збігатися автоматичним зміщенням / поворотом. Глобальне зміщення або поворот залишається реальною різницею.

Дочекатися або скасувати¶

Прогрес охоплює перевірку, імпорт Before / After, пари шарів, snapshots, зіставлення геометрії, ризики, точну 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; глобальне зміщення й поворот залишаються видимими.
Пікселі зображення, bbox і текст файлу не є fallback для точного геометричного Diff.

Поширені запитання¶

Чому `Compare` вимкнено?¶

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

Чому однакові розширення дають різні формати?¶

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

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

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

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

Added / Removed і ризики напрямлені. Swap перераховує зі зворотними Before / After, а не лише міняє підписи.

Результат¶

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

Остання перевірка¶

2026-07-30