feat(metadata): field-level episode metadata, titleZh and refresh?full=1 (MD-1)

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/contracts/src/settings.ts

@@ -214,6 +214,15 @@ export const MetadataSettings = z.object({
   tmdbApiKeySecretRef: Id.nullable(),
   /** 自建反代或测试 mock;null 用官方地址 */
   tmdbBaseUrl: z.url().nullable(),
+  /**
+   * 元数据语言回退链(MD-1):作品 / 季 / 集的标题与简介按顺序取第一个非空值;中文名(titleZh)取链中第一个中文值。
+   * BCP47 语言-地区,如 zh-CN;缺省 zh-CN → zh-SG → zh-TW → zh-HK → en-US
+   */
+  languages: z
+    .array(z.string().regex(/^[a-z]{2,3}(-[A-Z]{2})?$/))
+    .min(1)
+    .max(8)
+    .default(["zh-CN", "zh-SG", "zh-TW", "zh-HK", "en-US"]),
 });
 export type MetadataSettings = z.infer<typeof MetadataSettings>;
 
@@ -506,7 +515,7 @@ export const DEFAULT_SETTINGS: GlobalSettings = {
     sessionDir: null,
     webSearch: DEFAULT_WEB_SEARCH,
   },
-  metadata: { tmdbApiKeySecretRef: null, tmdbBaseUrl: null },
+  metadata: { tmdbApiKeySecretRef: null, tmdbBaseUrl: null, languages: ["zh-CN", "zh-SG", "zh-TW", "zh-HK", "en-US"] },
   sites: {
     defaultRateLimit: { requestsPerMinute: 20, concurrency: 2 },
     defaultSnapshotIntervalSec: 3600,
@@ -774,6 +783,7 @@ export const SETTINGS_SECTIONS: readonly SettingsSectionDef[] = [
     fields: [
       "metadata.tmdbApiKeySecretRef",
       "metadata.tmdbBaseUrl",
+      "metadata.languages",
       "cache.tmdbTtlHours",
       "cache.tmdbMaxSize",
       "cache.emptyResultTtlSec",