feat(subtitles): 字幕站(SubHD、字幕库)在线搜索与下载;rar / 7z 解压;验证码与页面解析在沙箱里

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

packages/contracts/src/api/subtitles.ts

@@ -28,6 +28,22 @@ export const subtitlesApi = {
       body: subtitles.SubtitleApplyRequest,
       response: subtitles.SubtitleApplyResult,
     }),
+    search: ep({
+      method: "post",
+      path: "/subtitles/search",
+      scope: "read",
+      summary: "在已启用的字幕站（SubHD、字幕库）搜这部作品的字幕；按季集、语言、下载量排序",
+      body: subtitles.SubtitleSearchRequest,
+      response: subtitles.SubtitleSearchResponse,
+    }),
+    fetch: ep({
+      method: "post",
+      path: "/subtitles/fetch",
+      scope: "read",
+      summary: "下载一条在线字幕并解析（同上传：解压、转 UTF-8、语言与季集、配对建议；不写文件）",
+      body: subtitles.SubtitleFetchRequest,
+      response: subtitles.SubtitleParseResponse,
+    }),
     writes: ep({
       method: "get",
       path: "/subtitles/writes",