如何使用 AI 实现 Google Docs 文档自动化创建与编辑

解决手动编辑云文档的低效问题:通过轻量级的 Python 脚本集成 Google Docs API,让 AI 能够自动创建会议记录、提取文档内容或批量更新 Workspace 文档。

为什么需要这个技能

在处理企业级文档时,手动在浏览器中打开、搜索并修改 Google Docs 非常耗时。尤其是当需要将 AI 生成的大量结构化内容同步到云端,或者需要从多个文档中快速提取文本进行分析时,缺乏直接的接口会导致工作流中断。

本技能提供了一套独立的 OAuth 认证方案,无需复杂的 MCP(Model Context Protocol)服务器部署,即可让 AI 通过命令行直接操作 Google Docs,实现文档管理的自动化。

适用场景

  • 自动化报告生成:AI 自动创建项目计划书并填充初始内容。
  • 快速内容同步:将本地分析结果通过 append-text 指令实时追加到云端会议纪要中。
  • 文档内容提取:通过文档 ID 或 URL 快速获取全文,交给 AI 进行摘要或翻译。
  • 批量文本替换:在多个文档中快速更新特定术语或日期。

核心工作流

1. 身份认证(首次运行)

由于需要访问 Google Workspace 账户(仅支持 Workspace 账号,不支持个人 Gmail),必须先完成 OAuth 授权:

python scripts/auth.py login

执行后将在浏览器中打开授权页面,确认后 Token 将安全存储在系统的 Keychain(macOS)或 Credential Locker(Windows)中。

2. 执行文档操作

所有操作均通过 scripts/docs.py 完成。如果未登录,脚本将在首次使用时自动引导认证。

  • 创建文档
python scripts/docs.py create "Meeting Notes"
# 带初始内容创建
python scripts/docs.py create "Project Plan" --content "# Overview\n\nThis is the project plan."
  • 查找与读取
# 按标题搜索文档
python scripts/docs.py find "meeting" --limit 10
# 通过 ID 或完整 URL 获取文本
python scripts/docs.py get-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms
  • 编辑内容
# 在文档末尾追加文本
python scripts/docs.py append-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "New paragraph at the end."
# 在文档开头插入文本
python scripts/docs.py insert-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "Text at the beginning.\n\n"
# 替换文档内特定文本
python scripts/docs.py replace-text 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "old text" "new text"

下载和安装

下载 google-docs-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