feat(cache): read cache TTLs from storage settings and renew tracked TMDB details (CACHE-2)

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

apps/server/src/modules/sources-identity/runtime.ts

@@ -15,7 +15,14 @@ import {
 } from "@umt/adapters";
 import { DEFAULT_SETTINGS, type SitesSettings } from "@umt/contracts";
 import { pgTokenBucketFor, type SiteRow, sql } from "@umt/db";
-import { CACHE_REGIONS, sharedCache, type TmdbCachePolicy, tmdbCachePolicy } from "../../shared-cache.ts";
+import {
+  CACHE_REGIONS,
+  renewTrackedTmdbDetail,
+  sharedCache,
+  type TmdbCachePolicy,
+  tmdbCachePolicy,
+  tmdbDetailRef,
+} from "../../shared-cache.ts";
 import type { ServerContext } from "../types.ts";
 
 // 模块运行时依赖:站点适配器与限流器(每站一个实例,令牌在 PG 跨进程共享)、RSS 抓取器、TMDB 客户端、时钟。
@@ -108,7 +115,11 @@ export class SourcesRuntime {
             ...(baseUrl ? { baseUrl } : {}),
             ...(this.overrides.fetch ? { fetch: this.overrides.fetch } : {}),
             // 请求响应进 PG 缓存(region tmdb.request),三进程共享;TTL / 条数上限 / 空结果短 TTL 取设置(对照 MP)
-            cache: { ttlMs: policy.ttl * 1000, emptyTtlMs: policy.emptyTtl * 1000 },
+            cache: {
+              ttlMs: policy.ttl * 1000,
+              searchTtlMs: policy.searchTtl * 1000,
+              emptyTtlMs: policy.emptyTtl * 1000,
+            },
             sharedCache: tmdbSharedCache(this.ctx, policy),
           })
         : null;
@@ -276,17 +287,27 @@ export class SourcesRuntime {
   }
 }
 
-/** TMDB 请求响应缓存:PG kv_cache region=tmdb.request;PG 出错按未命中 / 不写处理,不让 TMDB 请求失败 */
+/**
+ * TMDB 请求响应缓存:PG kv_cache region=tmdb.request;PG 出错按未命中 / 不写处理,不让 TMDB 请求失败。
+ * 详情命中且属于追踪中的作品时续期(CACHE-2),续期失败只记 debug。
+ */
 function tmdbSharedCache(ctx: ServerContext, policy: TmdbCachePolicy): TmdbSharedCache {
   const cache = sharedCache(ctx);
   const warn = (err: unknown) =>
     ctx.logger.warn({ err: { message: (err as Error).message } }, "TMDB 缓存读写失败，按未命中处理");
   return {
-    get: (key) =>
-      cache.get(CACHE_REGIONS.tmdbRequest, key).catch((e) => {
+    get: async (key) => {
+      const v = await cache.get(CACHE_REGIONS.tmdbRequest, key).catch((e) => {
         warn(e);
         return null;
-      }),
+      });
+      if (v !== null && tmdbDetailRef(key)) {
+        await renewTrackedTmdbDetail(ctx, key, policy.ttl).catch((e) =>
+          ctx.logger.debug({ err: { message: (e as Error).message } }, "TMDB 详情缓存续期失败"),
+        );
+      }
+      return v;
+    },
     set: (key, value, ttlMs) =>
       cache.set(CACHE_REGIONS.tmdbRequest, key, value, { ttl: ttlMs / 1000, maxsize: policy.maxsize }).catch(warn),
   };