Документация

CapyBro — это Windows tray-утилита которая пускает AI в вашу повседневную работу с текстом без единого лишнего шага. Выделили текст в Word, Chrome, VS Code, Slack, Notepad — где угодно → нажали глобальный хоткей (Ctrl+Shift+E по умолчанию) → AI переписал по вашему промпту → новый текст уже стоит на месте выделенного.

Никаких вкладок браузера, copy-paste в ChatGPT и обратно, никаких ручных промптов каждый раз. Работает офлайн-насколько-возможно: один HTTPS-запрос к OpenRouter (десятки моделей через единый аккаунт — GPT-4o, Claude, Gemini, Llama и т.д.), остальное — локально. Native .NET 8 / WPF, без Electron. Сидит в системном трее и просыпается только на ваш хоткей.

Скачать

Скачайте последний релиз с GitHub Releases — файл CapyBro-Setup-2.0.0.exe (~48 MB). Или зайдите на capybro.app — там всегда свежая ссылка.

Запустить инсталлятор

Запустите инсталлятор → мастер в 3 клика → готово. Иконка появится в системном трее возле часов. Инсталлятор per-user — НЕ требует админ-прав, ставится в %LOCALAPPDATA%\CapyBro\.

Через winget

Есть Windows Package Manager (winget — встроен в Windows 11 и свежие Windows 10)? Это самый быстрый путь: одна команда в PowerShell или Terminal скачивает и устанавливает CapyBro из официального манифеста.

Обновление в любой момент — winget upgrade RomanTykhonenko.CapyBro, удаление — winget uninstall RomanTykhonenko.CapyBro.

Первый запуск открывает onboarding-визард из 4 шагов:

1. Приветствие + язык интерфейса — краткое интро и селектор языка (English / Українська / Русский). Переключение здесь мгновенно перерисовывает весь визард, чтобы вы могли читать следующие шаги на своём языке.
2. API-ключ OpenRouter — вставьте ключ с openrouter.ai/keys. Визард пингует /credits через 400 мс после последнего нажатия и показывает зелёную галочку или ошибку. Нет ключа? Пропустите — позже можно переключиться на Ollama в Настройках → Провайдер.
3. Горячие клавиши — три комбинации сразу: улучшение (Ctrl+Shift+E), меню промптов (Ctrl+Shift+Q), undo (Ctrl+Shift+Z). Конфликты с уже зарегистрированными системными хоткеями подсвечиваются сразу.
4. Готово — выделите текст в любой программе, нажмите хоткей, наблюдайте магию.

После onboarding'а: tray-иконка → Settings → вкладка Промпты. Создайте несколько промптов под свои сценарии: «исправь ошибки», «переведи на английский», «сделай формальнее», «сократи до 100 слов», «объясни проще» и т.д.

Системный трей

После запуска иконка-капибара появляется в системном трее возле часов. Hover — подсказка CapyBro (если активен OpenRouter, по умолчанию) или CapyBro · Ollama (если локальный провайдер). Между запусками хоткея у приложения нет главного окна — всё доступно через трей.

• Левый клик по иконке → открывает окно Настроек.
• Правый клик по иконке → контекстное меню с тремя пунктами: Настройки, История, Выйти. «Выйти» запускает graceful shutdown — pending writes flush, in-flight HTTP запросы отменяются чисто.

Окно настроек — четыре вкладки в сайдбаре

• Настройки — провайдер, API-ключ, дефолтная модель, хоткеи, автозапуск, Pro-лицензия, экспериментальные флаги, Danger zone (Сброс).
• Промпты — управление библиотекой промптов и выбор дефолтного. Pro-пользователи также получают браузер Наборов промптов здесь.
• История — последние 50 улучшений (видима когда тоглер Истории включён — по умолчанию да). Поиск, копирование назад оригинала или результата, удаление отдельных записей или очистка всего.
• Статистика — Pro-фича, видима всем, но locked для free tier с teaser-панелью. Headline-цифры, breakdown по моделям, график активности за 30 дней, Reset.

В footer-е сайдбара — версия + ссылка capybro.app и (если вы на Ollama) маленький outlined «Ollama» pill, чтобы вы всегда знали какой бэкенд активен.

Все хоткеи регистрируются через Win32 RegisterHotKey с MOD_NOREPEAT, поэтому работают глобально поверх любой программы. Конфликты с системными / другими утилитами определяются сразу: onboarding-визард и Настройки → Общие подсвечивают конфликтный хоткей красным.

