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

139 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Русские запросы к англоязычным названиям (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` |
| Проще добавлять ботов | бот = набор команд, без своей логики входа |
Профильные боты — **исполнители**, секретарь — **оркестратор**.
Это ровно формулировка плана: «один вход вместо семи».