用途
youtube-acquire 用于将 YouTube 来源素材采集到本地 yt-insights 语料库。它支持视频、播放列表、频道以及字幕（transcript）等来源类型，适合需要把 YouTube 内容纳入本地分析语料的场景。
主要能力
- 通过打包的 yt-insights CLI 执行采集流程。
- 支持在预览阶段使用过滤器，例如 --slug、--years、--lang、--analyze。
- 预览会展示选中数量、来源类型、输出目标、字幕语言以及是否启用分析，并报告排除项和发现错误。
- 采集完成后报告 selected、transcripts_ready、insights_ready 以及失败项的数量与详情。
使用方式
- 运行 yt-insights doctor --json 进行环境检查。若必需检查失败则停止，并报告失败的检查项，但不暴露配置值。
- 构建预览：yt-insights acquire SOURCE --dry-run --json，将 SOURCE 替换为用户来源，并仅添加用户要求的过滤器。
- 汇总预览信息：选中数量、来源类型、输出目标、字幕语言、是否启用分析，并报告排除项与发现错误。
- 若来源是单个视频且用户明确要求采集，去掉 --dry-run 重复执行命令。
- 若来源是频道、播放列表或批量，等待用户明确确认预览后，去掉 --dry-run 并加上 --yes 重复执行同一命令。
- 报告 selected、transcripts_ready、insights_ready 以及失败项的数量与详情，并保留预览的输出目标一并报告，不要编造比 CLI 返回更具体的路径。
适用场景
- 需要把单个 YouTube 视频采集到本地语料库。
- 需要批量采集频道或播放列表内容。
- 需要获取字幕并可能启用分析。
限制与注意事项
- 采集必须在主会话中运行，因为它需要访问网络并修改本地语料库。
- 不要用下载器命令或直接编辑语料库来替代此工作流。
- 不要在预览命令中添加 --yes。
- 如果 CLI 报告与浏览器 cookies 相关的认证或机器人检查失败，建议用户使用 --cookies-from-browser chrome 重新进行显式预览，不要预先添加该参数。
- 不要仅凭预览就声称字幕或洞察已就绪。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。