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

# shb-cli part detail

备件详情查询。

> **本文档出现的命令、子命令、flag、参数名、接口/JSON 字段名都只供你后台执行，绝不出现在给用户的回复里**。

## 查看备件详情

```bash
shb-cli part detail --id <sparepartId>

# 格式化输出
shb-cli part detail --id <sparepartId> --format-data

# 只看部分字段
shb-cli part detail --id <sparepartId> --format-data --fields name,type,standard,salePrice,costPrice,enable
```

- `--id` 必填，是备件的 `id`（UUID），一般来自 `part search` 返回结果中的 `id` 字段。
- 若本轮对话中已经搜索过该备件（列表里出现过它的 `id`），**直接复用已有 id 调 detail，不要重新 search**（见 SKILL.md「复用已知 ID」）。

## --format-data 输出结构速查

`--format-data -o raw` 返回：

```json
{
  "columns": [{"field": "name", "label": "名称"}, ...],
  "row": {"name": "刹车片", "type": "耗材", "standard": "标准型", "salePrice": "99.50", "costPrice": "50.00", "enable": "启用", ...}
}
```

不加 `--fields` 时默认输出**全部已知字段**（详情场景展示信息更完整，与 `search` 只默认展示常用字段不同），包括：`id`、`serialNumber`、`name`、`type`、`standard`、`unit`、`salePrice`、`costPrice`、`description`、`enable`、`productTypeList`、`createTime`。

## 典型组合场景

### 按关键字搜索后查看详情

```bash
# 1. 用名称关键字搜索，从返回结果中读取目标备件的 id
shb-cli part search --keyword "刹车片" --format-data --fields serialNumber,id,name

# 2. 查看该备件完整详情
shb-cli part detail --id <sparepartId>
```

## 注意

- `part detail` 默认输出原始响应（裸 SparepartDTO，**没有** status/data 信封）；需要字段文案和值格式化时显式传 `--format-data`。
- `--id` 缺失时命令直接报错 `--id is required`，不要凭空编造 id。