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

# shb-cli part field list

备件字段定义查询。

```bash
shb-cli part field list
```

- 无必填参数。
- 返回备件表单的字段定义列表（字段名、文案、类型等），用于确定 `part search --fields` / `part detail --fields` 里可以传哪些字段 key，以及在展示自定义字段时把内部 key 换成中文文案。
- 响应已由 CLI 解包信封，直接输出字段定义数组 `[...]`，每项含 `fieldName`、`displayName`、`formType`、`isNull` 等。
- 备件目前只有系统固定字段（无类似工单/事件的自定义属性系统），本接口主要用于核对字段元数据，日常展示优先用 `--format-data` 自动格式化的结果，通常不需要手动查这个接口。

## 注意

- 本接口输出结构随后端定义变化，字段不确定时先执行一次命令查看实际返回，不要凭记忆假设字段名。