SuperAPI AI 工具集

lazycat-movie-search

通用与其它

查看项目

更新于 10-16 10:18

技能介绍

懒猫微服电影搜索(lazycat-movie-search)当前版本为 0.1.4。

【用途】 当用户明确调用“懒猫微服电影搜索”,或要求搜索电影、按分辨率选择电影资源,并可在确认后添加到 VueTorrent/qBittorrent 时使用。该技能设计为懒猫微服内网自用工作流,面向用户已经配置并授权访问的 YTS API 与 VueTorrent/qBittorrent 实例。

【主要能力】

  1. 搜索 YTS 电影资源,支持按关键词和分辨率筛选。
  2. 展示候选电影和可用分辨率、Seeds/Peers、torrent 链接、magnet 链接。
  3. 询问用户要添加哪一部、哪个分辨率。
  4. 用户确认后,把对应 magnet 添加到 VueTorrent/qBittorrent,默认启用顺序下载。
  5. 检查 VueTorrent 全局上传限速;如果未设置,自动设为 128 KiB/s。
  6. 全程用中文说明网络、API、登录失败等错误。
  7. 支持列出任务与查看下载状态。

【使用方式】 本技能目录内有两个脚本,优先调用脚本,不要手写 API 请求:

  • ./scripts/yts-api.sh:搜索电影,输出每个资源的 .torrent 和 magnet。
  • ./scripts/vuetorrent-api.sh:登录 VueTorrent、列出任务、添加 magnet、检查上传限速。

搜索示例: ./scripts/yts-api.sh search "<关键词>" --limit 10

如果用户明确指定分辨率,加上: --quality 1080p

可用分辨率:480p、720p、1080p、1080p.x265、2160p、3D。

向用户展示结果时,保留这些字段:电影标题和年份、IMDb ID 或 YTS ID、分辨率/编码/大小、Seeds/Peers、magnet 链接或说明“已找到 magnet”。如果候选结果很多,先列 5-10 个最相关结果,并问用户要哪一部和哪个分辨率。

添加到 VueTorrent: 用户选定 magnet 后,先检查上传限速: ./scripts/vuetorrent-api.sh upload-limit

然后添加任务: ./scripts/vuetorrent-api.sh add '<MAGNET>' 默认会启用顺序下载。不要加 --no-sequential,除非用户明确要求关闭顺序下载。

如果用户提供了保存路径: ./scripts/vuetorrent-api.sh add '<MAGNET>' --save-path '<PATH>'

VueTorrent 配置: ./scripts/vuetorrent-api.sh 默认使用懒猫“应用互访”地址: URL:http://app.<VueTorrent 应用 ID>.lzcx 默认应用 ID:cloud.lazycat.app.vuetorrent 用户名:admin 密码:adminadmin 系统票据:最新系统会自动注入 X-HC-USER-TICKET,技能不需要单独处理,也不要向用户索取 ticket。 不要默认使用 vuetorrent.<微服名>.heiyu.space 这类公网域名做应用间访问。懒猫应用互访应走 http://app.<target-app-id>.lzcx。

如果用户给了新的应用 ID、访问地址、账号或密码,应使用脚本参数: ./scripts/vuetorrent-api.sh
--pkg-id '<VUETORRENT_PKG_ID>'
--username '<USERNAME>'
--password '<PASSWORD>'
login

也可以把这些参数用于其他命令: ./scripts/vuetorrent-api.sh --pkg-id '<VUETORRENT_PKG_ID>' list

--url '<URL>' 只用于显式覆盖,例如调试或非懒猫环境。

列出任务: 用户问下载状态时: ./scripts/vuetorrent-api.sh list all ./scripts/vuetorrent-api.sh downloading ./scripts/vuetorrent-api.sh completed ./scripts/vuetorrent-api.sh maindata 用中文概括任务名称、状态、进度、下载速度、上传速度、顺序下载状态。

【适用场景】 适合在懒猫微服内网和个人私有环境中使用:懒猫微服提供稳定的本地运行环境、应用互访能力和私有数据空间;VueTorrent/qBittorrent 负责实际下载与任务管理;小龙猫/Hermes Agent 负责理解用户意图、搜索电影、询问用户选择,并调用脚本自动添加任务。可减少手动复制 magnet、切换网页和重复配置的步骤。

【限制与错误处理】 所有失败都要用中文说明,并给下一步建议。

  • YTS 搜索失败时:网络不通/DNS/TLS 说明“访问 YTS API 失败,可能是网络或域名解析问题”;HTTP 4xx/5xx 说明“YTS API 返回错误”,建议稍后重试或换关键词;无结果说明“没有找到匹配电影”,建议换中英文片名、年份或 IMDb ID。
  • VueTorrent 失败时:登录失败说明账号密码或应用互访地址可能不正确,同时提醒用户确认 VueTorrent 应用已安装并正在运行;403 说明应用可能没有启动、应用 ID 不正确,或 VueTorrent 服务端拒绝请求,不要要求用户单独提供 ticket;连接失败/DNS 失败说明 http://app.<target-app-id>.lzcx 无法访问,应要求用户检查 VueTorrent 应用 ID 是否正确、应用是否安装、是否启动,VueTorrent 默认应用 ID 是 cloud.lazycat.app.vuetorrent;添加失败说明 magnet/torrent 可能无效,或 VueTorrent/qBittorrent 拒绝请求;上传限速设置失败说明任务可以继续,但建议用户稍后检查 VueTorrent 设置。
  • 不要把长堆栈或完整 HTML 错误页直接贴给用户,只摘取关键错误信息。

回答风格:始终中文;先给可操作结果,再解释;搜索结果要让用户容易选择;用户确认后再添加到 VueTorrent,除非用户一开始明确说“直接添加 1080p”。

关于费用、价格、平台支持范围等具体信息,资料中暂未提供。