feat(server): scrapeMedia 刮削任务,入库后自动刮削(SCR-1)

- 文件道任务 scrapeMedia:NFO 原子写入、图片经图片缓存下载(并发 4,失败不阻塞 NFO)、只补缺失 / 全部覆盖
- 设置 organize.scrapeAfterImport / scrapeMode / scrapeImages / scrapeEpisodeThumbs
- POST /library/{id}/scrape、详情 scrape 状态;files/scrape writeNfo 与 scrape-batch write 走同一任务
- 迁移 0057_media_scrape、原因码、审计 organize.scrape
- 与 MP 输出的 NFO 差分测试(apps/server/test/scrape)

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/contracts/src/files.ts

@@ -685,6 +685,7 @@ export type IdentifyCompletedPayload = z.infer<typeof IdentifyCompletedPayload>;
 export const FilesScrapeRequest = z.object({
   idempotencyKey: IdempotencyKey,
   mediaEntityId: Id,
+  /** SCR-1:true 时另排 scrapeMedia,把 NFO(与 images 时的图片)写进媒体库目录 */
   writeNfo: z.boolean().default(false),
   images: z.boolean().default(false),
 });
@@ -695,9 +696,11 @@ export const FilesScrapeResult = z.object({
   taskId: z.string(),
   /** 当前被用户锁定、刷新不会改动的字段 */
   lockedFields: z.array(z.string()),
-  /** NFO/图片投影:W5 实现前请求时为 not_implemented */
-  nfo: z.enum(["written", "skipped", "not_requested", "not_implemented"]),
-  images: z.enum(["written", "skipped", "not_requested", "not_implemented"]),
+  /** NFO/图片投影(SCR-1):queued = 已排 scrapeMedia,结果看作品刮削状态;not_implemented 已不再返回 */
+  nfo: z.enum(["written", "skipped", "queued", "not_requested", "not_implemented"]),
+  images: z.enum(["written", "skipped", "queued", "not_requested", "not_implemented"]),
+  /** scrapeMedia 引擎 run id(writeNfo / images 时) */
+  scrapeTaskId: z.string().nullable().optional(),
 });
 export type FilesScrapeResult = z.infer<typeof FilesScrapeResult>;
 
@@ -845,6 +848,8 @@ export const FilesScrapeBatchRequest = z.object({
   idempotencyKey: IdempotencyKey,
   items: z.array(FileRef).max(500).optional(),
   mediaEntityIds: z.array(Id).max(200).optional(),
+  /** SCR-1:true = 刮削(排 scrapeMedia 写 NFO 与图片,覆盖方式按设置);false(缺省)= 刷新元数据 */
+  write: z.boolean().default(false),
 });
 export type FilesScrapeBatchRequest = z.infer<typeof FilesScrapeBatchRequest>;
 export const FilesScrapeBatchResult = z.object({