最后更新: 2026-11-20
先说结论
你可以把 Google Drive 或 Dropbox 接入 SourceWeft 工作区,并自己选择要索引哪些文件或文件夹,而不是把整个云端存储交给 AI。索引之后,这些文件会成为工作区里的来源,回答可以引用它们。
两个连接器限制访问的方式并不一样,连接之前值得先弄清楚区别:
- Google Drive 向 Google 请求
drive.file权限范围,你用 Google 自己的文件选择器来选文件。Google 把这个范围描述为按文件授权的访问:它覆盖你用这个应用程序打开的、或通过选择器共享给它的文件,而不是整个 Drive。 - Dropbox 请求对你账号里文件和元数据的只读访问。这个授权本身不是按文件的。之后由你选择 SourceWeft 索引哪些文件和文件夹,连接器读取的只有这些。
两个连接器都不会请求写入、编辑或共享的权限。
各自请求什么权限
| Google Drive | Dropbox | |
|---|---|---|
| 请求的权限 | drive.file | account_info.read、files.metadata.read、files.content.read |
| 能改动你的文件吗? | 以请求的权限不能 | 以请求的权限不能,三项都是只读 |
| 怎样选文件 | Google 的文件选择器 | SourceWeft 里的浏览器:打开文件夹,勾选文件和文件夹 |
| 限制由谁执行 | Google,按文件 | SourceWeft,限制它索引什么 |
Google 的文档说,drive.file "grants per-file and narrow access to specific features needed by an app"(为应用程序所需的特定功能授予按文件的、范围很窄的访问),并把它列为非敏感范围。想自己确认,可以看 Drive API 的权限范围文档。
我也读了连接器的代码。SourceWeft 向 Dropbox 发出的请求都是读取:读取账号信息、文件元数据、文件夹列表、搜索、下载和导出。向 Google Drive 发出的请求是读取文件元数据、导出和下载,外加标准的令牌刷新。两个连接器都不会调用创建、编辑、移动或删除你文件的接口。
开始之前
- 你需要一个 SourceWeft 工作区,并且在其中拥有工作区管理员角色。连接连接器和修改它都需要这个角色。编辑者可以触发同步,查看者只能查看。
- 你需要一个 Google 或 Dropbox 账号。连接是在 Google 或 Dropbox 自己的页面上通过 OAuth 登录完成的,SourceWeft 看不到你的密码。在那个页面上批准之前,先核对列出的权限和上面的表格一致。
连接一个连接器
- 打开一个工作区的聊天。右侧的面板(标题是 Hub)里有连接器(Connectors)标签页。选择管理(Manage),打开连接器目录。
- 找到 Google Drive("Pick Drive files to index and keep them in sync on a schedule.")或 Dropbox("Choose Dropbox files and folders to index and keep them in sync on a schedule."),选择连接(Connect)。
- 在 Google 或 Dropbox 的页面上登录,并批准访问请求。
- 按下面的说明选择文件。
Google Drive:选文件
在文件(Files)部分选择添加文件(Add files)。Google 的选择器会打开,选你要的文件。每个文件在处理过程中会显示一个状态:Waiting for sync(等待同步)、Syncing(同步中)、Indexed(已索引)、Skipped(已跳过)、Failed(失败),或 Deleted in Drive or access was lost(在 Drive 里被删除,或失去访问权限)。
每个连接器最多可以选 500 个文件。这个部分会显示你已选数量和上限,达到上限时会提示"You can select at most {limit} files. Remove some before adding more."(最多可选择 {limit} 个文件,请先移除一些再添加。)
如果 Google 要求你重新登录,这个部分会提示"Your Google account needs reconnecting. Reconnect it, then add files again."(你的 Google 账号需要重新连接。重新连接后再添加文件。)
哪些 Drive 文件可以被索引
- Google 文档、幻灯片和表格由 Google 导出后索引。Google 对这类导出有 10 MB 的上限,超过上限的文件会被跳过,并提示"Export exceeds Google's 10 MB limit"。
- 存储的文件,如 PDF、Word、PowerPoint、Excel、纯文本、Markdown 和 CSV,会被下载并解析。
- 扫描版 PDF 会被跳过,提示"Scanned PDFs are not supported yet"(暂不支持扫描版 PDF)。
- 其他类型会被跳过,提示"Unsupported file type"(不支持的文件类型);选择器也只提供连接器能读取的类型。
Dropbox:选文件和文件夹
在文件和文件夹(Files and folders)里选择选择文件(Choose files)。浏览器会在你的 Dropbox 根目录打开。"Open a folder to look inside, then tick the files and folders to index."(打开文件夹查看里面的内容,然后勾选要索引的文件和文件夹。)
Dropbox 的上限
- 最多可以选择 500 个文件和文件夹。
- 选中的文件夹合计最多同步 1,000 个文件。浏览器里也这样提示:"Folders sync up to 1,000 files in total"。
- 如果你选的内容里支持的文件超过 1,000 个,同步会失败,而不是仅索引一部分。它记录的信息是:"The selection has N supported files; the limit is 1,000. Remove a folder or choose smaller folders."(所选内容包含 N 个受支持的文件,上限是 1,000。请移除一个文件夹,或选择更小的文件夹。)
哪些 Dropbox 文件可以被索引
- 支持文档、文本文件、表格(电子表格)和 JSON 文件,文件类型规则和 SourceWeft 里的上传一致。
- Dropbox Paper 文档会导出为 Markdown。
- 图片和音频不会从 Dropbox 索引。
- 在浏览器里,不能被索引的文件会显示为灰色、无法选择,并提示"This file type cannot be indexed"(这个文件类型无法被索引)。
同步是怎么进行的
两个连接器都会按连接器设定的频率让所选文件保持同步。默认是每 6 小时一次,最小间隔是 1 小时。你也可以手动同步。
当一次同步扫描完你选的全部内容后,它会把不再看到的文件归档:不管是你从选择里移除的,还是在源头被删除的。比如在 Dropbox 里删除的文件,会在下一次同步时被归档,其余文件保持已索引。
索引之后,谁能看到这些文件
被索引的文件是它们所导入的那个工作区的来源,并不只属于连接它们的那个人。所以只连接你愿意向这个工作区开放的文件。工作区的开放范围由它自己的共享和成员设置决定,连接之前请先查看这些设置。
关闭它,并撤销授权
在 SourceWeft 里移除连接器时有两个选项:
- Disable connector(停用连接器)。"Stops syncing. Keeps authorization, configuration, history, and indexed content. You can enable it again later."(停止同步。保留授权、配置、历史和已索引的内容。以后可以重新启用。)
- Delete connector and all indexed content(删除连接器及所有已索引内容)。"Permanently deletes this connector, its local authorization, and all content imported by it. This cannot be undone."(永久删除这个连接器、它在本地的授权,以及它导入的所有内容。此操作无法撤销。)
对话框里还有一行你应该读:"SourceWeft will not revoke access in the third-party provider."(SourceWeft 不会撤销第三方服务商那边的访问权限。)意思是:在 SourceWeft 里删除连接器,并不会把 SourceWeft 从你 Google 或 Dropbox 账号的已授权应用程序列表里移除。要在那边撤销,请按服务商自己的说明操作:Google 的Third-party connections帮助页,以及 Dropbox 的How to manage third-party apps on Dropbox帮助页。
常见问题
SourceWeft 能看到我 Google Drive 里的所有文件吗?
以它请求的权限,不能。它请求的是 drive.file,Google 把它描述为对你用这个应用程序打开的、或通过 Google 选择器选取的文件的按文件访问。
SourceWeft 能看到我 Dropbox 里的所有文件吗? SourceWeft 请求的权限是只读的,覆盖账号里的文件元数据和内容。连接器只会索引你选择的文件和文件夹。
SourceWeft 能编辑、移动或删除我的文件吗?
Dropbox 请求的权限是只读的,Google Drive 请求的是 drive.file,并且连接器的代码里没有创建、编辑、移动或删除的请求。
哪些文件类型可以用? Drive:Google 文档、幻灯片、表格、PDF、Word、PowerPoint、Excel、文本、Markdown 和 CSV。Dropbox:文档、文本、表格、JSON 和 Paper 文档。暂不支持扫描版 PDF。
可以连接多少个文件? Drive 最多 500 个文件。Dropbox 最多选择 500 个文件和文件夹,所选文件夹合计最多 1,000 个文件。
谁能连接? 工作区管理员。编辑者可以触发同步,查看者可以查看。
怎样撤销访问? 在 SourceWeft 里停用或删除连接器,再到你的 Google 或 Dropbox 账号设置里撤销 SourceWeft。第二步 SourceWeft 不会替你做。
这个能用在 Gmail 上吗? 这篇文章不涉及 Gmail。