> **前置条件** — 执行以下任何命令前，请先确认已完成认证。如未认证，参见 [`../../shb-shared/SKILL.md`](../../shb-shared/SKILL.md)。

# shb-cli customer address

查询客户地址列表。必须传入客户 ID，分页返回该客户名下所有地址记录。

## 基础用法

```bash
# 查询指定客户的地址列表
shb-cli customer address list --customer-id <customerId>

# 表格展示
shb-cli customer address list --customer-id <customerId> -o table

# 翻页
shb-cli customer address list --customer-id <customerId> --page 2 --page-size 20
```

## 完整 Flags

| Flag | 说明 | 必填 |
|------|------|------|
| `--customer-id` | 客户 ID | 是 |
| `--page` | 页码（从 1 开始） | — |
| `--page-size` | 每页条数（默认 10） | — |

## 返回字段（表格模式）

| 列 | 说明 |
|----|------|
| ID | 地址唯一标识（UUID）。**仅供你内部串联后续调用，展示给用户时必须去掉此列，绝不输出这串 UUID** |
| 地址 | 省+市+区+街道+详细地址拼接 |
| 是否是主地址 | 1=主地址 |

> ⚠️ 工具的表格/JSON 输出里带 `ID`（UUID）列，但这是给你内部用的。**给用户的回复要把 ID 列剔除**，只呈现地址、是否主地址等可读信息；不要原样把含 UUID 的表格贴给用户。

## 注意

- `--customer-id` 是必填参数，未传时命令报错。
- **报数量只用真实数字，不要预告计划**：回复里说的条数必须是工具**本次实际返回的条数**或响应里的**总数**，绝不说"数据量可能较大、先展示前 N 条"这类预设话术，也不要出现与实际不符的数字；若只返回了部分，如实告知"共 X 个地址，当前展示前 N 个，还有更多"。
- 当工单创建需要客户地址时，先通过 `customer list` 获取客户 `id`，再用此命令获取地址列表；取到 `id` 后填入工单创建参数的 `address` 字段。
- 完整地址对象（含经纬度等字段）通过 JSON 输出模式获取。