Инструкция по установке CyrFlip

Как связаны две части

Приложение - это «мозг»: оно знает активную раскладку. Расширение - лишь поверхность для отображения в VS Code, потому что VS Code рисует собственную каретку, позицию которой приложение не может точно отследить снаружи.

  CyrFlip.exe (трей)               %LOCALAPPDATA%\CyrFlip\        Расширение VS Code
  определяет EN / RU / UK  ──пишет──▶      layout.txt      ──следит──▶  рисует маркер
                                                                       у каретки редактора

Приложение должно быть запущено, иначе расширению нечего показывать - оно только читает то, что публикует приложение. Без VS Code вы всё равно получаете значок в трее, маркер на курсоре мыши и горячую клавишу транслитерации везде.

Шаг 1 - установите и запустите приложение CyrFlip

Любой из вариантов:

• Microsoft Store - найдите CyrFlip в приложении Microsoft Store на Windows 10/11 и нажмите Получить.
• winget:

  winget install SerZhyAle.CyrFlip

• Переносимый ZIP - скачайте со страницы релизов, распакуйте куда угодно и запустите CyrFlip.exe. Устанавливать ничего не нужно; работает на «голой» Windows 10/11.

После запуска CyrFlip сидит в системном трее (без окна). Значок показывает активную раскладку (EN/RU/UK). Правый клик открывает меню - горячая клавиша «переворота», переключатель Start with Windows (автозапуск) и Exit (выход).

Включите Start with Windows, чтобы приложение - а значит и маркер раскладки везде, включая VS Code - было доступно сразу после перезагрузки.

Шаг 2 - установите расширение для VS Code (необязательно)

Расширение для VS Code не требуется для работы приложения. Если вы не пользуетесь VS Code - пропустите этот шаг. Устанавливайте его только если хотите маркер точно у каретки внутри VS Code. Выберите один способ:

• Из Marketplace - откройте Extensions (Ctrl+Shift+X), найдите CyrFlip (издатель SerZhyAle) и нажмите Install.
• Из файла .vsix - возьмите cyrflip-vscode-<версия>.vsix из папки vscode-extension, затем в VS Code: Extensions ▸ ⋯ ▸ Install from VSIX.., либо из терминала:

  code --install-extension cyrflip-vscode-<версия>.vsix

После установки выполните Developer: Reload Window (Ctrl+Shift+P). Расширение запускается само - настройка не требуется.

Шаг 3 - пользуйтесь вместе

1. Убедитесь, что приложение CyrFlip запущено (значок в трее показывает EN/RU/UK).
2. Кликните в редактор кода в VS Code и начните печатать. Переключите раскладку - цветной маркер EN/RU/UK следует за кареткой, а в строке состояния видно ⌨ EN/RU/UK.
3. Везде в других местах (другие приложения, диалоги, рабочий стол) маркер едет на курсоре-«балке» мыши и на значке в трее - всё от того же приложения.
4. Набрали в неправильной раскладке? Выделите и нажмите Ctrl+Shift+F12 - CyrFlip транслитерирует на месте (QWERTY ↔ ЙЦУКЕН, EN ↔ RU). Каждый символ переключается по скрипту, поэтому смешанный EN + RU тоже обрабатывается корректно. Работает в любом приложении, включая VS Code.
5. Хотите, чтобы клавиатура переключалась вслед за исправлением? Включите Change the language after the flip в меню трея - после флипа CyrFlip также переключит активный язык ввода (EN → RU, иначе → EN), чтобы вы продолжали печатать в правильной раскладке.

Где показывается раскладка

Внутри VS Code webview-панели и виджеты - встроенный терминал, поля поиска, панели чата, палитра команд - не могут содержать декорации редактора, поэтому маркер у каретки там не появляется. Раскладку по-прежнему показывают индикатор в строке состояния и маркер на курсоре мыши.

Решение проблем

• Нет маркера в VS Code. Проверьте, что приложение запущено, затем что файл раскладки существует и его содержимое меняется при смене раскладки. Путь зависит от способа установки: portable/winget → %LOCALAPPDATA%\CyrFlip\layout.txt; Microsoft Store → %ProgramData%\CyrFlip\layout.txt. Индикатор в строке состояния - самый быстрый способ убедиться, что расширение читает файл. Попробуйте Developer: Reload Window.
• Маркер у края поля (не в VS Code). В редакторах на основе Monaco внешний оверлей приложения не может точно прочитать каретку - именно это и решает расширение, так что установите его.
• Курсор-«балка» мыши остался изменённым после жёсткого завершения. CyrFlip восстанавливает системный курсор при выходе; если процесс снят принудительно («Снять задачу»), запустите CyrFlip снова или перезайдите в систему, чтобы восстановить курсор.
• Горячая клавиша не срабатывает. Сначала выделите текст и убедитесь, что Ctrl+Shift+F12 не перехватывает другой инструмент. Клавишу можно сменить в config.json.