feat(subtitles): 字幕库验证码由智能体视觉接管;字幕站原站视图下载当前字幕

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

packages/contracts/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@umt/contracts",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "exports": { ".": "./src/index.ts" },
   "tasks": {
     "test": "deno run -A npm:vitest run",

packages/contracts/src/subtitles.ts

@@ -188,10 +188,14 @@ export const SubtitleSearchResponse = z.object({
 });
 export type SubtitleSearchResponse = z.infer<typeof SubtitleSearchResponse>;
 
-export const SubtitleFetchRequest = z.object({
-  entityId: Id,
-  siteId: Id,
-  ref: z.string().min(1).max(500),
-  title: z.string().max(500).default(""),
-});
+/** 下载一条在线字幕:搜索结果给 siteId + ref;原站视图里人工打开的字幕页给 sessionId(取当前页与浏览器里的 Cookie) */
+export const SubtitleFetchRequest = z
+  .object({
+    entityId: Id,
+    siteId: Id.optional(),
+    ref: z.string().min(1).max(500).optional(),
+    sessionId: Id.optional(),
+    title: z.string().max(500).default(""),
+  })
+  .refine((v) => !!v.sessionId || (!!v.siteId && !!v.ref), { message: "给 sessionId，或 siteId 加 ref" });
 export type SubtitleFetchRequest = z.input<typeof SubtitleFetchRequest>;