连接器与源系统合同

连接器的产物是一组可同步的对象

企业资料接入的单位应是有稳定身份的源对象，而不是某次下载得到的一段文字。文件重命名、移动、修改内容和权限收紧可能同时发生；若以路径或标题作为唯一键，就会产生重复记录，并把旧对象遗留在索引里。建议以source system与source object ID建立身份，路径只作为可变属性。

Microsoft Graph的driveItem delta体现了这种接口合同：先完成分页枚举，再保存deltaLink获取后续变化；删除对象带deleted标记。官方还说明旧token可能失效并要求重新同步。因此连接器需要维护完整游标状态和对账过程，不能把一次HTTP成功等同于完成同步。其他资料源的变化语义须分别核查。

准入与恢复

接入前逐项确认六类事件：创建、内容更新、移动或改名、权限变化、归档、删除。记录资料所有者、访问范围、更新时间、是否允许二次分发与训练，以及限流和回填方式。若连接器读不到源系统的精细权限，只能用于明确开放的资料域。

同步任务宜按源对象幂等处理，保存最近确认的游标和处理结果；只有一批变化已经可靠写入，才能推进消费位置。发现游标失效时重新枚举，并比较现有对象，不能直接清空在线知识库。长期没有变化的对象也应接受周期对账，以捕获漏掉的删除和授权变化。

验收应刻意制造分页中断、重复事件、对象移动、token失效和漏通知，确认恢复后既不丢对象，也不制造重复版本。最终产物应同时回答两个问题：这一批资料是否已完整接入，以及其中哪些对象已经可供当前用户检索。