Skip to content

Версии документации

Это Binary GIN Editor 0.6.2. Основная версия — Binary GIN Editor 0.6.3.

MCP и совместное редактирование ​

Левая панель Binary GIN объединяет конвертер и подключения MCP. Несколько клиентов могут работать с одним открытым документом VS Code. Вы видите их правки, действия и рендеры и можете вмешаться, продолжая обычное редактирование.

Подключить клиента ​

Обычный редактор использует встроенный модуль и не требует Python. Для адаптера MCP через stdio пока нужен отдельный Python 3.10 или новее и исходники этого выпуска. В папке репозитория установите зависимости:

text
python -m pip install -e ".[mcp]"

Для старого Zstd v0.6 в ресурсах требуется библиотека с поддержкой старых версий. В PowerShell установите её из исходников:

powershell
$env:ZSTD_LEGACY = '1'
python -m pip install --use-pep517 --no-binary=zstd --no-cache-dir --force-reinstall zstd==1.5.7.2
python -c "import zstd; assert zstd.ZSTD_legacy_support()"

В macOS/Linux задайте ZSTD_LEGACY=1 перед той же командой python -m pip install. Встроенный модуль VSIX собирается с этой поддержкой автоматически.

  1. Откройте доверенную рабочую область и BGIN в VS Code.
  2. В левой панели Binary GIN нажмите Copy client command.
  3. Передайте команду настройкам клиента MCP. Каждому клиенту задайте своё имя через --client-name. Если клиент принимает программу и аргументы отдельно, используйте bgin-mcp как программу, остальные части — как аргументы.
text
bgin-mcp --mode connected --editor-bridge <файл-подключения> --client-name <имя>

Файл подключения относится к конкретному окну VS Code. Он содержит локальный ключ доступа; не включайте его в общедоступные архивы ресурсов. При недоступном окне подключённый режим сообщает ошибку, а не переходит к отдельной дисковой копии. Отдельный режим MCP для работы с файлами остаётся самостоятельным сценарием.

Что видят пользователь и модель ​

Клиент начинает с bgin_editor, затем читает документ через bgin_read. Правка передаёт полученную revision как base_revision и уникальный operation_id. После проверки данных ревизия сверяется повторно. Чужие правки, сделанные за это время, приводят к конфликту: клиент должен перечитать документ. Повтор запроса с тем же идентификатором не применяет уже выполненную правку дважды.

Ручные несохранённые изменения видны в общем документе. Даже временно неверный JSON остаётся текущим текстом: клиент не получает скрытую старую корректную копию. Правки входят в обычную историю Undo/Redo VS Code. Запись на диск требует отдельного сохранения; сохранение удерживает исходный формат BGIN.

Подписка на bgin://editor/state уведомляет об изменениях. Сервер отправляет уведомление, но момент появления события в контексте уже работающей модели определяется клиентом MCP. Проверка ревизии защищает от применения устаревшей правки.

Вмешаться в работу ​

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

  • Открыть затронутый документ и вручную исправить его.
  • Приостановить правки клиента и затем возобновить их.
  • Остановить ещё не применённую операцию.
  • Отключить сессию клиента.

Остановка не отменяет ранее выполненные изменения. Для них используйте Undo. Рендеры клиента появляются в галерее с автором; после изменения документа прежний результат помечается устаревшим. Настройки ресурсов общие с рабочей областью. Предпросмотр остаётся предпросмотром, а не запущенной игрой.