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

Решение проблем

Сначала запустите anonymize doctor

Перед тем как копать конкретный симптом — прогоните встроенную диагностику:

Окно терминала
anonymize doctor

Команда проверяет версию Python (для blis-wheels нужен 3.12), установленный пакет, готовность Tesseract OCR, остаточное состояние от сломанного updater-прогона и сетевую пробу. Код 0 если обязательные проверки зелёные, 1 если есть FAIL — каждая строка показывает ✓ / ? / ✗ с причиной. На офлайн-машинах добавьте --no-network; чтобы очистить stale-state — --fix.

Если doctor зелёный, а проблема осталась — смотрите гайды ниже по симптомам.

«Tesseract OCR не установлен» / упала обработка скана

Сканированным и гибридным PDF нужен локальный Tesseract с английским и русским языковыми пакетами. DOCX, XLSX и PDF с обычным текстовым слоем работают и без него, но страницы-картинки отклоняются, пока OCR недоступен.

Установите Tesseract, затем повторите anonymize doctor --no-network:

Окно терминала
# macOS
brew install tesseract tesseract-lang


# Ubuntu / Debian
sudo apt install tesseract-ocr tesseract-ocr-eng tesseract-ocr-rus


# Windows PowerShell
winget install UB-Mannheim.TesseractOCR

На Windows, если doctor всё ещё сообщает об отсутствии eng или rus, проверьте, что языковые файлы лежат в каталоге tessdata, а tesseract.exe доступен в PATH.

OCR-результат выглядит ненадёжно

Плохие сканы могут распознаваться с низкой уверенностью. UI показывает risky или unsafe предупреждения при низкой средней уверенности OCR; такие документы нужно проверять визуально. Если OCR не смог распознать текст на странице, обработка падает, а не пропускает страницу молча. Попробуйте более чёткий скан или предварительно прогоните PDF через отдельный OCR-инструмент.

Веб-интерфейс не открылся

Если вы запустили anonymize, но вкладка браузера не появилась:

  1. Найдите URL, который напечатался в терминале (например, http://127.0.0.1:54321) и откройте его вручную
  2. Если URL не напечатался — посмотрите ~/.anonymizer/logs/<date>.log
  3. На Linux без дефолтного браузера установите BROWSER=firefox (или ваш браузер) перед запуском

«Permission denied» при установке на macOS/Linux

Скрипт установки пишет в ~/.local/share/uv/tools/ и ~/.local/bin/. Если один из этих путей принадлежит другому пользователю (например, вы что-то ставили туда через sudo) — chown их обратно:

Окно терминала
sudo chown -R $USER ~/.local

«Антивирус заблокировал установку» на Windows

Некоторые AV-движки помечают свежие Python wheel-пакеты, пока те не наберут репутацию. Решения:

  1. Использовать Корпоративную / офлайн установку с явным allowlist
  2. Добавить %LOCALAPPDATA%\uv\ в исключения антивируса
  3. Подождать — обычно репутация набирается через несколько дней после релиза

«Баннер обновления не исчезает после апгрейда»

Проверка версии кэшируется на 60 минут. Чтобы перепроверить — перезапустите anonymize. Если баннер не исчезает — проверьте, что anonymize --version показывает ту версию, что вы ожидаете: на PATH могут быть две установки.

«Токены не совпадают между двумя запусками одного документа»

Это сделано намеренно. Нумерация токенов — на сессию. См. Токены.

Другая проблема

Если вашей проблемы здесь нет — отправьте через Обратная связь.