Initial commit: workspace files

This commit is contained in:
2026-10-22 22:33:51 +08:00
commit d82d903639
8 changed files with 4695 additions and 0 deletions
+157
View File
@@ -0,0 +1,157 @@
---
name: sales-dashboard-pipeline
displayName: 销售数据看板生成
description: 当用户上传销售数据 CSV/Excel 文件并希望生成可视化图表看板时触发。自动创建图表、组装仪表盘,并支持基于看板的智能问数。
---
# 销售数据看板生成
基于衡石数据集,通过智能问数获取数据,生成交互式 HTML 仪表盘。
## 触发条件
- 用户提到"看板""仪表盘""dashboard""可视化""分析"等关键词
- 用户要求对销售数据进行可视化展示
- 用户提到"生成报表""做图表""画趋势图"等需求
## 前置条件
- 数据集已存在:`datasetId=1`, `appId=14663`(小型阀体外壳销售记录大宽表)
- 如果数据集不存在,需要先手动在衡石平台创建
## 数据集字段说明
**维度字段**:
- 时间维度:订单日期、交货日期
- 分类维度:销售大区、销售部门、销售员、客户名称、客户级别、客户城市、产品名称、材质、铸造方式、表面处理、订单状态
**度量字段**:
- 订单数量、单价、订单金额、材料成本、铸造成本、机加工成本、毛利润、毛利率
## 工作流程
### 1. 确认分析目标
与用户确认:
- 分析时间范围(全部/最近一年/最近一月/自定义)
- 关注的维度(区域/产品/客户/销售员)
- 重点指标(销售额/利润/毛利率/订单量)
### 2. 通过智能问数获取数据
使用 {mcp: bi-metric-insight/bi-create-conversation}、{mcp: bi-metric-insight/bi-create-chat}、{mcp: bi-metric-insight/bi-get-chat}(轮询,每次传入随机 UUID 作为 `randomCode`)、{mcp: bi-metric-insight/bi-get-chart-data} 获取各图表数据:
**步骤**:
1. 调用 {mcp: bi-metric-insight/bi-create-conversation} 创建对话,传入 `appId=14663`, `datasetId=1`
2. 针对每个图表,调用 {mcp: bi-metric-insight/bi-create-chat} 发起自然语言查询
3. 轮询调用 {mcp: bi-metric-insight/bi-get-chat} 获取回答结果(每次轮询传入随机生成的 UUID 作为 `randomCode` 参数,直到返回最终结果)
4. 调用 {mcp: bi-metric-insight/bi-get-chart-data} 获取图表数据
**需要获取的数据**:
| 图表 | 查询语句 | 预期数据结构 |
|------|---------|-------------|
| KPI-总销售额 | "总销售额是多少" | 单一数值 |
| KPI-总利润 | "总毛利润是多少" | 单一数值 |
| KPI-平均毛利率 | "平均毛利率是多少" | 百分比数值 |
| KPI-订单总数 | "总订单数量是多少" | 单一数值 |
| 区域销售对比 | "各销售大区的订单金额对比" | 数组:[{region, amount}] |
| 产品销售占比 | "各产品的订单金额占比" | 数组:[{product, amount}] |
| 月度销售趋势 | "按月统计订单金额趋势" | 数组:[{month, amount}] |
| 材质分布 | "各材质的订单金额分布" | 数组:[{material, amount}] |
| 销售员排名 | "销售员订单金额排名TOP10" | 数组:[{salesperson, amount}] |
| 客户级别分布 | "各客户级别的订单数量分布" | 数组:[{level, count}] |
### 3. 生成 HTML 仪表盘
**参考模板**:`assets/dashboard-template.html` 提供了完整的 HTML 结构和 ECharts 配置示例。生成时复制模板并替换占位符数据。
使用获取的数据生成 HTML 文件,包含以下结构:
**布局设计**:
```
┌─────────────────────────────────────────────────────────┐
│ KPI卡片区 │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │总销售│ │总利润│ │毛利率│ │订单数│ │
│ └──────┘ └──────┘ └──────┘ └──────┘ │
├─────────────────────────────────────────────────────────┤
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ 区域销售对比(柱状图) │ │ 产品销售占比(饼图) │ │
│ └─────────────────────┘ └─────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────┐ │
│ │ 月度销售趋势(折线图) │ │
│ └─────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────────┐ ┌──────────┐ │
│ │材质分布 │ │销售员排名TOP10│ │客户级别 │ │
│ │(环形图) │ │(条形图) │ │(饼图) │ │
│ └──────────┘ └──────────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────┘
```
**技术要求**:
- 使用 ECharts 5.x 进行图表渲染
- 响应式布局,支持不同屏幕尺寸
- 数据从智能问数结果中提取并嵌入到 HTML 中
- 文件命名:`销售分析看板-{用户账号}-{日期}.html`
**HTML 生成步骤**:
1. 创建 HTML 文件,引入 ECharts CDN
2. 编写 CSS 样式(响应式网格布局)
3. 为每个图表创建容器 div
4. 将智能问数获取的数据转换为 ECharts 配置
5. 初始化每个图表并渲染
6. 添加标题和说明文字
### 4. 结果输出
- 提供生成的 HTML 文件路径
- 展示关键数据摘要(总销售额、总利润、平均毛利率等)
- 提示用户可以基于看板继续追问
### 5. 智能问数(可选)
用户可基于已创建的看板进行自然语言追问:
**调用工具**:
- 使用 {mcp: bi-metric-insight/bi-create-conversation} 创建或复用对话
- 使用 {mcp: bi-metric-insight/bi-create-chat} 发起问答
- 轮询调用 {mcp: bi-metric-insight/bi-get-chat} 获取回答(每次轮询传入随机 UUID 作为 `randomCode`,直到返回最终结果)
- 使用 {mcp: bi-metric-insight/bi-get-chart-data} 获取图表明细
**示例问题**:
- "西部大区的毛利率是多少?"
- "哪个产品的订单金额最高?"
- "各区域的成本结构对比"
- "上月销售额环比增长了多少?"
## 输入要求
- 数据集 ID 和应用 ID(默认:datasetId=1, appId=14663)
- 可选:分析时间范围、关注维度、重点指标
### 仪表盘管理
使用 {mcp: adi-metric-tool/bi_app_get_apps} 查询应用列表,使用 {mcp: adi-metric-tool/bi_dashboard_get_apps_appid_dashboards_dashboardid_42d6e007} 获取仪表盘配置详情。
## 输出格式
- HTML 文件:可离线查看的交互式仪表盘
- 数据摘要:关键指标数值
- 图表预览:主要图表的数据展示
## 失败处理
- 智能问数返回空结果:提示用户检查数据集是否存在数据
- 数据集不存在:提示用户先在衡石平台创建数据集
- 图表数据获取失败:说明失败原因,跳过该图表继续生成其他部分
- HTML 生成失败:提示检查文件写入权限
## 限制
- 依赖现有数据集(datasetId=1, appId=14663)
- 智能问数依赖 ChatBI 引擎的理解能力,查询结果可能需要调整
- HTML 文件为静态快照,数据为生成时的快照
- 图表样式受 ECharts 能力限制
@@ -0,0 +1,344 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>销售分析看板</title>
<script src="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/echarts.min.js"></script>
<style>
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
padding: 20px;
min-height: 100vh;
}
.container {
max-width: 1400px;
margin: 0 auto;
}
.header {
text-align: center;
color: white;
margin-bottom: 30px;
}
.header h1 {
font-size: 32px;
margin-bottom: 10px;
}
.header p {
font-size: 14px;
opacity: 0.9;
}
.kpi-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 20px;
margin-bottom: 30px;
}
.kpi-card {
background: white;
border-radius: 12px;
padding: 24px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
transition: transform 0.3s ease;
}
.kpi-card:hover {
transform: translateY(-5px);
}
.kpi-label {
font-size: 14px;
color: #666;
margin-bottom: 8px;
}
.kpi-value {
font-size: 32px;
font-weight: bold;
color: #333;
}
.kpi-value.sales { color: #667eea; }
.kpi-value.profit { color: #48bb78; }
.kpi-value.margin { color: #ed8936; }
.kpi-value.orders { color: #e53e3e; }
.chart-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(500px, 1fr));
gap: 20px;
margin-bottom: 20px;
}
.chart-card {
background: white;
border-radius: 12px;
padding: 20px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
}
.chart-title {
font-size: 18px;
font-weight: 600;
color: #333;
margin-bottom: 16px;
}
.chart-container {
width: 100%;
height: 350px;
}
.full-width {
grid-column: 1 / -1;
}
.three-col {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
gap: 20px;
}
@media (max-width: 768px) {
.chart-grid {
grid-template-columns: 1fr;
}
.three-col {
grid-template-columns: 1fr;
}
.kpi-grid {
grid-template-columns: repeat(2, 1fr);
}
}
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>销售分析看板</h1>
<p>数据时间范围:{{DATE_RANGE}} | 生成时间:{{GENERATED_TIME}}</p>
</div>
<!-- KPI 指标卡片区 -->
<div class="kpi-grid">
<div class="kpi-card">
<div class="kpi-label">总销售额</div>
<div class="kpi-value sales">¥{{TOTAL_SALES}}</div>
</div>
<div class="kpi-card">
<div class="kpi-label">总毛利润</div>
<div class="kpi-value profit">¥{{TOTAL_PROFIT}}</div>
</div>
<div class="kpi-card">
<div class="kpi-label">平均毛利率</div>
<div class="kpi-value margin">{{AVG_MARGIN}}%</div>
</div>
<div class="kpi-card">
<div class="kpi-label">订单总数</div>
<div class="kpi-value orders">{{TOTAL_ORDERS}}</div>
</div>
</div>
<!-- 第二行:区域销售对比 + 产品销售占比 -->
<div class="chart-grid">
<div class="chart-card">
<div class="chart-title">区域销售对比</div>
<div id="regionChart" class="chart-container"></div>
</div>
<div class="chart-card">
<div class="chart-title">产品销售占比</div>
<div id="productChart" class="chart-container"></div>
</div>
</div>
<!-- 第三行:月度销售趋势(全宽) -->
<div class="chart-grid">
<div class="chart-card full-width">
<div class="chart-title">月度销售趋势</div>
<div id="trendChart" class="chart-container"></div>
</div>
</div>
<!-- 第四行:材质分布 + 销售员排名 + 客户级别 -->
<div class="three-col">
<div class="chart-card">
<div class="chart-title">材质分布</div>
<div id="materialChart" class="chart-container"></div>
</div>
<div class="chart-card">
<div class="chart-title">销售员排名 TOP10</div>
<div id="salespersonChart" class="chart-container"></div>
</div>
<div class="chart-card">
<div class="chart-title">客户级别分布</div>
<div id="customerChart" class="chart-container"></div>
</div>
</div>
</div>
<script>
// 数据占位符 - 实际生成时替换为真实数据
const data = {
region: {{REGION_DATA}},
product: {{PRODUCT_DATA}},
trend: {{TREND_DATA}},
material: {{MATERIAL_DATA}},
salesperson: {{SALESPERSON_DATA}},
customer: {{CUSTOMER_DATA}}
};
// 区域销售对比 - 柱状图
const regionChart = echarts.init(document.getElementById('regionChart'));
regionChart.setOption({
tooltip: { trigger: 'axis' },
xAxis: {
type: 'category',
data: data.region.map(item => item.region),
axisLabel: { rotate: 30 }
},
yAxis: { type: 'value', name: '订单金额(元)' },
series: [{
type: 'bar',
data: data.region.map(item => item.amount),
itemStyle: {
color: new echarts.graphic.LinearGradient(0, 0, 0, 1, [
{ offset: 0, color: '#667eea' },
{ offset: 1, color: '#764ba2' }
])
}
}]
});
// 产品销售占比 - 饼图
const productChart = echarts.init(document.getElementById('productChart'));
productChart.setOption({
tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
legend: { orient: 'vertical', left: 'left' },
series: [{
type: 'pie',
radius: '60%',
data: data.product.map(item => ({
name: item.product,
value: item.amount
})),
emphasis: {
itemStyle: {
shadowBlur: 10,
shadowOffsetX: 0,
shadowColor: 'rgba(0, 0, 0, 0.5)'
}
}
}]
});
// 月度销售趋势 - 折线图
const trendChart = echarts.init(document.getElementById('trendChart'));
trendChart.setOption({
tooltip: { trigger: 'axis' },
xAxis: {
type: 'category',
data: data.trend.map(item => item.month)
},
yAxis: { type: 'value', name: '订单金额(元)' },
series: [{
type: 'line',
data: data.trend.map(item => item.amount),
smooth: true,
lineStyle: { width: 3 },
areaStyle: {
color: new echarts.graphic.LinearGradient(0, 0, 0, 1, [
{ offset: 0, color: 'rgba(102, 126, 234, 0.3)' },
{ offset: 1, color: 'rgba(102, 126, 234, 0.05)' }
])
},
itemStyle: { color: '#667eea' }
}]
});
// 材质分布 - 环形图
const materialChart = echarts.init(document.getElementById('materialChart'));
materialChart.setOption({
tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
legend: { orient: 'vertical', left: 'left' },
series: [{
type: 'pie',
radius: ['40%', '70%'],
avoidLabelOverlap: false,
label: { show: false },
emphasis: {
label: { show: true, fontSize: '16', fontWeight: 'bold' }
},
data: data.material.map(item => ({
name: item.material,
value: item.amount
}))
}]
});
// 销售员排名 - 条形图
const salespersonChart = echarts.init(document.getElementById('salespersonChart'));
salespersonChart.setOption({
tooltip: { trigger: 'axis' },
xAxis: { type: 'value', name: '订单金额(元)' },
yAxis: {
type: 'category',
data: data.salesperson.map(item => item.salesperson).reverse(),
axisLabel: { width: 80, overflow: 'truncate' }
},
series: [{
type: 'bar',
data: data.salesperson.map(item => item.amount).reverse(),
itemStyle: {
color: new echarts.graphic.LinearGradient(0, 0, 1, 0, [
{ offset: 0, color: '#48bb78' },
{ offset: 1, color: '#38b2ac' }
])
}
}]
});
// 客户级别分布 - 饼图
const customerChart = echarts.init(document.getElementById('customerChart'));
customerChart.setOption({
tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
legend: { orient: 'vertical', left: 'left' },
series: [{
type: 'pie',
radius: '60%',
data: data.customer.map(item => ({
name: item.level,
value: item.count
})),
label: {
formatter: '{b}\n{c}单'
}
}]
});
// 响应式调整
window.addEventListener('resize', () => {
regionChart.resize();
productChart.resize();
trendChart.resize();
materialChart.resize();
salespersonChart.resize();
customerChart.resize();
});
</script>
</body>
</html>
+71
View File
@@ -0,0 +1,71 @@
{
"schemaVersion": 1,
"skillId": "6ee15940-9b7b-4372-8a34-5d6fca1260b1",
"id": "6f7560da-da3b-4357-bfdf-81d91695182c",
"name": "sales-dashboard-pipeline",
"displayName": "销售数据看板生成",
"description": "当用户上传销售数据 CSV/Excel 文件并希望生成可视化图表看板时触发。自动创建图表、组装仪表盘,并支持基于看板的智能问数。",
"icon": null,
"skillType": "CUSTOM",
"runModes": [
"cloud"
],
"status": "draft",
"createTime": "2026-10-20T15:01:51.753Z",
"updateTime": "2026-10-22T06:38:11.320Z",
"createdBy": {
"userId": "dongsk@digiwin.com",
"userName": "董书康"
},
"isDraft": true,
"remoteSkillId": "6f7560da-da3b-4357-bfdf-81d91695182c",
"publishType": "private",
"groupIds": [
"all_general"
],
"tagIds": [],
"nacosVersion": "0.0.2",
"variables": [],
"resourceData": {
"plugins": [],
"mcps": [
{
"id": "6e4c0ffc-0669-4881-aba4-20eee9a638b1",
"name": "bi-metric-insight",
"toolName": "bi-create-conversation",
"toolId": "397abf5b-fa4f-4801-b5fb-d42d9830b96a"
},
{
"id": "6e4c0ffc-0669-4881-aba4-20eee9a638b1",
"name": "bi-metric-insight",
"toolName": "bi-create-chat",
"toolId": "fb6b0990-3545-4f54-846c-9c81f2da1df6"
},
{
"id": "6e4c0ffc-0669-4881-aba4-20eee9a638b1",
"name": "bi-metric-insight",
"toolName": "bi-get-chat",
"toolId": "3afd1cac-e45a-4908-a90d-1a0f98229111"
},
{
"id": "6e4c0ffc-0669-4881-aba4-20eee9a638b1",
"name": "bi-metric-insight",
"toolName": "bi-get-chart-data",
"toolId": "321342aa-76fe-40c6-9f1b-a9df4f568680"
},
{
"id": "688cdafe-dfc5-45d8-a4eb-d1e68d98000c",
"name": "adi-metric-tool",
"toolName": "bi_app_get_apps",
"toolId": "60fdaff8-a26e-47c0-aaf6-7cc23531993a"
},
{
"id": "688cdafe-dfc5-45d8-a4eb-d1e68d98000c",
"name": "adi-metric-tool",
"toolName": "bi_dashboard_get_apps_appid_dashboards_dashboardid_42d6e007",
"toolId": "d0771e84-33c4-4109-9d80-67445d8567f7"
}
]
},
"serverRevision": "2026-10-20T15:01:51.753Z"
}