Spreadsheet 与表格
创建、检查、编辑、验证和导出工作簿，并按需连接 Google Sheets。
Spreadsheet 能力用于处理结构化表格工作。它适合报价单、名单、排期、导出表、轻分析工作簿，以及需要公式、图表和多格式导出的任务。
功能状态：正式
表格工作簿的创建、检查、编辑、验证和导出属于正式能力；外部表格连接是否可写，还取决于 App Connections 的授权范围。
入口
在对话中使用 /spreadsheet，或从已有表格交付物继续修改。
适合的任务
- 把原始文本、CSV 或杂乱数据整理成工作簿；
- 为表格补公式、图表、汇总页；
- 导出 XLSX、CSV 或 TSV；
- 将结果继续交给 Google Sheets 等外部表格。
基本流程
输入
/spreadsheet，写清楚输入来源、目标结构和导出格式。说明是否需要公式、图表、汇总页、筛选字段或外部表格同步。
等待 Raydo 创建或检查工作簿，并运行必要验证。
查看预览中的工作表结构、列名、公式和导出状态。
确认无误后再导出，或继续写入获授权的外部表格。
表格操作范围
- 新建工作簿和多工作表结构；
- 检查已有表格的 sheet、行列、摘要和问题；
- 编辑单元格、添加图表、生成公式；
- 导出为
XLSX / CSV / TSV / JSON； - 在授权后读取或写入 Google Sheets。
成功标志
- 工作簿结构清楚，列名和数据含义一致；
- 公式和图表可解释，不是黑盒结果；
- 导出文件可正常打开，且进入项目交付物。
更好的使用方法
- 先说清楚每一列代表什么，再让系统整理，不要只丢一堆原始数据；
- 如果要导出给别人用，提前指定目标格式，例如 XLSX、CSV 或 TSV；
- 多工作表任务要明确每个 sheet 的用途，例如“原始数据”“清洗后结果”“汇总页”；
- 图表任务要说明图表类型、来源 sheet 和关键字段，不要只说“做个图”；
- 连接 Google Sheets 前，先在本地工作簿里验证结构，稳定后再同步。
常见报错会出现在哪
| 位置 | 你会看到什么 | 代表什么 |
|---|---|---|
/spreadsheet 当前任务 | create failed、inspect failed、validate failed | 当前工作簿创建、读取或验证阶段没有通过 |
| 导出状态 | format unsupported、output missing、sheet missing | 导出参数或工作簿结构不满足要求 |
| 图表生成阶段 | source sheet missing、key missing、anchor invalid | 图表引用的数据源、字段或位置有问题 |
| 外部表格连接 | 无法读取、无法写入、资源未选择 | 外部表格授权或目标资源边界不完整 |
常见报错与含义
| 常见提示或错误方向 | 用户应如何理解 | 建议先做什么 |
|---|---|---|
| spreadsheet export format unsupported | 你要求的导出格式当前不支持 | 改用界面支持的格式重新导出 |
| spreadsheet export workbook required | 当前没有可导出的工作簿对象 | 先确认任务已经实际生成工作簿，而不是只有口头说明 |
| spreadsheet export sheets required | 工作簿里没有有效工作表可导出 | 检查是否真的创建了 sheet，且不是空结构 |
| spreadsheet export sheet missing / sheet required | 你指定的工作表不存在，或没有指定具体 sheet | 用准确的 sheet 名称重新发起导出 |
| spreadsheet export validation failed | 工作簿内容没通过导出前校验 | 先修复列结构、公式或图表引用问题 |
| chart source sheet missing / key missing | 图表找不到数据源工作表或关键字段 | 明确图表引用哪个 sheet、哪几列 |
| chart anchor invalid / overlap | 图表放置位置不合法，或与现有图表冲突 | 重新指定图表区域，不要让多个图表互相重叠 |
| existing drawing requires review | 原文件里已经有复杂绘图对象，需要人工确认 | 先人工检查原始文件，再决定是否覆盖或重建图表 |
建议用户怎么排查
先判断问题是在“建表、验表、图表、导出、外部同步”哪一层。
导出失败时，先确认工作簿和目标 sheet 真的存在，再看格式问题。
图表失败时，先检查来源 sheet 名称、列名和放置区域，不要直接整本重做。
如果要写入 Google Sheets，先确认已经选中了具体资源，而不是只有连接授权。
保留失败任务和错误提示，做最小修改后重试，方便定位到底是数据结构还是导出环节出错。
截图占位
后续建议补 4 张图：
/spreadsheet输入示例、工作簿预览、图表区域、导出格式选择或导出结果区域。
录屏占位
后续建议补 1 段短录屏：从原始数据生成工作簿，到补图表，再导出 XLSX。