Начнём с первого инвентаря

BrickDesk — настольное приложение для локального ведения LEGO-инвентаря, коллекции,

продаж из инвентаря, списков покупок, партий россыпи и собственных MOC-проектов. Основные данные

хранятся на компьютере и не требуют учётной записи BrickLink.

1. Установка

Windows

• Запустите установщик, скачанный с главной страницы.
• Выберите папку установки и дождитесь копирования файлов.
• Разрешите помощнику загрузить каталог и библиотеку изображений. Для полной установки

понадобится стабильное подключение к интернету и около 6 ГБ свободного места.

• Запустите BrickDesk из меню «Пуск».

Если загрузка каталога или изображений была прервана, приложение останется установленным.

Повторите загрузку через пункт «Загрузить библиотеку изображений BrickDesk» в меню «Пуск».

macOS

• Откройте DMG-сборку BrickDesk для архитектуры вашего Mac (если она предоставлена отдельно).
• Перетащите BrickDesk.app в папку Applications.
• Один раз запустите Install BrickDesk Data.command, чтобы загрузить каталог и изображения.
• Откройте BrickDesk из папки «Программы».

Неподписанная или только ad-hoc-подписанная сборка может вызвать предупреждение Gatekeeper.

Для публичного распространения рекомендуется подписанный и нотарифицированный установщик.

2. Главное окно

Разделы переключаются кнопками в левой панели:

• Каталог — поиск деталей, наборов, минифигурок и аксессуаров;
• Инвентарь — рабочие таблицы с количеством, ценами и местами хранения;
• Коллекция — карточки наборов, минифигурок и аксессуаров;
• Покупки — списки недостающих деталей;
• Сортировка — учёт и анализ партий россыпи;
• MOC — личные проекты, инструкции, списки деталей, версии и резервы.

Подведите указатель к кнопке или полю, чтобы увидеть подсказку. Кнопка со знаком ? в левой

панели и клавиша F1 показывают краткую справку именно по открытому разделу. Полное

руководство открывается через Справка → Руководство пользователя, а Ctrl+F1 показывает

список основных горячих клавиш.

Верхнее меню содержит общие команды и действия текущего раздела:

• Файл — создать или открыть инвентарь, сохранить полную копию BrickDesk,

восстановить данные или экспортировать лоты в продаже в XML/BSX.

«Текущий инвентарь → Сохранить инвентарь» сохраняет данные в локальном хранилище.

• Инвентарь — добавление, изменение и проверка строк; меню видно только в инвентаре.

Команды для выбранных строк доступны только после выделения.

• Правка — поиск в текущем разделе (Ctrl+F) и сброс всех фильтров инвентаря.

Сброс очищает поиск, тип, цвет, состояние, категорию и излишки, сохраняя сортировку.

Esc также закрывает карточку или возвращает назад в каталоге.

• Настройки → Настройки BrickDesk… — все общие настройки в одном окне.

Закрыть или удалить инвентарь можно через меню по правой кнопке на его вкладке.

Удаление требует подтверждения; это не команда удаления выделенных деталей.

Колонки инвентаря настраиваются правым кликом по шапке таблицы: отметьте нужные

поля или снимите отметку с лишних. Выбор сохраняется. Размер миниатюр по умолчанию — 64 px.

Его можно изменить только в Настройки → Настройки BrickDesk… → Размер миниатюр.

Общий размер применяется к инвентарю, составу коллекции и сверке и сохраняется между запусками.

3. Каталог

• Выберите нужный тип объектов: наборы, минифигурки, мерч или детали; либо оставьте поиск

по всему каталогу. Детали не участвуют в случайной подборке «Мне повезёт».

• Введите артикул либо часть названия.
• Переключайте представление «Компактно»/«Карточки» и выбирайте сортировку.
• Откройте объект, чтобы увидеть цвета, изображения, состав и доступные инструкции.

Для детали вкладка «Наборы» показывает обложки и конкретные наборы отдельно для каждого

доступного цвета.

• Из карточки объекта используйте доступные команды добавления в коллекцию или список покупок.

Каталог и изображения работают локально после первоначальной загрузки. Открытие внешних

страниц, PDF-инструкций и поиск по фотографии требуют подключения к интернету.

Карточки категорий используют устойчиво выбранную иллюстрацию детали из этой категории или

её ближайшей дочерней категории. Поэтому изображение не меняется при повторном открытии и не

подменяется картинкой из соседней категории.

4. Инвентарь

В одной таблице показаны проверенные наборы/минифигурки и сводные строки деталей.

Детали объединяются по артикулу, цвету и состоянию. «Всего» — сумма отдельного

остатка и фактически найденного количества в активных проверенных предметах;

«Отдельно» и «В составе» показывают эти части суммы. «В продаже» входит в отдельный

остаток, а не прибавляется к нему. Недостающие детали не включаются в количество.

Нажмите название сводной строки, чтобы увидеть источники: отдельные позиции

инвентаря и наборы/минифигурки, в которых находятся детали. Сводка не редактируется

и не создаёт дополнительный запас. Для изменения количества раскройте источник

или выберите «Изменить отдельный остаток» правой кнопкой. Продажа доступна только

для отдельного остатка, в том числе прямо из сводной строки; детали внутри

набора сначала нужно освободить разбором.

Непроверенные, разобранные и проданные предметы в составе сводки не учитываются.

Создание и открытие

• Ctrl+N — создать новый инвентарь;
• Ctrl+O — открыть .bsx или BrickLink XML;
• Файл → Импортировать в текущий инвентарь — добавить строки в открытую вкладку;
• Ctrl+S — сохранить текущий инвентарь в локальную базу.

При импорте выберите валюту исходного файла. Для RUB пересчёт не выполняется; для других

валют BrickDesk получает текущий курс ЦБ РФ и переводит цены в рубли.

Перед добавлением строк BrickDesk показывает предварительный просмотр. В нём видно, какие

позиции будут добавлены как новые, какие объединятся с существующими и где различаются

цена, себестоимость, примечание или место хранения. Снимите отметку с ненужной строки,

чтобы исключить её из импорта.

Работа со строками

