# 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` | папка со словарём вместо стандартной | Нужна, чтобы прогонять перенос из тестовой копии словаря.