核心用法
dl 是一款本地化媒体下载工具，通过 Python 脚本调用 yt-dlp 等底层引擎，支持从 YouTube、Bilibili、X（Twitter）等主流平台下载视频或音频。用户可通过自然语言指令（如"Download this video"）或命令行触发，URL 自动识别媒体类型：视频保存为 MP4 至 ~/Movies/ 或 ~/Videos/，音频保存为 M4A 至 ~/Music/，播放列表则创建子目录归档。
显著优点
- 零配置开箱即用：依赖
uv运行时自动管理，无需手动安装 Python 包 - 智能分类归档：根据媒体类型自动选择存储路径，播放列表保持结构完整
- 家庭媒体生态集成：原生设计配合 Universal Media Server、Jellyfin 等 DLNA 服务器，下载内容即时同步至电视、手机等设备
- Telegram 增强体验：音频文件支持直接回传至聊天窗口，省去手动查找步骤
潜在局限与风险
- 版权合规依赖用户自律：工具本身不验证下载内容的版权状态，需用户自行确保合法使用
- 平台反爬对抗：YouTube 等站点频繁更新反爬策略，可能导致间歇性下载失败，需跟进 yt-dlp 更新
- 无内置代理/加速：大陆用户访问 YouTube 需自行配置网络环境，工具层不提供绕过方案
- 单线程设计：未提及多路下载或批量队列管理，大规模归档效率受限
适合人群
- 自建 NAS/家庭媒体服务器的影音爱好者
- 需要离线备份教学视频、播客内容的重度学习者
- 追求"下载-电视播放"无缝体验的非流媒体依赖用户
常规风险提示
- 下载受版权保护内容可能违反服务条款及当地法律
- 第三方脚本执行需信任作者（guoqiao）及
uv供应链安全 - 建议定期检查
dl.py源码变更，防止恶意代码注入