feat(scrape): 任意目录就地刮削,按路径识别作品,每次刮削一条记录(SCR-2)

- POST /files/scrape 改为对目录 / 视频文件刮削:已登记用作品,否则按路径识别(本地 + TMDB),
  认不准返回候选,选定后再提交;未登记直接用 TMDB 字段,addToLibrary 顺手建作品
- 作品详情重新刮削、入库后自动刮削改为对作品目录刮削,同一实现
- 迁移 0058_scrape_record 替代 media_scrape;GET /files/scrape-records
- 与 MP ScrapingChain 的文件布局差分(7 个场景,3 处登记偏离)

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

packages/contracts/src/api.ts

@@ -21,6 +21,7 @@ import * as organization from "./organization.ts";
 import * as pi from "./pi.ts";
 import * as policy from "./policy.ts";
 import * as schedules from "./schedules.ts";
+import * as scrape from "./scrape.ts";
 import * as search from "./search.ts";
 import * as settingsNs from "./settings.ts";
 import { GlobalSettings, GlobalSettingsUpdate } from "./settings.ts";
@@ -1551,10 +1552,19 @@ export const Api = {
       method: "post",
       path: "/files/scrape",
       scope: "organize.execute",
-      summary: "刮削已登记作品（字段级刷新，遵守字段锁；NFO 投影 W5）",
+      summary:
+        "刮削：对目录或视频文件就地写 NFO 与图片（按路径识别作品，不要求已登记；认不准时返回候选，选定后再提交）",
       body: files.FilesScrapeRequest,
       response: files.FilesScrapeResult,
     }),
+    scrapeRecords: ep({
+      method: "get",
+      path: "/files/scrape-records",
+      scope: "organize.read",
+      summary: "按 id 查刮削记录（目录、识别结果、逐文件结果）",
+      query: files.FilesScrapeRecordsQuery,
+      response: files.FilesScrapeRecordsResult,
+    }),
     probe: ep({
       method: "post",
       path: "/files/probe",
@@ -2244,8 +2254,8 @@ export const Api = {
       scope: "organize.execute",
       summary: "刮削：把作品的 NFO 与图片写进媒体库目录（后台任务 scrapeMedia；覆盖方式缺省按设置）",
       params: IdParam,
-      body: organization.LibraryScrapeRequest,
-      response: organization.LibraryScrapeResult,
+      body: scrape.LibraryScrapeRequest,
+      response: scrape.LibraryScrapeResult,
     }),
     reconcile: ep({
       method: "post",