开始前：确认插件里有 Notion 入口
本教程适用于文章库中已显示“Notion · 单向导出（完整版）”入口的版本。打开扩展的内容工作台，进入文章库 → 批量管理 → Notion。如没有入口，请先核对所安装版本；浏览器商店审核与本地测试版本可能不同，本页不表示所有商店版本均已支持。Notion 导出需要有效的完整版权益。
准备一个你能管理的 Notion 工作区和一个普通空白页面。首轮建议只导出一篇带图片的文章，确认结果后再批量处理。
第 1 步：创建 Notion 内部连接
- 打开 Notion 连接管理后台，登录你的 Notion 账号。
- 点击新建连接，名称可填写“我的文章归档”，选择准备接收文章的工作区。
- 连接类型选择 Internal（内部），按页面提示保存。创建内部连接需要工作区所有者权限；找不到目标工作区时，请检查当前登录账号和工作区权限。
第 2 步：在哪里找到 Token（配置密钥）？
在连接管理后台点击刚创建的连接，进入 Configuration（配置），找到 Internal Integration Secret（内部连接密钥），点击显示并使用旁边的复制按钮。Notion 的界面用词可能随版本或语言变化，请找该连接的 API Token／内部密钥。
把密钥直接粘贴到插件的“连接 Token”输入框。Token 是一整段密钥，不是连接名称、工作区名称、页面链接或 Notion 登录密码。不要连同字段名称、引号、空格或换行一起复制，也不要把密钥发到聊天、反馈截图或公开页面中。
第 3 步：开启连接的内容权限
在连接的能力或权限设置中，开启下面三项并保存。评论与用户信息权限不用于这条导出流程。
- Read content（读取内容）：检查目标页面，读取图片块及导出状态。
- Insert content（插入内容）：创建文章子页面和上传资源。
- Update content（更新内容）：将文章里的网络图片替换为上传至 Notion 的图片。
第 4 步：给测试页面授权
- 在同一个工作区创建一个普通页面，例如“微信文章导出测试”。先不要使用数据库作为目标。
- 打开该页面，点击右上角 ••• → 连接／Add connections，搜索并添加刚才创建的内部连接。
- 复制这个页面的完整链接，粘贴到插件的“目标页面链接或 ID”输入框。优先复制链接，不必手工提取 ID。
创建连接和授权页面是两个步骤：有 Token 不代表连接已经能访问目标页面。页面不需要发布到互联网；授权该页面也会让连接访问其子页面，因此建议使用独立的文章归档页面。
第 5 步：测试连接并导出文章与图片
- 回到插件，确认已填写 Token 和目标页面链接，点击“测试并保存连接”。浏览器询问是否允许访问 Notion API 时，确认这个权限请求。
- 显示连接成功后，先勾选一篇带图片的文章，点击“导出所选文章与图片”，确认发送到自己的 Notion 工作区。
- 保持内容工作台打开，等待逐篇处理结果。在 Notion 目标页面下打开新建的文章，检查正文、来源链接和图片。
- 再次导出同一篇文章，正常会跳过已有页面。确认首篇结果后，再选择多篇文章进行批量导出。
“测试并保存连接”确认的是读取权限；创建页面和更新图片的写入权限在实际导出时验证。文章正文、来源和图片由浏览器直接发送到你的 Notion，不经过运营者的内容服务器。Token 仅保存在当前浏览器扩展本地；官网不会要求输入 Token。
图片失败、重试和重复导出怎么处理？
- 图片未完成：正文页面可能已经创建，失败图片保留原网络链接。点击“重试未完成”只继续处理未完成部分。
- 额外图片来源权限：如果出现“授权图片来源并重试”，点击后允许访问对应图片网站，再检查结果。图片过大、格式或工作区限制也可能导致失败。
- 重复导出：同一连接、目标页面和本地文章的已有记录会跳过；本地正文变化也不会自动覆盖 Notion 中的编辑。更换 Token、清除扩展数据或更换浏览器后，需要自行核查已有页面。
- 创建结果未知：先打开 Notion 目标页面确认是否已经创建。只有确认没有创建时，才对单篇文章使用“处理创建结果未知”，避免重复页面。
- 关闭工作台：导出会停止。重新打开后选择相同文章和连接继续；不要因为中断就先删除已有页面。
常见报错怎么解决？
“请填写有效的 Notion 连接 Token”
这是插件的本地输入检查：Token 为空，或含有空格、换行时会触发，还没有发送连接请求。回到配置页，使用密钥旁的复制按钮，清空输入框后重新粘贴。不要把连接名称或字段说明当成 Token。
“Notion Token 无效或已撤销”
重新核对密钥是否完整、连接是否已删除或密钥是否已重置。复制该连接当前有效的 Token 再测试。
“Notion 页面不可访问”
确认连接和目标页面属于同一工作区，已在目标页面的“连接”菜单中添加该连接，并复制了正确页面链接。只填写 Token、未授权页面时也会发生此错误。
连接成功，但导出或图片更新失败
检查插入和更新内容权限是否开启、目标是否为普通页面，以及 Notion 的网络和工作区容量限制。保留逐篇结果，优先使用重试，不要反复创建新连接。
Notion 面板在哪里？
入口在文章库的“批量管理”中，不在浏览器工具栏弹窗里。如果当前安装版本没有 Notion 入口，本教程不能为该版本添加功能；请核对后续商店更新。
断开连接与官方参考
插件中的“断开连接”会删除本机保存的 Token，保留导出保护记录和 Notion 中的页面。如需彻底撤销访问，在 Notion 的连接设置中撤销该连接或重置密钥。单向导出不会自动把 Notion 修改同步回文章库。
参考 Notion 官方授权说明和连接能力说明。遇到问题可前往使用支持；反馈时仅提供报错与去除敏感信息的步骤。