recognition: глобальный переключатель языка вывода [general].language

- новое поле [general].language (ru|en, дефолт en) — единый источник языка
  локализованного title детектора и локали запросов к метабазам; original_title
  всегда на языке оригинала
- локаль TMDB (поиск + credits) выводится из него, [metadata.tmdb].language убран
- промпт LLM явно задаёт язык title с fallback на оригинал
This commit is contained in:
av
2026-07-24 14:09:04 +03:00
parent 8309ce0664
commit a2d8140e22
18 changed files with 556 additions and 48 deletions
+36 -9
View File
@@ -38,6 +38,12 @@ type General struct {
// Пусто → UTC. База зон встроена (time/tzdata), поэтому имя валидируется
// одинаково на любом хосте (см. DisplayLocation).
Timezone string `toml:"timezone"`
// Language — язык локализованного вывода: `title` от LLM-детектора и
// режиссёр/локаль запросов к метабазам. Допустимо: "ru" | "en", пусто → "en"
// (см. ContentLanguage). `original_title` от настройки не зависит — всегда на
// языке оригинала. Диалект локали провайдера (напр. TMDB ru-RU/en-US) выводит
// сам провайдер из этого кода.
Language string `toml:"language"`
}
// QBittorrent — доступ к qBittorrent WebUI и раскладка путей загрузок.
@@ -86,14 +92,14 @@ type Metadata struct {
}
// MetadataProvider — настройки одного провайдера метаданных. У keyless-баз
// (TVMaze) поле api_key не используется; language учитывает только TMDB
// (локаль возвращаемых названий, дефолт ru-RU).
// (TVMaze) поле api_key не используется. Язык названий задаёт глобальный
// [general].language (локаль провайдера выводится из него), отдельной настройки
// у провайдера нет.
type MetadataProvider struct {
Enabled bool `toml:"enabled"`
APIKey string `toml:"api_key"`
Proxy string `toml:"proxy"`
Timeout Duration `toml:"timeout"`
Language string `toml:"language"`
Enabled bool `toml:"enabled"`
APIKey string `toml:"api_key"`
Proxy string `toml:"proxy"`
Timeout Duration `toml:"timeout"`
}
// Jellyfin — пересканирование медиатеки после раскладки (опц.). Включается
@@ -181,11 +187,22 @@ func (c *Config) DisplayLocation() (*time.Location, error) {
return loc, nil
}
// ContentLanguage возвращает язык локализованного вывода абстрактным кодом
// ("ru" | "en"); пусто → "en". Диалект локали конкретного провайдера (ru-RU,
// en-US, …) выводит сам провайдер из этого кода — здесь его не знаем. Значение
// провалидировано на старте (validate): либо пусто, либо один из кодов.
func (c *Config) ContentLanguage() string {
if c.General.Language == "" {
return "en"
}
return c.General.Language
}
// Default возвращает конфиг с разумными умолчаниями; значения из файла
// перекрывают их при загрузке.
func Default() *Config {
return &Config{
General: General{Timezone: "UTC"},
General: General{Timezone: "UTC", Language: "en"},
QBittorrent: QBittorrent{
URL: "http://qbit:8989",
Username: "admin",
@@ -204,7 +221,7 @@ func Default() *Config {
MaxRetries: 3,
},
Metadata: Metadata{
TMDB: MetadataProvider{Timeout: Duration(10 * time.Second), Language: "ru-RU"},
TMDB: MetadataProvider{Timeout: Duration(10 * time.Second)},
TVDB: MetadataProvider{Timeout: Duration(10 * time.Second)},
},
Jellyfin: Jellyfin{Timeout: Duration(10 * time.Second)},
@@ -264,6 +281,16 @@ func (c *Config) validate() error {
if _, err := c.DisplayLocation(); err != nil {
errs = append(errs, err)
}
// Язык локализованного вывода: пусто (→ en) или один из кодов. Fail-fast,
// как llm.type: мусорное значение не должно молча дефолтить. Множество
// {ru, en} — канон; при добавлении кода синхронно расширь мапперы
// metadata.tmdbLocale и recognize.languageDirective, иначе новый язык молча
// даст английский вывод.
switch c.General.Language {
case "", "ru", "en":
default:
errs = append(errs, fmt.Errorf("unsupported general.language %q (supported: ru, en)", c.General.Language))
}
// Медиа-пути песочницы: абсолютные, без traversal, существующие каталоги.
for _, p := range []struct{ name, path string }{