Apple Music 同步到 Notion
NotionHub 可以把 Apple Music 系统「喜爱歌曲」歌单中的歌曲，以及关联的歌手、专辑整理到 Notion，方便建立自己的音乐收藏库。
可以同步什么
当前同步范围是系统「喜爱歌曲」歌单，不包含整个媒体库或所有自建歌单。仅将一首歌加入资料库，不代表它会进入同步范围；请先在 Apple Music 中将歌曲标记为喜爱，并确认系统歌单中能看到它。
歌曲日期优先使用 Apple 返回的加入日期；新建记录没有该日期时，会使用同步当天。日期和热力图不能用来统计实际播放时间、播放次数或收听时长。
使用前准备
- 安装最新版 NotionHub 浏览器插件，并登录 NotionHub。
- 在安装插件的同一个浏览器中，确认可以登录 Apple Music 网页版，并访问自己的「喜爱歌曲」歌单。
- 准备自己的 Notion 工作区，使用插件提供的 Apple Music 模板。
- 按插件提示连接 GitHub，用于运行同步任务，参见 GitHub Action 同步。
- 确认服务有可用的体验次数或已激活，具体范围以插件显示为准，参见 免费体验与激活。
资料同步以 Apple 网页能够返回账号歌单为前提。音频和歌词下载还需要有效的 Apple Music 订阅及可用的网页登录状态；插件显示「已登录」不代表订阅、播放或下载权限一定有效。NotionHub 服务激活也不包含 Apple Music 订阅。
第一步：复制并授权 Notion 模板
- 打开 NotionHub 插件，在服务列表中选择「Apple Music」。
- 在「Notion 模板」卡片点击「去复制」。
- 在 Notion 授权页面选择开发者提供的模板，确认工作区并允许访问。
- 返回插件，等待模板显示已配置，再点击「打开模板」确认页面。
如果插件提示提交链接，请提交复制到自己工作区后的模板页面链接。不要使用空白页面替代模板，也不要提交官方模板预览链接。
请保留歌曲、歌手、专辑、歌单及日期相关数据库的字段类型和关系。可以调整视图，更多说明见 Notion 模板与授权。
第二步：连接 Apple Music
- 在 Apple Music 账号卡片点击「去登录」。
- 在打开的 Apple Music 网页中登录日常使用的 Apple 账号，并按浏览器提示允许插件访问相关网站。
- 打开资料库中的「喜爱歌曲」，刷新网页，必要时播放一首可以正常播放的歌曲，让网页加载账号数据。
- 返回插件，等待账号卡片显示「已登录」。
只在 iPhone 或 Mac 的音乐 App 中登录，不能替代浏览器中的连接。插件会识别网页登录状态，无需手动复制 Cookie 或 Token。
第三步：设置音频和歌词上传
打开「同步设置」，在「媒体文件」中按需开启「上传音频和歌词」。关闭时仍会同步歌曲、歌手、专辑等基础资料；首次使用可以先关闭，确认歌曲正常写入后再开启。
开启后会尝试补充缺失的文件，但并非每首歌曲都能下载：
- Apple Music 订阅及网页登录状态需要有效。
- 曲目需要有可获取的音频和歌词；下架、地区限制或 DRM 保护可能导致无法获取音频。
- 仅有个人云端资料库链接、未对应到 Apple Music 流媒体曲目的歌曲，会跳过音频下载。
- 文件还需符合 Notion 工作区或所用存储的上传限制，参见 图片、音频和视频上传。
没有歌词时，页面可能显示暂无歌词的占位内容。播放器或歌曲页面已经出现，也不代表完整音频已经上传成功。
热力图、通知和其它选项以插件实际展示为准，参见 同步设置。
第四步：开始同步并查看结果
完成模板和账号连接后，点击「开始同步」。如果提示连接 GitHub，点击「连接 GitHub」并完成授权，再按提示继续。
通过插件的运行记录或对应的 GitHub Action 查看进度；任务未结束时，避免重复点击。运行完成后，打开 Notion 模板，检查歌曲、歌手、专辑以及「喜爱歌曲」歌单之间的关联。开启媒体上传时，还需查看歌曲中的音频、歌词是否已经补齐。
日常同步会识别已存在的歌曲并补充新记录。需要重新检查当前可获取的歌曲资料时，可以在权益允许时使用「全量同步」。全量同步仍只处理「喜爱歌曲」，不会扩大到全部媒体库或恢复 Apple 已不再返回的内容。
在 Apple Music 中取消喜爱，不会自动删除已经写入 Notion 的页面。在 Notion 中编辑歌曲资料，也不会回写 Apple Music。
常见问题
为什么媒体库里有很多歌，Notion 中却没有？
先检查网页版「喜爱歌曲」中是否能看到这些歌曲。当前只读取该系统歌单，普通资料库歌曲、自建歌单中的歌曲不会因此自动同步。还需确认最近一次运行已完成，并检查体验条数限制。
已标记喜爱，仍提示没有找到歌单怎么办？
确认网页登录的是正确账号，并在网页端打开系统「喜爱歌曲」。当前可识别的歌单名称包括「喜爱歌曲」「喜欢的歌曲」「Favorite Songs」「Loved Songs」。如果网页显示其它本地化名称，或没有生成该系统歌单，请联系 技术支持 核实，不要用普通自建歌单替代。
网页已登录，插件为什么没有识别？
确认网页与插件位于同一个浏览器，并已允许网站访问权限。打开资料库、刷新网页或播放歌曲后回到插件重试；连接失效时点击「重新登录」。只打开公开专辑介绍页，可能没有加载账号数据。
有订阅，为什么仍然没有音频或歌词？
有效订阅只是前提。还要检查「上传音频和歌词」是否开启、对应处理是否完成，以及该曲目是否存在可下载资源。个人云端曲目、DRM 限制或上传失败都可能造成文件缺失。此时歌曲资料可能已经同步成功，不能仅凭缺少音频判断基础同步失败。