报表官-图表生成

噗滋（pozzzi）报表官 - 图表代码生成工具。接收 pozzzi-cfo-analyze 返回的 viz_specs，生成目标工具（Excel/WPS/钉钉/腾讯文档）的图表代码。48 个图表模板（4 种工具 × 12 种 chart 类型），代码可直接粘贴回原报表。

可视化生成工具 (visualize)

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

工具描述

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

触发方式

text

/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）

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 辅助生成，请在目标工具中测试后使用"免责说明