SuperAPI AI 工具集

google-drive

办公与效率

查看项目

更新于 10-16 09:48

技能介绍

用途:作为统一 Google Drive 插件中处理 Google 文件工作的顶层路由。不要引导用户使用单独的 Docs、Sheets 或 Slides 插件;先以 Google Drive 做文件发现和文件生命周期任务,仅在任务具体落到文档、表格或幻灯片时再路由到更细的子技能。

主要能力:搜索、获取文件、最近文件、文件夹列表、元数据读取、共享、复制、删除、导出、版本历史、文件移动等文件生命周期操作。版本历史场景可先定位文件、获取当前内容,再用 list_file_revisions 列出修订,用 fetch_file_revision 获取上一个或用户指定的修订并对比,不要贸然声称不支持历史版本。移动文件需定位源文件与目标文件夹,读取含当前 parents 的元数据,再用 update_file 的 addParents 添加目标、removeParents 仅移除已确认的源父级,保留无关父级并回读验证。

使用方式:导出或原始文件获取前先读取或复用元数据,确认 MIME 类型和 Drive URL。原生 Google 文档、表格、幻灯片用 export_file 转换为明确要求的格式,返回的是已认证文件引用而非内联字节或 base64,且 files.export 响应上限 10 MB,超大导出会失败。更大的原生 PDF 在可用时用 download_file(id=file_id, mime_type="application/pdf"),其返回顶层可物化 file_uri;该流式下载路径成为规范获取后改用 fetch(url=google_drive_url, download_raw_file=True, raw_export_mime_type="application/pdf")。非原生存储文件(PDF、图片、ZIP、Office 文件、音视频等)用 fetch(url=google_drive_url, download_raw_file=True)。只使用已认证的顶层 file_uri 或物化后的 workspace_path,不要暴露内联二进制、base64 或带令牌 URL。

路由规则:评论的创建、回复、解决或通过评论评审用 google-drive-comments;Docs 新建、摘要、修订规划、改写或段落编辑用 google-docs;Sheets 新建、本地表格导入、范围检查、清洗、重构、公式与图表设计修复或批量更新用 google-sheets;Slides 摘要、编辑、新建、本地演示文稿导入、视觉清理、结构修复或模板迁移用 google-slides。按产物类型判断:Doc 走 Docs,Sheet 走 Sheets,Deck 走 Slides。新建 Google Doc 必须走 Docs 技能,由其承担本地 .docx 到原生 Google Docs 的强制导入流程;新建 Google Sheet 走 Sheets 技能,优先用本地 .xlsx 再导入为原生 Google Sheets;新建 Google Slides 走 Slides 技能,由其承担本地 .pptx 到原生 Google Slides 的导入流程。除非用户明确要求保留源文件类型,否则默认转换为原生类型。

限制:不要从本路由直接创建空白 Google Doc 或 Google Slides 演示文稿;能用纯文件级 Drive 操作完成时不要加载更重的子技能;导入或创建返回用户可见 Google Workspace 链接前,需等待写入完成并通过连接器或 Drive 元数据回读验证,只使用回读得到的 URL 或 id,不得编造。写操作应尽量保留用户现有的文件组织、共享状态和目标产物。本资料未提供收费、价格与平台支持等信息。