Standboy

Что такое Standboy?

Standboy — расширение для VS Code, которое встраивает панель эмулятора Game Boy и связывает видимость и состояние воспроизведения эмулятора с активностью вашего AI-агента. Когда агент начинает генерацию, Standboy автоматически разворачивает боковую панель эмулятора и возобновляет воспроизведение; когда агент завершает работу или переходит в режим ожидания, Standboy скрывает панель и ставит эмулятор на паузу.

Цель — сократить «мёртвое время» ожидания агента, сохраняя развлечение внутри IDE и жёстко приостанавливая эмулятор, когда агент неактивен. Поддерживается загрузка собственных ROM-файлов, а последняя запущенная игра и сохранения сохраняются между перезапусками VS Code.

Ключевые возможности

• Автопоказ/автоскрытие по активности агента: расширение разворачивает эмулятор после нескольких секунд работы агента и сворачивает его после аналогичного периода бездействия, чтобы избежать мерцания при кратких циклах агента.
• Интеграция с Cursor и Claude Code: Standboy подключается через официальные API жизненного цикла Cursor и Claude Code с помощью одного переключателя в меню панели.
• Возобновление с середины кадра: при повторном открытии эмулятор продолжает игру точно с того момента, где она была остановлена.
• Библиотека ROM и постоянные сохранения: загруженные ROM копируются в управляемую библиотеку. Состояние сохранения в игре записывается на диск при скрытии панели, выгрузке страницы и перед экспортом; runtime-состояние хранится в IndexedDB, а сохранения сохраняются после перезапуска VS Code.
• Сопоставление ROM и метаданные библиотеки: ROM идентифицируются по SHA-1 с помощью встроенной базы No-Intro, что обеспечивает единые канонические названия и обложки (с fallback в виде буквенных плиток для homebrew и хаков).
• Поддержка устройств и ввода: поддерживаются ROM .gb, .gbc и .gba с автоматическим определением платформы по расширению файла. Управление с клавиатуры переназначается в меню панели: D-pad — на стрелки, A/B/Start/Select — на любые выбранные клавиши.
• Оффлайн-эмулятор и встроенные данные: эмулятор (EmulatorJS) и база No-Intro поставляются в комплекте и работают без подключения к интернету.

Как использовать Standboy

1. Установите расширение VS Code: в VS Code откройте панель расширений и найдите Standboy или выполните code --install-extension mfbzme.standboy.
2. Подключите определение агента (первый запуск): при первой активации Standboy автоматически открывает панель и показывает карточку для подключения обнаруженного типа агента (Claude Code, если существует ~/.claude/settings.json, или Cursor при работе внутри Cursor). Нажмите Подключить, чтобы включить хуки жизненного цикла, или закройте и переключите позже через меню ⋯ в разделе Detection.
3. Добавьте ROM: нажмите + Add ROM (или Load ROM… в меню), выберите локальный файл .gb, .gbc или .gba. Standboy скопирует его в управляемую библиотеку, идентифицирует по базе No-Intro и запустит эмулятор.
4. Используйте эмулятор во время активной генерации: панель принимает ввод с клавиатуры, пока открыта. Когда агент бездействует, Standboy ставит эмулятор на паузу и скрывает панель согласно правилам окна бездействия.

Сценарии использования

• Сохранение фокуса во время работы агента: когда Cursor/Claude Code начинает генерацию кода, Standboy разворачивает эмулятор, чтобы вы могли играть, не покидая IDE; когда генерация завершается, панель сворачивается и эмулятор ставится на паузу.
• Избегание переключения вкладок при длительных запусках агента: вместо перехода в другие приложения (чат, форумы, мессенджеры) эмулятор предлагает перерыв внутри редактора с жёсткой границей паузы при активности/завершении агента.
• Возврат к той же игре после перезапуска: после однократной загрузки ROM Standboy автоматически возобновляет последнюю запущенную игру при следующем запуске VS Code, восстанавливая данные сохранений.
• Создание библиотеки ROM с едиными названиями и обложками: файлы ROM с разными именами на диске отображаются с каноническими названиями и обложками благодаря сопоставлению SHA-1 с базой No-Intro.
• Тестирование разных раскладок управления: пользователи могут переназначать клавиши управления в меню панели под свою клавиатуру или предпочтения.

FAQ

• Включает ли Standboy игры или предоставляет источники ROM? Нет. Standboy загружает только пользовательские ROM и не содержит предустановленных игр или ссылок на источники ROM.

• Можно ли использовать расширение оффлайн? Эмулятор и база No-Intro встроены и работают без подключения к интернету. Единственные исходящие запросы — однократная загрузка обложек из libretro-thumbnails, выполняемая хостом расширения и кэшируемая локально.

• Как Standboy решает, когда показывать или скрывать эмулятор? Standboy активируется только после обнаружения активности агента в течение нескольких секунд (автопоказ) и скрывается после аналогичного периода бездействия (автоскрытие). Такое поведение предотвращает частое мигание при коротких циклах агента.

• Какие интеграции с агентами поддерживаются? Расширение подключается к Cursor и Claude Code через их официальные API жизненного цикла, с переключателем в меню панели. Для других агентов используется эвристика по всплескам правок, если специальная поддержка недоступна.

• Возобновляет ли эмулятор работу с того места, где вы остановились? Да. Standboy возобновляет с середины кадра при повторном открытии панели, а webview сохраняется при скрытии, поэтому эмуляция ставится на паузу и продолжается с того же состояния.

Альтернативы

• Универсальные эмуляторы Game Boy (отдельные приложения для ПК/мобильных): Они ориентированы на игру, но не интегрируются с жизненным циклом агентов VS Code для автоматического показа/скрытия.
• Другие медиа-панели и уведомления в VS Code: Расширения, отображающие индикаторы активности или простые дашборды, помогают управлять вниманием, но обычно не предлагают эмулятор с возобновлением с середины кадра и сохранением прогресса.
• Планировщики задач и таймеры фокуса в IDE (в стиле Pomodoro): Они позволяют структурированно сократить «время ожидания», но не предоставляют встроенный эмулятор с идентификацией ROM и сохранением прогресса.
• Интеграции эмуляторов через webview без привязки к агентам: Похожий рабочий процесс (игра внутри редактора), но без автоматического показа/скрытия на основе жизненного цикла и возобновления с середины кадра, привязанных к активности AI-агента.