---
name: review
description: Review management, moderation, and AI review generation. View, approve, reject, and respond to customer reviews. Handle featured reviews, reports, and settings. Generate AI reviews for products. Use when user needs to moderate reviews, respond to feedback, manage review reports, configure auto-approval, view review statistics, or generate AI reviews.
---

# Commerce CLI - Review Management

评价管理模块，用于审核、回复和管理顾客评价。

## 典型场景

当用户说：
- "查看待审核评价" → `commerce review list --status pending`
- "批准评价XX" → `commerce review approve --id XX`
- "回复评价XX" → `commerce review respond --id XX --content "感谢您的反馈！"`
- "查看评价统计" → `commerce review stats`
- "设为精选" → `commerce review feature --id XX --enable`
- "查看举报" → `commerce review reports --status pending`
- "查看评价设置" → `commerce review get-settings`
- "开启自动审核" → `commerce review update-settings --auto-approve`
- "生成评价" / "给商品刷评价" → `commerce review generate`
- "创建一条评价" → `commerce review create`
- "给产品生成5条评价" → 先 `commerce product get` 了解产品 → 再 `commerce review generate`
- "查看AI评价" → `commerce review list --ai-generated`

### 场景决策表

| 用户需求 | 推荐命令 | 关键注意点 |
|---------|---------|-----------|
| 查看待审核评价 | `review list --status pending` | 优先处理1-2星低分评价 |
| 批量审核 | `review batch --action approve` | 高分评价可批量批准 |
| 回复差评 | `review respond` | 先道歉再解决，避免激化 |
| 精选好评 | `review feature --enable` | 选择有图、详细的5星评价 |
| 处理举报 | `review handle-report` | 核实后决定删除或驳回 |
| 查看统计 | `review stats` | 监控平均分和评分分布趋势 |
| 查看设置 | `review get-settings` | 了解当前自动审核等配置 |
| 开启自动审核 | `review update-settings --auto-approve` | 所有评价自动通过 |
| AI 生成评价 | `review generate --product-id xxx --reviews '[...]' --spread-days 30` | 先查产品信息，自然评分分布，混合风格 |

### 标准评价管理流程
1. **每日审核** - `commerce review list --status pending` 查看待审核
2. **批准好评** - 4-5星评价快速批准 `commerce review approve --id XX`
3. **处理差评** - 1-3星评价仔细查看，考虑是否回复
4. **回复评价** - `commerce review respond` 对有建设性的差评友善回复
5. **精选好评** - `commerce review feature --enable` 选择有代表性的好评
6. **处理举报** - `commerce review reports` 查看并处理被举报的评价

### 差评处理流程
1. **查看详情** - `commerce review get --id XX` 了解评价内容
2. **核实情况** - 查看订单记录，确认是否有服务问题
3. **决定行动** - 合理差评→回复致歉；恶意差评→考虑拒绝或删除
4. **回复评价** - `commerce review respond` 真诚道歉并提出解决方案
5. **跟进改进** - 记录问题，优化产品或服务

### AI 评价生成流程
1. **了解产品** - `commerce product get --id prod_xxx` 获取产品名称、描述、卖点
2. **构思评价** - 根据产品特点构思多样化评价（不同评分、角度、风格、买家名字）
3. **批量提交** - `commerce review generate` 一次提交所有评价，自动分散时间

**单条创建示例：**
```bash
commerce review create \
  --product-id prod_123 \
  --rating 5 \
  --title "品质出色" \
  --content "收到后非常满意，做工精细，材质很好，值得推荐！" \
  --customer-name "张明" \
  --ai-generated --verified
```

**批量生成示例（推荐）：**
```bash
# 逐条控制 is_verified_purchase，建议 60-80% 标记为已购买
commerce review generate \
  --product-id prod_123 \
  --spread-days 30 \
  --reviews '[
    {"rating":5,"title":"品质出色","content":"收到后非常满意，做工精细，材质很好，值得推荐给朋友！","customer_name":"张明","is_verified_purchase":true},
    {"rating":4,"title":"性价比高","content":"整体不错，这个价位能买到这样的质量很满意。包装也很用心。","customer_name":"李华","is_verified_purchase":true},
    {"rating":5,"title":"超出预期","content":"比想象中好很多！细节处理得很到位，能看出品牌的用心。已经推荐给同事了。","customer_name":"王芳","is_verified_purchase":true},
    {"rating":4,"title":"物流很快","content":"下单第二天就到了，包装完好无损。产品本身也挺好用的，会回购。","customer_name":"陈磊"},
    {"rating":3,"title":"还行吧","content":"一般般，没有特别惊艳但也没什么问题，中规中矩的产品。","customer_name":"赵静"}
  ]'
```

