ChartGPT是零基础用户通过自然语言生成交互图表的首选工具：本地运行前端服务，支持自然语言生成、实时样式调整、多格式导出及免代码调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您从未接触过数据可视化工具，但希望仅凭文字描述就能生成可交互的图表，ChartGPT可作为零基础用户的首选辅助工具。它不依赖编程经验，全程通过自然语言驱动图表生成与调整。以下是引导您入门的具体路径：
一、本地环境快速搭建
ChartGPT需在本地运行前端服务，该步骤为后续所有交互式图表操作提供基础运行平台。无需配置服务器或数据库，全部依赖轻量级开发服务。
1、打开终端（Windows用户使用Git Bash，macOS/Linux用户使用默认终端）。
2、执行代码克隆命令：git clone https://gitcode.com/gh_mirrors/ch/chart-gpt。
3、进入项目目录：cd chart-gpt。
4、安装项目依赖：npm install。
5、复制环境模板文件：cp .env.example .env。
6、用文本编辑器打开.env文件，在BARD_KEY="your-api-key-here"处填入有效API密钥。
7、启动开发服务：npm run dev。
8、浏览器访问http://localhost:3000，加载主界面即表示环境就绪。
二、自然语言驱动图表生成
ChartGPT的核心能力在于将非结构化文本自动解析为结构化图表逻辑，避免手动选择坐标轴、映射字段等传统操作，大幅降低理解门槛。
1、在页面左侧输入框中输入明确描述，例如：“展示2023年各季度销售额，以季度为X轴，金额为Y轴，生成带悬停提示的柱状图”。
2、点击“Draw”按钮触发AI解析流程。
3、系统自动调用/api/get-type接口识别图表类型，并通过/api/parse-graph生成Tremor兼容的数据格式。
4、右侧预览区即时渲染出可交互图表，支持鼠标悬停查看数值、缩放及响应式布局。
三、文本指令实时调整图表样式
生成图表后无需导出再编辑，所有视觉属性均可通过追加自然语言指令动态修改，实现所见即所得的迭代式设计。
1、在已有输入框末尾添加新指令，例如追加：“改为深蓝配色，Y轴显示单位为万元，添加标题‘年度销售趋势’”。
2、再次点击“Draw”按钮，系统保留原始数据结构，仅更新样式参数。
3、观察预览区变化：颜色方案切换至内置12种专业配色之一，Y轴刻度自动适配单位换算，标题栏同步更新。
4、如需还原某次修改，可点击界面右上角的“Undo”按钮回退至上一步状态。
四、多格式一键导出嵌入PPT
生成的交互式图表不仅限于网页浏览，还可直接导出为汇报场景所需的标准格式，确保零基础用户也能完成专业交付。
1、点击界面右上角“Export”下拉菜单。
2、选择“Download as PNG”获取静态高清图像，适用于打印或基础PPT插入。
3、选择“Download as SVG”保留矢量清晰度，支持在PowerPoint中无损缩放与二次编辑。
4、选择“Copy Embed Code”获取HTML片段，粘贴至支持iframe的演示平台（如Microsoft Stream或内部Wiki）实现在线交互。
5、若需保留数据逻辑，选择“Export Data as JSON”，导出结构化数据供后续分析或跨平台复用。
五、免代码调试与反馈闭环
当图表未按预期呈现时，ChartGPT提供面向初学者的容错机制和渐进式提示，避免陷入技术排查困境。
1、若输入文本被判定为模糊，界面底部会显示“请补充X轴/Y轴字段名或指定图表类型”等具体引导语。
2、若API密钥无效，系统在控制台输出“Authentication failed: invalid BARD_KEY”并禁用Draw按钮。
3、若数据解析失败，预览区显示“Unable to extract numeric values from input”，同时高亮原文中疑似异常的数字段落。
4、每次操作后，界面左下角显示“Processed in 1.2s”等耗时反馈，帮助用户建立响应预期。
