When to Use
- - 用户发来单个视频链接，希望自动下载并归档
- 需要复用既有 yt-dlp 下载规则与元数据补全规则
- 需要把下载结果写入指定飞书多维表格
- 需要对已存在文件做补全、核对或补记录，而不是盲目重下
Quick Reference
| Topic | File |
|---|
| 主流程 | INLINECODE0 |
| 飞书表字段映射 |
bitable-mapping.md |
| 错误与终止规则 |
error-handling.md |
| 执行脚本 |
scripts/run_video_archive.py |
| 使用说明 |
usage.md |
Core Rules
- 1. 只处理单个视频链接；不处理播放列表、频道页、多链接批量任务。
- 必须先调用
scripts/run_video_archive.py <url> 完成预检、主键生成、本地查重、下载/补全和字段组装。 - 主键固定为
站点-视频ID，同时写入“视频主键”和“视频唯一ID”。 - 本地归档目录固定为
~/Downloads/yt-dlp/<上传者目录>/；优先用 @handle 作为上传者目录名。 - 默认下载最高质量版本、优先 mkv、保留
.info.json，并沿用现有元数据补全规则。 - 下载脚本只负责本地执行与生成
record_fields；飞书写表必须使用平台提供的 feishu_bitable_app_table_record 工具完成。 - 写入飞书前若发现字段缺失、字段类型不匹配，或需要新增字段，必须暂停并先询问用户。
- 已存在文件时优先补全与补记录，不要因为路径变化就直接重下。
何时使用
- - 用户发来单个视频链接，希望自动下载并归档
- 需要复用已有的 yt-dlp 下载规则与元数据补全规则
- 需要将下载结果写入指定的飞书多维表格
- 需要对已存在的文件进行补全、核对或补记录，而不是盲目重新下载
快速参考
| 主题 | 文件 |
|---|
| 主流程 | workflow.md |
| 飞书表字段映射 |
bitable-mapping.md |
| 错误与终止规则 | error-handling.md |
| 执行脚本 | scripts/run
videoarchive.py |
| 使用说明 | usage.md |
核心规则
- 1. 仅处理单个视频链接；不处理播放列表、频道页面、多链接批量任务。
- 必须先调用 scripts/runvideoarchive.py 完成预检、主键生成、本地查重、下载/补全及字段组装。
- 主键固定为 站点-视频ID，同时写入“视频主键”和“视频唯一ID”。
- 本地归档目录固定为 ~/Downloads/yt-dlp/<上传者目录>/；优先使用 @handle 作为上传者目录名。
- 默认下载最高质量版本、优先 mkv、保留 .info.json，并沿用现有元数据补全规则。
- 下载脚本仅负责本地执行与生成 recordfields；飞书写表必须使用平台提供的 feishubitableapptable_record 工具完成。
- 写入飞书前若发现字段缺失、字段类型不匹配，或需要新增字段，必须暂停并先询问用户。
- 已存在文件时优先进行补全与补记录，不要因路径变化就直接重新下载。
