# Application Context в superwhisper
Настройка режима, при которой в промпт языковой модели подмешивается текст
из активного окна. Помогает правильно записывать термины, которых нет
ни в словаре, ни в промпте, — но отправляет содержимое экрана в облако.
> [!note] Границы этой страницы
> Здесь описан только `Application`. Две соседние галочки — `Selected text`
> и `Copied text` — на практике не проверялись, поэтому о них здесь ничего
> не утверждается.
## Оглавление
- [[#Где включается]]
- [[#Что реально захватывается]]
- [[#Когда захватывается]]
- [[#Что даёт — измерено]]
- [[#Цена]]
- [[#Как проверить у себя]]
- [[#Источник]]
## Где включается
В настройках режима, строка `Context`, галочка `Application`. В файле режима
этому соответствует поле `contextFromActiveApplication`.
Настройка доступна только у кастомных режимов. Из встроенных все галочки
контекста включены лишь у режима Super.
## Что реально захватывается
Окно целиком не пересылается. Приложение вытаскивает из видимого текста
существительные и кладёт их списком, вместе с именем программы.
В измеренном прогоне контекст выглядел так:
```
name : <имя программы>
nouns : список существительных, вытащенных из видимого текста окна
```
В список попадают не только термины: туда же уходят имена файлов, фрагменты
путей и имя пользователя системы — всё, что оказалось на экране.
## Когда захватывается
**После распознавания речи, перед обработкой языковой моделью.**
Это неочевидно и важно: учитывается то окно, которое активно **в конце**
диктовки, а не в начале. Если сразу после произнесения переключиться
в другую программу, в контекст попадёт содержимое уже нового окна.
## Что даёт — измерено
Проверка на одной диктовке в окне терминала:
```
распознавание : ...запущен cloudcode, тестируем функцию applicationcontext
итог : ...запущен Claude Code, тестируем функцию applicationContext
```
Исправлены оба термина. Второй — со средней заглавной буквой — **отсутствовал
в словаре, в глоссарии и в примерах**: правильное написание модель взяла
с экрана.
Это принципиально иной механизм, чем словарь и промпт. Те работают
по заранее заведённому списку, а контекст — по тому, что видно прямо сейчас.
При диктовке в терминал или редактор, где нужные названия почти всегда
на экране, выигрыш ощутимый и не требует никакой поддержки списков.
## Цена
**Промпт разрастается.** В измеренном случае — с 4517 до 6517 символов,
то есть в полтора раза. Разработчики предупреждают, что избыточный контекст
ухудшает результат: модель отвлекается на постороннее.
**Содержимое экрана уходит в облако.** При облачной языковой модели список
существительных отправляется на сервер при каждой диктовке. Для работы
в терминале и редакторе кода это может быть чувствительно.
> [!info] Отдельно от этой настройки
> Имя пользователя передаётся в промпт в поле `userContext` независимо
> от того, включён ли `Application`.
> [!tip] Когда включать
> Если языковая модель локальная, содержимое экрана не покидает машину,
> и функция становится выгодной без оговорок. При облачной модели вопрос
> сводится к тому, приемлема ли отправка видимого текста наружу.
## Как проверить у себя
Эффект не виден в интерфейсе — проверяется по базе истории распознавания.
Смотреть нужно две вещи:
1. поле `promptContext` — что именно захвачено;
2. длину промпта — насколько он вырос.
Включать стоит по одной галочке за раз, иначе непонятно, что дало эффект.
## Источник
Официальная документация — [Context Awareness](https://superwhisper.com/docs/common-issues/context).
Цитаты приведены в переводе:
> **Контекст приложения:** текст из активных полей ввода, имена и заголовок
> активного окна.
Про момент захвата:
> Захватывается после завершения обработки голоса, между шагами транскрипции
> и обработки ИИ. То есть какое окно активно в этот момент — оттуда и берётся
> контекст.
Предупреждение о размере контекста:
> Подходите избирательно к тому, какие типы контекста включать для кастомных
> режимов. Включение ненужного контекста отправляет ИИ избыточную информацию
> и может ухудшить качество результата.