• нажмите Insert или кнопку +, чтобы открыть окно «Добавить в инвентарь»;
• редактируйте значения непосредственно в таблице;
• Ctrl+D дублирует выбранные строки;
• Ctrl+M переносит выбранные строки в другой открытый инвентарь;
• Delete удаляет выбранные строки;
• Ctrl+K помогает подобрать деталь из каталога для выбранной строки;
• Ctrl+Shift+P выделяет отдельные детали на фотографии и распознаёт их через Brickognize;
• Ctrl+Shift+E массово меняет отмеченные поля у всех выбранных строк;
• Инвентарь → Найти и объединить дубликаты показывает группы с одинаковыми артикулом,

цветом и состоянием, прежде чем суммировать их количество;

• F5 выполняет проверку артикулов, цветов и обязательных полей.

В окне добавления доступны каталог (по артикулу или названию), фото и камера.

Во временном инвентаре рядом расположены «Ваше фото» и «Эталон»: сравните

выделенный фрагмент с миниатюрой выбранной детали. Изображение каталога обновляется

при смене варианта распознавания, цвета и после ручной правки. Если в локальной

библиотеке картинки нет, показывается «Нет изображения».

При съёмке клавиша Z делает следующий снимок; распознанные детали накапливаются

во временном списке. Проверьте цвет и количество, затем нажмите

«Далее…». Закрытие окна без подтверждения

не создаёт пустых строк и не меняет остатки.

На следующем экране задайте количество, новое/б/у, комментарий о состоянии и,

при необходимости, место хранения. Чтобы продать только часть, включите

«Выставить часть на продажу», укажите её количество и цену за единицу.

Пустой комментарий допустим.

«Разделить по состоянию» открывает группы одной детали: например, отдельно

хорошие, с царапинами и с трещинами. У каждой группы свои количество,

комментарий, хранение и количество в продаже. Общая сумма должна совпадать

с исходным количеством — иначе подтверждение недоступно. «Быстрое описание…»

вставляет заготовку в выбранную группу; свои варианты можно добавить, изменить

или удалить в Настройки → Описания состояния (по одному в строке).

Уже добавленный физический лот можно изменить или разделить через контекстное

меню таблицы: Редактировать лот… / Разделить лот…. Если видна суммарная строка,

сначала раскройте её до исходных лотов. Лоты с резервом сначала нужно освободить.

Сохранение всех групп выполняется одной операцией; доступна отмена, пока эти

лоты не были изменены снова. При добавлении автоматически объединяются только

лоты с совпадающими состоянием, комментарием, хранением, ценами и остальными

значимыми полями. Различия не теряются при объединении.

Выбранное фото автоматически разделяется и распознаётся. Для цветной поверхности

с тенями используется выделение по оттенку, менее чувствительное к освещению.

Если фон сложный или границы определены неверно, нажмите «Выделить области…»:

обведите детали на исходном снимке, удалите лишние рамки правым кликом и выберите

«Распознать выделенное». Перефотографировать детали не требуется. В сервис

распознавания отправляются только выбранные фрагменты, не весь исходный снимок.

Управление инвентарём, поиск, выбор типа и состояния расположены в одной строке.

Кнопка Изменить выбранные… меняет несколько выделенных строк одной операцией.

Переключатель Сведения расположен справа над областью просмотра и доступен,

даже когда она скрыта. Нажатие заголовка столбца

меняет сортировку и её направление, в том числе для столбца Излишек.

Кнопка «Представление» и отдельные фильтры цвета, категории и излишка удалены.

После массового изменения или объединения дубликатов операцию можно вернуть командой

Отменить. При объединении количество суммируется; разные описания состояния,

места хранения и цены не объединяются в один физический лот.

Количество в коллекции и излишек

Столбец «В коллекции» показывает количество, закреплённое за проверенными предметами

коллекции. «Излишек» — оставшееся свободное количество. Если одинаковая деталь разбита на

несколько строк, резерв распределяется между ними по порядку строк.

Чтобы выставить свободные позиции на продажу, выделите отдельные остатки и используйте

«Продажа → Выставить на продажу». Меняется отметка продажи в существующей позиции;

копия в отдельном магазине не создаётся.

Экспорт

«Файл → Экспорт лотов в продаже» создаёт BrickLink XML или BSX только

для выставленного остатка. Для сохранения всех данных используйте собственный формат

«Файл → Полная копия BrickDesk → Сохранить полную копию…» (.brickdesk-backup).

5. Продажа из инвентаря

Выгрузка: «Файл → Экспорт лотов в продаже → BSX… / BrickLink XML…»

или кнопка «Экспорт лотов в продаже» в разделе «Продажи».

Она включает весь выставленный остаток текущего инвентаря независимо от поиска,

фильтров и выделения: количество в продаже, цену продажи и комментарий

в поле Comments файла BSX. Коллекция, составные предметы и их вложенный состав

в эту выгрузку не включаются. Невыставленные позиции и лоты другого инвентаря

также не включаются. Внутренние заметки в выгрузку продажи не попадают.

Пустой комментарий допустим. Общего экспорта всего инвентаря в BSX/XML больше нет.

Выгрузка не меняет остатки и не отмечает позиции проданными.

Откройте раздел «Продажи» и выберите инвентарь над таблицей. Здесь видны его

выставленные лоты и целые предметы. Двойной щелчок по строке или кнопка

«Редактировать…» открывает количество, цену и комментарий о состоянии предмета. У целого

предмета количество равно одному. Для массового изменения цены выбирайте

отдельно лоты деталей или целые предметы. Колонки настраиваются правым щелчком

по шапке; ширина и порядок сохраняются. Комплектность показана отдельной колонкой,

недостача выделена красным.

Колонка «Комментарий» есть и в инвентаре. Она описывает состояние конкретного

лота или предмета: царапины, пожелтение, повреждения и другие особенности.

Заполнять её можно до выставления на продажу. Для деталей раскройте сводную

строку и измените комментарий исходного лота; разные комментарии не объединяются.

У набора или минифигурки комментарий редактируется прямо в строке целого предмета.

Этот же текст виден в продажах и выгружается в BSX Comments.

Внутреннее примечание лота или комментарий коллекции хранится отдельно.

Старые примечания остаются внутренними заметками и сохраняются в полной копии

BrickDesk. В торговую выгрузку они не попадают; комментарий состояния передаётся

в BSX Comments и BrickLink XML DESCRIPTION.