## AI 评价质量指标

生成 AI 评价时，必须遵循以下质量标准：

| 维度 | 标准 |
|------|------|
| 评分分布 | 自然分布：5星 60%、4星 30%、3星 10%，避免全5星 |
| 内容多样性 | 每条评价角度不同（材质、外观、使用体验、性价比、物流、包装等） |
| 风格多样性 | 混合专业型、口语型、简短型、详细型 |
| 名字真实性 | 使用目标市场常见姓名，避免重复 |
| 长度适中 | 50-200 字，避免过短或过长 |
| 语言一致 | 评价语言与店铺目标市场一致 |
| 已购买比例 | 建议 60-80% 标记为已验证购买（`--verified`），提升可信度 |
| 时间分散 | 使用 `--spread-days` 分散评价时间，默认 30 天 |

## AI 评价风格模板

每次批量生成时混合使用不同风格，使评价看起来来自不同用户：

- **专业型**: 客观描述产品特点和功能，用词准确，适合电子产品、工具类
  > 例："这款蓝牙耳机的降噪效果令人印象深刻，续航实测达到标称的8小时，佩戴舒适度也很好。"
- **口语型**: 像真实买家的日常用语，带有个人情感，适合服饰、日用品
  > 例："哇真的好好看！颜色跟图片一模一样，穿上特别显瘦，闺蜜都问我在哪买的～"
- **简短型**: 1-2 句话 + 评分，模拟快速评价
  > 例："质量不错，好评。"
- **详细型**: 多角度描述使用体验，150-200 字，提供丰富参考
  > 例："用了一周来评价。首先包装很精致，打开就能感觉到品质。实际使用中，XX功能非常实用，解决了我之前YY的困扰。唯一小遗憾是ZZ方面还有提升空间，但整体性价比很高，推荐购买。"

## 卓越标准

### 评价管理质量指标
- **审核及时性**: 新评价24小时内审核完成
- **回复率**: 差评(1-3星)回复率 > 80%
- **平均评分**: 维持在 4.0 以上
- **精选覆盖**: 每个热门商品至少有1条精选评价

### 评价管理原则
- **及时响应**: 待审核评价堆积不超过50条
- **真诚回复**: 差评回复要表达歉意和解决意愿
- **精选多样**: 精选不同评分、不同角度的好评
- **公正处理**: 只删除明显违规评价，不删真实差评
- **数据驱动**: 定期查看统计，发现产品问题

## 常见问题

### 差评回复错误

❌ **错误做法 - 推卸责任**：
```
"这不是我们的问题，可能是快递造成的损坏。"
```

✅ **正确做法 - 真诚道歉**：
```bash
commerce review respond --id review_123 --content "非常抱歉给您带来了不好的体验。我们已经联系您协商补偿方案，感谢您的理解。如有任何问题，请随时联系我们的客服。"
```

### 精选评价选择

❌ **错误做法 - 只选5星简短评价**：
- "好" "不错" 这类评价没有参考价值

✅ **正确做法 - 选择有价值的评价**：
- 有详细使用体验
- 有实拍图片
- 提到具体优点
- 对其他买家有参考价值

### 举报处理

❌ **错误做法 - 不核实就删除**：
- 收到举报就删除评价，可能删除真实差评

✅ **正确处理**：
- **虚假评价** → 查看订单记录，确认未购买则删除
- **不当内容** → 包含脏话、广告则删除
- **恶意竞争** → 多个可疑评价来自同一IP则删除
- **真实差评** → 即使被举报也不应删除，驳回举报

### AI 评价生成错误

