av
a2d8140e22
- новое поле [general].language (ru|en, дефолт en) — единый источник языка локализованного title детектора и локали запросов к метабазам; original_title всегда на языке оригинала - локаль TMDB (поиск + credits) выводится из него, [metadata.tmdb].language убран - промпт LLM явно задаёт язык title с fallback на оригинал
60 lines
4.5 KiB
Markdown
60 lines
4.5 KiB
Markdown
## Why
|
||
|
||
Приложение и медиатека — на русском, но распознавание и метабазы часто отдают
|
||
`title` и режиссёра на английском (или, наоборот, на русском там, где хочется
|
||
латиницу). Сейчас язык локализованного названия задан неявно и вразнобой: LLM
|
||
сам решает, на каком языке вернуть `title`, а TMDB жёстко умолчанием `ru-RU`.
|
||
Нужен один явный переключатель языка вывода, единый для детектора и метабаз, с
|
||
предсказуемым дефолтом.
|
||
|
||
## What Changes
|
||
|
||
- Вводится единый конфиг `[general].language` со значениями `ru`|`en`, **по
|
||
умолчанию `en`** (рядом с `[general].timezone` — тот же класс
|
||
presentation-настройки отображения). Он задаёт язык *локализованных* полей
|
||
вывода — `title` и режиссёра. `original_title` он не затрагивает: оно всегда
|
||
остаётся на языке оригинала картины.
|
||
- **recognition**: промпт LLM явно требует возвращать `title` на выбранном
|
||
языке (локализованное название с fallback на оригинал, если перевода нет).
|
||
Контракт `original_title` не меняется.
|
||
- **metadata-match**: локаль запросов к TMDB (`language`) выводится из
|
||
глобального `language` (`ru`→`ru-RU`, `en`→`en-US`), а не задаётся отдельно.
|
||
В запрос credits (режиссёр) тоже передаётся эта локаль — best-effort: имена
|
||
людей провайдеры локализуют не всегда, где перевода нет, остаётся оригинал.
|
||
- **BREAKING (конфиг)**: поле `[metadata.tmdb].language` удаляется — теперь это
|
||
единственный способ задать язык, второго не остаётся. Дефолт локали TMDB
|
||
меняется с `ru-RU` на `en-US` (следствие общего дефолта `en`).
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
(нет — новых доменов не вводим)
|
||
|
||
### Modified Capabilities
|
||
|
||
- `recognition`: требование к промпту LLM — `title` возвращается на языке,
|
||
заданном глобальным `language` (fallback на оригинал при отсутствии
|
||
перевода); контракт `original_title` не меняется.
|
||
- `metadata-match`: локаль запроса к TMDB выводится из глобального `language`
|
||
(вместо отдельного `[metadata.tmdb].language`), та же локаль передаётся в
|
||
запрос режиссёра (best-effort).
|
||
|
||
## Impact
|
||
|
||
- **Конфиг**: новое поле `[general].language` (валидация `ru`|`en`, дефолт
|
||
`en`); удаление `[metadata.tmdb].language`; обновление `config.example.toml`
|
||
и `docs/conventions/config.md`.
|
||
- **Медиатека на диске**: имя папки Jellyfin строится из локализованного
|
||
`title` (`recognize.go` подменяет `plan.Title` каноническим именем матча),
|
||
поэтому дефолт `en` даёт английские имена папок. Это косметика: Jellyfin
|
||
идентифицирует контент по id-тегу метабазы (TVDB/IMDb в имени папки), а не по
|
||
языку названия, поэтому распознавание медиатеки не ломается.
|
||
- **Код**: `internal/config` (парсинг/валидация/дефолт нового поля, удаление
|
||
старого), `internal/recognize/prompt.go` (язык `title` в промпте),
|
||
`internal/metadata/tmdb.go` (локаль из глобального, передача в credits),
|
||
проброс `language` из конфига в recognizer и клиента TMDB.
|
||
- **Поведение**: дефолтный язык `title`/режиссёра меняется на английский;
|
||
существующие деплои, полагавшиеся на `ru-RU`, должны выставить
|
||
`language = "ru"`.
|