В таблице инвентаря есть количество «В продаже»,

«Цена продажи» за единицу и «Сумма продажи». Количество и цену можно изменить

двойным щелчком по ячейке. Сортировка — по заголовку, настройка колонок — правым

щелчком по шапке таблицы.

У минифигурки в коллекции те же действия, что у набора: выставить целиком

или разобрать в инвентарь. При разборе переходят только фактически найденные

детали; пока предмет выставлен, разбор заблокирован до снятия с продажи.

Старые сохранённые проверки учитываются: при продаже/разборе их состав

переносится в новую модель без обнуления количеств. Дата сохраняется, если

известна; перенос отмечается в истории. Новый непроверенный предмет сначала

нужно сверить. Данные, уже синхронизированные старым способом с россыпью,

автоматически повторно не переносятся.

Выделите строки и откройте меню «Продажа» в меню инвентаря или по правому клику:

«Выставить на продажу», «Снять с продажи», «Изменить цены продажи» или «Продано».

Отметка количества и цены продажи также видна рядом с названием предмета.

При выставлении открывается окно цены и необязательного комментария. Комментарий

сохраняется в примечании отдельной позиции или комментарии составного предмета;

существующий текст подставляется в поле, его можно оставить или очистить.

При массовом выставлении комментарии сохраняются, если не выбрана их замена.

Можно выбрать сводную строку: команды продажи используют только её отдельные

физические источники, не детали внутри наборов. Если сводка и раскрытый источник

выделены одновременно, источник учитывается один раз. Снятие с продажи,

изменение цены и «Продано» затрагивают только выставленные источники сводки.

Для одной строки можно выбрать количество; для нескольких выставляется весь

свободный остаток. Цену можно назначить одинаковую или изменить на процент.

Выставление не создаёт копий и не уменьшает физическое количество. Выставленные

единицы исключаются из свободного остатка для покупок, MOC и восстановления

коллекции. Сохранение пакетное: при ошибке изменения отменяются.

Для продажи выберите выставленные строки и команду «Продано…». Для одной строки

можно указать проданное количество, для нескольких — списывается весь выставленный

остаток. Перед массовыми операциями показывается таблица всех выбранных позиций

с названиями, количеством, ценой и общей суммой. Позиции без доступного остатка

не пропускаются молча: операция отменяется с пояснением.

Полностью проданная строка исчезает из активного инвентаря.

В меню «Продажа» откройте «История продаж и возвраты…». Итог учитывает возвраты;

для пустой истории показано пояснение. Она сохраняет дату,

артикул, цвет, количество, цену и сумму. Выберите продажу и «Вернуть в инвентарь…»

для полного или частичного возврата. Возвращённые единицы не выставляются повторно.

Если исходная строка изменена или удалена, они поступают отдельной строкой.

Продажа и возврат сохраняют остаток и историю одной транзакцией. Старые отмены

операций инвентаря блокируются после продажи/возврата, чтобы не восстановить прежний

остаток в обход истории. Если остаток ещё не сохранён, сначала сохраните инвентарь локально.

Эти команды доступны в desktop-интерфейсе. Проверенный набор или минифигурку можно

выставить целиком: выделите верхнюю строку объекта и выберите «Выставить на продажу»

в контекстном меню. Цена задаётся за весь экземпляр; «В продаже» показывает 1.

Комплектность может быть неполной: продаётся фактически подтверждённый состав.

Выставить предмет также можно через меню «Продажа» в карточке коллекции

или одноимённой командой по правому клику на карточке. Укажите цену за экземпляр;

повторное выполнение обновляет цену той же записи в инвентаре. Сначала необходимо

подтвердить состав предмета.

На обложке карточки видны статус продажи и цена. Пока предмет выставлен,

сверка и разбор недоступны: сначала снимите его с продажи. После продажи доступен

возврат через историю; история карточки показывает только продажи этого экземпляра.

Несколько составных объектов можно обработать вместе, выделяя их отдельно от россыпи.

После команды «Продано…» объект исчезает из активного инвентаря и получает статус

«Продан» в коллекции. Его состав сохраняется. Возврат из истории восстанавливает тот

же экземпляр с прежним результатом сверки, без появления свободных деталей и без

повторного выставления. Пока объект выставлен или продан, разборка, повторная сверка

и удаление блокируются; сначала снимите его с продажи либо оформите возврат.

Вложенные детали не продаются отдельно этими командами.

Старый shop.json сохранён, но приложение больше не загружает его и не переносит

позиции автоматически.

6. Коллекция

Добавление предметов

• кнопка + открывает поиск по каталогу;
• «Поиск по фото» распознаёт предмет через внешний сервис и требует интернет;
• «Импорт инвентаря» добавляет поддерживаемые наборы, минифигурки и аксессуары из BSX/XML.

Используйте поиск и фильтры по типу, серии, комплектности, коробке и инструкции. Карточки

можно выделять по одной или группой для создания списков недостающих деталей.

Карточка предмета

Дважды щёлкните карточку. В открывшемся окне можно:

• отметить наличие коробки и инструкции, сборку; проверку подтвердить кнопкой завершения сверки;
• оставить комментарий;
• менять найденное количество кнопками + и −;
• показывать только недостающие детали;
• начать или продолжить пошаговую сверку: полностью найденные строки скрываются

автоматически, а кнопка «Показать полные строки» временно возвращает их в таблицу;

• создать список недостающего.

Кнопка «Зарезервировать из инвентаря» закрепляет доступные свободные детали за предметом.

Такие детали перестают считаться доступными для других наборов, MOC и списков. Для нескольких

отмеченных карточек доступно групповое резервирование. «История изменений» хранит проверки,

изменения комплектности, резервы и операции продажи.

Горизонтальный разделитель между панелью управления и таблицей состава можно перетаскивать.

Само окно свободно растягивается и разворачивается. Для минифигурок стрелка рядом с названием

показывает вложенный состав.

Важно: в расчёте занятых деталей инвентаря участвуют предметы с отметкой «Проверено».

Набор или минифигурку можно удалить правым кликом по карточке → «Удалить из коллекции».

Для проверенного объекта удаляется также строка составного объекта в активном инвентаре;

его детали не превращаются в россыпь. Если объект уже разобран, перенесённые в инвентарь

