bug处理

web/src/utils/groupSeries.ts

@@ -36,6 +36,7 @@ export type SeriesCard = {
   linkMedia?: Media
   linkLibraryId?: string
   count: number
+  is_series?: boolean
   last_added_at?: string
 }
 
@@ -223,6 +224,7 @@ export function seasonLabel(season: number): string {
 export function isSeriesCard(card: SeriesCard): boolean {
   const linkMedia = card.linkMedia ?? card.rep
   return (
+    card.is_series === true ||
     card.count > 1 ||
     isEpisodeLike(card.rep) ||
     isEpisodeLike(linkMedia) ||

web/src/utils/seriesCardResolve.ts

@@ -0,0 +1,59 @@
+import { libraryAPI, mediaAPI } from '../api/library'
+import type { Media } from '../types'
+import { groupSeries, type SeriesCard } from './groupSeries'
+import { isRemoteEmbyID } from './remoteEmby'
+
+/**
+ * 按 series key 反解出剧集卡片。
+ *
+ * 首页「最新条目」、海报墙等入口点击后带 ?series=<key> 深链进媒体库页，
+ * 但媒体库页每次只加载一页剧集卡片（远程 Emby 库 100 条），目标剧集不在
+ * 这一页时列表里找不到对应卡片，页面就退化成整个媒体库列表。这里按 key
+ * 单独解析目标剧集，与分页无关：
+ *
+ * - 远程 Emby 的 key 本身就是（伪装后的）剧集 ID，直接取该条目详情；
+ * - 本地 key 是分组 hash，改取该剧集的集列表，再折叠出代表条目。
+ *
+ * key 失效（剧集已删除等）时返回 null，调用方保持"整库列表"原状态。
+ */
+export async function resolveSeriesCardByKey(libraryID: string, key: string): Promise<SeriesCard | null> {
+  if (!libraryID || !key) return null
+
+  if (isRemoteEmbyID(key)) {
+    const rep = await fetchRemoteSeriesMedia(key)
+    if (rep) {
+      return { key, rep, linkMedia: rep, count: 0, is_series: true }
+    }
+  }
+
+  const episodes = await fetchSeriesEpisodes(libraryID, key)
+  if (episodes.length === 0) return null
+  // 与列表页同一套折叠规则，选出海报/元数据最好的那一集做代表卡片。
+  const [grouped] = groupSeries(episodes)
+  const rep = grouped?.rep ?? episodes[0]
+  return {
+    key,
+    rep,
+    linkMedia: grouped?.linkMedia ?? rep,
+    count: episodes.length,
+    is_series: true,
+  }
+}
+
+async function fetchRemoteSeriesMedia(id: string): Promise<Media | null> {
+  try {
+    const media = await mediaAPI.get(id)
+    return media?.id ? media : null
+  } catch {
+    return null
+  }
+}
+
+async function fetchSeriesEpisodes(libraryID: string, key: string): Promise<Media[]> {
+  try {
+    const page = await libraryAPI.listSeriesEpisodes(libraryID, key)
+    return Array.isArray(page.items) ? page.items : []
+  } catch {
+    return []
+  }
+}