可视化生成工具 (visualize)#

基于已分析数据集，生成目标工具（Excel/WPS/钉钉/腾讯文档）的图表代码

工具描述#

接受 dataset_id 和可视化规格，调用 /api/visualize，返回可直接贴入目标工具的图表代码（公式/VBA/Apps Script/宏脚本等）。

触发方式#

text

/visualize [图表类型] [维度说明]

或自然语言触发：

• "帮我画个柱状图"
• "做个对比表"
• "生成图表代码"

参数#

参数类型必填说明dataset_idstring是来自上传步骤的数据集 IDchart_typeenum是bar/line/pie/pivot/heatmap/waterfall/scatter/area/radar/funnel/gauge/sankey（共 12 种，详见下方"支持图表类型"）x_axisstring是X 轴字段名（来自数据集列名）y_metricsstring[]是Y 轴指标，最多 5 个target_toolenum是excel/wps/dingtalk/tencent-docstitlestring否图表标题

输出格式#

根据 target_tool 返回对应代码：

Excel（VBA / Office Scripts）#

vba

' [图表标题] - Excel VBA
Sub CreateChart()
    ' 自动生成，可直接运行
    ...
End Sub

WPS（WPS JSAPI）#

javascript

// [图表标题] - WPS JSAPI
const chart = Application.ActiveSheet.Charts.Add();
...

钉钉智能表格（钉钉宏脚本）#

javascript

// [图表标题] - 钉钉宏
...

腾讯文档（Sheets API）#

javascript

// [图表标题] - 腾讯文档
...

支持图表类型（v1.5.2 共 12 种 × 4 工具 = 48 模板）#

类型中文名适用场景bar柱状图维度对比、同比环比line折线图趋势分析、时间序列pie饼图占比分析pivot透视表多维汇总heatmap热力图相关性分析 / 二维矩阵waterfall瀑布图利润归因、增减分析scatter散点图相关性 / 客户分布area面积图累积趋势radar雷达图多维评估（部门绩效）funnel漏斗图销售漏斗 / 转化分析gauge仪表盘目标达成度（部分工具用 Donut 模拟）sankey桑基图流向 / 客户流转（部分工具用堆叠条模拟）

约束#

• 图表代码仅基于用户上传的数据集生成，不硬编码数值
• 每次 /api/visualize 调用从 viz_templates 表中选最匹配模板
• 代码已做基本错误处理，但需用户在目标工具中实际运行验证
• 输出附"AI 辅助生成，请在目标工具中测试后使用"免责说明