---
name: merchant
description: "店铺基础信息管理。使用场景：查看店铺信息、更新店铺名称/描述/联系方式/发货地址。注意：运费设置用 shipping skill。"
---

# 店铺管理

## 典型场景

| 用户说 | 命令 |
|--------|------|
| "查看店铺信息" / "我的店铺" | `commerce merchant info` |
| "修改店铺名称" / "更新店铺描述" | `commerce merchant update --name/--description` |
| "设置联系方式" | `commerce merchant update --contact-*` |
| "更新发货地址" | `commerce merchant update --origin-*` |
| "设置品牌色" / "修改主题色" / "换个颜色" | `commerce merchant update --primary-color "#1a3a5c"` |
| "查看店铺链接" / "我的店铺地址" | `commerce merchant url` |
| "在浏览器打开店铺" | `commerce merchant url --open` |
| "初次开通店铺" / "OAuth 后初始化" | `commerce merchant setup` |

## 不在此模块（重要）

| 用户说 | 正确位置 |
|--------|----------|
| "运费设置" / "运费模式" / "运费区域" | **shipping skill**：`commerce shipping get-mode` |
| "Easyship" / "快递公司" | **shipping skill**：`commerce easyship couriers` |
| "Stripe/支付设置" | `commerce stripe status` |
| "首页设置" | **homepage skill** |

---

## 查看店铺信息

```bash
commerce merchant info
```

返回：店铺名称、描述、Logo、货币、联系信息、发货地址

**注意**：此命令不返回运费设置，运费相关请用 `commerce shipping get-mode`

---

## 更新店铺信息

```bash
commerce merchant update [选项]
```

### 基础信息
| 选项 | 说明 |
|------|------|
| `--name` | 店铺名称 |
| `--slug` | 店铺标识（影响 URL） |
| `--description` | 店铺描述 |
| `--default-currency` | 默认货币（USD, CNY 等） |
| `--google-ads-customer-id` | Google Ads 客户 ID（10位数字） |
| `--primary-color` | 品牌主色（hex 格式，如 #FF5A5F） |

### 联系方式
| 选项 | 说明 |
|------|------|
| `--contact-name` | 联系人 |
| `--contact-phone` | 联系电话 |
| `--contact-email` | 联系邮箱 |
| `--company-name` | 公司名称 |

### 发货地址
| 选项 | 说明 |
|------|------|
| `--origin-country-alpha2` | 国家代码（CN, US 等） |
| `--origin-city` | 城市 |
| `--origin-postal-code` | 邮编 |
| `--origin-line-1` | 地址行1 |
| `--origin-line-2` | 地址行2 |
| `--origin-state` | 省/州 |

---

## 示例

```bash
# 更新名称和描述
commerce merchant update --name "我的小店" --description "精选好物"

# 更新联系方式
commerce merchant update \
  --contact-name "张三" \
  --contact-phone "13800138000" \
  --contact-email "shop@example.com"

# 更新发货地址
commerce merchant update \
  --origin-country-alpha2 CN \
  --origin-city 深圳 \
  --origin-postal-code 518000 \
  --origin-line-1 "科技园路1号" \
  --origin-state 广东

# 设置品牌色
commerce merchant update --primary-color "#1a3a5c"
```

---

## 查看 / 打开店铺链接

```bash
commerce merchant url           # 输出 https://{slug}.optima.shop
commerce merchant url --open    # 同时在浏览器中打开
```

返回公开店铺前台 URL。需要 merchant 已设置 slug（用 `merchant update --slug` 或 `merchant setup`）。

---

## 首次初始化店铺（OAuth 用户）

```bash
commerce merchant setup [选项]
```

OAuth 注册的用户首次需要初始化 merchant profile（设置 slug + 基础信息）。普通注册用户不需要此命令。

支持的选项与 `merchant update` 相同：`--name`、`--slug`、`--default-currency`、`--contact-*`、`--origin-*` 等。

---

## 命令参考

- `commerce merchant info` - 查看店铺信息
- `commerce merchant update` - 更新店铺信息
- `commerce merchant url` - 查看店铺前台链接
- `commerce merchant setup` - 初次初始化店铺（OAuth 用户）

## 不确定用什么命令？

运行 `commerce --help` 查看所有模块，或 `commerce merchant --help` 查看子命令。