детали остаются. История проверок и операций сохраняется. Команда отмены возвращает

карточку и прежнее состояние объекта без изменения свободных деталей.

7. Списки покупок

• «Создать список» создаёт ручной список; добавление позиции доступно в контекстном меню

его заголовка после открытия;

• «Импортировать XML» находится на главном экране и загружает Wanted List BrickLink

в раздел «Прочее»;

• один клик выбирает карточку списка, двойной клик открывает её;
• правый клик по карточке → «Удалить список» удаляет список и его управляемую XML-копию.

Исходный файл импорта остаётся на месте; отмена удаления восстанавливает список и XML;

• несколько списков, выделенных с Ctrl, можно объединить кнопкой «Объединить списки»;
• «Папка, теги и архив» доступна отдельной кнопкой после выбора списка;
• фильтр состояния показывает все, недостающие, полностью отсутствующие или частично

найденные позиции;

• найденное количество можно редактировать в таблице;
• «Экспортировать недостающее» создаёт XML только для ещё не найденного количества.
• папки, теги и архив помогают разделить списки по проектам и убрать завершённые списки с

основного экрана;

• после выбора списка кнопка «Режим покупки» открывает учёт заказа: статус, заказанное и

полученное количество, фактическую цену и магазин. Полученные позиции можно сразу перенести

в текущий инвентарь.

Кнопка «Создать список недостающих» в карточке объекта коллекции создаёт один список

в разделе «Восстановление». Та же кнопка на главном экране коллекции создаёт отдельный

список для каждого некомплектного объекта, независимо от выделения и фильтров.

Повторное создание обновляет существующий список. XML-копии новых списков хранятся

в папке wanted_xml рядом с wanted_lists.json и обновляются при сохранении изменений.

8. Сортировка россыпи

• Создайте партию кнопкой + и задайте понятное название.
• Добавляйте распознанные или введённые вручную позиции, цвет и количество. В окне

распознавания можно сразу выбрать несколько фотографий и обработать их как очередь.

• Используйте +1, +5, +10, −1 и команду задания точного количества.
• «Обновить» выполняет быстрый пересчёт; «Полный анализ» запускает подробное сопоставление.
• Проверьте предложенные совпадения и подтвердите правильные.
• После завершения партии откройте мастер финализации и выберите, куда передать результат.

Индикатор над рабочей областью показывает текущий этап. Завершённый проект можно переместить

в архив, не удаляя историю подтверждений. В настройках проекта доступно автоматическое

подтверждение только для совпадений, прошедших заданный порог уверенности.

Распознавание по фотографии использует внешний сервис и требует интернета. Уже сохранённая

партия и локальный каталог доступны без сети.

9. MOC

Создание и импорт

• Откройте раздел MOC и нажмите Добавить MOC.
• Укажите название, описание, автора, источник и внешнюю ссылку. Обложка хранится локально

и показывается без искажения пропорций.

• Добавьте инструкцию, цифровую модель или список деталей. Поддерживаются Rebrickable CSV,

LEGO Pick-A-Brick CSV, BrickLink XML, BSX, LDCad PBG и HTML-таблицы/сетки.

• Проверьте найденные соответствия. Для одной исходной позиции можно массово выбрать

артикул BrickDesk и цвет, а затем при необходимости поправить отдельные строки.

Комплектность и резервы

Вкладка деталей показывает нужное, свободное и недостающее количество. Команда

Зарезервировать доступные детали закрепляет свободный остаток инвентаря за текущим MOC;

Снять резерв возвращает его в общий доступ. Из недостающих позиций можно создать список

покупок. Резервы MOC учитываются вместе с резервами коллекции и не расходуются повторно.

Версии и Studio

Перед значимыми изменениями создайте снимок версии. В истории можно сравнить выбранный

снимок с текущим проектом и восстановить прежний состав. Для .io/Studio-файла доступен

лёгкий интерактивный просмотр размещения деталей; он помогает осмотреть модель, но не

заменяет полноценный редактор Studio.

Несколько деталей на одной фотографии

В инвентаре откройте Инвентарь → Добавить в инвентарь… (Ctrl+Shift+P или Insert).

Выберите фото или нажмите Снять камерой….

В окне камеры выберите устройство и нажмите Z (в русской раскладке Я).

Кадр автоматически разделяется на детали и распознаётся. После обработки нажмите Z

для следующего кадра: результаты накапливаются во временном инвентаре, не заменяя предыдущие.

Во время обработки повторная съёмка заблокирована; удержание Z не создаёт очередь кадров.

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

Нажмите Завершить съёмку, проверьте детали, цвета и количества в таблице,

снимите отметки с ошибочных позиций. Завершить и перенести подтверждённое

добавляет только отмеченные позиции в текущий инвентарь. До этого основной инвентарь

не меняется. Временный список хранится только в этом окне; закрытие без переноса отменяет его.

При закрытии камера выключается.

Нераспознанные области снимков камеры скрыты во временном инвентаре; найденные

детали показываются рядом с эталонным изображением из каталога. Скрытые области

не добавляются в инвентарь и сохраняются до закрытия окна для повторного

распознавания. Для загруженного файла неизвестные области остаются видимыми.

Если доступ запрещён, проверьте разрешение камеры для настольных приложений в настройках системы.

Приложение локально выделит отдельные области и покажет миниатюры.

Разложите детали с промежутками на однотонном контрастном фоне, не друг на друге.

Белые и прозрачные детали лучше фотографировать на тёмном фоне.

Нажмите Распознать детали. Brickognize включён по умолчанию во всех режимах,

отдельное разрешение не запрашивается. Во внешний сервис

отправляются отдельные выделенные фрагменты, не всё фото. Каждая область получает

свои варианты артикула и цвета; повторные детали остаются отдельными строками.

Проверьте миниатюры, выберите варианты и цвета, при необходимости нажмите Исправить…

для поиска по каталогу. По умолчанию количество равно 1; его можно изменить.

Снимите отметку «Добавить» с ошибочных фрагментов. Строки без детали или цвета

не добавляются; слабые предложения не отмечаются автоматически.

Кнопка Добавить выбранные в инвентарь добавляет только подтверждённые строки,

объединяя совместимые дубликаты. Уже выбранная строка инвентаря не перезаписывается.

