用途
cursor-google-sheets 是一份 Google Sheets 表格编写指导，旨在帮助协调 google-sheets 工具完成建表、填数和格式化工作。该资料明确说明其性质为“源代码指导”，并非已安装的连接器或运行时证明；使用前需要先针对当前宿主解析工具、阅读实际 schema，不能仅凭文档假定工具存在或可用。
主要能力
资料按两类坐标系统组织操作：
- 值操作（read_range、write_range、append_rows、clear_range）：以标签页标题加 A1 单元格寻址，例如 {sheet: "Data", cells: "A1:B4"}。
- 结构与格式操作（format_cells、set_borders、merge_cells、add_chart、add_conditional_formatting、insert_rows_or_columns、delete_rows_or_columns、freeze_rows_or_columns、sort_range、set_data_validation、set_basic_filter、add_banding、set_column_width、rename_sheet_tab、delete_sheet_tab）：以数字 sheetId 寻址。
get_spreadsheet 返回每个标签页的标题和 sheetId，但不含单元格数据，因此应首先调用并保存映射关系；新建标签页的 sheetId 出现在 add_sheet_tab 的回复中。
使用方式
推荐顺序是：先写值，再格式化，最后添加图表。
- 用 create_spreadsheet 创建表格（可指定命名标签页，但不能指定目标文件夹，需要之后用 google-drive 的 google_drive_move_or_rename 移动）。
- 用 write_range 写入数据；当值包含数字、日期或公式时应设置 parseInput: true，否则内容会按字面文本存储，这是“图表为空”类问题的常见来源。
- 进行仪表盘式格式化：表头加粗、填充颜色、白色文字；数值列设置数字格式（如 $#,##0、0.0%）；冻结表头行；对表格区域设置基础筛选；设置边框（外框比内框粗）或使用隔行变色；调整列宽；按阈值添加条件格式。
- 最后调用 add_chart 添加图表。第一个范围是域（x 轴或饼图标签），后续范围为系列，每列一个系列；图表锚定到错误或颠倒的范围是最常见的图表问题；所有范围须与图表位于同一标签页；设置 headerCount: 1 时各范围应包含表头行。图表应放在表格旁边或下方的空白单元格上。
- 命名区域与保护区域：add_named_range 让公式更易读（如 =SUM(Budget)），公式需以 parseInput: true 写入，名称不能看起来像单元格引用；protect_range 保护表头与公式单元格，warningOnly: true 默认仅警告编辑者，false 则锁定；保护应在对该范围的最后一次写入之后进行。
适用场景
适用于需要通过工具链创建结构化表格、为数据添加格式与图表、设置条件格式、命名区域或保护的场景，尤其适合希望产出可读性接近仪表盘的电子表格。
限制与注意事项
资料列出了若干陷阱：任何地方都没有修订保护，最后写入者生效，协作编辑时应先读再写；merge_cells 只保留左上角的值，合并后需再写入文本；sort_range 会重写单元格位置，应在添加引用该范围的公式之前排序，并排除表头行；insert_rows_or_columns 与 delete_rows_or_columns 的位置从 1 开始计数（A=1），删除立即生效且无法通过 API 撤销；find_replace_sheet 按字面匹配（不是正则），可用 searchFormulas: true 搜索公式内部；整表读取可能超出字节上限，未确定大小的标签页应限定单元格范围（如 "1:2000"），截断时按 nextCells 继续。
完成后应校验：read_range 读取值（FORMATTED_VALUE 显示用户所见内容，UNFORMATTED_VALUE 显示原始数值，可用于确认数字不是文本）；get_spreadsheet 检查结构（标签页、图表、命名区域、保护）；当视觉结果重要时，可用 google-drive 的 google_drive_export_file 导出 PDF，以查看包括图表和格式在内的每个标签页。
此外，资料要求使用官方 Codex Google 插件及其所属技能（如有），文档中的工具名与 schema 细节描述的是上游连接器，不构成对 Codex 插件的承诺；若官方插件缺少某操作，应指出缺口，而不是在无明确授权时改用 GOG 或其他凭据途径；不得扩大共享范围，也不得为满足图片 URL 要求而将私有图片公开。收费、价格、安装命令等信息资料中暂未提供。