Создавайте/редактируйте свои сценарии: исправить ошибки, перевести, сократить, формальнее, дружелюбнее, technical-style, marketing-tone и т.д. Каждый промпт может иметь:

• Свою модель (override default для именно этого промпта — сначала включите «Модель для каждого промпта» в Дополнительных функциях).
• Отдельную модель по провайдеру — если у вас настроены и OpenRouter, и Ollama, промпт запоминает разную модель для каждого.
• Diff preview перед применением (включено по умолчанию — можно выключить per-prompt или глобально, если хотите instant paste).

Меню промптов (Ctrl+Shift+Q)

Toast со списком ваших промптов. Стрелки + Enter для выбора, Esc для отмены, цифры 1-9 как быстрый доступ. Popover автоматически закрывается когда клик уходит в другой процесс (foreground-window polling).

Наборы промптов (Pro)

Вкладка Промпты → справа вверху кнопка Наборы промптов. Просмотрите 5 курированных наборов — Юридический / Маркетинг / Академический / Code review / Бизнес — по ~10 промптов каждый (~50 всего). Нажмите Установить, чтобы скопировать промпты набора в вашу библиотеку; конфликты имён получают суффикс 2 / 3, чтобы ничего из ваших существующих не перезаписалось. Бейдж «Установлено» отмечает наборы, которые вы уже добавили.

CapyBro v2.0 поддерживает два бэкенда — переключаются одной галочкой в Настройках → Провайдер:

• OpenRouter (облако, по умолчанию) — быстро, широкий выбор моделей (GPT-4o, Claude, Gemini, Llama и т.д.), pay-as-you-go. Нужен API-ключ с openrouter.ai/keys.
• Ollama (локально) — для тех, кто категорически не хочет отправлять текст в облако. Запустите ollama, скачайте любую модель (ollama pull gemma3), нажмите «Обновить модели» — весь pipeline работает офлайн.

Как переключиться на Ollama

1. Установите Ollama и запустите ollama serve (обычно auto-start после установки).
2. В терминале: ollama pull gemma3 (или любую другую модель из библиотеки).
3. Настройки → Провайдер → ✓ «Использовать локальную модель (Ollama)». CapyBro делает health-check: если ollama serve не запущен, появляется toast-предупреждение и галочка возвращается в OpenRouter.
4. Настройки → Локальные модели (Ollama) → нажмите кнопку обновления. Появится список тегов которые вы pull-нули. Выберите один.
5. Готово — Ctrl+Shift+E работает как всегда, но через локальный backend.

Вкладка История

Включено по умолчанию. Сохраняет оригинал / результат / промпт / модель / время последних 50 запусков. Вкладка История имеет поле поиска (debounce 150 мс), записи сгруппированы по Сегодня / Вчера / На этой неделе / Раньше, и подробный viewer с кнопками-иконками copy для оригинала и результата. Удалить отдельную запись можно из шапки деталей, или очистить всё кнопкой «Очистить всё».

Отключается в Настройки → Дополнительные функции → снимите галочку «История». Файл: ~/.ai_text_improver_v2_history.json.

Экспорт истории (Pro)

Сверху вкладки История — кнопка Экспорт. Выбор CSV (удобно для таблиц: Timestamp, Original, Improved, Prompt, Model, HotkeyKind) или JSON (полная структура). Полезно для архивирования, передачи команде или внешнего анализа паттернов редактирования.

Diff preview

Сравнение оригинала + AI-результата side-by-side с подсветкой изменений перед тем, как что-то попадёт в документ. Три действия: Принять (вставить), Перегенерировать (повторить с тем же промптом), Отклонить (отменить + восстановить буфер). Удобно для длинных текстов, где одним взглядом не увидишь что изменилось.

Включено по умолчанию для всех промптов — стандартных и кастомных. Отключить per-prompt можно чекбоксом в редакторе промптов, или глобально через master-toggle в Настройки → Дополнительные функции.

Редактировать результат (toggle справа сверху): переключает правую панель с read-only diff на редактируемое текстовое поле. Подправь AI-результат вручную — и Принять сохранит именно твою отредактированную версию (не сырой AI-выход).

Streaming-тост