До подтверждения инвентарь не меняется. Обработку можно остановить после текущего

запроса; результаты уже обработанных деталей останутся для проверки.

На одном фото поддерживается до 50 выделенных областей. Этот локальный алгоритм

не гарантирует разделение касающихся или перекрывающихся деталей и распознавание

на пёстром фоне. Сервисы фото-поиска коллекции, мобильной сортировки и веб-интерфейса

пока сохраняют прежний одиночный сценарий.

Детали из PDF-инструкции

Откройте Инструменты → Детали из инструкции PDF… и выберите PDF. Наличие набора

в коллекции не требуется. Brickognize используется автоматически: отправляются только выделенные

изображения деталей, не весь PDF и не целые страницы.

Нажмите Распознать. Обработка идёт в фоне. Таблица постепенно заполняется:

миниатюра, артикул, цвет и номера шагов. Одинаковые артикулы одного цвета объединяются,

номера шагов не дублируются. Неопределённые цвет и шаг явно отмечаются; они не

подменяются догадками. Неоднозначные артикулы не включаются в результат.

Для маленьких изображений из старых инструкций автоматически проверяется

улучшенный вариант фрагмента. Совпадение артикула на исходном и обработанном

вариантах позволяет включить его в список при умеренной оценке сервиса,

если нет близкого конкурента. Такое совпадение не подтверждает спорный цвет

и не является подтверждением физических деталей в инвентаре.

После распознавания приложение локально сопоставляет оставшиеся фрагменты с

уверенно распознанными изображениями из этой же инструкции. Близкие повторы

добавляют номера шагов к найденной детали без дополнительных запросов в

Brickognize. Форма, внутренние контуры и цвет должны совпадать; спорные случаи

остаются в нижнем списке. Сопоставленные повторы не используются как новые

образцы, чтобы ошибка не распространялась цепочкой. Образцы сохраняются вместе

с результатом этой инструкции; старые результаты автоматически образцами не становятся.

Оставшиеся маленькие фрагменты автоматически проходят локальный нейросетевой

апскейл Real-ESRGAN x4 и одну дополнительную попытку распознавания. Модель

размером около 5 МБ загружается при первом использовании и затем хранится локально.

Видеокарта не требуется; повторяющиеся изображения обрабатываются один раз.

Уже распознанные позиции не заменяются нейросетевыми. Цвет берётся только из

исходных изображений, а обработанный фрагмент не становится образцом для других

деталей. Если модель недоступна, сохраняется обычный результат распознавания.

Если указан номер набора, автоматическое распознавание также использует его

состав из каталога. Это помогает выбрать между близкими артикулами и уточнить

цвет из реально присутствующих в наборе. Требуется подходящий визуальный

кандидат: само наличие детали в составе не создаёт результат. Сильно

противоречащие изображению или близкие конкурирующие варианты остаются для

ручной правки. Состав загружается один раз, коллекция и инвентарь не изменяются.

Мелкие рисунки дополнительно сравниваются специализированным классификатором;

артикул принимается только при согласии с основным визуальным сопоставлением.

Для неопознанных фрагментов состав также сужает поиск до ещё не найденных

артикулов, с обязательной проверкой изображения. Найденный артикул может

повторяться на других шагах: число строк не считается количеством использованных

деталей. Наличие единственной оставшейся позиции само по себе не подтверждает её.

Подписи xN в блоках деталей теперь сохраняются с результатом: в колонке шагов

видно, например, 8 (×2). При неизвестном количестве или неразрешённом повторе

подсборки учёт помечается как неполный (≥), а не заменяется единицей.

Явное «собрать ×2» умножает количества только связанного блока деталей,

если рамка подсборки и основной шаг определены однозначно. Вложенные и

конфликтующие рамки не умножаются автоматически. При новом анализе количество

вычисляется заново из инструкции, а не умножает предыдущий сохранённый итог.

Подсборка может продолжаться на соседних страницах: рамки с непрерывной внутренней

нумерацией связываются до явной отметки «×N» на последней странице. Количества

связанного блока относятся к основному шагу, на котором начата подсборка.

Разрыв страниц, сброс нумерации или новый самостоятельный шаг прерывают связь;

одной лишь близости страниц недостаточно для применения повтора.

Уверенно опознанные позиции с прочитанными количествами уменьшают доступное

количество в каталожном составе при поиске оставшихся кандидатов. Противоречащие

остатку предложения не принимаются методом исключения; конфликтующие предложения

проверяются вместе, без предпочтения первого по порядку. Ваш физический инвентарь

при этом не изменяется. Старые результаты получат количества после повторного распознавания.

Проверка учитывает не только артикул, но и цвет. Противоречие по одному артикулу

не отключает проверку остальных. Спорные автоматические совпадения, которые вместе

превышают состав набора, возвращаются в нижний список с объяснением и повторно

проверяются по изображению и доступному остатку. Ручные и уверенные исходные

распознавания не удаляются: при противоречии выводится предупреждение.

Неизвестный цвет уменьшает общий остаток артикула, но не назначается по остатку

автоматически. Цвет уточняется только при наличии подходящего визуального кандидата.

Для старых инструкций есть дополнительное локальное уточнение цвета по самой PDF:

алгоритм сравнивает оттенок детали с надёжно подписанными примерами из той же

инструкции. Для выбора нужны согласованные примеры разных деталей и отличие

от конкурирующих цветов. Голубой фон и белые поля не используются как цвет детали.

Ручные цвета и артикулы не меняются; новые цвета не становятся обучающими примерами

для следующих догадок. Белые и светло-серые поверхности сравниваются внутри

контура детали: белые поля и пустые белые области не служат образцами цвета.

Если контур не отделяет поверхность от фона или оттенки слишком близки, цвет

остаётся неопределённым. Прозрачные, металлические детали и декоративные рисунки

этот проход оставляет без автоматического уточнения.

Для ещё не опознанных фрагментов палитра инструкции также помогает выбрать

между близкими предложениями сервиса. Артикул должен независимо совпасть по

форме, а его цвет присутствовать в составе набора. Если цвет не различает

кандидатов, нет надёжных образцов возможного цвета или количество противоречит

составу, фрагмент остаётся на уточнение. Дополнительных запросов к сервису для

этого прохода нет.

