fix: обновление доки

2026-09-23 23:45:56 +03:00
parent 76e93959ba
commit af18ae8791
7 changed files with 13 additions and 91 deletions
@@ -33,6 +33,16 @@ docker compose up -d

 Действующие системы читаются из `config/systems.json`. Это не встроенный файл в jar: при запуске из каталога проекта используется именно он.

+### Модели второй и третьей ступеней (опционально)
+
+Без моделей сервис работает на одних правилах — этого достаточно для контракта `/process`. Модели нужны для распознавания в свободном тексте (иностранные имена без русских словообразовательных признаков, регион/район адреса, юридические реквизиты в нетиповых формулировках). Скачиваются одной командой (~1 ГБ, требует `python3` для конвертации третьей модели):
+
+```bash
+./tools/fetch-ner-model.sh
+```
+
+Кладёт веса в `models/wikineural-ner`, `models/rubert-ner`, `models/ru-legal-ner`. При локальном запуске (`java -jar ...`) включаются через `pdguard.ner.*-engine` (см. `docs/03-architecture.md`); в `docker compose up -d` каталог `models/` уже примонтирован и подхватывается автоматически, если модели скачаны до запуска. Сбой конкретной модели отключает только её ступень, остальное продолжает работать на правилах.
+
 ## Как устроен запрос

 `POST /process`