用途:把 Obsidian 仓库中标记的链接自动整理并本地化存档,形成含文本、图片、视频和附件的完整 Markdown 素材库,实现从发现链接到本地保存的流程。
主要能力:分四阶段运行。先是扫描带 #Marker-待下载 的文件,提取 time 与 source,生成 YAML 下载列表并将标签改为 #Marker-下载中-YYYYMMDD;随后等待用户确认;确认后执行下载,YouTube 与 X(Twitter)链接用 yt-dlp 以最高画质下载并保留全量 JSON 元数据(--write-info-json),无法识别或未配置下载方式的站点直接标记为“下载失败(未识别站点)”;每个任务建立独立目录,命名 [YYYY-MM-DD-HH] {分类} {描述/ID},主文档为同名 .md,视频、JSON、图片等资产放在同目录并用相对路径引用;最后回写列表状态,并将原文件标签更新为 #Marker-已下载-YYYYMMDD。
使用方式:在 Vault 根目录的 AGENTS.md 中配置“下载列表目录位于”(--list-dir)与“下载内容目录位于”(--archive-dir)。Agent 先读取该文件解析路径,再调用 scripts/collect_links.py(传 --vault-path 与 --list-dir),确认后调用 scripts/process_downloads.py(传 --list-file 与 --archive-dir)。路径应从 AGENTS.md 读取而非硬编码。
依赖与限制:依赖 yt-dlp、MarkItDown 或 Pandoc、ffmpeg。除已识别站点外不尝试下载;下载失败会记录原因且不中断后续任务。其他未识别站点与更多配置细节暂未提供。