Files
buryan-infra/ops/media/ALIASES.md

6.1 KiB
Raw Permalink Blame History

Русские запросы к англоязычным названиям (23.10)

Проблема

Пользователь пишет «матрицу», а в системе фильм называется The Matrix. Поиск по подстроке не находил ничего: до этого работали только «дюна» (русское название в Jellyfin) и «кларксона» (частичное совпадение).

Решение — два механизма

1. Словарь переводов

/opt/hub-core/data/title_aliases.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
Проще добавлять ботов бот = набор команд, без своей логики входа

Профильные боты — исполнители, секретарь — оркестратор. Это ровно формулировка плана: «один вход вместо семи».