用途：把艺人名单（如 New-Artists.md 清单、粘贴的名字片段或单个艺人请求）整理为可核验、可下载的本地音乐库，而不是单纯调用 yt-dlp。默认输出根目录为当前工作区的 Downloaded。
主要能力与流程：
- 解析输入并确定范围，规范化勾选行、项目符号与纯文本；对歧义项先调研再提问。
- 调研官方专辑目录，按发行顺序整理录音室专辑或官方原声专辑，并区分 EP、混音带、现场、合辑、豪华版等。可用 MusicBrainz 过滤主线专辑，用 YouTube Music 元数据（含 OLAK5uy_ 播放列表 ID）获取专辑信息。
- 用 Playwright 打开 YouTube 播放列表页，人工/可视化比对标题、频道、曲目数与具体曲目清单，拒绝含额外内容或缺失曲目的列表；未验证的专辑不进入下载阶段。
- 生成人类可读的 Markdown 计划与严格 JSON 清单（artists/albums/url/verified 等字段），供 scripts/download-album-manifest.ps1 使用。
- 全部 verified 后下载，示例：powershell -NoProfile -ExecutionPolicy Bypass -File .\music-downloader\scripts\download-album-manifest.ps1 -ManifestPath .\music-download-manifest.json -OutputRoot .\Downloaded；加 -PlanOnly 可干跑。
- 检查 Downloaded 与 Downloaded/_logs，核对文件夹、文件大小与失败日志，只重试失败专辑。
附带工具：tools/ 下含 collect_ytmusic_catalog.py、build_mainline_catalog_musicbrainz.py、augment_catalog.py、verify_youtube_playlists.cjs、prune_verified_manifest.cjs、compare_library_inventory.cjs、build_library_repair_catalog.cjs、apply_library_repair_moves.ps1、recover_missing_album_tracks.py 等。依赖 ytmusicapi、Playwright、yt-dlp、ffmpeg，需按 references/dependencies.md 在新工作区安装。
限制：年龄限制曲目需认证 cookies；网络或地区受限曲目可能失败；长播放列表可能加载不全；下载后需按实际 MP3 数量对账。价格与收费信息暂未提供。