二、前提条件
在开始本操作前，请确保满足以下条件：
·已开通 DataBuddy 服务并完成空间初始化。
·已创建一个仪表盘，详见 创建仪表盘与布局。
·已在仪表盘中至少添加一份数据集，详见 配置数据源与查询。
·当前账号在该仪表盘上拥有 可编辑 或更高权限。
三、使用限制
| 限制项 | 说明 |
| 计算资源类型 | 仪表盘运行查询需选择「数据分析型」计算资源 |
| 单个 Tab 内组件数量 | 暂无硬限制，受布局可读性影响 |
| 透视表行/列/值字段数 | 行、列、值最多各 100 个字段 |
| 全局筛选器数量 | 单个仪表盘最多 50 个 |
| 标题长度 | 单个组件标题最多 50 字，描述最多 200 字 |
五、步骤 1：添加组件
在画布编辑态，画布下方居中位置常驻工具栏。常用入口：
1. 点击图表 ：在弹出的图表类型面板中选择类型，鼠标移动到画布上会出现蓝色组件区域跟随移动；在目标位置点击或拖拽出区域并松开，画布上即创建一个空组件。
2. 点击文本框 ：在画布上拖拽出区域后，进入富文本编辑模式，可输入标题、说明、图片等。
3. 点击页面筛选器 ：用于添加只对当前 Tab 生效的筛选器。
注意：说明：
注意：未给当前仪表盘添加任何数据集时，新增图表组件后选择「数据集」下拉为空，画布上会出现引导，点击可直接跳转到「创建数据集」流程。
六、步骤 2：用自然语言一键生成图表（推荐）
新创建的图表组件会默认展开 AI 输入框 ，你可以直接通过自然语言生成图表：
1. 在右侧面板中确认 数据集 。
2. 在 AI 输入框中描述你的诉求，例如「按地区统计销售额」。
3. 系统也会基于当前数据集自动展示 5 个推荐分析问题，可直接点击采用。
4. 单击发送 ，AI 调用大模型生成图表后给出三个操作：
·接受：保留生成结果，AI 输入框收起。
·拒绝：丢弃生成结果，回到生成前的空状态。
·重新生成：让模型再生成一次。
注意：说明：
注意：AI 生成图表时会同步数据集字段信息，包含字段名与字段类型；维值（如「地区」字段下的「华东、华南」）会作为额外上下文一起同步，因此推荐问题与生成结果会更贴近真实业务。
七、步骤 3：手动配置图表
选中图表后，右侧面板展示当前图表的配置区域。常见配置项（具体显隐取决于图表类型）：
1. 小组件：标题、描述。在更多中支持主题配置，实现背景、边框、字体、标题对齐的配置。
2. 数据集 ：选择本仪表盘内已添加的数据集。
3. 过滤字段 ：对当前图表追加字段过滤或参数。
4. 图表类型 ：在已生成图表的基础上，切换为其他兼容图表类型。
5. 维度、指标（X 轴 / Y 轴） ：从数据集中选取字段。
6. 数据提示、数据标签、配色、注释、大小 ：图表呈现样式。
八、步骤 4：调整字段与计算方式
为 X 轴 / Y 轴添加字段时：
1. 点击对应轴的 + 按钮，下拉中显示当前数据集的字段；支持模糊搜索。同一字段可被多次添加（用于配置不同的计算方式）。
2. 点击已添加的字段，可设置：
·切换字段 。
·计算方式 ：默认、求和、平均、中位数、最小值、最大值、计数、去重计数、方差、标准差、百分位数。
·显示名称 。
点击轴右侧的 更多 ，可设置该轴的整体属性（轴标题、是否显示轴值、标签角度、排序、双轴启用、最小、最大值、反转轴、标度等）。
注意：说明：
注意：字段默认聚合 ：柱状图、折线图等对数值类型 Y 轴字段默认采用 求和 聚合。
九、步骤 5：组件级操作
每个图表组件右上角的 ⋯ 菜单提供：
·剪切、复制、删除 （也支持选中组件后按键盘 Delete 键删除）。
·下载 ：支持导出为数据（Excel/CSV）、PNG、PDF。文件名为「图表标题.格式」，未设置标题时为「图表.格式」。
·查看数据集 ：跳转到当前组件使用的数据集详情。
每次操作后右上角弹出 提示成功或失败。
十一、通用组件配置
| 参数 | 说明 | 是否必填 | 默认值 |
| 标题 | 显示在组件顶部的标题 | 否（默认不勾选） | – |
| 描述 | 标题旁的说明文字 | 否 | – |
| 数据集 | 组件使用的数据集，从仪表盘已添加的数据集中选择 | 是 | – |
| 标题对齐方式 | 自动 / 左 / 居中 / 右 | 否 | 自动 |
十二、主要图表类型与字段
| 图表类型 | 主要字段配置 | 适用场景 |
| 柱状图 | X 轴（1 字段）/ Y 轴（多字段） | 类别对比 |
| 折线图 | X 轴（1 字段）/ Y 轴（多字段） | 时间趋势；配色不支持添加字段 |
| 面积图 | X 轴（1 字段）/ Y 轴（多字段） | 趋势 + 累计 |
| 饼图 | 指标、内径占比（0-100%） | 占比构成 |
| 指标卡 | 指标 + 副指标（各 1 字段） | KPI 展示 |
| 表格 | 列、网格配置 | 明细数据 |
| 透视表 | 行 / 列 / 值（各 ≤ 100 字段） | 行列交叉汇总；值支持链接、悬停提示等动作 |
| 散点图 | X 轴 / Y 轴 / 散点大小 | 相关性、分布 |
| 组合图 | X 轴 / 条形 Y 轴 / 折线 Y 轴 | 双指标对比 |
| 漏斗图 | 阶段（1 字段）/ 值（1 字段） | 转化分析 |
| 热力图 | X 轴（1 字段）/ Y 轴（1 字段）/ 配色 | 二维分布密度 |
| 箱型图 | X 轴（1 字段）/ Y 轴（1 字段） | 数据分布 |
| 点地图 | 经度、纬度 + 数值 | 地理坐标点 |
十三、透视表「值」字段的高级动作
透视表「值」字段支持设置 链接 与 悬停提示 ，使用动态变量语法：
| 动态变量 | 含义 |
| {{@}} | 当前单元格的原始数据值（不带格式） |
| {{@formatted}} | 当前单元格的最终显示内容（带格式） |
| {{字段名}} | 引用同一行其他字段值 |
| {{聚合(字段)}} | 引用聚合值，如 {{SUM(Profit)}} |
示例：
·链接：https://crm.example.com/order/{{@}}，打开新页面。
·悬停提示：所属区域：{{Region}} | 门店利润：{{SUM(Profit)}}。
十四、验证结果
完成图表配置后：
1. 画布上图表按配置呈现，标题、字段名、聚合方式与预期一致。
2. 鼠标悬停在数据点上，会显示数据提示（维度、指标、额外配置内容）。
3. 同一数据集的多个图表之间，点击柱形、扇区可触发联动筛选。
十六、Q：折线图为什么不能在「配色」上添加字段？
A：折线图按字段配色时会被解析为多个独立的点，没有具体业务含义，因此折线图的配色不支持额外添加字段，仅支持调色板设置。
十七、Q：表格里设置了「行号」为什么仍然没显示？
A：指标卡按字段名、计算值显示主、副指标，不使用按行号显示 的逻辑；如果需要行号请使用普通表格组件并在网格配置中开启 withRowNumber。
十八、Q：组合图中相同的度量字段会用同一个颜色吗？
A：组合图的配色按 度量字段（系列） 自动分配。即使两个字段表达式相同，也会被视为两个独立系列分别配色。系列数 = 主轴字段数、副轴字段数。
十九、Q：自定义计算字段在哪些图表里能用？
A：饼图、指标卡、折线图、面积图等支持作为度量与维度。柱状图 X 轴只支持自定义维度，Y 轴维度与度量都支持。表格不展示自定义度量；点地图不支持任何自定义计算字段。
20、相关文档
·创建仪表盘与布局
·配置数据源与查询