装上就能干活的 AI 小程序

适用场景

按主题查找 YouTube 公开内容，查看本次采集结果中的热门视频，并在再次采集时比较同一视频的播放量变化。也可将自己拥有版权或已获得下载授权的公开视频保存为 MP4，再导出到本地目录。

核心功能

• 关键词采集与筛选：每次目标数量为 1–100 条，支持内容类型、时长、上传日期、优先顺序及多选视频特征。
• 查看与比较结果：展示封面、时长、内容类型、标题、频道和播放量；同一视频出现在上一次成功采集结果中，且两次播放量均可读取时，显示“较上次”的变化。
• 单条与批量下载：选择 MP4 清晰度上限，确认下载授权后保存可下载的视频。
• 保存与再次导出：最近采集结果、成功采集的搜索设置和下载文件记录保留在当前应用中；新搜索不会清空下载记录。

开始使用

使用前，请确保宿主客户端能够打开 YouTube，并具备可用的下载运行环境。可点击页面底部的 “检查下载环境” 查看依赖检查结果。下载视频还需网络能够访问 YouTube 视频 CDN。

1. 在 “搜索关键词” 中输入 1–200 字符的主题，例如 AI 工具、旅行或 Blender。
2. 设置 “采集数量”，填写 1–100 的整数，默认 20 条。
3. 如需限定范围，点击 “筛选” 展开高级条件；不展开也可直接使用默认的长视频、热门程度条件。
4. 点击 “开始采集”。应用会打开可见的 YouTube 浏览器窗口，进入搜索页并采集公开结果。页面状态区显示打开、导航、等待和已采集数量。

可用筛选条件

时长筛选实际边界为：少于 180 秒、180–1200 秒、超过 1200 秒。选择频道或播放列表时，时长、日期和视频特征会重置并禁用。

“重置筛选” 恢复默认筛选，不清空关键词和采集数量。搜索区下方的标签展示当前条件。

查看与重新采集

采集完成后，在 “采集结果” 查看实际条数和目标条数。点击视频标题可打开 YouTube 来源页面。

• 热门程度：先使用 YouTube 热门优先搜索，再按本次已采集候选的已知总播放量降序排列，不代表全站排名，也不保证穷举所有视频。
• 相关程度：保留网站返回的相关程度顺序。
• “刷新”：按当前输入框和筛选条件重新采集。
• 宽窗口侧栏中的 “恢复本次条件”：将搜索条件恢复为当前显示结果所使用的条件。
• 未找到内容时，可点击 “调整筛选”，减少限制或更换关键词。

实际结果可能少于目标数量。采集有有限滚动次数，总等待最多 90 秒；失败或取消不会覆盖最近成功结果，只有网站明确返回无匹配结果时才保存空列表。

下载并导出视频

单条下载

1. 在 “保存到本地” 区域选择下载清晰度：最高 360p、720p、1080p 或 4K，默认最高 720p。
2. 点击视频行中的 “一键下载”。
3. 若尚未提前勾选授权，会出现 “确认下载授权” 弹窗，显示本次视频数量、清晰度上限和视频标题。
4. 勾选 “我确认拥有这些视频的版权或已获得下载授权”，再点击 “确认并下载”。点击 “取消下载” 不会启动任务。
5. 下载成功后，在系统弹出的保存目录选择器中选择导出目录。

也可提前勾选 “我拥有视频版权或已获得下载授权”，之后发起下载时直接提交任务。该勾选仅在当前界面会话中保留，请仅选择自己有权保存的视频。

批量下载

1. 勾选视频行左侧的复选框，或使用 “全选可下载视频”。
2. 查看已选数量，必要时点击 “清空选择”。
3. 选择清晰度，点击 “下载所选（数量）”，并按提示确认授权。
4. 应用逐条处理视频；单条失败不会阻止后续视频，已成功文件会保留，失败原因显示在对应记录中。
5. 下载结束后，选择目录导出本次成功的文件。

清晰度是上限，会按可用格式向下匹配，并非保证获得所选分辨率。文件为 MP4；无兼容音视频格式或文件校验失败时，会显示错误，不导出不完整文件。

再次导出已有文件

切换到 “下载记录”，查看文件标题、清晰度上限、体积和下载时间，点击 “导出文件” 选择保存目录。

当前结果中，所选清晰度已有保存文件时，按钮会变为 “再次导出”；也可使用 “导出已下载文件”。这些操作只复制已有文件，不重新下载，也不再次要求下载授权。

取消目录选择不会删除应用内已下载文件，可稍后再次导出。导出遇到同名文件时采用重命名方式处理。窄窗口中，下载设置会显示在结果列表上方。

任务控制与注意事项

• 后台执行：切换“采集结果”和“下载记录”或切换页面不会重启、重复或中断任务；重新打开界面可恢复当前运行状态。客户端退出会停止任务，不自动恢复未完成任务。
• 取消与停止：采集时可点击“取消采集”；下载时点击“停止后续下载”只停止后续视频，当前视频继续完成。若需立即终止当前任务，请使用宿主“停止”。同一次运行不能同时进行多个采集或下载任务。
• 公开内容边界：频道和播放列表仅支持打开来源，不能作为单个视频下载；正在直播和预约直播不录制。不处理私密、DRM、付费、已购买、会员、登录限定或需要登录确认年龄的内容。
• 数据精度：当前采集未读取发布日期，结果显示“日期未知”，不影响上传日期筛选交由 YouTube 执行。播放量来自公开页面，缩写数值为近似值；无法读取时显示“未知”。播放量变化仅比较上一次成功采集，不是持续监测或定时自动追踪。
• 筛选不等于下载保证：4K、HD、字幕等特征是 YouTube 搜索条件，不保证下载文件达到 4K 或包含字幕；“知识共享”筛选也不能替代对下载权限的确认。
• 网页验证与网络异常：遇到人机验证或网站同意页面，请在浏览器处理后重新采集。导航失败、空白页或超时会提示错误并保留旧结果；不要在采集中将浏览器切离本次搜索页。
• 下载失败处理：网络重试次数有限，单视频下载最多 900 秒。遇到 CDN 超时可降低到 360p/720p并检查网络后重试；同一次任务尽量续传，新任务不会保留上次临时断点。应用不读取或导出浏览器 Cookie，下载不携带浏览器 Cookie，也不修改宿主代理。