Версии документации
Если редактор не открывается
Найдите ниже то, что вы видите на экране. Для повторной установки используйте инструкцию первого запуска.
Файл открылся как текст
- Нажмите правой кнопкой по вкладке файла вверху VS Code.
- Выберите Reopen Editor With… → Binary GIN.
- Чтобы открывать так все
.bgin, в списке редакторов выберите Configure default editor for '*.bgin'… → Binary GIN.
Если Binary GIN нет в списке, нажмите Ctrl+Shift+X и проверьте, что расширение Binary GIN Editor установлено и включено. После установки или обновления нажмите Ctrl+Shift+P, найдите Developer: Reload Window и нажмите Enter. Затем откройте файл заново.
Пустая вкладка, write EOF или The editor could not be opened
write EOF означает, что прервалась связь с модулем BGIN. Проверьте, что суффикс VSIX соответствует платформе среды расширения. Для WSL, SSH и Dev Containers учитывайте платформу удалённой среды.
- При ошибке
ENOENTилиNo module namedпереустановите VSIX для своей платформы. - Если редактор запрашивает доверие к рабочей области, подтвердите его, если доверяете содержимому папки.
- Выполните Developer: Reload Window из палитры команд, откройте файл снова и при повторной ошибке откройте журнал.
Дерево открылось, а картинки нет
- Нажмите Preview, если правая панель скрыта, затем Refresh.
- Если вы используете комплект с ресурсами, откройте его
Preview.code-workspace. Папкаresourcesдолжна оставаться рядом с ним. - Для своих ресурсов проверьте пути в Resources и нажмите Save folders.
- Откройте View → Problems: там видны отсутствующие файлы. Предупреждения к изображению можно раскрыть под ним кнопкой Render notes.
- После исправления нажмите Refresh ещё раз.
Подробные шаги подключения — на странице ресурсов.
Текст слишком мелкий или видно только часть экрана
Для увеличения изображения используйте + или поле масштаба возле Fit. Не уменьшайте Height в настройках предпросмотра ради приближения: от высоты экрана может зависеть размер текста. Если нужно вернуть стандартные параметры, откройте Settings → Reset to defaults, закройте окно и нажмите Refresh.
Если виден только один объект, нажмите Clear selection над деревом. Подробнее о предпросмотре.
Не получается сохранить пути к ресурсам
Если сообщение содержит not a registered configuration или просит перезагрузить окно, выполните Ctrl+Shift+P → Developer: Reload Window, снова откройте Resources и нажмите Save folders. Убедитесь, что у вас установлена последняя полученная версия расширения.
Как получить текст ошибки
- В верхнем меню VS Code выберите View → Output.
- Справа над нижней панелью раскройте список журналов. Вместо Window выберите Binary GIN. Для ошибки только при построении картинки также проверьте Binary GIN Preview.
- Повторите действие, которое приводит к ошибке.
- Скопируйте последние сообщения целиком, включая строки перед
EOFилиBGIN worker exited. Укажите версию расширения, суффикс VSIX и имя файла BGIN.
Скриншот пустого редактора помогает увидеть симптом, а журнал Binary GIN нужен, чтобы установить причину.
Новый BGIN отклоняется или формат неоднозначен
Общая сигнатура BGIN не гарантирует одинаковую двоичную запись. Проверьте поддерживаемые форматы и покрытие наборов. Специальные записи второй таблицы и несогласованные каталоги не исправляются автоматически. Сохраните оригинал для исследования; ручная замена номера формата не исправляет структуру.
Всё перекрыто объектами
В уже открытом экране нажмите Refresh, затем выберите Spread branches или используйте Hide top layers. Подробнее о просмотре композиции.
Правка MCP получила конфликт
Человек или другой клиент уже изменил документ. Клиент должен перечитать текст и ревизию; не повторяйте устаревшую замену целого документа. Проверьте окно подключения, паузу сессии и настройку MCP. Если файл изменён извне, сохранение также отклоняется: сначала сохраните нужный ручной текст отдельно и заново откройте актуальный файл.