139 lines
6.1 KiB
Markdown
139 lines
6.1 KiB
Markdown
# Русские запросы к англоязычным названиям (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` |
|
||
| Проще добавлять ботов | бот = набор команд, без своей логики входа |
|
||
|
||
Профильные боты — **исполнители**, секретарь — **оркестратор**.
|
||
Это ровно формулировка плана: «один вход вместо семи».
|