---
name: product-page
description: 商品详情页(PDP)配置。自定义商品详情页的区块内容（如护理说明、退货政策、品牌故事）。当用户需要编辑商品页信息区块、隐藏区块、添加自定义区块、管理翻译时使用。
---

## 概念

PDP（Product Detail Page）区块是商品详情页上的内容模块，采用三层继承：

```
System（系统默认 7 个区块）→ Merchant（商户定制）→ Product（单品覆盖）
```

- 无 `--product` → merchant 级（影响所有商品）
- 有 `--product <id或handle>` → product 级（仅影响该商品）

### 系统默认区块

| handle | 说明 | 类型 |
|--------|------|------|
| `highlights` | 产品亮点 | static |
| `details` | 产品详情 | collapsible |
| `guarantee` | 品质保证 | collapsible |
| `care` | 护理说明 | collapsible |
| `shipping-policies` | 发货政策 | collapsible |
| `return` | 退换政策 | collapsible |
| `eco-friendly` | 环保说明 | collapsible |

### 模板变量

content 支持：`{{product.name}}`、`{{product.description}}`、`{{variant.sku}}`、`{{merchant.name}}`

## 命令（共 7 个）

### 查看

```bash
commerce pdp show                          # 所有区块（合并视图）
commerce pdp show --product blue-hoodie    # 某商品的区块
commerce pdp show --handle care            # 单个区块详情
```

### 添加新区块

```bash
commerce pdp add --handle faq --content "## FAQ\n\nQ1: ..." --type collapsible
commerce pdp add --handle faq --content "..." --product blue-hoodie
```

### 编辑已有区块（自动覆盖系统默认）

```bash
commerce pdp edit --handle care --content "机洗30度"
commerce pdp edit --handle care --content "干洗" --product silk-dress
commerce pdp edit --handle care --position 3 --type static
```

### 隐藏区块

```bash
commerce pdp hide --handle eco-friendly
commerce pdp hide --handle eco-friendly --product blue-hoodie
```

### 重置（删除定制，恢复继承）

```bash
commerce pdp reset --handle care --yes
commerce pdp reset --handle care --product blue-hoodie --yes
```

### 排序（handle:position 格式，无 JSON）

```bash
commerce pdp reorder highlights:1 details:2 care:3 return:4
commerce pdp reorder --tab-group product-info highlights:1 details:2
commerce pdp reorder --product blue-hoodie highlights:1 details:2
```

### 翻译

```bash
# 设置
commerce pdp translate --handle care --lang zh-CN --title "护理说明" --content "机洗30度"

# 查看
commerce pdp translate --handle care --list

# 删除
commerce pdp translate --handle care --lang zh-CN --delete --yes
```

## 自然语言映射

- "查看商品详情页区块" → `commerce pdp show`
- "修改护理说明" → `commerce pdp edit --handle care --content "..."`
- "隐藏环保说明" → `commerce pdp hide --handle eco-friendly`
- "添加品牌故事" → `commerce pdp add --handle brand-story --content "..."`
- "调整区块顺序" → `commerce pdp reorder highlights:1 details:2 care:3`
- "给护理说明加中文翻译" → `commerce pdp translate --handle care --lang zh-CN --title "..." --content "..."`

## 注意

- **PDP 管理页面区块**（内容板块），**product 管理商品属性**（名称、价格、库存）。两者不同。
- 编辑继承的区块会自动创建 override，无需手动指定 operation-type
- `--tab-group none` 可清除 tab 分组
