# Русские запросы к англоязычным названиям (23.10) ## Проблема Пользователь пишет «матрицу», а в системе фильм называется `The Matrix`. Поиск по подстроке не находил ничего: до этого работали только «дюна» (русское название в Jellyfin) и «кларксона» (частичное совпадение). ## Решение — два механизма ### 1. Словарь переводов `/opt/hub-core/data/title_aliases.json`: ```json { "the matrix": ["матрица", "матрицу", "матрице"], "arrival": ["прибытие"], "interstellar": ["интерстеллар"], "clarkson's farm": ["ферма кларксона"] } ``` При сборке каталога каждый алиас добавляется в карточку (`aliases: ["The Matrix", "матрица", ...]`), и поиск проверяет их все. Ключ ищется и по полному названию, и по названию без года — иначе `Foundation (2021)` не находил «основание». ### 2. Транслитерация + нечёткое сравнение Для заимствований, которых нет в словаре: `транслит(запрос)` сравнивается с `транслит(название)` через `difflib.SequenceMatcher`, порог 0.72. ``` интерстеллар → interstellar (точное совпадение после транслита) матриц → matric ≈ matrix (0.83) ``` ## Проверка | Запрос | Найдено | |---|---| | матрицу | The Matrix, The Matrix Reloaded | | интерстеллар | Interstellar | | прибытие | Arrival | | чужой | Alien | | бегущий по лезвию | Blade Runner | | основание | Foundation | | пространство | The Expanse | | мир дикого запада | Westworld | | дюну | Дюна | | ферму кларксона | Ферма Кларксона | Через намерения: ``` «найди матрицу» → find → The Matrix (1999) — в планах «скачай матрицу» → add → «The Matrix» уже в планах (Radarr/Sonarr) ``` ## Ограничения * словарь **курируемый** (~25 популярных названий) — новые фильмы надо добавлять вручную; * переводы («Прибытие» → Arrival) транслитом не решаются, только словарём; * транслит неточен для сложных случаев (`ё`, `й`, `ц`) — используются варианты `zh`, `i`, `ts`. ## Как расширять 1. Добавить строку в `title_aliases.json` (ключ — английское название строчными). 2. `python3 /opt/hub-core/media_catalog.py` — пересобрать каталог. 3. Проверить: `curl "http://127.0.0.1:9120/catalog?q=<русский запрос>"`. --- # Расширение (20:25): 90 названий + управление алиасами ## Что добавлено | Механизм | Как работает | |---|---| | **Словарь** | 90 названий, 114 алиасов (было ~25 названий) | | **Авто-транслит** | при сборке для каждого названия добавляется транслит-алиас | | **API `/aliases`** | `GET /aliases?latin=Dune&russian=дюна` — добавить и пересобрать | | **Команда `!алиас`** | в секретаре, только владелец: `!алиас Dune = Дюна` | ## Проверка добавления алиаса ``` GET /aliases?latin=Dune&russian=дюночка {"ok": true, "title": "dune", "aliases": ["дюна","дюну","дюны","дюночка"]} каталог?q=дюночка → Дюна ``` Тестовый алиас после проверки убран, каталог пересобран. ## Важное ограничение Алиас помогает найти **то, что уже есть в каталоге**. Запрос «оппенгеймер» не находит ничего не потому, что алиаса нет, а потому что **фильма нет в Radarr/Sonarr/Jellyfin**. Проверено по 7 названиям (Oppenheimer, The Boys, Breaking Bad, Game of Thrones, The Witcher, Black Mirror, Friends) — ни одного нет в каталоге. ## Тест словаря | Запрос | Найдено | |---|---| | матрицу | The Matrix | | интерстеллар | Interstellar | | прибытие | Arrival | | чужой | Alien | | бегущий по лезвию | Blade Runner | | дюну | Дюна | | ферму кларксона | Ферма Кларксона | | разделение | Severance | | основание | Foundation | | пространство | The Expanse | | мир дикого запада | Westworld | 11 из 11 присутствующих в каталоге — найдены. ## Почему не переносим разбор в профильные боты Решение владельца и моё согласие: **секретарь остаётся единым входом**. | Причина | Что даёт | |---|---| | Одна точка разбора намерений | нет девяти разных парсеров | | Одна проверка ролей | `_role_gate` в `dispatch` | | Один журнал | диалог и решения в `dialog.jsonl` | | Проще добавлять ботов | бот = набор команд, без своей логики входа | Профильные боты — **исполнители**, секретарь — **оркестратор**. Это ровно формулировка плана: «один вход вместо семи».