@youzan-cloud/zan-saas-cli 0.0.0-stage → 0.1.0-beta.3

package/src/commands/native/customer/customer/get/schema.json

@@ -0,0 +1,958 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "required": [
+      "kdtId",
+      "yzOpenId",
+      "include"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "kdtId": {
+        "$ref": "#/definitions/shopId"
+      },
+      "yzOpenId": {
+        "$ref": "#/definitions/customerId"
+      },
+      "include": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": [
+            "tags",
+            "benefit_cards",
+            "level_summary",
+            "credit",
+            "behavior",
+            "valuecard_gift",
+            "valuecard_balance",
+            "level",
+            "auth_info"
+          ]
+        },
+        "uniqueItems": true,
+        "description": "省略include选项后规范化为[]；显式空值或空项不是省略。"
+      }
+    },
+    "description": "CLI 解析参数并完成必要上下文补全后的业务输入；不是直接传入 CLI 的 JSON。原始选项、必填条件和默认值见 options。"
+  },
+  "output": {
+    "type": "object",
+    "required": [
+      "data"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "required": [
+          "user_base"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "user_base": {
+            "$ref": "#/definitions/user_base"
+          },
+          "tags": {
+            "$ref": "#/definitions/tags"
+          },
+          "benefit_cards": {
+            "$ref": "#/definitions/benefit_cards"
+          },
+          "level_summary": {
+            "$ref": "#/definitions/level_summary"
+          },
+          "credit": {
+            "$ref": "#/definitions/credit"
+          },
+          "behavior": {
+            "$ref": "#/definitions/behavior"
+          },
+          "valuecard_gift": {
+            "$ref": "#/definitions/valuecard_gift"
+          },
+          "valuecard_balance": {
+            "$ref": "#/definitions/valuecard_balance"
+          },
+          "level": {
+            "$ref": "#/definitions/level"
+          },
+          "auth_info": {
+            "$ref": "#/definitions/auth_info"
+          }
+        }
+      }
+    }
+  },
+  "preview": {
+    "type": "object",
+    "required": [
+      "method",
+      "path",
+      "body"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "method": {
+        "const": "POST"
+      },
+      "path": {
+        "const": "youzan.scrm.customer.detail.get/1.0.1"
+      },
+      "body": {
+        "type": "object",
+        "required": [
+          "kdt_id",
+          "yz_open_id",
+          "fields"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "kdt_id": {
+            "$ref": "#/definitions/shopId"
+          },
+          "yz_open_id": {
+            "$ref": "#/definitions/customerId"
+          },
+          "fields": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  },
+  "error": {
+    "type": "object",
+    "required": [
+      "success",
+      "code",
+      "message",
+      "details"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "success": {
+        "const": false
+      },
+      "code": {
+        "const": -10001
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1
+      },
+      "details": {
+        "type": "object",
+        "required": [
+          "category",
+          "stage",
+          "command",
+          "targetScope",
+          "requestState",
+          "nextStep",
+          "errorVersion",
+          "recovery",
+          "execution"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": [
+              "parameter",
+              "configuration",
+              "permission",
+              "authentication",
+              "http",
+              "transport",
+              "business_rejected",
+              "protocol"
+            ]
+          },
+          "stage": {
+            "type": "string",
+            "enum": [
+              "input",
+              "context",
+              "scope",
+              "configuration",
+              "http",
+              "transport",
+              "response",
+              "customer",
+              "customer-model"
+            ]
+          },
+          "command": {
+            "const": "customer.customer.get"
+          },
+          "targetScope": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/scope"
+              },
+              {
+                "type": "object",
+                "maxProperties": 0
+              }
+            ]
+          },
+          "requestState": {
+            "type": "string",
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ],
+            "description": "not_sent确认未发送；sent已取得响应但不证明业务成功；unknown发送或结果无法确认。"
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1
+          },
+          "api": {
+            "type": "string",
+            "minLength": 1
+          },
+          "httpStatus": {
+            "type": "integer",
+            "minimum": 100,
+            "maximum": 599
+          },
+          "businessCode": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/safeInteger"
+              },
+              {
+                "type": "string",
+                "pattern": "^-?[0-9]{1,12}$"
+              }
+            ]
+          },
+          "gatewayCode": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/safeInteger"
+              },
+              {
+                "type": "string",
+                "pattern": "^-?[0-9]{1,12}$"
+              }
+            ]
+          },
+          "trace_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$"
+          },
+          "request_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$"
+          },
+          "errorVersion": {
+            "const": 2,
+            "description": "本命令采用错误诊断协议第二版。"
+          },
+          "issues": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 16,
+            "items": {
+              "$ref": "#/definitions/diagnosticIssue"
+            },
+            "description": "最多十六个已定位问题，不包含收到的原值。"
+          },
+          "issuesTruncated": {
+            "const": true,
+            "description": "问题超过返回上限，当前列表没有穷尽全部问题。"
+          },
+          "recovery": {
+            "$ref": "#/definitions/diagnosticRecovery",
+            "description": "受限的恢复说明，不会自动执行。"
+          },
+          "execution": {
+            "$ref": "#/definitions/diagnosticExecution",
+            "description": "整次调用的请求观察，独立于失败阶段的 requestState。"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "safeInteger": {
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991,
+      "description": "JSON安全整数；原始long超出安全范围时失败，不把已舍入数值转成字符串。"
+    },
+    "shopId": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991,
+      "description": "目标店铺 ID；省略 --kdt-id 时取当前上下文 shopId，显式非法值不回退；非总部须与上下文 shopId 一致。"
+    },
+    "customerId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "返回的客户yzOpenId须与请求完全一致；不得用请求值补造响应。"
+    },
+    "yuanMoney": {
+      "type": "string",
+      "pattern": "^-?(0|[1-9][0-9]*)\\.[0-9]{2}$",
+      "description": "默认人民币（CNY）的元十进制金额字符串，固定两位；不执行换汇或浮点舍入。"
+    },
+    "user_base": {
+      "type": "object",
+      "required": [
+        "yz_open_id"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "yz_open_id": {
+          "$ref": "#/definitions/customerId"
+        },
+        "name": {
+          "type": "string",
+          "description": "客户姓名"
+        },
+        "show_name": {
+          "type": "string",
+          "description": "展示姓名(包含展示逻辑：客户姓名=>手机号=>微信昵称=>匿名用户)"
+        },
+        "mobile": {
+          "type": "string",
+          "description": "客户联系手机号"
+        },
+        "gender": {
+          "$ref": "#/definitions/safeInteger",
+          "description": "客户性别， 1:男，2:女"
+        },
+        "created_at": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "$comment": "upstream-time:seconds",
+          "description": "创建时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "tags": {
+      "type": "object",
+      "required": [
+        "tags"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "$ref": "#/definitions/safeInteger",
+                "description": "标签id"
+              },
+              "name": {
+                "type": "string",
+                "description": "标签名"
+              }
+            },
+            "description": "元素只输出本视图选择的属性；未选择的源属性忽略，必需身份字段缺失或已选属性错型失败。"
+          },
+          "description": "客户标签"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "benefit_cards": {
+      "type": "object",
+      "required": [
+        "cards"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "cards": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "$ref": "#/definitions/safeInteger",
+                "description": "客户卡摘要标识；不能直接当作权益卡 cardAlias 或客户持卡 cardNo 使用。"
+              },
+              "name": {
+                "type": "string",
+                "description": "权益卡名称"
+              },
+              "begin_at": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "format": "beijing-date-time-ms"
+                  },
+                  {
+                    "const": ""
+                  }
+                ],
+                "$comment": "upstream-time:text:empty",
+                "description": "权益卡有效期开始时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。业务哨兵原值保留：['']。"
+              },
+              "end_at": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "format": "beijing-date-time-ms"
+                  },
+                  {
+                    "const": ""
+                  }
+                ],
+                "$comment": "upstream-time:text:empty",
+                "description": "权益卡有效期结束时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。业务哨兵原值保留：['']。"
+              }
+            },
+            "description": "元素只输出本视图选择的属性；未选择的源属性忽略，必需身份字段缺失或已选属性错型失败。"
+          },
+          "description": "客户会员卡"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "level_summary": {
+      "type": "object",
+      "required": [
+        "level"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "level": {
+          "$ref": "#/definitions/safeInteger",
+          "description": "本次取得的单值等级；不表示权益等级，不与 level_infos 自动换算。"
+        }
+      },
+      "description": "客户单值等级摘要；与免费、付费等级关系的对应未明确，不能据此补造等级记录或推算会员身份。"
+    },
+    "credit": {
+      "type": "object",
+      "required": [
+        "points"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "points": {
+          "$ref": "#/definitions/safeInteger",
+          "description": "客户积分"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "behavior": {
+      "type": "object",
+      "required": [
+        "trade_count",
+        "total_trade_amount"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "trade_count": {
+          "$ref": "#/definitions/safeInteger",
+          "description": "购买次数"
+        },
+        "total_trade_amount": {
+          "$ref": "#/definitions/yuanMoney",
+          "$comment": "upstream-money:fen",
+          "description": "购买总金额，单位：分；源为分安全整数，CLI精确转换为元两位字符串；不补零。"
+        },
+        "last_trade_at": {
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "beijing-date-time-ms"
+            },
+            {
+              "const": 0
+            }
+          ],
+          "$comment": "upstream-time:seconds:zero",
+          "description": "最后购买时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。业务哨兵原值保留：[0]。"
+        },
+        "refund_count": {
+          "$ref": "#/definitions/safeInteger",
+          "description": "退款次数"
+        },
+        "refund_trade_amount": {
+          "$ref": "#/definitions/yuanMoney",
+          "$comment": "upstream-money:fen",
+          "description": "退款总金额，单位：分；源为分安全整数，CLI精确转换为元两位字符串；不补零。"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "valuecard_gift": {
+      "type": "object",
+      "required": [
+        "totalBalance"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "totalBalance": {
+          "$ref": "#/definitions/yuanMoney",
+          "$comment": "upstream-money:fen",
+          "description": "礼品卡余额摘要，人民币元两位文本；不提供本金与赠金拆分，不证明等于逐卡余额之和。"
+        }
+      },
+      "description": "客户档案返回的分类余额摘要；归集范围未明确，不能与另一分类相加为客户总资产。"
+    },
+    "valuecard_balance": {
+      "type": "object",
+      "required": [
+        "totalBalance"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "totalBalance": {
+          "$ref": "#/definitions/yuanMoney",
+          "$comment": "upstream-money:fen",
+          "description": "余额卡余额摘要，人民币元两位文本；不提供本金与赠金拆分，不证明等于逐卡余额之和。"
+        }
+      },
+      "description": "客户档案返回的分类余额摘要；归集范围未明确，不能与另一分类相加为客户总资产。"
+    },
+    "level": {
+      "type": "object",
+      "required": [
+        "level_infos"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "level_infos": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "level_value",
+              "level_type"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "level_value": {
+                "$ref": "#/definitions/safeInteger",
+                "description": "等级值"
+              },
+              "level_alias": {
+                "type": "string",
+                "description": "等级别名设置"
+              },
+              "level_name": {
+                "type": "string",
+                "description": "等级名称"
+              },
+              "level_type": {
+                "$ref": "#/definitions/safeInteger",
+                "description": "等级类型 1：免费等级，2：付费等级"
+              }
+            },
+            "description": "元素只输出本视图选择的属性；未选择的源属性忽略，必需身份字段缺失或已选属性错型失败。"
+          },
+          "description": "本次返回的免费、付费等级记录，保留顺序；不保证包含完整等级历史。"
+        }
+      },
+      "description": "本次取得的等级关系摘要；缺失不从单值摘要补齐。"
+    },
+    "auth_info": {
+      "type": "object",
+      "required": [
+        "is_mobile_auth"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "is_mobile_auth": {
+          "type": "boolean",
+          "description": "手机号码是否授权 true:已授权 false:未授权"
+        }
+      },
+      "description": "CLI已确认的有限字段视图；required为本视图成功所需核心内容，其余明细允许省略但返回时须类型正确。省略只表示未取得，不推断无值/权限；null不在本视图类型内。"
+    },
+    "scope": {
+      "type": "object",
+      "required": [
+        "kdtId"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      }
+    },
+    "diagnosticExpected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "type": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "预期的 JSON 类型。"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "description": "预期的 JSON 类型。"
+              }
+            }
+          ],
+          "description": "同版模型允许的类型。"
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "契约声明的静态标量约束。"
+          },
+          "description": "同版模型允许的静态值。"
+        },
+        "const": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "契约声明的静态标量约束。"
+        },
+        "minimum": {
+          "type": "number",
+          "description": "包含的最小值。"
+        },
+        "maximum": {
+          "type": "number",
+          "description": "包含的最大值。"
+        },
+        "exclusiveMinimum": {
+          "type": "number",
+          "description": "不包含的最小值。"
+        },
+        "exclusiveMaximum": {
+          "type": "number",
+          "description": "不包含的最大值。"
+        },
+        "minLength": {
+          "type": "integer",
+          "description": "最少字符数。"
+        },
+        "maxLength": {
+          "type": "integer",
+          "description": "最多字符数。"
+        },
+        "minItems": {
+          "type": "integer",
+          "description": "最少元素数。"
+        },
+        "maxItems": {
+          "type": "integer",
+          "description": "最多元素数。"
+        },
+        "format": {
+          "type": "string",
+          "description": "同版模型声明的格式。"
+        },
+        "pattern": {
+          "type": "string",
+          "description": "同版模型声明的字符约束。"
+        },
+        "additionalProperties": {
+          "const": false,
+          "description": "对象拒绝契约以外的属性。"
+        },
+        "contains": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "const"
+          ],
+          "properties": {
+            "const": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "契约声明的静态标量约束。"
+            }
+          }
+        },
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "enum"
+          ],
+          "properties": {
+            "enum": {
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "契约声明的静态标量约束。"
+              },
+              "description": "元素允许的静态值。"
+            }
+          }
+        }
+      }
+    },
+    "diagnosticIssue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "reason"
+      ],
+      "properties": {
+        "source": {
+          "enum": [
+            "argv",
+            "input",
+            "context",
+            "output",
+            "preview"
+          ],
+          "description": "问题所属的参数、输入、上下文、结果或预览模型。"
+        },
+        "path": {
+          "type": "string",
+          "description": "对应模型中的 JSON Pointer；不含原始输入或动态字典键。"
+        },
+        "option": {
+          "type": "string",
+          "description": "可定位时给出的已注册 CLI 选项。"
+        },
+        "reason": {
+          "enum": [
+            "required",
+            "invalid_type",
+            "invalid_choice",
+            "out_of_range",
+            "invalid_format",
+            "conditional_required",
+            "constraint",
+            "unexpected_property",
+            "unknown_option",
+            "unknown_command",
+            "excess_arguments",
+            "missing_value"
+          ],
+          "description": "字段违反的约束类型，原始值不回显。"
+        },
+        "expected": {
+          "$ref": "#/definitions/diagnosticExpected",
+          "description": "同版契约的静态预期。"
+        },
+        "relatedPaths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "关联字段的 JSON Pointer。"
+          },
+          "description": "触发条件约束的关联字段。"
+        }
+      }
+    },
+    "diagnosticRecovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "automaticBusinessRetry"
+      ],
+      "properties": {
+        "action": {
+          "enum": [
+            "correct_input",
+            "complete_authentication",
+            "request_access_review",
+            "stop_and_inspect"
+          ],
+          "description": "依次表示修正本地输入、补认证、核对权限或停止核查；仅是说明，不执行操作或授予权限。"
+        },
+        "automaticBusinessRetry": {
+          "const": false,
+          "description": "不据此自动重放业务请求。"
+        }
+      }
+    },
+    "diagnosticExecution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestState",
+        "coverage",
+        "observedAttempts"
+      ],
+      "properties": {
+        "requestState": {
+          "enum": [
+            "not_sent",
+            "sent",
+            "unknown"
+          ],
+          "description": "整次调用尚未发送、已有发送记录或无法排除未知请求；不代表业务完成。"
+        },
+        "coverage": {
+          "enum": [
+            "complete",
+            "partial"
+          ],
+          "description": "请求观察覆盖全部已接入路径，或存在未观测路径；部分覆盖不能声明零请求。"
+        },
+        "observedAttempts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
+        }
+      }
+    }
+  },
+  "modules": {
+    "user_base": {
+      "base": true,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "默认客户身份及常用资料；只选模型中6个字段，主键必需，其余已返回资料可省略。"
+    },
+    "tags": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "客户标签视图，只返回tags中id/name，不重复tag_ids。"
+    },
+    "benefit_cards": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "客户卡视图，只返回id/name/begin_at/end_at，不推断当前可用性或卡实例身份。"
+    },
+    "level_summary": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "单值等级摘要，不能据此推算免费、付费等级关系或会员身份。"
+    },
+    "credit": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "当前积分points；不输出累计消费积分。"
+    },
+    "behavior": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "购买/退款次数与金额、最后购买时间点；不输出全渠道统计。"
+    },
+    "valuecard_gift": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "礼品卡 gift余额摘要，使用储值卡域 totalBalance 术语；不推断逐卡归集范围或可支付金额。"
+    },
+    "valuecard_balance": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "余额卡 balance余额摘要，使用储值卡域 totalBalance 术语；不推断逐卡归集范围或可支付金额。"
+    },
+    "level": {
+      "base": false,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "本次取得的免费、付费等级关系摘要；只查询客户等级关系时优先选择 member.customer-level.get。"
+    },
+    "auth_info": {
+      "base": false,
+      "upstreamPath": "data.auth_info",
+      "required": true,
+      "description": "手机号码授权状态is_mobile_auth，不等同手机号验证。"
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.scrm.customer.detail.get/1.0.1"
+  },
+  "success": {
+    "description": "客户主键匹配，user_base 及全部请求模块的有限字段视图满足模型后整体成功。"
+  },
+  "errors": {
+    "description": "失败 stdout 为空，stderr 为一份脱敏错误 JSON，退出码非零；不返回部分成功，不自动重试、切换身份或目标。按 error 模型及安全下一步处理。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
+    "默认 user_base 只包含 yz_open_id、name、show_name、mobile、gender、created_at，其中仅 yz_open_id 必需。",
+    "--include 追加所列扩展模块，不替换基础模块；未请求模块省略，已请求模块必须满足模型后才整体成功。",
+    "已选可选明细缺失不表示无值、无权限或不存在；不补零、null 或空集合，不承诺完整客户档案。",
+    "已定义人民币金额为元、固定两位小数字符串，不能再次除以 100；日期时间遵循字段模型。",
+    "卡、等级及标签只表示本次返回关系，不推导会员身份、卡可用性、可支付金额或全渠道统计。",
+    "本地 --dry-run 不读取凭证、不联网；预览只证明构造计划，不证明对象存在或权限有效。真实执行仍需有效上下文及目标范围授权，at 声明不替代服务端授权。",
+    "本命令已定义金额的币种默认人民币（CNY）；字段、结果或明确父对象上下文声明其他币种时按该声明处理，不执行换汇。",
+    "level 是免费、付费等级关系摘要；level_summary 是单值等级摘要，两者不自动换算。不存在名为权益等级的独立概念。",
+    "valuecard_balance 与 valuecard_gift 分别展示余额卡、礼品卡余额摘要；不相加为客户总资产，不断言与 valuecard 逐卡余额求和相等。",
+    "benefit_cards 的 id 只作为客户卡摘要标识，不提供到 cardAlias 或 cardNo 的标识转换。"
+  ]
+}