返回博客

只让 AI 读你挑的文件:把 Google Drive 或 Dropbox 接入 SourceWeft

SourceWeft 的 Google Drive 和 Dropbox 连接器怎么工作:它请求什么权限、你怎样选文件、支持哪些文件类型和有哪些上限,以及怎样关闭连接器和撤销授权。

SOSourceWeftNov 20, 20267 分钟阅读

最后更新: 2026-11-20

先说结论

你可以把 Google Drive 或 Dropbox 接入 SourceWeft 工作区,并自己选择要索引哪些文件或文件夹,而不是把整个云端存储交给 AI。索引之后,这些文件会成为工作区里的来源,回答可以引用它们。

两个连接器限制访问的方式并不一样,连接之前值得先弄清楚区别:

  • Google Drive 向 Google 请求 drive.file 权限范围,你用 Google 自己的文件选择器来选文件。Google 把这个范围描述为按文件授权的访问:它覆盖你用这个应用程序打开的、或通过选择器共享给它的文件,而不是整个 Drive。
  • Dropbox 请求对你账号里文件和元数据的只读访问。这个授权本身不是按文件的。之后由你选择 SourceWeft 索引哪些文件和文件夹,连接器读取的只有这些。

两个连接器都不会请求写入、编辑或共享的权限。

各自请求什么权限

Google DriveDropbox
请求的权限drive.fileaccount_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 看不到你的密码。在那个页面上批准之前,先核对列出的权限和上面的表格一致。

连接一个连接器

  1. 打开一个工作区的聊天。右侧的面板(标题是 Hub)里有连接器(Connectors)标签页。选择管理(Manage),打开连接器目录。
  2. 找到 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)。
  3. 在 Google 或 Dropbox 的页面上登录,并批准访问请求。
  4. 按下面的说明选择文件。

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。

相关文章

可分享链接

继续阅读

相关文章

全部文章

Notion、Google Drive 和 Slack 的 MCP 服务器

Notion、Slack 和 Google Workspace 都发布了官方 MCP 服务器。本文说明连接每一个之前需要具备什么条件,以及什么情况下社区服务器是更实际的替代选择。

继续阅读

在 Claude Code 里安装技能和 MCP 服务器:从空文件夹开始的教程

从空文件夹开始,给 Claude Code 安装一个技能和一个 MCP 服务器:搜索、安装前先看详情、配置文件放在哪里,以及怎样检查和移除。所有命令都是实际运行的结果。

继续阅读

Claude 技能是什么?怎样找、怎样安装

用白话说明 Claude 技能(智能体技能)是什么、技能文件夹里有什么、去哪里找,以及两种安装方法:用命令安装,或手动复制文件夹。包含安装前要检查的事项。

继续阅读