GammaAI需CSV首行为规范列名且无特殊符号，UTF-8编码（无BOM），数值列纯数字，否则无法自动生成图表；上传后若列名显示为“Column 1”，需手动启用首行标题，再通过推荐图表、字段绑定或自然语言指令生成可视化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
GammaAI为已有CSV文件自动识别列名并生成可视化图表，需确保文件结构清晰、编码规范且字段语义可判别。若上传后仅显示原始表格而无图表，大概率是列名缺失、首行被误读为数据，或数值列中混入了非数字字符导致类型推断失败。
检查CSV文件是否具备自动识别前提
GammaAI依赖首行作为列名，并基于内容自动判断字段类型（如日期、数值、分类）。这一步不做校验，后续所有图表生成都会失败。
用文本编辑器（如Notepad++或VS Code）打开CSV文件，确认第一行确实是列名，且不含空格、中文括号、斜杠等特殊符号——例如“销售日期,产品名称,销量,销售额”是合格的，“销售日期 / 产品名称 / 销量 / 销售额”会导致列名被截断为单个字段。
检查第二行起是否存在全为空值的行，或某列在前10行中混有文字与数字（如“-”、“N/A”、“暂缺”），这类混合类型会让GammaAI将整列识别为文本型，无法参与数值类图表（柱状图、折线图）。
保存文件时选择【UTF-8 编码】，不要用“UTF-8 with BOM”，否则GammaAI可能把BOM字节当为首字符，导致第一列名开头出现不可见乱码，列名识别直接失败。
上传CSV并触发自动可视化流程
进入GammaAI编辑界面，将CSV文件拖入正文区域或点击“+”号选择“Upload file”。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
文件上传成功后，GammaAI会在右侧弹出“Data Preview”面板，自动解析并展示前5行数据——此时若看到列名显示为“Column 1”“Column 2”，说明首行未被识别为标题，需手动点击面板右上角的【Use first row as headers】开关。
面板底部会出现“Suggested visualizations”区块，列出3～5种图表建议（如“销量随时间变化趋势图”“各产品销量占比饼图”）。这些推荐基于列名关键词（如含“date”“time”触发时间序列图，含“category”“type”触发分组统计）和数值列分布自动推断，无需额外指令。
手动指定图表类型与字段映射
方法一：点击任一推荐图表下方的“Edit”按钮→进入字段绑定页→左侧勾选X轴字段（如“销售日期”）、Y轴字段（如“销量”）、分组字段（如“产品名称”）→右上角点“Apply”。
方法二：不依赖推荐，在Data Preview面板中直接点击某列标题→下拉菜单中选择“Visualize as”→从中选取“Bar chart”“Line chart”“Pie chart”等→GammaAI立即在当前幻灯片插入对应图表，并自动完成字段绑定。
方法三：在编辑区任意位置输入自然语言指令，例如：“用柱状图展示各城市销售额，按金额降序排列”，GammaAI会解析指令中的实体（城市、销售额）、动作（柱状图、降序）和约束（排序），自动匹配对应列并渲染图表——但该方式要求列名中必须明确包含“城市”“销售额”等关键词，若列名为“city”“revenue”，则需先在Data Preview中重命名为中文，否则指令无法命中。
注意：重命名列名后，原CSV文件不会被修改，仅影响本次会话中的可视化逻辑。
