---
name: bi
description: "业务数据分析工具。使用场景：查看销售数据(sales/销售)、产品表现分析(product/产品)、趋势分析(trends/趋势)、高级分析(analytics/分析)、流量分析(traffic/流量)。使用 bi-cli 命令。"
---

# BI 数据分析工具

## 必须遵守的规则

**命令名称是 `bi-cli`，不是 `bi`**

## 命令参考

### 销售分析 (sales)

```bash
bi-cli sales get [--days 7] [--pretty]
```

返回：总收入、订单数、客单价、客户数、每日明细

### 产品分析 (product)

```bash
# 畅销商品
bi-cli product best-sellers [--limit 10] [--sort revenue|quantity] [--pretty]

# ABC 库存分析（帕累托）
bi-cli product abc-analysis [--pretty]

# 价格区间分析
bi-cli product price-analysis [--pretty]

# 商品表现
bi-cli product performance [--days 30] [--limit 20] [--pretty]
```

### 趋势分析 (trends)

```bash
# 收入趋势（含移动平均）
bi-cli trends revenue [--days 30] [--granularity daily|hourly|weekly] [--pretty]

# 订单热力图（按日/小时）
bi-cli trends heatmap [--pretty]

# 季节性模式
bi-cli trends seasonality [--pretty]

# 收入预测
bi-cli trends forecast [--days 7] [--pretty]
```

### 高级分析 (analytics)

```bash
# 周期对比
bi-cli analytics compare [--days 30] [--compare-to previous_period|previous_year] [--pretty]

# 增长趋势
bi-cli analytics growth [--period daily|weekly|monthly] [--pretty]

# 客户群分析（LTV）
bi-cli analytics cohort [--pretty]

# 订单状态漏斗
bi-cli analytics funnel [--days 30] [--pretty]
```

### 流量分析 (traffic)

```bash
# 流量概览
bi-cli traffic overview [--days 30] [--product <uuid>] [--pretty]

# 流量来源
bi-cli traffic sources [--limit 10] [--pretty]

# 转化漏斗
bi-cli traffic funnel [--pretty]

# 站内搜索分析
bi-cli traffic search [--zero-results] [--pretty]

# 热门页面
bi-cli traffic pages [--limit 20] [--pretty]
```

## 工作流示例

### 示例 1：查看近期销售
用户："查看最近 7 天的销售情况"

```bash
bi-cli sales get --days 7 --pretty
```

### 示例 2：查看畅销商品
用户："哪些商品卖得最好"

```bash
bi-cli product best-sellers --limit 5 --pretty
```

### 示例 3：收入趋势
用户："收入趋势如何"

```bash
bi-cli trends revenue --days 30 --pretty
```

### 示例 4：同比分析
用户："和去年同期比怎么样"

```bash
bi-cli analytics compare --days 30 --compare-to previous_year --pretty
```

### 示例 5：流量来源
用户："流量都从哪来的"

```bash
bi-cli traffic sources --limit 10 --pretty
```

## 注意事项

- 命令是 `bi-cli` 不是 `bi`
- 默认输出 JSON 格式（AI 友好）
- 使用 `--pretty` 获取彩色表格
- 默认时间范围是最近 7 天或 30 天（因命令而异）
