前言¶
在 DeepSeek Harness（DSH）裏做智能體開發時，工作區文件、瀏覽器、終端往往集中在右側邊欄，但云盤裏的文檔仍要反覆打開瀏覽器複製路徑或手動下載。若希望代理和用戶看到同一份 Drive 內容，並把文件直接交給對話處理，需要在 Harness 內完成賬號綁定與瀏覽。dsh-google-drive 由 boldandigital 維護，歸類爲聯網工具，把 Google Drive 賬號接入 DSH 設置，並在右側邊欄提供 Drive 標籤頁瀏覽與拖入會話的能力。
這是什麼¶
dsh-google-drive 的定位是：在 DSH 中連接 Google Drive 賬號，在設置裏管理連接，在右側邊欄瀏覽文件，並將文件以引用形式交給智能體。插件不在左側邊欄單獨佔一項；已連接賬號位於 Settings → Google Drive，文件列表位於右側邊欄的 Drive 標籤（與 Workspace files、Browser、Terminal 並列）。
項目倉庫：boldandigital/dsh-google-drive。社區目錄頁：skillhub.cn 插件頁。許可證爲 MIT；當前 package 版本爲 0.1.5。DSH 插件生態以「一切皆插件」爲理念；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
下面按 README 中已說明的行爲歸納，均可在安裝後按相同路徑操作。
設置與賬號¶
- Settings → Google Drive 列出已連接賬號。每個賬號提供 Edit（重命名、指定其扮演的 Workspace 用戶、輪換密鑰、續期 Google 登錄）、Test（檢測連接）、Remove（確認後刪除），另有 Add account、刷新及存儲/橋接信息。
- 若本機已安裝
google-workspace-mcp且其服務器擁有的賬號，會以 MCP 標記列出；憑據屬於該服務器，提供 Make editable 而非 Edit——一鍵後本插件持有自己的副本，服務器仍繼續使用原賬號。 - 添加賬號走引導向導：主路徑爲 Sign in with Google；服務賬號與 Workspace 域範圍委派藏在 disclosure 中。嚮導會打開瀏覽器，並說明 Google 提示與常見卡點。
- 設置區開關可打開或關閉右側 Drive 標籤；選擇會持久化，下次啓動生效。
右側邊欄 Drive 標籤¶
- 賬號選擇器、文件夾麪包屑與返回、當前目錄文件列表。
- 每行帶類型標識：Google Sheet、Doc、Slides、Drawing、Form、Script、Folder、Shortcut，或普通文件的擴展名（如 PDF、XLSX）。
- 將行拖入對話，或點 Add to chat，文件以智能體可操作的引用進入會話。
- 在輸入框輸入
@打開 Harness 引用菜單時，也會列出 Google Drive 文件。
智能體與 MCP¶
- 同一套賬號與文件操作向智能體暴露爲
google_drive_*工具。 - 賬號會鏡像到
~/.google-mcp/accounts.json；已安裝的google-workspace-mcp在下次調用時即可看到新賬號，無需重啓服務器。
登錄方式選擇（README 建議）¶
| 需求 | 方式 | 代價 |
|---|---|---|
| 個人 Drive 及共享給自己的文件 | Sign in with Google | 需在 Google Cloud Console 創建一次登錄用客戶端 |
| 單一文件夾、自動化或腳本 | 服務賬號 | 需 GCP 項目，並將文件夾共享給服務賬號郵箱 |
| 以 Workspace 某用戶身份訪問企業網盤 | 域範圍委派 | 需 Workspace 超級管理員授權；Google 生效可能長達一天 |
多數個人場景應使用 Sign in with Google，所見與 drive.google.com 一致。…/auth/drive 爲 Google 受限範圍，未通過驗證的應用登錄時會出現「應用未驗證」提示，可按 Advanced → Go to … 繼續。服務賬號不經 OAuth 同意屏，僅能看到被共享的內容。
安裝與啓用¶
DSH 要求 >=0.2.0，Node >=22.0.0。支持 macOS、Linux、Windows。OAuth 通過本機 http://localhost 迴環 URL 完成，瀏覽器與 Harness 須在同一臺機器。
命令行 / npm¶
在 Plugin Manager 的 Discover 標籤安裝，或直接執行：
dsh plugin --profile web add dsh-google-drive
npm 包名同爲 dsh-google-drive，也可：
npm install dsh-google-drive
從本地 checkout 以 link 方式添加（將路徑換成你的目錄）：
dsh plugin --profile desktop add "link:/path/to/dsh-google-drive"
Discover 索引源¶
若要在 Plugins → Discover 中看到該插件自有市場索引，在 Manage index sources 中加入：
https://boldandigital.github.io/dsh-plugin-index/index.json
索引每日從 npm registry 重建，不會指向 registry 中不存在的版本。
可選配置¶
默認配置已寫在 bundle 的 cordis.patch.yml 中。如需覆蓋，在 profile 的 cordis.patch.yml 中修改 google-drive 行：
- id: google-drive
name: 'dsh-google-drive'
config:
scopes:
- 'https://www.googleapis.com/auth/drive'
defaultAccount: ''
mcpBridge: true
storeDir: ''
| 鍵 | 默認值 | 含義 |
|---|---|---|
scopes |
['https://www.googleapis.com/auth/drive'] |
登錄時請求的 OAuth 範圍 |
defaultAccount |
'' |
打開 Drive 標籤時默認賬號；空則取第一個 |
mcpBridge |
true |
是否鏡像註冊表到 ~/.google-mcp 供 google-workspace-mcp 使用 |
storeDir |
'' |
註冊表與憑據目錄；空則 ~/.google-mcp |
憑據不進 bundle patch、profile 或日誌：賬號元數據、OAuth 客戶端、刷新令牌、服務密鑰在 DSH 憑據庫 ~/.dsh/.credentials.yaml 的 google-drive/… 下；庫所讀文件在 <storeDir>/tokens/<name>.json 與 <storeDir>/keys/<name>.json（權限 0600）；MCP 讀取的註冊表爲 <storeDir>/accounts.json。添加、替換、刪除賬號僅用戶可操作，智能體不能代勞。
典型用法¶
- 安裝插件後打開 Settings → Google Drive，點 Add account，按嚮導用 Google 賬號登錄（或按 disclosure 配置服務賬號/委派）。
- 確認設置中已開啓右側 Drive 標籤；在邊欄 Drive 中選賬號、進入文件夾，將目標文件拖入對話或點 Add to chat。
- 在對話輸入
@，從引用菜單選 Drive 中的文件交給智能體。 - 若同時使用
google-workspace-mcp，連接新賬號後等待其下次調用即可從accounts.json讀取，無需重啓 MCP 服務。
適用場景與注意¶
適合誰： 已在 DSH web/desktop profile 中開發智能體、需要與個人或團隊 Google Drive 對齊文件來源的開發者；需要把雲盤文檔作爲 untrusted 引用交給模型處理、而非每次手動導出上傳的場景。
權限與數據： 插件按你連接的賬號讀寫 Drive，僅在請求時下載文件；不讀取未連接賬號之外的文件。交給模型時僅發送賬號名、文件 id、文件名，並標記爲不可信數據；其餘不離開本機。密鑰存放在 DSH 憑據庫與插件 0600 密鑰文件中。
安全與合規： 插件以當前 DSH 進程權限運行，安裝前宜閱讀源碼與 MIT 許可證，並確認 OAuth / 服務賬號策略符合組織要求。外部依賴爲 Google Drive API；選擇自建服務賬號密鑰時需使用 Google Cloud Console。
結尾¶
dsh-google-drive 把賬號管理放在 Settings → Google Drive，把瀏覽與交付放在右側 Drive 標籤和 @ 引用菜單，並與 google_drive_* 工具、google-workspace-mcp 橋接對齊。更多截圖與市場上架說明見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/boldandigital/dsh-google-drive
- GitHub：https://github.com/boldandigital/dsh-google-drive
