Video Finder

帮助用户搜索、筛选并下载成人影片。支持 yt-dlp 下载、偏好记忆、代理配置、进度监控和反馈闭环。触发：找片、搜片、下片、下载视频、JAV、Pornhub 等

video-finder — 找片下载技能

搜索、筛选并下载成人影片。

前置条件

• 称呼约定：{{{user}}} 为占位符，实际对话时根据上下文自然称呼
• yt-dlp 安装在宿主机
• 工作目录：skill 所在目录（相对路径，所有 JSON/MD 文件都在此目录下）
• 偏好配置：./preferences.json（首次从 preferences.example.json 复制）
• 代理配置：./proxy.json（首次从 proxy.example.json 复制）
• 下载跟踪：./tracking/downloads.json（首次从 tracking/downloads.example.json 复制）
• 记忆文件：./history.md（首次从 history.example.md 复制）
• 下载目录：无默认值，由用户指定或自动探测
• 默认工作空间：./workspace（最终回退目录）

子技能

技能	文件	职责
偏好管理	preferences.md	偏好初始化、修改、标签维护
代理探测	proxy.md	网络可达性探测、代理配置
搜索	search.md	多引擎搜索、自动筛选、结果展示
下载	download.md	目录确定、yt-dlp 下载、进度跟踪、清理
反馈闭环	feedback.md	观后反馈、正负面标签提炼

完整工作流程

Phase 0: 代理探测

委托给 video_finder_proxy：每次访问站点前探测可达性。

Phase 1: 接收任务

text

收到请求
├─ 检查 preferences.json（首次→委托 video_finder_preferences 初始化）
├─ 检查 proxy.json（首次→跳过，不通时委托 video_finder_proxy 初始化）
│
├─ 用户给关键词 → 走 Phase 2 搜索
├─ 用户给链接 → 走 Phase 3 下载
└─ 用户说"改偏好" → 委托 video_finder_preferences 覆盖配置

Phase 2: 搜索

委托给 video_finder_search：

1. 探测目标站点可达性（→ video_finder_proxy）
2. 多搜索引擎查询
3. 获取页面内容（web_fetch / browser）
4. 基于 preferences.json 自动筛选
5. 展示结果供用户选择

→ 用户选定 → Phase 3
→ 用户不满意 → 换关键词重新搜

Phase 3: 下载

委托给 video_finder_download：

1. 确定下载目录（preferences → 自动沿用上次 → 首次询问 → 探测 → 回退）
2. 代理判断（→ video_finder_proxy）
3. 启动 yt-dlp（文件跟踪法，支持跨 session）
4. 定时进度检测（动态 cron + 心跳 cron）
5. 完成后清理

Phase 4: 结果

text

成功 ✅
→ 告知{{{user}}}：文件名、路径、文件大小
→ 追加记录到 history.md

失败 ❌
→ 告知原因：链接失效 / 画质不足 / 代理 Timeout / 站点被墙
→ 询问是否换源继续

Phase 5: 反馈闭环

委托给 video_finder_feedback：

• 轻量提醒一次（不追问）
• 根据反馈更新 tag_weights / author_weights 权重
• 追加反馈记录到 history.md

🚫 红线

规则	说明
用户确认后才下载	不能替用户决定下载哪个，只能推荐
不主动整站翻页搜刮	用户给了方向才搜
不关注剧情标签	默认忽略剧情关键词（可在 preferences.json 配置 plot_tags: true 开启）
下载目录动态确定	preferences → 自动沿用上次 → 首次询问 → 探测 → 回退到 workspace
proxy.json 保密	不在对话/日志中输出密码
反馈闭环	看完后提醒一次（不追问），维护 tag_weights 加权标签

♻️ 用户随时可干预

text

"改下偏好"       → 委托 video_finder_preferences 覆盖 preferences.json
"换个代理"       → 委托 video_finder_proxy 覆盖 proxy.json
"这次不用代理"   → 不加 --proxy，不写文件
"记得这个代理"   → 写入 proxy.json 持久化