正确的验证链
- self：确认连接的是预期 Notion 账户。
- search：用页面标题关键词找到目标页面并获得页面标识。
- fetch：用搜索结果中的页面标识读取正文。
只有三步都成功，才能说明插件“能阅读文档”。
隐私提示先用一篇无敏感内容的测试页验证，不要一开始读取财务、客户或私人笔记。
搜索成功、读取失败的常见原因
- 目标页面没有共享给当前集成或当前账号。
- 搜索返回的是数据库条目或快捷方式，读取时使用了错误标识。
- 插件只有搜索工具，fetch 工具未加载或版本不匹配。
- OAuth 授权有效，但授权范围不包含该工作区或页面。
排查步骤
- 新建一篇测试页，只写“Notion read test”。
- 确认该页对当前连接可见，然后执行 search。
- 从搜索结果复制正确页面标识，再执行 fetch。
- 若 fetch 工具不存在，回到插件清单与技能开关检查加载状态。
成功标志
- search 返回目标测试页。
- fetch 返回页面正文“Notion read test”。
- 重启应用后再测一次仍成功。