#图片、音频和视频上传

NotionHub 除了同步文字和链接，也会尽量把头像、封面、正文图片、音频或视频保存到 Notion。

#默认会同步哪些媒体

多数服务会自动处理轻量媒体：

• 头像。
• 封面。
• 正文图片。
• 外部图片链接。

如果上传到 Notion 失败，部分服务会降级为外部链接，尽量避免页面没有图片。

#哪些属于大文件上传

大文件上传通常需要你在插件设置中手动开启。

常见服务包括：

• B 站：上传选中收藏夹中的视频。
• YouTube：上传选中播放列表中的视频。
• 网易云音乐：上传音频文件。
• Apple Music：上传音频文件。
• 小红书：上传图片或视频。
• 长毛象：上传嘟文中的图片、GIFV、视频或音频；正文写入不依赖媒体成功。

Telegram 收件箱会处理你主动发送或转发给 Bot 的照片、相册、视频、音频、语音和文件。NotionHub 使用自托管 Telegram Bot API；20 MiB 是服务端直传阈值，不是产品下载上限。更大的附件会自动触发你自己的 GitHub-hosted Runner，以 10 MiB 分片上传到 Notion。最终单文件上限以 Notion 当前工作区返回的限制为准。超限时会优先保存文字、caption、来源和文件元数据，并把结果标记为部分成功。

大文件上传会显著增加同步时间。只想保存资料索引时，可以先关闭大文件上传。

#Notion 文件大小限制

Notion 工作区对文件大小有限制。超过限制的音频、视频或大图可能无法上传。长毛象单个媒体还设有 50 MB 的服务上限，并使用工作区限制和服务上限中的较小值；超过单次上传范围的大文件会按 Notion 协议分片。

如果你经常同步音频、视频或大文件，建议确认自己的 Notion 套餐是否支持对应大小。

#上传失败是否影响主同步

不一定。

很多服务会把媒体上传作为辅助步骤。即使某个图片、音频或视频上传失败，文字数据、链接、日期和关系仍可能已经同步成功。

你可以先查看 Notion 中是否已有主数据。如果只有媒体缺失，可以稍后重新运行补充。

#为什么上传很慢

常见原因：

• 第三方平台下载速度慢。
• GitHub Action 网络不稳定。
• 文件数量多或文件体积大。
• Notion 上传接口限速。
• Telegram 媒体网关暂时不可用，或用户 GitHub Action 未配置/运行失败。
• 首次同步需要处理历史数据。

如果任务经常超时，可以先关闭大文件上传，再运行一次确认主数据是否正常。

#如何减少上传耗时

建议：

• 只开启自己真正需要的大文件上传。
• B 站和 YouTube 只选择少量重点收藏夹或播放列表。
• 首次同步先关闭大文件上传，确认主数据正常后再开启。
• 如果 Notion 免费版无法上传大文件，就保留外部链接。

#隐私说明

上传到 Notion 的文件会保存在你的 Notion 工作区中。NotionHub 只负责把文件写入你授权的模板。

请不要同步没有权限保存或分享的第三方内容。部分平台可能会限制下载或上传，遇到限制时 NotionHub 会尽量保留原始链接。