merge: fix/m-search-filter

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

packages/contracts/src/release-facets.ts

@@ -3,14 +3,14 @@ import { NonNegInt } from "./common.ts";
 
 // 资源列表快速筛选(SEARCH-3):GET /search/releases 与 GET /sites/{id}/releases 共用。
 // 口径实现在 @umt/domain release-facets:同一维度多选为 OR,不同维度为 AND;
-// 计数按其它维度的已选条件统计(0 = 在其它条件下没有结果)。
+// 计数按其它维度的已选条件统计;选项只列计数不为 0 的值(已选的值总会列出)。
 
 export const FacetCount = z.object({ value: z.string(), label: z.string(), count: NonNegInt });
 export type FacetCount = z.infer<typeof FacetCount>;
 
 /**
  * 快速筛选参数 qf:`维度:值,值;维度:值`,值经 encodeURIComponent。
- * 维度:resolution(2160p/1080p/720p/other)、videoCodec(H.265/H.264/AV1/other)、
+ * 维度:seasonEpisode(季集,MP 写法 `S01` / `S01-S02` / `S02 E14` / `S01 E25-E48`)、resolution(2160p/1080p/720p/other)、videoCodec(H.265/H.264/AV1/other)、
  * releaseType(disc/remux/encode/webdl/hdtv/other)、site(站点 ID)、promotion(free/2x/50%/other/none)、
  * hdr(DV/HDR10/HDR10+/other/SDR)、hr(yes/no/unknown)、releaseGroup(制作组名,不分大小写)、season(季号)、episode(集号 / pack 整季);
  * SEARCH-4 起:audioCodec(Atmos/TrueHD/DTS:X/DTS-HD/DTS/DDP/DD/AAC/FLAC/LPCM/other/unknown)、
@@ -20,6 +20,8 @@ export type FacetCount = z.infer<typeof FacetCount>;
 export const QuickFilterParam = z.string().max(4000).optional();
 
 export const ReleaseQuickFacets = z.object({
+  /** 季集:整季在前、单集在后,季号新的在前(对照 MP);没有剧集资源时为空 */
+  seasonEpisode: z.array(FacetCount),
   resolution: z.array(FacetCount),
   videoCodec: z.array(FacetCount),
   releaseType: z.array(FacetCount),

packages/contracts/src/search.ts

@@ -342,8 +342,14 @@ export const ReleaseSearchPage = z
     nextCursor: z.string().nullable(),
     /** 筛选后的条数 */
     total: NonNegInt,
-    /** 未筛选的全部条数 */
+    /** 未筛选的全部条数(按作品搜时只算属于这部作品的) */
     unfilteredTotal: NonNegInt,
+    /**
+     * 按作品搜(entityId / tmdb)时判定不属于这部作品的资源(对照 MP match_torrent:识别到别的作品,
+     * 或名字、类型、年份、季集对不上);不参与筛选与分面,只在第一页给出(最多 200 条)。关键词搜索没有这两项
+     */
+    unmatched: z.array(SearchRelease).optional(),
+    unmatchedTotal: NonNegInt.optional(),
     /**
      * sites / resolutions / sources:旧的筛选项计数(基于未筛选的全部结果);
      * 其余为快速筛选分面(SEARCH-3,在其它筛选条件之后、按其它维度的已选条件计数)