前言¶
在 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