Потоковое отображение генерации — видно как AI печатает. Не блокирует вашу работу — можете продолжать делать что угодно, пока AI генерирует. Кнопка ✕ отменяет запрос мгновенно. Переключатель в Настройки → Дополнительные функции.

Pro — одноразовая покупка ($9 через Gumroad). Разблокирует пять фич в дополнение к бесплатной версии. Каждая из них видна пользователям free tier — с маленьким outlined «Pro» pill — чтобы вы видели, что именно получаете. Клик по locked-действию показывает тост со ссылкой на страницу покупки.

1. Экспорт истории в CSV / JSON

Упомянуто выше. Экспорт всех 50 записей истории в один клик в CSV (для таблиц) или JSON (полная структура).

2. Резервное копирование и восстановление настроек

Настройки → Общие → карточка Резервное копирование. Сохранит весь конфиг — промпты, модели, хоткеи, язык, флаги — в портативный JSON-файл, который можно перенести на другую машину или сохранить как снимок перед экспериментами. Важно: бэкап НЕ содержит ваш API-ключ и Pro-лицензию (из соображений безопасности и портативности — это per-machine). Восстановление сохраняет текущую лицензию этой машины, так что сам бэкап остаётся портативным.

3. Хоткей переключения моделей

Настройки → Общие → карточка Переключение моделей. Закрепите 2–3 модели в слотах, затем нажимайте Ctrl+Shift+M (можно переназначить) где угодно, чтобы циклически переключаться между ними. Отдельные наборы по провайдеру: OpenRouter имеет свой набор закреплённых моделей, Ollama — свой, переключение провайдера сохраняет оба. Работает во время выполнения запроса — хоткей обходит single-in-flight guard, так что если модель «тормозит», можно мгновенно повторить с другой.

4. Премиум наборы промптов

Пять курированных наборов по ~10 промптов каждый (~50 всего): Юридический, Маркетинг, Академический, Code review, Деловая переписка. Каждый промпт на трёх языках (English / Українська / Русский). Просматривать и устанавливать — с вкладки Промпты → справа вверху кнопка Наборы промптов. Установка сливается с вашей библиотекой — конфликты имён получают суффикс 2 / 3, так что ваш кастомный набор никогда не перезаписывается.

5. Статистика использования

Четвёртая вкладка в Настройках. Три карточки: Обзор (общее количество улучшений, total characters, total spent, активен с), По моделям (run-count + расходы по моделям), Активность 30 дней (барчарт по дням). Статистика записывается безусловно для каждого успешного улучшения — это только счётчики, без текста — поэтому данные есть, даже когда тоглер Истории выключен. Файл: ~/.ai_text_improver_v2_stats.json. Reset — кнопка в карточке Обзор.

Как активировать

1. Купите ключ на Gumroad — см. раздел pricing на capybro.app.
2. Gumroad пришлёт вам лицензионный ключ на email после покупки.
3. Настройки → Общие → карточка Pro-лицензия → вставьте ключ в единственное поле ввода → Активировать. Email вводить никуда не нужно — почта покупателя приходит с Gumroad автоматически и показывается под статусом «Pro активирован».
4. Если ключ валидный, мгновенно появляется бейдж «✓ Pro активирован», в заголовке окна светится «Supporter», и все пять Pro-фич разблокируются.

CapyBro по-умолчанию собирает ZERO телеметрии — никакой analytics, crash reporting, опросов. Все сетевые запросы — это только ваши запросы к OpenRouter (один HTTPS-call на хоткей). Больше ничего никуда не идёт.

Маскирование PII (экспериментально)

Настройки → Дополнительные функции → Маскирование PII автоматически заменяет перед отправкой в модель: email → <<EMAIL_n>>, телефоны → <<PHONE_n>>, URLs → <<URL_n>>, кредитные карты → <<CARD_n>>, IBAN → <<IBAN_n>>, ФИО (heuristic) → <<NAME_n>>. После ответа AI оригинальные значения подставляются назад — модель никогда не видит ваших реальных PII.

У CapyBro три независимых хранилища — настройки, история и статистика. У каждого из них внутри приложения есть собственная кнопка сброса в один клик. Удалять файлы вручную не нужно.

Сбросить настройки (самый частый случай)

Настройки → Общие → пролистайте вниз → Danger zone → Сбросить настройки. Появится диалог подтверждения. На ДА произойдут три вещи сразу:

• Файл конфига перезаписывается дефолтами — промпты, хоткеи, язык, списки моделей, экспериментальные флаги, все сбрасываются.
• Ваш OpenRouter API-ключ удаляется из Windows Credential Manager.
• Ваша Pro-лицензия (если была) деактивируется — бейдж «Supporter» исчезает, Pro-фичи снова блокируются.

Очистить историю

Настройки → История → Очистить всё. Очищает JSON с 50 записями. Перед действием — диалог подтверждения.

Сбросить статистику

Настройки → Статистика → Сбросить статистику (вверху карточки Обзор). Обнуляет все счётчики и bucketed-данные. Pro-only — вкладка видна всем, но действие сброса требует активной лицензии.

Отключить автозапуск

Настройки → Общие → Система → снимите «Запускать с Windows». Убирает запись в реестре HKCU\Software\Microsoft\Windows\CurrentVersion\Run\CapyBroV2. Состояние галочки само по себе — часть конфига, так что Reset не тронет запись автозапуска, если вы её до того включили.

Снова увидеть onboarding-визард

Reset не возвращает onboarding-визард — флаг «onboarding выполнен» тоже есть в дефолтном конфиге, который пишется при Reset. Если хотите действительно свежий first-run, закройте приложение (трей → Выйти), откройте ~/.ai_text_improver_v2_config.json в текстовом редакторе, найдите "OnboardingCompleted": true и установите false. Перезапустите — визард появится снова.

Хоткей не реагирует

1. Проверьте, не занят ли этот хоткей другой утилитой (например, Snipping Tool Ctrl+Shift+S конфликтует).
2. Настройки → Общие → блок «Горячие клавиши». Конфликт подсвечивается красным с подсказкой.
3. Измените на что-то уникальное вроде Ctrl+Alt+Shift+E.

AI возвращает перевод вместо исправления (или наоборот)

Откройте промпт в Настройки → Промпты и перепишите его эксплицитнее («Исправь ошибки тем же языком, не переводи»). Модель делает то, что говорит промпт — если промпт неоднозначный, модель решает за вас.

Toast исчез, но новый текст не появился

• Проверьте, есть ли в целевой программе фокус на текстовом поле. CapyBro вставляет через clipboard + Ctrl+V — поле должно принимать paste.
• Некоторые sandbox-приложения (UWP / WSA) блокируют keyboard automation. Результат уже в вашем clipboard — вставьте Ctrl+V вручную.

Как отменить неудачное улучшение

Нажмите Ctrl+Shift+Z сразу после нежелательного результата. CapyBro восстановит оригинал из in-memory кэша (или из файла истории, если она включена). Работает один раз — для более старых улучшений откройте вкладку История и нажмите иконку copy-original на нужной записи.

Предупреждение «Неизвестный издатель» при установке

Инсталлятор сейчас неподписан (SmartScreen accumulation period). Сейф — нажмите «Подробнее» → «Выполнить в любом случае». Или подождите, пока инсталлятор подпишут сертификатом.

Settings окно не открывается

• Иконка в трее должна быть жива (не Windows-серая). Если серая — приложение упало. Перезапустите из Start menu.
• Лог: %USERPROFILE%\.ai_text_improver_v2*.log — там будет stack trace.

Работает ли на Windows 10?

Да, минимальное требование — Windows 10 1809 (для WPF / DPI awareness). Большинство фич прозрачно деградируют на старых билдах (Mica → solid background).

Работает ли на macOS / Linux?

Нет. Зависит от Win32 API (RegisterHotKey, SendInput, Credential Manager, NotifyIcon). Порт возможен через другой stack (Avalonia + alternative tray + keyring), но это переписанный с нуля проект.

Интересно, как CapyBro смотрится на фоне других AI-инструментов для текста? Side-by-side сравнения с таблицами фич и инструкциями перехода:

• CapyBro против Grammarly — бесплатная open-source альтернатива, работающая в любом Windows-приложении, а не только в браузере и MS Office.
• CapyBro против ChatGPT Desktop — те же модели (GPT, Claude, Gemini через OpenRouter), но доступны по глобальной горячей клавише, а не в одном chat-окне.
• CapyBro против Slashit App — open-source альтернатива AppSumo lifetime deal, с локальным режимом Ollama для приватности.

• Проект: capybro.app · GitHub repo · Releases
• API провайдер: OpenRouter · API docs
• Локальная LLM: Ollama · Библиотека моделей