merge: fix/e-scrape

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

packages/contracts/src/reasons.ts

@@ -108,7 +108,11 @@ const REASONS: Record<string, ReasonText> = {
   task_enqueue_failed: { text: "后台任务没排上", action: "稍后重试" },
   scrape_no_videos: { text: "目录里没有视频", action: "对作品或季目录刮削" },
   scrape_tmdb_unavailable: { text: "TMDB 不可用", action: "检查 TMDB 设置后重新刮削" },
-  scrape_exists: { text: "文件已存在，只补缺失时不改" },
+  scrape_exists: { text: "文件已存在，不是本工具写的或只补缺失时不改" },
+  scrape_unchanged: { text: "内容没有变化" },
+  scrape_user_modified: { text: "文件写入后被改过，更新时不覆盖", action: "要替换就选全部覆盖重新刮削" },
+  scrape_metadata_missing: { text: "缺少这一季或这一集的元数据，没有写占位文件", action: "刷新元数据后重新刮削" },
+  scrape_internal_error: { text: "刮削过程中出错", action: "查看日志后重新刮削" },
   scrape_write_failed: { text: "写入目录失败", action: "检查目录权限后重新刮削" },
   scrape_image_failed: { text: "图片没下载成功", action: "稍后重新刮削" },
   scrape_no_episode: { text: "文件名里认不出集号" },

packages/contracts/src/scrape.ts

@@ -14,11 +14,16 @@ export const ScrapeFileResult = z.object({
   action: z.enum(["written", "skipped", "failed"]),
   /** 跳过 / 失败原因码(reasons.ts:scrape_exists / scrape_write_failed / scrape_image_failed …) */
   reason: z.string().nullable(),
+  /** 本工具写入(或核对未变)时文件内容的 sha256;「更新」模式据此判断文件之后有没有被人改过 */
+  hash: z.string().nullable().optional(),
 });
 export type ScrapeFileResult = z.infer<typeof ScrapeFileResult>;
 
-/** missing = 只补缺失;overwrite = 全部覆盖 */
-export const ScrapeMode = z.enum(["missing", "overwrite"]);
+/**
+ * missing = 只补缺失;overwrite = 全部覆盖;
+ * update = 更新(缺省):不存在的写入,本工具上次写入且没被改过的用新内容覆盖,被改过 / 不是本工具写的不动
+ */
+export const ScrapeMode = z.enum(["missing", "overwrite", "update"]);
 export type ScrapeMode = z.infer<typeof ScrapeMode>;
 
 export const ScrapeStatus = z.enum(["queued", "running", "succeeded", "partial", "failed"]);

packages/contracts/src/settings.ts

@@ -78,8 +78,11 @@ export const OrganizeSettings = z.object({
   minSizeBytes: z.number().int().nonnegative(),
   /** SCR-1:整理入库成功后自动刮削(往媒体库目录写 NFO 与图片);缺省关(同 MP 目录「刮削」缺省) */
   scrapeAfterImport: z.boolean(),
-  /** SCR-1:目标文件已存在时 missing = 只补缺失(MP「仅缺失」)/ overwrite = 全部覆盖 */
-  scrapeMode: z.enum(["missing", "overwrite"]),
+  /**
+   * 目标文件已存在时:update = 更新(缺省;只覆盖本工具写过且没被改过的文件)/ missing = 只补缺失(MP「仅缺失」)/
+   * overwrite = 全部覆盖
+   */
+  scrapeMode: z.enum(["missing", "overwrite", "update"]),
   /** SCR-1:下载海报、背景图、季海报 */
   scrapeImages: z.boolean(),
   /** SCR-1:下载每集剧照(`<视频名>-thumb.jpg`) */
@@ -642,7 +645,7 @@ export const DEFAULT_SETTINGS: GlobalSettings = {
     allowCrossVolumeMove: true,
     minSizeBytes: 50 * 1024 * 1024,
     scrapeAfterImport: false,
-    scrapeMode: "missing",
+    scrapeMode: "update",
     scrapeImages: true,
     scrapeEpisodeThumbs: true,
   },