feat(cache): TMDB / 豆瓣 / Bangumi 接入统一元数据缓存与策略表

- 策略表「来源 × 资源类型」(metaCachePolicy):搜索 / 识别 7 天(空 1 天)、详情 / 季 / 剧集组 30 天(空 1 天)、
  榜单 / 热门 / 每日放送 6 小时(空 1 小时)、人物 / 图片 90 天;取值来自 storage.cacheTtl,
  追加 tmdbListHours / tmdbListEmptyHours / imageDays / metaDetailDays / metaMissDays,metaSearchDays 缺省改 7 天
- TMDB 客户端共享缓存端口加 fetch(带请求类别与空结果判定),服务端整条读取交给 MetadataCache;
  识别缓存、douban.request / bangumi.request、douban.subject / bangumi.subject、meta.subject_miss、discover.match 都走这一层
- 豆瓣 / bgm 条目只在「不存在」时记查无,网络失败 / 被拦不缓存(本进程冷却 30 分钟)
- 关注中作品(isEntityWatched 口径,含选中的剧集组)的 TMDB 条目写入 pinned、命中续期
- 各进程启动 LISTEN 失效通知并每分钟把命中计数写 cache_stat;GET /cache/regions 给元数据 region 带近 7 天命中统计

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei

packages/adapters/src/tmdb/tmdb.test.ts

@@ -7,6 +7,7 @@ import {
   matchTmdbMulti,
   type TmdbConfig,
   TmdbError,
+  tmdbRequestKind,
   yearRange,
 } from "./index.ts";
 
@@ -135,6 +136,44 @@ describe("TmdbClient 缓存/限流/错误分类", () => {
     expect(tmdb.cacheStats().size).toBe(0);
   });
 
+  it("共享缓存给了 fetch:整条读取交给它,带请求类别(搜索 / 详情 / 列表 / 图片)与空结果判定;失败不进缓存", async () => {
+    const seen: { key: string; kind: string; empty: boolean }[] = [];
+    const store = new Map<string, unknown>();
+    const { mock, tmdb } = await setup({
+      sharedCache: {
+        get: async () => null,
+        set: async () => {},
+        fetch: async (req, load) => {
+          if (store.has(req.key)) return store.get(req.key);
+          const v = await load();
+          seen.push({ key: req.key, kind: req.kind, empty: req.isEmpty(v) });
+          store.set(req.key, v);
+          return v;
+        },
+      },
+    });
+    await tmdb.details("movie", 872585);
+    await tmdb.details("movie", 872585);
+    await tmdb.search("不存在的片名xyz", { type: "movie" });
+    await tmdb.getJson("/movie/872585/images", {});
+    await tmdb.getJson("/trending/all/week", {});
+    await expect(tmdb.getJson("/movie/999999999", {})).rejects.toThrow();
+    const byPath = new Map(seen.map((x) => [x.key.split("?")[0], [x.kind, x.empty]]));
+    expect(Object.fromEntries(byPath)).toEqual({
+      "/movie/872585": ["detail", false],
+      "/search/movie": ["search", true],
+      "/movie/872585/images": ["image", false],
+      "/trending/all/week": ["list", false],
+    });
+    const detailCalls = mock.callsTo("/3/movie/872585").length;
+    await tmdb.details("movie", 872585);
+    expect(mock.callsTo("/3/movie/872585")).toHaveLength(detailCalls);
+    expect(seen.some((x) => x.key.startsWith("/movie/999999999"))).toBe(false);
+    expect(tmdbRequestKind("/person/1")).toBe("image");
+    expect(tmdbRequestKind("/tv/1/season/2")).toBe("detail");
+    expect(tmdbRequestKind("/find/tt1")).toBe("search");
+  });
+
   it("并发合并:同一请求并发只发一次", async () => {
     const { mock, tmdb } = await setup();
     await Promise.all(Array.from({ length: 5 }, () => tmdb.season(100088, 1)));