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

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

docs/plan/README.md

@@ -31,7 +31,7 @@
 
 ### 进行中
 
-- 补字幕：[subtitles.md](subtitles.md)，第 1、2 步已完成；待办：以后接进整理 / 订阅工作流；站点验证码识别真出现失败时再接智能体视觉兜底。
+- 补字幕：[subtitles.md](subtitles.md)，第 1、2 步已完成；待办：以后接进整理 / 订阅工作流。
 - 沙箱第二批：站点网页、RSS、网页抓取的 HTML / XML 解析迁入常驻子进程池（ADR-005）。
 
 ### 业务（需要真实环境或决定）

docs/plan/subtitles.md

@@ -26,15 +26,19 @@
 ## 在线（SubHD、字幕库）
 
 - 搜索词：作品中文名、原名、年份，剧集带季号；结果按标题与季集匹配度排序，对不上的不列。
-- 验证码三层兜底：① 代码识别（SubHD SVG 路径长度表、字幕库 BMP 采样模板，插件里各 80 行左右）；② 浏览器服务打开页面（与 PT 站过人机验证同一流程，可人工接管）；③ 智能体视觉处理页面挑战。
+- 验证码：① 代码识别（SubHD SVG 路径长度表、字幕库 BMP 采样模板，在沙箱里）；② 没过就由智能体视觉在浏览器里接管；③ 智能体也没过就转人工。
+  - 何时接管：字幕库请求遇到云锁验证码页，沙箱识别提交 3 次仍是验证码页（或识别不出字符），且自动化总开关开着。SubHD 现在的下载页前端已没有验证码这一步（2026-10-03 抓页确认），只保留旧 SVG 识别，不接管。
+  - 怎么接管：用该字幕站的匿名浏览器会话打开同一地址；页面已不是验证码页（例如人刚在原站视图里过过）就直接算过；否则派视觉子流程（系统发起，截图读码、输入、点「点击继续访问网站」，≤ 6 步、1 次，预算取智能体设置），按页面上「网站访问认证页面」字样消失核实。
+  - 结果：过了 → 读回浏览器里该站的 Cookie 并进字幕库请求的 Cookie 罐，重开原页面，搜索 / 下载照常继续，用户无感；没过 → 会话转等待处理，待处理事项「字幕库需要你在原站视图里过一次验证码」（附子流程每步截图），本次搜索报错并提示去原站视图；人过完交还后再搜，接管时发现页面已放行，直接带回 Cookie。
+- 原站视图手动下载（与 PT 站「下载当前资源」同一思路）：字幕站的原站视图工具栏是「下载当前字幕」。人在原站视图里打开一条字幕详情页（SubHD `/a/<sid>`、字幕库 `/detail/<id>.html`）→ 点按钮 → 选作品 → 补字幕对话框自动带着浏览器里的 Cookie 下载这一条、解压、按季集配对到视频，可逐个改写到哪个视频后写入，历史记来源。
 - 下载结果走与上传相同的解析 → 预览 → 写入。
 
 ## 分步
 
 1. 手动上传：解析、配对预览、写入、历史与撤销、作品页入口。（v0.3.22 完成）
 2. 字幕站类型 + SubHD / 字幕库搜索下载（第 ① 层验证码），站点页与添加站点；rar / 7z。（v0.3.24 完成；解压、页面解析、验证码都在沙箱里，见 ADR-005）
-3. 验证码第 ② ③ 层兜底：Cloudflare 挑战已由站点出口自动走浏览器；站点自己的验证码（云锁 / SubHD）识别失败时，目前提示去原站视图手动处理，智能体视觉处理待接。
+3. 验证码智能体视觉接管 + 原站视图「下载当前字幕」。（v0.3.25 完成）
 
 实测记录（2026-10-03）：字幕库搜索、验证码、下载、解压、配对全链路通；SubHD 搜索通，下载流程与单独实测一致，但当晚测试请求较多后 SubHD 对本机限流（直连与代理都超时），需要隔天复测。
 
-复测（2026-10-03 晚）：SubHD 按豆瓣 ID 搜索、prepare-download、下载全通，连续下载 7 个未触发验证码。验证码第 ② ③ 层先不做：第 ① 层失败时已提示去原站视图手动下载再上传，等实际出现识别失败再接。
+复测（2026-10-03 晚）：SubHD 按豆瓣 ID 搜索、prepare-download、下载全通，连续下载 7 个未触发验证码。