返回部落格

只讓 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 教學:用一行指令安裝 skills 與 MCP(從零到能用)

從空資料夾開始,一步一步在 Claude Code 裡安裝技能(skills)與 MCP 伺服器:搜尋、安裝前先看詳情、設定檔寫在哪裡、怎麼確認裝好了。所有指令都是實際執行過的結果。

繼續閱讀

Claude skills(技能)是什麼?怎麼找、怎麼安裝

用白話說明 Claude skills(agent skills)是什麼、一個技能資料夾長什麼樣子、去哪裡找,以及兩種安裝方法:用指令安裝,或手動複製資料夾。附上安裝前要先看的幾件事。

繼續閱讀