При повторной попытке слегка обрезанная одиночная картинка детали восстанавливается

из оригинального изображения PDF. Для рисованных фрагментов граница может быть

немного расширена, если контур упирается в край и рядом нет другой картинки или

подписи. Удаление серо-голубой подложки применяется только в улучшенном повторном

варианте; основной проход сохраняет прежние границы и обработку изображения.

Большие обрезания и недостающие части изображения алгоритм не дорисовывает.

В сверке состава коллекции доступна кнопка «Сверка по камере…». Поставьте одну

деталь под камеру и нажмите Z (Я в русской раскладке). Уверенно опознанная деталь

из состава засчитывается как одна найденная единица. Уберите её перед следующим

снимком. Два коротких низких сигнала означают, что деталь не опознана; один высокий

сигнал — что деталь/цвет не нужны либо нужное количество уже найдено. Если сервис

не определил цвет, автоматический учёт возможен только для единственного цвета

этого артикула в составе. Закройте камеру и нажмите «Завершить сверку» для

подтверждения результата. Свободный инвентарь при съёмке не изменяется.

Варианты с наклейкой показываются отдельно, но засчитываются в базовую деталь того

же цвета. Они не увеличивают общее требуемое количество. При неоднозначном

сопоставлении автоматическое засчитывание такого варианта не выполняется.

Если очищенный фрагмент не распознан, анализатор автоматически проверяет

исходное изображение без удаления подложки, затем при необходимости улучшенный

вариант. Одинаковые варианты пропускаются; успешное распознавание повторно

не запускается. Это помогает сохранить светлые поверхности и тонкие края.

В колонке «Шаги» показана нумерация сборки внутри инструкции, а не страницы PDF.

Печатные номера в колонтитулах исключаются; секции могут начинать шаги заново.

Результаты раннего MVP с ошибочной нумерацией страниц требуют обновления кнопкой

«Распознать»: старые номера скрыты, артикулы, миниатюры и удаления сохранены.

Для точных повторов сохранённых изображений связи пересчитываются локально.

Нераспознанные фрагменты показаны ниже основного списка с миниатюрами и шагами.

Выделите строку и нажмите Указать деталь… либо дважды щёлкните по ней.

В окне ручного выбора кнопка Посмотреть страницу открывает исходную страницу

PDF в отдельном изменяемом окне. Можно увеличить изображение кнопками + / −

или вписать страницу целиком. Введённые артикул, цвет и шаги при просмотре сохраняются.

При загрузке PDF можно указать номер набора в поле Набор: он сохраняется для

этой инструкции и помогает выбирать детали из каталожного состава, без добавления

набора в коллекцию. Для многотомной инструкции укажите Книга (1, 2 и т. д.)

при загрузке PDF каждого тома; для однотомной оставьте 1. Результат сохраняется

автоматически вместе с номером набора, номером книги и отпечатком PDF. Разные PDF

хранятся отдельно: одинаковые номера шагов разных томов не смешиваются.

При повторном открытии восстанавливаются результат, номер книги и ручные исправления.

Неопознанные фрагменты дополнительно сравниваются с изображениями деталей из состава

набора, включая повороты рисунка. При близкой форме сравнение точных цветных эталонов

может помочь различить артикулы. Эталоны загружаются пакетно из локальной библиотеки.

Если цвет неизвестен, а артикул встречается в наборе только в одном цвете, приложение

подставляет этот цвет. Для нескольких цветов сравниваются исходный фрагмент и точные

каталожные изображения, без подмены картинки другим цветом. Неоднозначный цвет остаётся

неопределённым. Это прогноз по инструкции и каталогу, не проверка физических деталей;

ручные исправления не заменяются.

Неизвестный цвет также сравнивается с уже установленными цветами деталей из той же

инструкции: автоматическая «пипетка» берёт оттенок светлых участков детали, исключая

фон и тёмные контуры. При близком совпадении достаточно одного надёжного эталона;

похожие конкурирующие оттенки остаются для уточнения. Новые прогнозы не становятся

эталонами для следующих прогнозов. Если артикул отличается от варианта в составе,

цвет дополнительно проверяется по доступным цветам этого артикула в каталоге.

В списке неопознанных одинаковые изображения объединены: одна строка показывает все

шаги и количества. Цвет может быть подобран по распознанным деталям, даже если артикул

ещё неизвестен. Указание детали или удаление такой строки применяется ко всем её

появлениям; исходные страницы и количества сохраняются.

После подбора цвета анализатор вычитает уже найденные количества из состава набора

и сравнивает неопознанные изображения с оставшимися деталями того же цвета. Простого

наличия артикула в результате недостаточно, чтобы считать все его экземпляры найденными.

Новые совпадения проверяются совместно по доступному количеству; один оставшийся артикул

не назначается автоматически, если его изображение не похоже на фрагмент.

Для оставшихся неопознанных фрагментов выполняется локальный нейросетевой повторный

проход. Пустые поля превью убираются, деталь подготавливается для модели Real-ESRGAN,

а результат сравнивается с каталогом: при известном цвете — с остатком этого цвета.

Повторяющиеся изображения обрабатываются один раз. Этот проход не отправляет новые

запросы в Brickognize, не меняет исходные миниатюры и не использует улучшенную картинку

для определения цвета. Апскейл не гарантирует распознавание и не заменяет проверку

визуального сходства и допустимого количества.

После расчёта остатка также повторяется нейросетевое сравнение признаков исходного

и улучшенного фрагментов среди оставшихся деталей того же цвета. Для этого прохода

попиксельное совпадение контуров не обязательно: учитываются цветные и обесцвеченные

изображения. Кандидат должен устойчиво отличаться от конкурентов и согласовываться

с исходным фрагментом, а не только с изображением после апскейла.

Данные готовы для будущей выгрузки; отправка на сайт сейчас не выполняется.

В ручном выборе вводите артикул или название и выбирайте подсказку.

Подсказки содержат только позиции указанного набора, включая детали его минифигурок.

Если набор не указан или его состав отсутствует в каталоге, подсказок нет.

Названия ищутся на языке каталога.

Цвета из состава также предлагаются первыми; единственный цвет выбирается автоматически.

Выберите цвет и при необходимости исправьте номера

шагов. После сохранения фрагмент исчезает из нижней таблицы, а выбранная деталь

