用途 cursor-google-docs 是围绕 Google Docs 编写与编辑的源指导文档，配套一组 google-docs 工具操作，用于结构化写作、字符与段落样式、列表、表格、图片、页眉页脚等场景。文档同时说明其能力边界：这是源指导，不是已安装的连接器或运行时的证明。使用前应针对当前宿主解析工具并阅读实际 schema；保留指定产品与目标结果；若所需操作不可用，应报告其确切名称并让该步骤保持未完成，不应凭本文档臆造工具名、连接账户、安装辅助程序、产生费用或扩大访问范围；实际操作受当前运营方授权与原生权限约束。
主要能力 文档重点在于避免索引计算错误。Docs 编辑针对单个标签页内从零开始的 UTF-16 索引区间，且每次写入都会移动后续索引；猜测或过期的索引会静默命中错误段落，典型症状是两个列表合并成一个连续编号。为此提供：find_text 返回精确文本的最新 {start, end} 区间，作为 apply_text_style、apply_paragraph_style、delete_content、set_paragraph_format 的索引来源，定位后紧接着编辑；create_list 以 firstItemText/lastItemText 锚点自行解析范围，每个列表单独调用一次并选对预设（项目符号用 BULLET_，编号用 NUMBERED_），不跨两个视觉上分离的列表；需要结构化范围时从 read_document 元素读取，段落 {start, end} 为段落级工具的范围，END 为排他（少一位漏掉最后字符，多一位会波及短语后字符）。无法避免原始索引时，先 read_document、只计算一次编辑、传 requiredRevisionId、应用后再读，多段定位工作从后往前做。
创建文档 create_document 生成空白文档（其 API 忽略内容）。若内容已知，优先用 google-drive 的 google_drive_create_file 以 Markdown 导入（target_mime_type 设为文档类型），一次导入标题、列表和表格并可指定文件夹；若增量构建，先 create_document，再用 insert_text 省略 index 以追加段落，追加模式自行读取末尾并自动做修订保护，可在同一次调用中用 paragraphStyle 设置段落样式、用 bold/italic 设置插入文本样式。文档创建不能设置父文件夹，需要位置时再用 google_drive_move_or_rename 配 destination_folder_id。
结构与样式 文档建议默认结构为：TITLE 段落、斜体署名或日期行、每节 HEADING_2、简短正文并对关键短语加粗、枚举用项目符号列表；在写入时通过 insert_text 的 paragraphStyle/bold/italic 参数完成，而不是事后补样式。字符样式（apply_text_style）支持加粗/斜体/下划线/删除线、fontSize、fontFamily、textColor/backgroundColor（#RRGGBB）、linkUrl，排他 END 索引下可用 end - 1 避免带换行；段落样式用 apply_paragraph_style 设置命名样式（TITLE/HEADING_1..6），用 set_paragraph_format 设置对齐、缩进和行距（百分比，100 为单倍）。列表先插入纯文本行，再对段落范围 create_list，每个换行分隔的段落成为一项；预设属于正确性的一部分，枚举默认 BULLET_，仅有序内容（步骤、排名）或用户要求时用 NUMBERED_；加项目符号前先检查是否已有前导符号，直接追加在列表后的文本会继承列表成员关系，此时应先 create_list 并设 remove: true 去除，再应用所需预设。
表格与图片 insert_table 插入空网格，填充时先重新读取（单元格带各自索引区间），再从最后一个单元格到第一个插入文本，以保持前面单元格索引有效；表格填充后再按表格元素的 start 设置样式：set_table_cell_shading 设置表头行底纹（据底色选择文字颜色）、merge_table_cells 合并跨列标题单元格（左上内容保留，其余丢弃）、set_table_column_width 以磅为单位设置固定列宽；结构编辑会移动索引，后续文本编辑前需重读。insert_image 需要可公开获取的 URL（由 Google 拉取，鉴权墙和私有主机会失败），支持 PNG/JPEG/GIF，用 width/height 以磅设置尺寸（只设一个时保持宽高比）。insert_page_break 在指定索引处分页。
页眉页脚与批量操作 set_header_footer 一次调用设置默认页眉或页脚：文档没有时创建段、已有则替换文本、空文本即清除；文本为静态（API 无页码字段），应用于第一个标签页；不要把伪造页眉用 insert_text 插入正文，否则会随内容滚走。replace_text 可无索引计算地替换全局或指定标签页中的字面字符串，适合重命名与更正；delete_content 拒绝拆分表格结构或代理对的区间，删除段落末尾换行会使其与下一段合并。完成后用 read_document 复查结构与样式，或用 google_drive_read_file 以 Markdown 读取全文，或在视觉结果重要时用 google_drive_export_file 导出 PDF；任何样式调用后确认样式区间恰好覆盖目标文本。
适用场景与限制 适用于借助 Google Docs 工具生成或修改结构化文档、设置样式、制作列表表格图片与页眉页脚的场景。限制在于：本文档不保证工具在具体宿主中存在，使用前须核对 schema；不满足条件的操作应报告缺口而非绕道其他凭据途径；不得为满足图片 URL 要求而放宽共享或将私有图片公开；视觉工作应应用可用的设计指导并检查导出结果。