支持与常见问题
先从下面的三步上手说明开始；如果遇到问题，再到排查清单中定位原因。
快速上手
- 申请 API Key：打开微信读书开放服务页面，用微信读书账号扫码授权，复制以
wrk-开头的 API Key。 - 粘贴并连接：在 ReadRelay 引导页点击「粘贴」，应用会自动清洗格式并校验密钥，通过后即完成连接。
- 选择同步目标：进入「设置 → 同步目标设置」，按需开启 Markdown、Obsidian、Notion 或 flomo，然后按书同步或一键批量推送。
常见问题
如何获取微信读书 API Key？
打开微信读书开放服务页面，用微信读书账号扫码授权登录，在页面中找到「API 密钥」并复制。密钥通常以 wrk- 开头。回到 ReadRelay 的引导页，点击输入框旁的「粘贴」即可自动填入并清洗格式。
连接时提示密钥无效或返回 404，如何排查？
依次确认：密钥是否完整复制（无多余空格、换行或命令前缀）；密钥是否仍处于有效状态，刚重置过的话等待一两分钟重试；设备网络是否可正常访问微信读书开放服务。若仍失败，请更换密钥后重新连接。
导出的 Markdown 文件在哪里？
Markdown 目标写入应用沙盒的 Documents/ReadRelay 目录。可在设置页的「Markdown 本地文件」二级页面查看路径，或通过 iOS「文件」App 在「我的 iPhone / 我的 iPad」中找到对应应用目录，也可使用系统分享导出。
Obsidian 同步后没有看到文件？
请确认在设置中选择的是正确的 Vault 目录（默认写入 Books/ReadRelay/ 子目录），并确认已授予应用访问该目录的权限。若仓库位于 iCloud Drive，文件同步到其他设备可能需要一点时间。
Notion 同步提示无权限或无数据库？
需要两个前置条件：Integration Token 填写正确；以及在目标数据库页面的右上角菜单中通过 Connections 将你的 Integration 关联到该数据库。同时请核对 Database ID 是否来自同一个数据库。
flomo 没有收到推送内容？
请检查 Webhook 地址是否完整（flomo 网页版或 App 的「API / Webhook」入口可获取），并确认同步目标中已开启 flomo 开关。若短时间内推送内容较多，应用会自动加入节流等待以避免触发官方速率限制，稍后即可看到全部卡片。
同步后出现重复笔记怎么办？
默认的增量同步会跳过已导出内容。若曾经清空过同步记录，应用会认为所有笔记都是新的并重新导出。若目标端出现重复，可先删除目标端旧内容，再重新执行一次全量同步。
联系与反馈
如果上面的说明没能解决你的问题，欢迎把以下信息一并告知，便于快速定位：应用版本、iOS 版本、使用的同步目标，以及错误提示的原文或截图。
支持邮箱：支持邮箱
也可以在 App Store 产品页 下载应用或留下评价。
提交反馈时请勿附带完整的 API Key 或 Token，仅需说明错误现象即可。