добавляется в основной список; шаги совпадающей позиции объединяются.

Ручные исправления сохраняются и имеют приоритет при повторном распознавании.

Ошибочно выделенный фрагмент можно удалить кнопкой Удалить ошибочное.

Нижний список и удаления также восстанавливаются после повторного открытия PDF.

В результатах ранних версий фрагменты не сохранялись: для их показа нужен новый

запуск распознавания.

Локальное сопоставление с изображениями печатного перечня PDF дополняется распознаванием

через Brickognize без отдельного запроса разрешения. Для сервиса требуется интернет.

Таблица содержит предсказания алгоритма, а не подтверждённый физический состав.

Коллекция и инвентарь не изменяются.

Выделите явно ошибочные строки и нажмите Удалить ошибочное.

Результаты упорядочены по цвету; позиции без определённого цвета находятся в конце.

Автоматически присвоенные цвета одного артикула перепроверяются

по исходным изображениям каждого появления до объединения количеств.

Для исправления ошибочного автоматического цвета нужны независимые образцы

других деталей в той же инструкции. Ручные подтверждения не меняются.

При повторном анализе кеш многоцветной детали сохраняет её артикул, но не

закрепляет прежний цвет: каждое появление оценивается заново. Автоматический

цвет, отсутствующий в составе указанного набора, не сохраняется без проверки.

Противоречие количества проверяется отдельно и не служит причиной оставить

старый цвет, который опровергнут независимыми образцами.

Палитра инструкции отделена от обычных результатов распознавания. Высокий балл

Brickognize сам по себе не превращает изображение в образец цвета. Основа —

ручные подтверждения и однозначно сопоставленные изображения печатного состава.

Автоматические образцы одноцветных деталей набора добавляются только при

согласовании с этой основой либо с другой независимой деталью того же цвета,

без близких противоречащих меток. Новые предсказания не обучают следующие.

В больших инструкциях ограничение палитры распределяется между цветами,

чтобы один распространённый цвет не вытеснил остальные.

Если в PDF есть однозначно сопоставленный печатный список деталей, цвет сначала

сравнивается с изображениями именно этого артикула во всех цветах из состава

набора. Такое сопоставление имеет приоритет над общей палитрой разных деталей.

Если изображения конкурирующего цвета отсутствуют, результат не подбирается

просто по единственному оставшемуся эталону. Ручные подтверждения сохраняются.

В томах без доступного печатного списка действует общая палитра; сообщение

после анализа указывает, что эталоны из списка деталей получить не удалось.

Для сравнения цветов исключается светло-серый фон блока деталей, включая фон,

видимый через отверстия. Цвет берётся из исходных пикселей детали, а не из

нейросетевого улучшения. Неизвестные локальному каталогу кандидаты также

участвуют в проверке однозначности: приложение не выбирает менее уверенный

вариант только потому, что более сильного конкурента нет в каталоге.

Чтобы исправить распознанную позицию, выделите её и нажмите Исправить…

или дважды щёлкните по строке. Можно изменить артикул, цвет, шаги и количество

на каждом шаге: например 5:2, 8:1. Исправления сохраняются для этого PDF

и не сбрасываются при повторном анализе. Совпадающие позиции объединяются.

Ручные количества имеют приоритет над числами, прочитанными из PDF, в том числе

после повторного анализа. Пустое поле количества означает «неизвестно», а не

разрешение восстановить прежнее число автоматически. Исправление группы

одинаковых фрагментов задаёт общую сумму на каждом шаге и учитывается один раз.

Подтверждённые шаги исправленной строки сохраняются, а новые шаги вне области

этой правки могут добавляться при последующем распознавании.

Справа показан состав указанного набора: требуемое и найденное количество

для каждого артикула и цвета. Полностью найденные позиции отмечены зелёным,

недостающие — красным, превышение количества — жёлтым. Знак ≥ означает

неполный подсчёт, — в колонке «Найдено» — распознанную деталь без известного

количества. Сравнение относится только к выбранной книге, а не ко всем томам

инструкции и не к физической коллекции. При совместном анализе нескольких книг

эта область показывает суммарные найденные количества. Ширину области можно

менять разделителем.

Для многотомной инструкции выберите сразу несколько PDF кнопкой Выбрать файл….

В строке «Книга» появится переключатель файлов. Номера назначаются по порядку

выбранных файлов; при необходимости выберите книгу и исправьте её номер перед

запуском. Номера должны быть уникальными. Укажите общий номер набора и нажмите

Распознать один раз: сначала подготавливаются все книги, затем список деталей

из любого тома используется как общий источник эталонов.

Результаты, ручные исправления и удаления сохраняются отдельно для каждого PDF

с его номером книги. Переключатель показывает шаги выбранной книги, поэтому

одинаковые номера шагов разных томов не смешиваются. Если остановить обработку

или один из PDF изменится во время запуска, прежние результаты остаются на месте.

При ошибке записи сообщается, какие книги не удалось сохранить.

Суммарная проверка количества выполняется после ручных исправлений и удалений.

Превышение состава выделяется жёлтым, даже при неполном подсчёте. Приложение

сообщает о противоречии, но не уменьшает ручное количество и не подменяет цвет

или артикул, чтобы искусственно согласовать числа с каталогом.

Удаления сохраняются

для данного PDF и применяются при повторном распознавании. Готовый результат

восстанавливается после повторного выбора файла. Изменённый PDF считается новой

инструкцией. Предыдущие ручные отметки старого анализатора не удаляются и не перезаписываются.

Во время обработки доступна Остановить. Текущий запрос завершится, новые

фрагменты отправляться не будут. Прерванный запуск не заменяет ранее сохранённый

готовый результат частичным. Диагностических вкладок, экспортов

и расширенных настроек в этом окне нет. Поле «Книга» задаёт номер тома.

Для сравнения качества достаточно записать число «Не распознано» после полного

запуска на одном и том же PDF с одинаковыми номером набора и книгой. Это число

фрагментов, включая повторения, а не количество уникальных деталей. Уменьшение

числа само по себе не доказывает правильность всех распознанных артикулов.

10. Веб-доступ в локальной сети

Кнопка «Веб-сервер» в боковой панели включает локальный интерфейс. «Открыть веб» запускает

