坚果云与 WebDAV
坚果云与 WebDAV
坚果云与 WebDAV 连接器用于从官方坚果云 WebDAV 服务或企业私有 WebDAV 部署读取文件。连接器为只读模式：AIvis 会索引匹配文件，但不会上传、修改、移动或删除源文件。
当团队已经把共享文件放在坚果云或兼容 WebDAV 服务器中，并希望这些文件可被智能体和知识库搜索引用时，使用此连接器。
需要准备什么
坚果云官方 WebDAV 帮助文档也按服务器地址、账号和应用密码三项说明连接方式。官方服务的服务器地址是 https://dav.jianguoyun.com/dav/；账号是坚果云登录邮箱；密码是生成的第三方应用密码。
生成坚果云应用密码
使用官方坚果云服务时，请先创建专用应用密码，再在 AIvis 中创建凭据。
- 登录坚果云网页端。
- 打开账号菜单，进入账户信息和安全选项。
- 在第三方应用管理中选择添加应用密码。
- 输入应用名称，例如
AIvis，然后生成密码。 - 复制生成的应用密码，粘贴到 AIvis 凭据表单的密码或应用密码字段。
坚果云移动端也可以从设置进入第三方应用管理。建议每个集成使用独立应用密码，这样撤销 AIvis 访问时不会影响其他 WebDAV 客户端。
创建凭据
保存凭据后，先使用测试连接，再创建或启用连接器。
配置连接器
尽量使用更窄的根路径。/ 是有效路径，但它会包含该 WebDAV 账号可读取的所有目录，容易索引超出预期的内容。
权限与 ACL 边界
WebDAV 账号决定 AIvis 在索引时能读取哪些文件。AIvis 不会把坚果云或 WebDAV 的文件级 ACL 导入为文档权限。
这意味着：
- 选中根路径下的文档会继承此连接器的 AIvis 访问设置。
- 如果不同团队应看到不同文件夹，请按根路径和访问群组拆分为多个连接器。
- 只有当每个被索引文件都适合组织内所有目标用户查看时，才把连接器设为组织公开。
- 如果 WebDAV 账号失去某个根路径的访问权限，后续同步可能失败或停止索引该路径。
坚果云服务限制
坚果云会对 WebDAV 使用施加限制。具体限制可能随套餐或部署变化，但官方帮助当前说明了访问频率限制和单次目录项数量限制。大目录、高频同步或多个连接器并发使用同一账号时，可能触发这些限制。
实践建议：
- 只需要少数文件夹时，优先配置多个明确根路径，而不是直接索引一个很大的根目录。
- 避免让多个坚果云连接器使用同一账号在同一时间同步。
- 如果某个文件夹文件很多且索引不完整，请拆分文件夹或收窄根路径。
- 如果多次测试或同步后连接开始失败，等待 WebDAV 频率窗口重置后再重试。
验证
创建凭据和连接器后：
- 测试凭据连接。
- 保存连接器，并确认已勾选 ACL 限制确认项。
- 运行首次同步。
- 确认每个根路径下的代表性文件已被索引。
- 确认根路径之外的文件不会被索引。
- 使用有权限用户搜索，确认能看到预期结果。
- 使用连接器受众之外的用户搜索，确认受限文件不会出现。
- 在维护窗口轮换坚果云应用密码，并重新测试连接。