SharePoint 无法连接、同步或重新授权

SharePoint 包含两个环节：Microsoft 授权和 Formist 同步。OAuth 登录成功不代表所选站点和文件一定可以同步。

连接检查

1. 在 Settings > Connectors 确认 Microsoft 连接存在且有效。
2. 出现授权过期或不足时重新连接。
3. 使用同一 Microsoft 账号直接打开目标 SharePoint site。
4. 确认当前空间选择了正确的 site、drive 或 folder。

同步检查

执行一次 Sync now 并等待结果。首次同步需要枚举和分类文件，通常比增量同步更久。文件可能因格式不支持、无权限、过大或无法转换而被跳过；Skip reason 属于文件元数据，不等同于 OAuth 失败。

如果文件看起来已同步，但还不能被搜索或总结，请检查该连接是否开启了按需读文件（Settings > Connectors，连接的菜单里）。开启后同步只记录文件的名称、大小、时间和链接；文件内容会在成员或 AI 第一次打开它时才读取，这是预期行为，不是同步失败。

SharePoint 是数据源。重命名、移动、删除和源端元数据变化会在后续同步中反映。在 Formist 内，同步文件可由空间成员读取；成员打开 SharePoint 原始页面时，Microsoft 会另行校验个人权限。

已断开的连接仍会列出，并带有重新连接按钮。若连接完全消失，说明它已被移除，可能需要 Admin 新建或共享空间连接。

Frequently asked questions

Microsoft 登录成功是否就能保证同步正常？

不能。SharePoint 连接包含两个独立部分：Microsoft 授权和 Formist 同步，OAuth 登录成功并不保证选定的站点和文件一定能同步成功。

为什么某个文件在同步时被跳过？

文件可能因为格式不支持、无法访问、体积过大，或无法转换以供索引而被跳过；跳过原因属于文件本身的元数据，与 OAuth 连接无关。

在 SharePoint 中重命名或移动文件，Formist 会同步这个变化吗？

会。SharePoint 始终是数据的最终来源，重命名、移动、删除和源端元数据变化都会在之后的同步中体现。