可视化生成工具 (visualize)

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

工具描述

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

触发方式

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

或自然语言触发：

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

参数

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

输出格式

根据 target_tool 返回对应代码：

Excel（VBA / Office Scripts）

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

WPS（WPS JSAPI）

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

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

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

腾讯文档（Sheets API）

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

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

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

约束

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