BUTTON-S — ускоритель ввода для macOS

# BUTTON-S **Печатайте в любом приложении — BUTTON-S исправляет раскладку, опечатки и берёт на себя рутину.** BUTTON-S — небольшой фоновый помощник для macOS, который живёт в строке меню и не занимает Dock. Он понимает, что вы набрали не в той раскладке, исправляет опечатки, продолжает списки, подсказывает голосом и работает с текстом через ИИ. Всё это — поверх любых приложений: браузера, мессенджера, редактора, почты. **Версия 1.0.0 · macOS 13+ · Windows и Linux — следом · без подписок · без телеметрии.** > **Платформы.** Сейчас тестируется версия для **macOS** — релиз уже совсем скоро. > Следом выйдут версии для **Windows** и **Linux**. Официальные сборки и исходники — > в этом репозитории, готовый DMG появится в разделе **Releases**.

Поддержать проект: DonationAlerts — это ускоряет релиз macOS-версии и порт на Windows и Linux.

## Проблема Мы печатаем быстро и постоянно спотыкаемся об одно и то же: - набрали `ghbdtn`, а нужен «привет»; - переключили раскладку и не заметили; - слово с опечаткой ушло клиенту; - Shift залип, и половина слова — ЗАГЛАВНЫМИ; - список после Enter пришлось начинать вручную; - нужно быстро переписать или перевести выделенный текст, а не открывать ещё одну вкладку. Мелочи. Но их много, и они съедают внимание каждый день. ## Решение BUTTON-S встраивается в ввод на уровне macOS и исправляет это **на месте**, пока вы печатаете. Никаких копирований, вставок и переключений окна: набрали слово, поставили пробел — текст уже исправлен. Приложение не мешает: его нет в Dock, настройки открываются из строки меню, а все функции можно выключить одним тумблером. ## Почему BUTTON-S - **Работает в любом приложении.** Браузер, Telegram, Slack, VS Code, почта, заметки — везде, где есть текстовый курсор. - **Локально и приватно.** Словари, модели Whisper и локальные LLM работают на вашем Mac. Приложение не имеет своего сервера, не собирает телеметрию и не отправляет текст без вашего явного выбора облачного провайдера. - **Не мешает.** Живёт в строке меню, не занимает Dock, не перехватывает управление. В защищённых полях и менеджерах паролей отключается автоматически. - **Экономит время.** Одна автозамена раскладки уже убирает десятки раздражающих правок в день. Опечатки, капитализация, списки и хоткеи — сверху. - **Голос без облака.** Whisper распознаёт русскую и английскую речь локально. Аудио не покидает компьютер. - **ИИ — по желанию.** Подключите облачный сервис по своему ключу или скачайте локальную модель и работайте офлайн. Ключи хранятся в связке ключей macOS. - **Настраивается под вас.** Личный словарь, исключения для отдельных приложений, свои автозамены и горячие клавиши. ## Что умеет ### Автоподмена раскладки Набрали `ghbdtn` — после пробела получилось `привет`. Набрали `руддщ` — получилось `hello`. BUTTON-S смотрит на слово, проверяет его по частотным словарям RU/EN и меняет раскладку только тогда, когда это действительно нужно. Раскладка переключается автоматически. Есть и ручной режим: выделите слово или текст и нажмите хоткей. ![Главный экран BUTTON-S: статус, разрешения и возможности](docs/assets/readme/capabilities.png) *Один экран настроек: включить нужное можно одним тумблером.* ### Опечатки, автозамены и порядок в тексте - Исправление опечаток по словарю, а не наугад. - Автозамены: `--` → `—`, `->` → `→`, `(c)` → `©`. - Капитализация после точки, восклицательного и вопросительного знака. - Исправление залипшего Shift: `ППривет` → `Привет`. - Продолжение списков: `1.`, `2.`, `a)`, `-`, `•`. - Отмена последней автозамены одним хоткеем. Все встроенные автозамены по умолчанию **выключены** — включите нужные в разделе «Замены», чтобы они не мешали в коде. Порядок работы предсказуемый: сначала автозамены, потом опечатки, потом раскладка. ### Голосовой ввод Удерживайте **Right Shift** и говорите — текст появится там, где стоит курсор. Отпустите клавишу — текст вставится. Поддерживаются режимы «удерживать клавишу», «нажал — говоришь» и авто-остановка по тишине. Right Shift назначен по умолчанию; для заглавных букв удобнее использовать левый Shift. Комбинацию можно изменить в настройках голоса. Пять моделей Whisper — от лёгкой Tiny до Large Turbo. Модель скачивается один раз и работает локально; аудио не отправляется в интернет. Язык — русский, английский или автоопределение. ![Голосовые модели Whisper с размерами и характеристиками](docs/assets/readme/voice.png) *Whisper Tiny, Base, Small, Medium и Large Turbo — под разное железо и задачи.* ### ИИ и перевод ИИ умеет переписать, сократить, исправить или перевести выделенный текст. Есть два пути: - **облачный провайдер** — OpenAI-совместимый сервис, Anthropic или Ollama по вашему API-ключу; - **локальная модель** — скачивается один раз и работает без интернета. Встроенные действия: «Исправить орфографию», «Сократить», «Переписать официально», «Суммировать», «Ответить на письмо». Можно добавить свои промпты, назначить им хоткеи и выбрать, куда выводить результат: заменить выделение, показать в окне, скопировать или дописать. ![Экран ИИ: облачные провайдеры и локальные модели](docs/assets/readme/ai.png) *Облако или локальная модель — переключается в один клик. Всё, что нужно, объяснено прямо на экране.* ### Личный словарь Добавьте имена, термины, названия компаний и всё, что BUTTON-S не должен исправлять. Слова из словаря имеют приоритет над опечатками и автозаменой. Можно добавить слово из выделения — без ручного ввода. ![Личный словарь BUTTON-S](docs/assets/readme/dictionary.png) *Личный словарь: имена и термины, которые приложение не трогает.* ### Исключения для приложений Не хотите, чтобы BUTTON-S работал в банковском приложении или редакторе кода? Нажмите «Обзор», выберите `.app` — и выключите его одним тумблером. Терминалы и менеджеры паролей исключены всегда: это защита, а не настройка. ![Список приложений и исключения по умолчанию](docs/assets/readme/apps.png) *Список приложений пуст, пока вы сами не добавите нужное.* ## Горячие клавиши | Действие | По умолчанию | |---|---| | Конвертировать последнее слово | `⌥⌘Z` | | Конвертировать выделение | `⌥⌘L` | | Отменить последнюю замену | `⌥⌘⌫` | | Диктовка | `⇧ Right` (удерживать) | | Перевести RU → EN | `⌥⌘T` | | Перевести EN → RU | `⌥⌘⇧T` | | ВЕРХНИЙ регистр | `⌥⌘U` | | нижний регистр | `⌥⌘⇧U` | | Начинать С Заглавных | `⌥⌘I` | | Инвертировать регистр | `⌥⌘⇧I` | | Исправить текст через ИИ | `⌥⌘F` | | Пауза всех функций | `⌥⌘P` | Все сочетания меняются в настройках. Для голоса и ИИ хоткей можно записать прямо в соответствующем разделе. ## Приватность и безопасность - **Нет собственного сервера.** BUTTON-S не собирает статистику и не отправляет текст «куда-то» по умолчанию. - **Локальные модели.** Whisper и локальные LLM работают на вашем Mac; аудио и текст не уходят в облако. - **Облако — только по вашему выбору.** Если вы подключили провайдера, запрос уходит только ему. Ключи хранятся в связке ключей macOS и не попадают в конфиг. - **Защищённые поля.** В полях с secure input ввод не буферизуется и не исправляется. - **Менеджеры паролей** исключены из всех функций. - **История в интерфейсе не ведётся.** - **Никакой телеметрии и скрытых сетевых запросов.** Подробнее — в [SECURITY.md](SECURITY.md). ## Для кого - Тем, кто много печатает и устал от раскладки и опечаток. - Тем, кто работает в браузере, мессенджерах, почте и редакторах кода. - Тем, кто хочет голосовой ввод и ИИ, но не хочет отправлять рабочий текст в облако. - Тем, кто ценит нативный macOS-интерфейс без тяжёлых подписок и лишних окон. ## Установка **Требования:** macOS 13+ (Apple Silicon). Приложение работает в строке меню и не показывает иконку в Dock. 1. Скачайте DMG из раздела **Releases** этого репозитория. 2. Откройте DMG и перетащите **BUTTON-S** в `Applications`. 3. Запустите приложение. Сборка не нотаризована, поэтому при первом запуске может понадобиться правый клик → **Открыть**. 4. Выдайте разрешения: - **Универсальный доступ** — чтобы вставлять исправленный текст; - **Мониторинг ввода** — чтобы перехватывать клавиатуру; - **Микрофон** — только для диктовки. 5. Перезапустите BUTTON-S, если macOS попросит. 6. Проверьте: наберите `ghbdtn` и поставьте пробел — должно получиться `привет `. Модели Whisper (от 78 МБ до 1,6 ГБ) и локальные LLM (от 250 МБ до 2,5 ГБ) скачиваются отдельно, по вашему действию. В установщик они не входят. Как проверять и ставить новые версии вручную — [UPDATES.md](UPDATES.md). ## Техническая основа - **Tauri 2** + **Rust** — нативный бэкенд, перехват ввода и инъекция через CGEvent. - **Svelte 5 (runes)** + **TypeScript** + обычный CSS — интерфейс без тяжёлых UI-фреймворков. - **Whisper** через `whisper-rs` — локальное распознавание речи. - **llama.cpp** через `llama-cpp-2` — локальные LLM. - **SQLite** — локальные данные; **Keychain** — секреты. ## Сборка из исходников Нужны Node.js 20+, Rust stable, Xcode Command Line Tools и CMake (для `llama-cpp-2` и `whisper-rs`). ```bash npm install npm run tauri dev ``` Проверки: ```bash npm run check npm run build cargo test --manifest-path src-tauri/Cargo.toml cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets npx tauri build ``` Release-сборка создаёт `.app` и `.dmg` в `src-tauri/target/release/bundle/`. ## Что дальше - Полировка UX по реальному использованию. - Windows и Linux — после стабилизации macOS-версии. - Больше локальных моделей и сценариев для ИИ. - Автообновление и подпись релизов. ## Лицензия и участие BUTTON-S распространяется по модели **source-available**: исходники открыты для просмотра и изучения, но это не open-source-проект. - **Официальные сборки** можно бесплатно использовать в любых целях, включая коммерческие. - **Модификация** приложения и **перепродажа/лицензирование** его или изменённых версий требуют предварительного письменного разрешения автора. - **Авторство обязательно:** `BUTTON-S by Михаил Базаров (https://bazarow.ru)`. - Полный текст: [LICENSE.md](LICENSE.md) - Безопасность: [SECURITY.md](SECURITY.md) - Как участвовать: [CONTRIBUTING.md](CONTRIBUTING.md) - Кодекс поведения: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) - Лицензии сторонних словарей: [NOTICE.txt](NOTICE.txt)

Button-S-local-corrector

Описание

Языки