Dropbox
索引内容
Dropbox 连接器从访问令牌可见的根目录开始，递归索引每个可见子文件夹中的可下载文件。每个文件会成为一个可搜索文档；文件夹只用于组织遍历，本身不会作为文档索引。
前置条件
- 通过组织批准的流程创建 Dropbox App 或令牌。
- 将令牌的 Dropbox 可见范围限制为所有预期 OpenCore 受众都可索引的内容；连接器不提供更窄的文件夹选择器。
- 允许令牌列出和下载文件，并允许列出共享链接；仅当列表调用成功且没有现有链接时，还需要允许创建共享链接。
- 允许连接器 Worker 通过 HTTPS 访问 Dropbox API。
凭据
当前 Admin UI 中的 Dropbox 索引连接器不提供 OAuth 流程。请通过正常的 Dropbox App 流程轮换 Access Token。
在 OpenCore 中配置
- 在 Admin 后台打开 Connectors，选择 Dropbox，然后创建 Dropbox Token 凭据。
- 审查令牌能看到的内容。连接器没有文件夹、Prefix 或文件名过滤器。
- 对受限内容选择 Private 并分配 OpenCore 用户组。只有当所有 OpenCore 账号都可搜索令牌可见的每个文件时，才使用 Public。
- 设置刷新和清理选项，创建连接器，然后运行首次索引尝试。
- 将生成的文档集附加给 Agent 前，先审查实际索引的文件。
权限
Dropbox 源权限不会同步。令牌决定 OpenCore 能摄取什么内容，但 Dropbox 共享设置和逐文件 Viewer 列表不会复制到 OpenCore。
因此，任何能访问该连接器或其文档集的 OpenCore 用户都能搜索所有成功索引的文件，即使该用户无法在 Dropbox 中打开对应文件。请为敏感区域使用分别限定范围的 Dropbox 凭据或 App，并通过 OpenCore Private 用户组执行访问控制。源共享链接也可能根据 Dropbox 链接设置暴露内容，因此索引前应审查 App 的共享策略。
验证
- 验证凭据，并确认连接器能够列出令牌可见的根目录。
- 运行索引尝试，分别搜索一个根目录文件和一个嵌套文件中的文本。
- 确认不可下载或刻意设为令牌不可访问的文件没有出现。
- 打开搜索结果中的源链接。如果没有链接，检查 Token 能否列出共享链接，以及列表为空时能否创建链接。
- 使用分配给连接器的每个 OpenCore 用户组测试搜索访问；Dropbox ACL 不会提供第二次授权检查。