Перейти к содержимому

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

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

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

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

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

image

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

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

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

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

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

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

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

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

image

image

Команду можно запустить из палитры команд или с помощью сочетания клавиш — см. настройки клавиатуры:

  • 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 (или применить локальную эвристику) перед передачей в модель, запросы могут немного замедлиться при включённом анонимайзере.

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