feat(scrape): TMDB 标志写 clearlogo.png

- 富详情请求加 images(include_image_language=zh,en,null),作品原语言不是中英文时另取 /images;
  选一张 PNG 标志(原语言 → 中文 → 英文 → 无文字,同语言按评分)存作品字段 logoPath,变化时触发重刮
- 刮削布局新角色 clearlogo:电影写影片目录 clearlogo.png、剧集写剧集根目录,库根 / 平铺电影 <视频名>-clearlogo.png;
  覆盖方式与 hash 规则同其它图片
- 布局金样差分登记偏离 tmdb_clearlogo;mock TMDB 支持 logos 与 /images

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

packages/domain/src/scrape/layout.ts

@@ -7,6 +7,8 @@
 // - 剧集:作品目录 tvshow.nfo、poster.jpg、fanart.jpg;季目录 season.nfo;季海报同时写作品目录
 //   `season01-poster.jpg`(特别篇 `season-specials-poster.jpg`)与季目录 `poster.jpg`(MP 同);
 // - 每集:`<视频名>.nfo`;剧照 `<视频名>-thumb.jpg`(Kodi / Jellyfin / Emby 都认;MP 写 `<视频名>.jpg`)。
+// - 标志(TMDB logos,MP 只在接 fanart.tv 时写):电影写在影片目录、剧集写在剧集根目录,文件名 `clearlogo.png`
+//   (Kodi / Emby / Jellyfin 通用);平铺 / 库根的电影用 `<视频名>-clearlogo.png`。
 // 视频直接在库根(没有作品目录)或电影目录里还有别的作品时,电影图片改用 `<视频名>-poster.jpg` / `<视频名>-fanart.jpg`,
 // 剧集不写 tvshow / 季文件(不能往库根里放 tvshow.nfo)。
 
@@ -42,6 +44,7 @@ export type ScrapeTargetRole =
   | "episode_nfo"
   | "poster"
   | "fanart"
+  | "clearlogo"
   | "season_poster"
   | "episode_thumb";
 
@@ -61,6 +64,8 @@ export interface ScrapeVideo {
 export interface ScrapeImages {
   posterPath?: string | null;
   backdropPath?: string | null;
+  /** TMDB 标志(PNG) */
+  logoPath?: string | null;
   /** 季号 → 季海报路径 */
   seasonPosters?: ReadonlyMap<number, string | null>;
   /** "季:集" → 剧照路径 */
@@ -165,7 +170,7 @@ export function planScrapeTargets(input: ScrapeLayoutInput): ScrapeTarget[] {
     }
     if (!input.options.images || input.parts?.work === false) return out;
     const inWork = workDir && !input.sharedDir && videos.some((v) => isUnder(v.path, workDir));
-    const art = (role: "poster" | "fanart", p: string | null | undefined) => {
+    const art = (role: "poster" | "fanart" | "clearlogo", p: string | null | undefined) => {
       if (!p) return;
       if (inWork) add({ path: join(workDir, `${role}${extOf(p)}`), kind: "image", role, imagePath: p });
       else
@@ -182,6 +187,7 @@ export function planScrapeTargets(input: ScrapeLayoutInput): ScrapeTarget[] {
     };
     art("poster", img.posterPath);
     art("fanart", img.backdropPath);
+    art("clearlogo", img.logoPath);
     return out;
   }
 
@@ -206,6 +212,13 @@ export function planScrapeTargets(input: ScrapeLayoutInput): ScrapeTarget[] {
           role: "fanart",
           imagePath: img.backdropPath,
         });
+      if (img.logoPath)
+        add({
+          path: join(workDir, `clearlogo${extOf(img.logoPath)}`),
+          kind: "image",
+          role: "clearlogo",
+          imagePath: img.logoPath,
+        });
     }
   }
   // 季:按视频所在目录(不等于作品目录的才算季目录);没有作品目录时只写季目录里的 season.nfo / poster

packages/domain/test/scrape.test.ts

@@ -199,6 +199,60 @@ describe("刮削目标布局", () => {
     expect(atRoot.map((x) => x.path)).toEqual(["x.nfo", "x-poster.jpg", "x-fanart.png"]);
   });
 
+  it("标志 clearlogo.png:电影写影片目录、剧集写剧集根目录;库根 / 平铺的电影用 <视频名>-clearlogo.png;选中季 / 集不写", () => {
+    const withLogo = { ...images, logoPath: "/logo.png" };
+    const movie = planScrapeTargets({
+      kind: "movie",
+      workDir: "星际穿越 (2014)",
+      videos: [{ path: "星际穿越 (2014)/星际穿越 (2014) - 1080p.mkv" }],
+      images: withLogo,
+      options: { images: true, episodeThumbs: true },
+    });
+    expect(movie.filter((x) => x.role === "clearlogo").map((x) => [x.path, x.imagePath])).toEqual([
+      ["星际穿越 (2014)/clearlogo.png", "/logo.png"],
+    ]);
+    const atRoot = planScrapeTargets({
+      kind: "movie",
+      workDir: null,
+      videos: [{ path: "x.mkv" }],
+      images: withLogo,
+      options: { images: true, episodeThumbs: true },
+    });
+    expect(atRoot.map((x) => x.path)).toEqual(["x.nfo", "x-poster.jpg", "x-fanart.png", "x-clearlogo.png"]);
+    const tv = planScrapeTargets({
+      kind: "tv",
+      workDir: "S",
+      videos: [{ path: "S/Season 1/a.mkv", season: 1, episode: 1 }],
+      images: withLogo,
+      options: { images: true, episodeThumbs: true },
+    });
+    expect(tv.slice(0, 4).map((x) => x.path)).toEqual([
+      "S/tvshow.nfo",
+      "S/poster.jpg",
+      "S/fanart.png",
+      "S/clearlogo.png",
+    ]);
+    const seasonOnly = planScrapeTargets({
+      kind: "tv",
+      workDir: "S",
+      videos: [{ path: "S/Season 1/a.mkv", season: 1, episode: 1 }],
+      images: withLogo,
+      options: { images: true, episodeThumbs: true },
+      parts: { work: false },
+    });
+    expect(seasonOnly.some((x) => x.role === "clearlogo")).toBe(false);
+    // 关图片不写;没有标志不写
+    const noImages = planScrapeTargets({
+      kind: "tv",
+      workDir: "S",
+      videos: [{ path: "S/Season 1/a.mkv", season: 1, episode: 1 }],
+      images: withLogo,
+      options: { images: false, episodeThumbs: false },
+    });
+    expect(noImages.some((x) => x.role === "clearlogo")).toBe(false);
+    expect(movie.length).toBe(4);
+  });
+
   it("剧集视频在库根:不写 tvshow / 季文件,只写集 NFO", () => {
     const t = planScrapeTargets({
       kind: "tv",