Версии документации
MCP и совместное редактирование
Левая панель Binary GIN объединяет конвертер и подключения MCP. Несколько клиентов могут работать с одним открытым документом VS Code. Вы видите их правки, действия и рендеры и можете вмешаться, продолжая обычное редактирование.
Подключить клиента
Обычный редактор использует встроенный модуль и не требует Python. Для адаптера MCP через stdio пока нужен отдельный Python 3.10 или новее и исходники этого выпуска. В папке репозитория установите зависимости:
python -m pip install -e ".[mcp]"Для старого Zstd v0.6 в ресурсах требуется библиотека с поддержкой старых версий. В 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 собирается с этой поддержкой автоматически.
- Откройте доверенную рабочую область и BGIN в VS Code.
- В левой панели Binary GIN нажмите Copy client command.
- Передайте команду настройкам клиента MCP. Каждому клиенту задайте своё имя через
--client-name. Если клиент принимает программу и аргументы отдельно, используйтеbgin-mcpкак программу, остальные части — как аргументы.
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. Рендеры клиента появляются в галерее с автором; после изменения документа прежний результат помечается устаревшим. Настройки ресурсов общие с рабочей областью. Предпросмотр остаётся предпросмотром, а не запущенной игрой.