feat(集数映射): 作品季集结构字段(迁移 0075)、剧集组接口契约与按 TMDB 默认季集换算

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

packages/contracts/src/api/episode-mapping.ts

@@ -51,4 +51,33 @@ export const episodeMappingApi = {
       response: em.EpisodeMappingPreview,
     }),
   },
+  episodeGroups: {
+    list: ep({
+      method: "get",
+      path: "/media-entities/{id}/episode-groups",
+      scope: "read",
+      summary: "作品可选的季集结构：TMDB 剧集组列表与当前选择",
+      params: IdParam,
+      response: em.EpisodeGroupList,
+    }),
+    seasons: ep({
+      method: "get",
+      path: "/media-entities/{id}/episode-structure",
+      scope: "read",
+      summary: "某套季集结构（TMDB 默认季或剧集组）的季卡片与每集，带本地已入库情况（纯读）",
+      params: IdParam,
+      query: em.EpisodeStructureQuery,
+      response: em.EpisodeStructureSeasons,
+    }),
+    set: ep({
+      method: "put",
+      path: "/media-entities/{id}/episode-group",
+      scope: "organize.execute",
+      summary:
+        "切换作品的季集结构：按 TMDB 原季集原地迁移集单元（引用不动），重建季表，按作品重算已绑定资源并刷新元数据",
+      params: IdParam,
+      body: em.EpisodeGroupSetInput,
+      response: em.EpisodeGroupSetResult,
+    }),
+  },
 } as const;