# apply — документация
Переносит содержимое словаря в настройки superwhisper.
Как устроен перенос — в [[apply — дизайн]]. Как вести сам словарь —
в [[dict — документация]].
```
bun apply.ts <команда>
```
## Оглавление
- [[#Команды]]
- [[#plan]]
- [[#apply]]
- [[#Что куда попадает]]
- [[#Предусловия]]
- [[#Переменные окружения]]
## Команды
| Команда | Что делает |
|---|---|
| `plan` | показывает, что изменится, ничего не записывая |
| `apply` | применяет изменения |
Без команды выполняется `plan` — по умолчанию скрипт ничего не меняет.
## plan
```bash
bun apply.ts plan
```
```
записей в словаре: 4
список слов : 23
замены : 16
блок промпта: 868 символов
отданы языковой модели (подстановка небезопасна):
клод код -> Claude Code
код-код -> Claude Code
докер -> Docker
```
Последний список стоит просматривать: это формы, у которых нет гарантии
подстановки — их чинит только языковая модель. Если форма попала туда
по ошибке, поправьте флаг в словаре.
## apply
```bash
bun apply.ts apply
```
Перед записью создаются резервные копии обоих затронутых файлов — их пути
выводятся в отчёте.
## Что куда попадает
```
канон и все его формы -> список слов
формы с safeToReplace: true -> замены
канон и все его формы -> блок правил в промпте режима
noise -> замены на пустоту
notMatch -> раздел «не путать» в промпте
```
Кроме этого в промпт всегда попадает правило пометки: модель обязана обернуть
в знаки `‡ ‡` место, где слово грамматически невозможно, а канона для него нет.
Пометки потом достаёт `diagnose`. Зачем это нужно — в
[[apply — дизайн#Пометка неопознанного]].
Формы попадают и в замены, и в промпт одновременно — это не ошибка.
Замена берёт точное совпадение, языковая модель — падежные формы, которые
пословная замена не видит. Подробнее в [[apply — дизайн#Промпт: каноны и все формы]].
Блок в промпте перезаписывается целиком при каждом применении: скрипт находит
свою метку и заменяет всё от неё до конца. Текст промпта выше метки не
затрагивается.
## Предусловия
**Режим должен существовать.** Скрипт обновляет уже созданный режим, но не
создаёт его — иначе пришлось бы решать, какие модели и язык в нём выставить.
**Нужен доступ к папке Documents.** Конфигурация superwhisper лежит там, а
папка защищена механизмом macOS. При первом применении появится диалог —
нажать **Allow**. Больше он не появится.
Без доступа скрипт останавливается с сообщением и ничего не портит.
Как это устроено и почему именно так — в
[[apply — дизайн#Доступ к папке Documents]].
## Переменные окружения
| Переменная | Назначение |
|---|---|
| `SW_DICT_DIR` | папка со словарём вместо стандартной |
Нужна, чтобы прогонять перенос из тестовой копии словаря.