# Руководство по анонимайзеру

Источник: https://docs.kodik.ru/features/anonymizer

Анонимайзер (KodikShield) — это опциональная функция защиты конфиденциальности, которая заменяет чувствительный контент на заполнители перед тем, как он попадёт в модель. Содержимое ваших файлов не изменяется; защита действует только на уровне передачи данных в модель.

Когда анонимайзер включён, Kodik маскирует:

- текст, который вы вручную пометили как чувствительный (выделения в редакторе);
- контент, который анонимайзер обнаруживает автоматически в результатах инструментов (чтение файлов, поиск, вывод команд, результаты MCP).

Вместо исходного значения модель получает заполнитель вида `__KODIK_...__`. Это позволяет агенту рассуждать о задаче, не видя защищённого контента.

![image](https://docs.kodik.ru/img/image41.png)

## Что защищается

Анонимайзер снижает риск случайного раскрытия:

- API-ключей, токенов, паролей и приватных URL;
- учётных данных баз данных и строк подключения;
- внутренних фрагментов кода, которые вы не хотите показывать модели;
- регионов, явно отмеченных вами как чувствительные.

## Что не защищается

Анонимайзер — не универсальная граница конфиденциальности.

- Он не шифрует файлы и не изменяет их содержимое.
- Он не скрывает пути файлов и их имена.
- Автоматическое обнаружение основано на эвристике и не гарантирует 100% охвата.
- Индекс поиска и другие локальные функции работают с исходными данными.

Используйте анонимайзер как дополнительный уровень защиты, а не как замену стандартным средствам управления секретами.

## Включение

1. Откройте **Настройки Kodik**.
2. Перейдите на вкладку **Настройки анонимайзера**.
3. Включите **Включить анонимайзер**.

После включения ручные маркеры чувствительности становятся активными, и Kodik начинает маскировать защищённый контент перед отправкой в модель.

## Как пометить текст как чувствительный

1. Откройте файл в редакторе.
2. Выделите текст, который хотите защитить.
3. Выполните команду **Mark Selection Sensitive**.

![image](https://docs.kodik.ru/img/image42.png)

![image](https://docs.kodik.ru/img/image32.png)

Команду можно запустить из палитры команд или с помощью сочетания клавиш — см. [настройки клавиатуры](https://docs.kodik.ru/configuration/keyboard-shortcuts):

- Linux/Windows: `Ctrl+Alt+S`
- macOS: `Cmd+Alt+S`

Kodik сохраняет выделение как ручной регион чувствительности для текущего рабочего пространства. Помеченные регионы подсвечиваются в редакторе.

## Как снять маркер

Выберите уже защищённый текст и выполните команду **Unmark Sensitive Selection**, или откройте **Настройки Kodik → Настройки анонимайзера** и удалите регион из списка.

Сочетание клавиш:

- Linux/Windows: `Ctrl+Alt+U`
- macOS: `Cmd+Alt+U`

Снятие маркера не изменяет содержимое файла — удаляется только сохранённое правило защиты.

## Что происходит во время запроса

1. Вы отправляете Kodik запрос или он начинает выполнять инструмент.
2. Kodik собирает контекст запроса и результаты инструментов.
3. **Результаты инструментов анонимизируются.** Kodik отправляет содержимое файла (или вывод команды, результат поиска, результат MCP) на Kodik API. При недоступности API применяется локальный запасной механизм. Ручные выделения применяются дополнительно — поверх любого из путей — как гарантия.
4. Оригинальный контент → заполнители; маппинг сохраняется в памяти на время сессии.
5. Модель получает и видит только версию с заполнителями.
6. **Аргументы инструментов деанонимизируются перед применением.** Когда модель генерирует правку файла или другую операцию, ссылающуюся на заполнитель, Kodik подставляет обратно исходные значения перед записью на диск.

## Просмотр и управление маркерами

Вкладка **Анонимайзер** в настройках показывает:

- включён ли анонимайзер;
- сколько файлов содержат ручные регионы и сколько регионов отслеживается;
- список регионов по файлам с предпросмотром кода.

Оттуда можно открыть регион в редакторе или удалить маркер.

## Компромисс по производительности

Поскольку Kodik должен отправить содержимое на API (или применить локальную эвристику) перед передачей в модель, запросы могут немного замедлиться при включённом анонимайзере.

## Рекомендации

- Помечайте наименьший регион, который действительно нуждается в защите.
- Регулярно проверяйте список **Чувствительные файлы** и удаляйте устаревшие маркеры.
- Продолжайте использовать стандартные практики управления секретами — анонимайзер является дополнительным слоем, а не самостоятельным решением.