его в браузере. Другому устройству в той же сети можно передать показанный адрес и временный

код подключения. На телефоне широкие таблицы превращаются в компактные карточки без

горизонтальной прокрутки. В мобильной сортировке можно снять фото камерой, выбрать активный

проект и подтвердить результат; проекты MOC доступны для просмотра.

Разделы загружаются независимо, поэтому переход между ними не обрабатывает заново всю базу.

Длинные списки продолжаются автоматически при прокрутке вместо перехода по страницам.

В формах добавления начните вводить артикул — BrickDesk покажет совпадения локального каталога.

В карточке предмета коллекции можно начать сверку состава: найденные полностью строки

скрываются, а кнопка «Показать полные строки» временно возвращает их в таблицу.

Локальный веб-интерфейс работает по обычному http:// внутри домашней сети. Разрешайте доступ

только доверенным устройствам: временная ссылка и код подключения передаются по локальной сети

без шифрования. Для изменения данных по-прежнему требуется временная авторизация BrickDesk.

11. Автосохранение, данные и резервная копия

При аварийном завершении BrickDesk предлагает восстановить несохранённые вкладки. Команда

Ctrl+Shift+R открывает восстановление вручную.

Пользовательские данные установленной версии находятся отдельно от программы:

• Windows: %LOCALAPPDATA%\BrickDesk\Data;
• macOS: ~/Library/Application Support/BrickDesk.

Для копии пользовательских данных используйте «Файл → Полная копия BrickDesk».

Архив .brickdesk-backup содержит базу целиком, коллекцию, историю продаж и возвратов,

настройки, этикетки и локальные материалы MOC. Несохранённые правки открытых вкладок

входят как аварийные снимки и восстанавливаются через Ctrl+Shift+R.

Каталог изображений, модели и внешние оригиналы файлов в архив не входят.

Подробнее: [сохранение и экспорт](save-and-export.md).

Для ручного переноса всей папки данных закройте BrickDesk и скопируйте её. Особенно важны:

• local_data/brickdesk.sqlite — локальные инвентари и рабочие данные;
• local_data/collection.json — коллекция;
• local_data/shop.json — сохранённые данные отключённого старого магазина;
• local_data/wanted_lists.json — списки покупок;
• local_data/moc_projects.json и local_data/moc_files — MOC и добавленные материалы;
• local_data/brickdesk_desktop_settings.json — настройки.

Обновление и удаление приложения не должны удалять папку данных. Не очищайте её вручную без

проверенной резервной копии.

Результаты PDF-анализатора могут находиться отдельно в

%LOCALAPPDATA%\BrickDesk\instruction_analyzer. Скопируйте также эту папку, если она есть,

и внешние PDF/XML, включая выбранную папку экспорта Wanted Lists.

12. Этикетки для хранения

«Инструменты → Этикетки для хранения…» создаёт наклейки из деталей каталога или текущего инвентаря.

Добавьте нужные позиции, измените названия и число копий, проверьте предпросмотр

и экспортируйте PDF для выбранного размера ленты или листа A4. Печатайте в масштабе 100%.

Предпросмотр учитывает формат: отдельная этикетка для ленты или реальная сетка

очереди на A4 с переключением листов.

«Настроить макет…» позволяет изменить расположение картинки, текст, рамку,

цветной маркер, код ящика и источник количества. Название цвета включается

по желанию; названия из каталога не переводятся. «Сохранить макет» сохраняет

именованные настройки. Очередь и макеты восстанавливаются после перезапуска

и входят в резервную копию; инвентарь не меняется.

Подробности: [Этикетки для хранения](storage-labels.md).

13. Горячие клавиши

| Клавиши | Действие |

|---|---|

| Ctrl+N | Новый инвентарь |

| Ctrl+O | Открыть BSX/XML |

| Ctrl+S | Сохранить локально |

| Ctrl+W | Закрыть вкладку |

| Ctrl+Shift+R | Восстановить аварийное сохранение |

| Ctrl+Shift+C | Открыть каталог |

| Ctrl+K | Подобрать деталь для строки |

| Insert | Добавить строку |

| Ctrl+D | Дублировать строки |

| Ctrl+M | Перенести строки |

| Delete | Удалить строки |

| Ctrl+F | Поиск или фильтр текущего раздела |

| Esc | Снять выделение/сбросить фильтр в поддерживаемом контексте |

| F5 | Проверить инвентарь |

| F1 | Справка по текущему разделу |

| Ctrl+F1 | Показать справку по клавишам |

14. Если что-то не работает

Оформление Brick Workshop использует встроенный Rubik и новую боковую панель.

Подписи разделов можно закрепить; свёрнутая панель сохраняет крупные значки.

Ширины колонок и их видимость по-прежнему настраиваются правым кликом по шапке.

Настройки и данные из отдельной тестовой копии автоматически не подменяют рабочие.

• Нет названий, цветов или состава: повторно запустите установщик каталога и изображений.
• Нет картинок: проверьте путь к локальному кэшу в настройках и наличие папки image_cache.
• Не загружается курс или распознавание: проверьте интернет и повторите операцию.
• Файл не импортируется: убедитесь, что это корректный BSX или BrickLink XML.
• После сбоя пропали несохранённые изменения: откройте восстановление через

Ctrl+Shift+R до создания новых аварийных снимков.

• Окно или таблица слишком тесные: растяните окно; в карточке коллекции также перемещайте

разделитель над таблицей состава.

Подключение к серверу и обратная связь

В обновлённом клиенте откройте Настройки → Сервер BrickDesk. Проверьте адрес сервера, сертификат и подключение. Каталог загружается отдельно от пользовательских данных и применяется после перезапуска. При отсутствии сети используется локальная библиотека.

Для сообщения об ошибке или предложения откройте Справка → Отправить отзыв. Выберите тип обращения и опишите ситуацию. Можно указать контакт и вручную приложить один скриншот. Проверьте изображение перед отправкой: оно может содержать личные данные.

При проблеме с сетью сообщение и выбранный скриншот остаются в локальном черновике. Успешная отправка подтверждается номером обращения. Отзывы доступны только администратору.

Опубликованный установщик и клиент из исходников могут содержать разные наборы функций; новые серверные возможности перечислены в разделе тестирования дорожной карты.