如何使用 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。
你可能还需要
暂无推荐