❌ **错误做法 - 全部5星、内容雷同**：
```bash
# 所有评价都是5星，内容模板化，一看就是假的
commerce review generate --product-id prod_123 --reviews '[
  {"rating":5,"title":"很好","content":"很好很满意","customer_name":"用户A"},
  {"rating":5,"title":"不错","content":"很好很满意","customer_name":"用户B"},
  {"rating":5,"title":"好评","content":"很好很满意","customer_name":"用户C"}
]'
```

✅ **正确做法 - 多样化评分、内容、风格**：
- 评分分布自然（5星60%、4星30%、3星10%）
- 每条评价从不同角度评价（材质、外观、使用感受、物流等）
- 混合不同风格（专业、口语、简短、详细）
- 使用真实感的姓名，不重复
- 先 `product get` 了解产品卖点再构思

## 命令参考

### 评价查看
- `commerce review list` - 查看评价列表
- `commerce review get` - 查看评价详情
- `commerce review stats` - 查看评价统计

### 评价审核
- `commerce review approve` - 批准评价
- `commerce review reject` - 拒绝评价
- `commerce review batch` - 批量操作

### 评价互动
- `commerce review respond` - 商家回复
- `commerce review delete-response` - 删除回复
- `commerce review feature` - 设置精选

### 评价管理
- `commerce review delete` - 删除评价
- `commerce review reports` - 查看举报
- `commerce review handle-report` - 处理举报

### AI 评价生成
- `commerce review create` - 创建单条评价（商家/AI）
- `commerce review generate` - 批量生成评价（推荐，支持时间分散）

### 评价设置
- `commerce review get-settings` - 查看评价设置
- `commerce review update-settings` - 更新评价设置

## 详细示例

### 查看待审核评价
```bash
# 用户说："查看待审核的评价"
commerce review list --status pending
```

### 批准评价
```bash
# 用户说："批准评价review_123"
commerce review approve --id review_123
```

### 拒绝评价
```bash
# 用户说："拒绝评价review_456"
commerce review reject --id review_456
```

### 回复评价
```bash
# 用户说："回复评价review_123，内容是感谢您的支持"
commerce review respond \
  --id review_123 \
  --content "感谢您的支持和认可！我们会继续努力提供优质的产品和服务。"
```

### 设为精选
```bash
# 用户说："把评价review_123设为精选"
commerce review feature --id review_123 --enable

# 取消精选
commerce review feature --id review_123 --disable
```

### 批量审核
```bash
# 用户说："批量批准这几条评价"
commerce review batch --ids review_1,review_2,review_3 --action approve

# 批量拒绝
commerce review batch --ids review_4,review_5 --action reject
```

### 查看统计
```bash
# 用户说："查看店铺评价统计"
commerce review stats
```

### 处理举报
```bash
# 查看待处理举报
commerce review reports --status pending

# 标记已处理
commerce review handle-report --id report_123 --action reviewed

# 驳回举报
commerce review handle-report --id report_456 --action dismissed
```

### 删除评价
```bash
# 用户说："删除评价review_789"
commerce review delete --id review_789 --yes
```

### 查看评价设置
```bash
# 用户说："查看评价设置"
commerce review get-settings
```

### 更新评价设置
```bash
# 用户说："开启自动审核"
commerce review update-settings --auto-approve

# 设置评价时间窗口（订单后30天内可评价）
commerce review update-settings --review-window-days 30

# 允许用户上传图片，设置最大5张
commerce review update-settings --allow-images --max-images 5
```

## 评价设置配置项

| 配置 | 说明 |
|------|------|
| `--auto-approve` | 新评价自动通过 |
| `--require-purchase` | 需要验证购买才能评价 |
| `--allow-anonymous` | 允许匿名评价 |
| `--review-window-days` | 评价时间窗口（1-365天）|
| `--allow-images` | 允许上传图片 |
| `--max-images` | 最大图片数（0-10）|
| `--allow-edit` | 允许编辑评价 |

## 重要提示

- 评价状态：pending(待审核) → approved(已批准) / rejected(已拒绝)
- 批准后的评价会在店铺公开显示
- 删除操作不可撤销，谨慎使用
- 商家每条评价只能有一条回复
- 精选评价会在商品页面突出显示
- 使用 `--help` 查看命令详细参数
