Double Shift RU/EN layout rescue для Linux
lay чинит слово, набранное не в той раскладке: нажал Shift два раза и
продолжил писать.
Статус: alpha. Основной сценарий уже рабочий. Главная зона активной доводки — автопомощь после пробела и редкие desktop edge cases.
curl -fsSL https://raw.githubusercontent.com/radislabus-star/lay-public/main/scripts/install-remote.sh | bash
lay — локальный клавиатурный помощник для Linux-пользователей, которые пишут
на русском и английском вперемешку.
Главный сценарий:
Набрал: ghbdtn
Нажал: Shift Shift
Стало: привет
lay не использует буфер обмена для основного сценария и не требует облачной
модели. Он слушает физические клавиши локально, помнит короткий хвост набора и
при команде перепечатывает его в другой раскладке.
По умолчанию double Shift исправляет 1 последнее слово. Области 2 слова
и 3 слова можно включить отдельно в трее.
- заложен первый системный слой
Typing Correction Core: входной текст теперь получает единый паспорт ошибки, класс ошибки, доску кандидатов и gate-решение; - deterministic typing-assist и NANDA-кандидаты проходят через общий
CandidateBoard, вместо разрозненного применения частных правил; - добавлены классы ошибок: wrong layout, mixed script, missing/extra/repeated letter, adjacent transposition, composite typo, split/glue, grammar, completion-only, technical/protected token;
- IME остаётся backend отображения/вставки: новый core не переносит принятие решений в IME и не меняет маршрут видимого preedit.
- общий рубильник
Журнал отладки действийтеперь реально гасит runtime debug JSONL-журналы, включая NANDA/IME trace; - runtime-журналы ограничены кольцевым хвостом 500 KiB, чтобы
cell_traceиprecognitionне разрастались во время живого набора; - добавлен контекстный guard для
b -> и: замена разрешается только внутри русской фразы с поддержкой слева и справа, без технических/ASCII-барьеров; - IME profile-тесты закрепляют различие Kitty terminal passthrough и managed commit для клиентов с surrounding text.
- добавлен и документирован экспериментальный IME backend: inline/preedit подсказки, Tab-принятие кандидата и committed-tail замены без clipboard;
- демо
docs/publicity/demo.gifобновлено: теперь показывает double Shift, smart-tail, IME-подсказку и автопомощь после пробела; - усилены guard-правила автозамены по живым логам: NANDA/L2 больше не должны
превращать нормальные фразы в смысловой дрейф вроде
модель генерит -> модель генерал.
- в окне настроек поменяны местами блоки
УправлениеиАрбитры и каналы, чтобы управление триггерами было в ожидаемой позиции.
- IME double Shift восстанавливает потерянную первую layout-букву в
терминальном passthrough-хвосте:
hbdtn -> привет,dnjpfvtyf -> автозамена; - mixed-script автозамена удаляет дублирующий латинский layout-префикс перед
русским словом:
fавтозамена -> автозамена; - NANDA Wave trainer умеет дообучать Cell32-память из успешных live-действий
typing-assist,ime-typing-assist,layout-replay,smart-text; - ручные
user-correctionне попадают в обучение по умолчанию и требуют отдельного opt-in флага.
- IME-подсказки больше не переводят уже напечатанный токен в активную композицию в терминальных клиентах без surrounding-text;
- это защищает Kitty/терминалы от рассинхрона preedit, потери пробела и склейки соседних слов после подсказки;
- генерация подсказок остаётся быстрой и работает как безопасный suffix-preedit.
- установщик больше не проверяет и не предлагает Ollama/smollm;
- при установке или обновлении выполняется миграция старых lay-установок:
legacy
ollama.service, бинарник и локальные модели Ollama удаляются; - если Ollama нужна пользователю отдельно от lay, перед установкой можно
сохранить её через
LAY_KEEP_OLLAMA=1 bash install.sh; - в настройках NANDA вынесена в отдельное окно: в основном меню осталась
кнопка
NANDA ячейки; - старый Expert64/microbrain runtime удалён, окно NANDA показывает только
реальный статус NANDA Wave из
lay-nanda-wave-eval --status-json; - live smoke harness научился использовать
LAY_CONFIG_PATH, чтобы тестировать временный config без подмены$HOMEи без поломки session bus.
- CI smoke-проверка на GitHub переведена на стабильный главный сценарий:
ghbdtn -> привет, без зависимости от словарной autocorrect-эвристики runner-а.
- починен публичный CI/status на GitHub: architecture guard синхронизирован с текущей структурой проекта и больше не проверяет удалённые модули;
- статус последнего коммита на странице репозитория больше не должен оставаться красным из-за устаревшего guard-скрипта.
- исправлен idle busy-loop в non-GNOME backend:
lay-daemonбольше не зацикливаетpoll()на 1 мс из-за stale focus-poll timestamp; - настройки демона кешируются по
mtimeс коротким интервалом проверки, чтобы горячий путь не читал~/.config/lay/config.jsonна каждом цикле; - русские горячие словари упакованы компактнее: текущая память свежего демона снизилась примерно со 168 МБ до 139 МБ после прогрева.
- исправлен Niri/backend-кейс без
focused_window_identity: при смене текстового поля буфер теперь разделяется поfield_context_epoch, поэтому хвост из одного поля не склеивается с вводом в другом поле; - добавлен регрессионный тест на сценарий без информации об окне.
- GNOME extension больше не пишет штатные success-сообщения в журнал при каждом
reload:
DBus enabled,DBus disabled,LayImpl enabled; - диагностические сообщения в GNOME journal оставлены только для ошибок и реально полезных предупреждений.
- режим
Смелеестал действительно смелее для одиночных раскладочных букв:zможет исправляться вя,b— ви, при этом нормальный режим эти короткие замены не включает; - короткий технический RU→EN перевёртыш
ьытеперь распознаётся какms; - усилены существующие typo-слои: соседняя клавиша ловит формы вроде
кнорку -> кнопку, а фразовый missing-letter может исправлять контекст вродес фалом -> с файлом; - область помощи при наборе отделена от области ручного double Shift: по
умолчанию double Shift остаётся
1 слово, а typing assist может смотреть короткий хвост отдельно; - окно настроек получило desktop entry и нормальную иконку в GNOME panel / Alt-Tab;
- иконки в GNOME tray, меню и окне настроек приведены к одному компактному размеру;
- часть пунктов меню настроек переведена на русский и дополнительно сжата по горизонтали.
- исправлен mixed-word рассинхрон в KDE/Kate и других backend: если слово почти целиком набрано в одной раскладке, а последняя буква пришла из другой, lay нормализует слово в доминирующую раскладку;
- живой проверочный кейс:
привеnпо double Shift становитсяпривет, без дробления наприве+n.
- добавлен Niri layout backend через прямой
niri-ipc; autoстал умнее: в KDE/Plasma VM с nested Niri он выбирает KDE, а не ошибается по старомуNIRI_SOCKET;- в GNOME и KDE tray добавлен ручной выбор среды раскладки:
auto / KDE / X11 / GNOME / Niri; - KDE tray показывает выбор среды в верхнем блоке меню и не закрывается после смены backend;
- Niri помечен как экспериментальный режим для реальной Niri-сессии, а не как обязательный выбор для KDE + nested Niri.
- откатили небезопасную GNOME/uinput speed-оптимизацию, которая в терминале работала, но в браузерных полях могла ломать double Shift replay;
- перед replay снова обязательно синхронизируются GNOME Shell и IBus, чтобы браузеры успевали принять фактическую раскладку;
- фиксы
b, коротких кириллических фрагментов иon/offиз0.1.213сохранены.
- standalone
bбольше не автозаменяется вв/ибез фразового контекста; - короткие кириллические фрагменты больше не улетают в случайный EN-токен,
например
ылне должен превращаться вsk; - технические короткие EN-слова
on/offоставлены разрешёнными для автопереворота; - GNOME/uinput speed-path был добавлен в этом релизе, но в
0.1.214откатан как ненадёжный для браузерных полей.
- GNOME tray разрезан на отдельные модули: DBus bridge, меню последних исправлений и общие helpers больше не лежат одним большим файлом;
- установщик, dev-reload и CI теперь копируют и проверяют все JS-модули расширения, а не только старый монолит;
- таблицы русской морфологии вынесены в
data/lexicon, чтобы runtime-код не превращался в склад списков; - встроенные сценарии
lay-test-inputвынесены вdata/test_input; - исправлен баг
protected_words.txt: пользовательские защищённые ASCII-слова больше не перебиваются LEM/LLM-скорингом, напримерcdне должен превращаться всвпосле пробела.
- KDE backend кэширует
qdbusи список раскладок вместо повторного запроса на каждый double Shift; - короткий KDE replay теперь использует тот же быстрый isolated-output путь, что и GNOME;
- проверено live в KDE/Plasma X11 VM.
Ориентировочные live-замеры KDE/Plasma VM:
- KDE: короткое слово
~54-67 ms; - KDE: backspace/replay для коротких хвостов
~0-1 ms; - основной остаток в KDE теперь тоже переключение layout.
- double Shift стал быстрее: если daemon успешно изолировал физическую клавиатуру через evdev grab, короткие замены выводятся без лишнего pacing;
- длинные хвосты остаются на paced-пути, чтобы приложения не теряли Backspace/replay события;
- debug-лог теперь показывает разрез времени по стадиям: layout, delete, insert/replay, total;
- ускоренный manual replay и typing assist проверены live в GNOME.
Ориентировочные live-замеры на тестовой машине:
- GNOME: manual double Shift на 2-3 слова
~40 ms; - GNOME: короткое слово
~53-62 ms, основной остаток — переключение layout; - GNOME: typing assist после пробела
~61-75 ms; - длинный хвост около 240 клавиш остаётся безопасно paced:
~1.1 s.
Установка одной командой:
curl -fsSL https://raw.githubusercontent.com/radislabus-star/lay-public/main/scripts/install-remote.sh | bashПосле установки выйди из сессии и зайди снова. Это нужно для группы input,
доступа к /dev/uinput и desktop-интеграции.
Проверка:
1. Включи русскую и английскую раскладки.
2. Набери ghbdtn.
3. Нажми Shift два раза.
4. Должно получиться привет.
Обновление:
cd ~/projects/lay && bash update.shВ GNOME и KDE обновление также доступно из меню трея: Проверить обновления.
- Double Shift исправляет последнее слово в другой раскладке.
- Replay физически перепечатывает хвост теми же keycode.
- Smart старается не трогать уже нормальные соседние слова.
- Помощь при наборе после пробела исправляет только уверенные ошибки.
- Автоподмена включает автоматические исправления после пробела.
- NANDA — экспериментальный клеточный слой внутри автоподмены; включается
отдельно в окне
NANDA ячейки. - ptah_alexs жёстко ставит раскладку для выбранных окон.
- Прямые RU/EN хоткеи могут включать конкретную раскладку без toggle.
- KDE/Niri/X11 backend есть, но покрытие меньше, чем у GNOME Wayland.
Пример Smart-сценария:
good ntrcn -> good текст
Здесь good остаётся на месте, а исправляется только ntrcn.
Для новой установки базовое поведение консервативное:
- double Shift включён;
- область double Shift —
1 слово; - автоматическая помощь после пробела выключена, пока пользователь сам её не включит;
- точная автоподмена выключена, пока пользователь сам её не включит;
- основной вывод идёт через
uinput; - среда раскладки выбирается автоматически:
layout_backend=auto; - сетевые LLM/API не используются.
Старые версии lay могли оставлять локальный ollama.service для экспериментов.
Новые установки и обновления его вычищают. Это часть перехода на локальный
deterministic/NANDA pipeline без фонового LLM-сервиса.
Настройки хранятся в:
~/.config/lay/config.json
Основная проверенная среда: Ubuntu/GNOME Wayland с RU/EN раскладками.
Текущая матрица:
- GNOME Wayland — основной и самый зрелый путь.
- KDE/Plasma Wayland — поддерживается, но покрытие меньше.
- Niri Wayland — есть backend через прямой
niri-ipc, требует проверки на реальной Niri-сессии. - X11 — есть native XKB backend, проверяется как экспериментальный путь.
- Sway/Hyprland/другие WM — пока не заявлены как поддержанные.
- Языки — текущая цель только RU/EN.
Поддерживаемые backend'ы:
- GNOME: Shell extension, tray и DBus bridge для переключения раскладки;
- KDE/Plasma: отдельный
lay-kde-trayи переключение черезqdbus6; - Niri: прямой IPC через Unix socket и crate
niri-ipc; - X11: native XKB backend через
x11rb.
По умолчанию используется layout_backend=auto. Обычно это правильный выбор:
GNOME выбирает GNOME, KDE/Plasma выбирает KDE, X11 выбирает X11, настоящая Niri
сессия выбирает Niri. Ручной выбор нужен только для диагностики или нестандартной
вложенной среды.
KDE, Niri и X11 моложе GNOME-пути. Если что-то ломается в другой сборке Linux, лучше открыть issue с точным примером: что набрано, что ожидалось, что получилось.
Текущая цель проекта — качественная пара RU/EN.
Используется:
- физическое соответствие US ↔ RU;
- Hunspell-словари, если они есть в системе;
- локальные RU/EN правила;
- char n-gram и LEM scoring;
- пользовательские точные замены;
- пользовательский список защищённых слов.
Не заявлено как готовое:
- другие пары раскладок;
- полноценная грамматика русского языка;
- исправление целых абзацев;
- универсальные серые подсказки во всех приложениях. Экспериментальный IME backend уже умеет preedit-кандидаты, но это отдельный режим, а не гарантированный путь для каждого текстового поля.
lay экспериментирует с маленькой локальной NANDA Wave-архитектурой. Это не
облачная LLM и сейчас не замена основного автокорректора. Основной runtime
остаётся детерминированным: словари, LEM/ngram, protected words, rule graph и
safe replacement pipeline. NANDA Wave отдельно изучает клеточные признаки,
кандидаты, ablation и ансамблевые моды.
Базовая единица:
Cell32 = 32 KB волновой клетки
Клетка маленькая по памяти, но может видеть весь короткий хвост предложения. Она не обязана отвечать только за одно слово. Текущие зоны:
L1сенсоры: UTF-8, письмо/форма, клавиатура, границы;L2кандидаты: раскладка, технические токены, фразовый сигнал;L3согласование: защитный контекст, фразовая связность, Mesh.
NANDA держится не на одном большом признаке, а на нескольких пространствах признаков:
layout— точное/обратное совпадение раскладки, расстояние до layout-кандидата;script— кириллица, ASCII, смешанные токены, переходы RU/EN;token_identity— известное русское/английское слово, technical, protected, CLI option;boundary— число слов, пробелы, склейка/разрыв, сохранение хвостового separator;shape— форма токена, регистр, цифры, пунктуация, дефисы;edit— edit distance, replacement span, длина правки;risk— plain-layout risk, technical/protected risk, prefix deletion risk;context— последовательность типов токенов в коротком хвосте.
Это важно: одинаковый сырой бюджет памяти может иметь разную топологию. Монолит хранит всё в одном пространстве, а ансамбль раскладывает признаки по органам: layout, guard, context/space.
Текущая цель по масштабу:
- минимальный живой мозг:
16active-клеток; - нормальный локальный организм:
64warm-клетки; - большой персональный мозг: до
1024клеток в локальной памяти.
Это не число ради числа. Клетка считается живой только если ablation показывает пользу: отключили клетку — ухудшился именно её класс задач. Если отключение ничего не меняет, клетка декоративная и должна уйти в сон или быть удалена.
Важная часть NANDA Wave — искать моды не только внутри одной клетки, а в ансамбле.
Ensemble Mode — устойчивый паттерн совместной активации Cell32-клеток,
который причинно отвечает за класс решений.
Пример безопасного wrong-layout режима:
layout_writer high
layout_signal high
space_boundary high
technical_guard low
undo_guard low
sentence_mesh high
=> apply
Пример режима запрета:
layout_writer high
layout_signal high
technical_guard high
cli_guard high
sentence_mesh low
=> keep original
Иными словами, ответ не обязан жить в одной клетке. Он появляется как
когерентный пик нескольких независимых сигналов. Mesh делает несколько коротких
вычислительных тактов без задержек ввода: если пик устойчивый — исправление
можно применить; если клетки спорят — lay молчит.
Клетки не должны хаотично самообновляться во время печати. Обучение должно быть отдельным локальным процессом:
- пользователь даёт главный сигнал истины: оставил, удалил, откатил, перепечатал, добавил protected word;
- deterministic
layдаёт безопасные initial labels: layout, словари, n-gram, LEM, protected words, replacement safety; - старший teacher/arbiter может помогать разбирать спорные случаи и создавать synthetic training cases, но не должен становиться постоянным runtime-мозгом;
- offline trainer собирает fixtures, synthetic cases, learning log, user corrections и ablation reports;
- Mesh supervisor учит не одну клетку, а связи: какие сочетания клеток усиливать и какие гасить.
Схема:
user feedback
+ deterministic labels
+ teacher labels
+ synthetic cases
-> trainer
-> new Cell32 candidate
-> eval
-> ablation
-> promote or reject
Runtime остаётся безопасным: клетки не печатают напрямую в систему. Они предлагают или оценивают кандидаты, а вывод всё равно идёт через существующий safe replacement pipeline.
Текущий статус NANDA: старый Expert64/microbrain runtime удалён. В коде остался NANDA Wave-слой: Cell32-паспорт, L1/L2/L3, Wave trace, real-suite, status JSON и ablation.
Проверка Wave-слоя:
lay-nanda-wave-eval --status-json
lay-nanda-wave-eval --trace "djn "
lay-nanda-wave-eval --real-suite --ablationКлетку нельзя делать главной только потому, что она существует. Минимальный
критерий: lay-nanda-wave-eval не ухудшает baseline, а ablation показывает, что
отключение клетки ухудшает её конкретный класс задач.
Сравнение 64x3-vs-192 пока остаётся исследовательской задачей, а не
production-командой.
Для ансамбля критерий жёстче. Это называется LayMesh Ensemble Mode Criterion:
synergy(E, C) =
quality(E, C) - max_i quality({e_i}, C)
ablation_drop(e_i, E, C) =
quality(E, C) - quality(E without e_i, C)
Ансамблевая мода считается найденной только если одновременно верно:
synergy(E, C)выше порога: связка лучше любой одиночной клетки;ablation_dropключевой клетки заметный: разрушение связки ломает эффект;false_positive_deltaне вырос: мода не шумит на чужих классах;stabilityподтверждена на разных split-корпуса;localityподтверждена: улучшение живёт в своём классе ошибок.
То есть мода — это не просто рост общей accuracy. Это устойчивый причинный контур: несколько клеток вместе дают способность, которой нет у клеток по отдельности, и эта способность исчезает при разрушении связки.
lay-nanda-wave-eval --real-suite --ablation печатает текущие признаки:
synergy_vs_best_single
synergy_vs_best_pair
ablation_drop
false_positive_delta
stability
locality
mode_status
Если отчёт пишет mode_status: ensemble_mode_found, связка прошла критерий.
Если отчёт пишет too_easy_or_redundant, корпус не доказывает новую моду:
одиночные клетки уже справляются или связка ничего причинно не добавляет. Если
пишет rejected_false_positives, связка полезна в своём классе, но опасно
портит чужие случаи.
lay сознательно работает с коротким хвостом текста, который daemon видел через
evdev. Это делает основной сценарий быстрым, но задаёт границы:
- не исправляет произвольное слово под курсором после ручного перемещения;
- не меняет выделенный текст как универсальную функцию;
- не читает весь текст поля и не знает весь документ;
- Enter-autocorrect не включён в публичный стабильный UI, потому что evdev/uinput не может гарантировать порядок "исправить хвост, потом отправить Enter" во всех приложениях;
- IME/preedit и inline-подсказки доступны как экспериментальный режим ввода, но не заменяют текущий быстрый uinput-путь;
- автопомощь после пробела остаётся консервативной: лучше пропустить сомнительный случай, чем самовольно испортить текст.
Основные пункты:
Помощь при наборе— осторожная правка после пробела.Автоподмена— главный рубильник автоматических исправлений после пробела.NANDA ячейки— отдельное окно с клеточным Wave-слоем, статусом и ablation.Режим—ReplayилиSmart.Режим ввода— быстрый uinput или экспериментальный IME backend с preedit-кандидатами.Область— сколько слов брать для double Shift, по умолчанию1.Арбитр— LEM и auto-layout настройки.ptah_alexs— жёсткая раскладка по окну.Daemon— запуск, остановка и статус сервиса.О программе— версия, ссылка на GitHub и служебная информация.
lay можно использовать из терминала:
lay "Ye djn ghbvth"
# Ну вот пример
lay "руддщ цщкдв"
# hello world
echo "ghbdtn" | lay
# приветlay-daemon читает клавиатурные события локально, потому что иначе double
Shift rescue невозможен. По умолчанию он не отправляет набранный текст в сеть,
не требует удалённой модели и не ведёт полный keylog.
Опциональный learning log локальный и выключен по умолчанию:
~/.local/share/lay/corrections.jsonl
Диагностические файлы и счётчики тоже локальные:
~/.local/share/lay/recent_actions.jsonl
~/.local/share/lay/learning_candidates.json
~/.local/share/lay/stats.json
На Unix такие файлы создаются с правами 0600.
Стабильное ядро: ручной double Shift и локальная RU/EN конвертация.
Активно оттачиваются:
- автопомощь после пробела;
- пробелы и границы слов после автозамены;
- mixed RU/EN сценарии;
- KDE/X11 edge cases;
- работа в старых/особых текстовых полях;
- экспериментальный IME backend и preedit-кандидаты в разных приложениях.
Если присылаешь bug report, укажи:
- что набрано;
- что ожидалось;
- что получилось;
- GNOME/KDE/Niri/X11 и версия системы;
- включены ли
Помощь при наборе,Автоподмена,Smart, LEM.
Приватный текст перед отправкой лучше заменить на безопасный пример.
- Как это работает
- Проверочный список архитектуры
- Multi-tap Shift scope
- Research: Linux input correction best practices
- Публичные материалы
cargo test
cargo build --release
bash install.shПолная локальная проверка перед публикацией:
scripts/check-lay-full.shlay is a local Double Shift RU/EN layout rescue tool for Linux desktops.
Main workflow:
Typed: ghbdtn
Press: Shift Shift
Result: привет
Quick install:
curl -fsSL https://raw.githubusercontent.com/radislabus-star/lay-public/main/scripts/install-remote.sh | bashAfter installation, log out and log back in so the input group, /dev/uinput
permissions, and desktop integration are picked up.
Main tested target: GNOME Wayland with RU/EN layouts. KDE/Plasma Wayland and Niri Wayland are supported with a smaller compatibility matrix. X11 has a native XKB backend and is treated as experimental. Other layouts and non-RU/EN pairs are not supported yet.
Known limitations: lay works on a short typed tail, not arbitrary selected
text or the whole document. Enter autocorrect is not the stable default path.
IME/preedit-style inline assistance exists as an experimental input backend, but
the fast uinput path remains the default.
By default lay does not use cloud APIs, does not require an LLM, and does not
send typed text anywhere.
MIT