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

package/src/commands/native/aftersale/case/list/schema.json

@@ -0,0 +1,1095 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "scope",
+      "filters",
+      "range",
+      "pagination"
+    ],
+    "properties": {
+      "scope": {
+        "$ref": "#/definitions/scope"
+      },
+      "filters": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "orderNo": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$",
+            "description": "精确交易订单号，不转数字。"
+          },
+          "caseId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$",
+            "description": "精确售后单号，与交易订单号不同，不转数字。"
+          },
+          "yzOpenId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$",
+            "description": "有赞客户标识，不是员工ID。预览遮盖为 ***。"
+          },
+          "buyerPhone": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f](?:[^\\u0000-\\u001f\\u007f-\\u009f]*[^\\s\\u0000-\\u001f\\u007f-\\u009f])?$",
+            "description": "买家电话，保留文本，不允许控制字符或首尾空白。预览遮盖为 ***。"
+          },
+          "demand": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3
+            ],
+            "description": "诉求筛选：1=仅退款，2=退货退款，3=换货。列表不返回当前诉求，不回填筛选值。"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "WAIT_SELLER_AGREE",
+              "WAIT_BUYER_RETURN_GOODS",
+              "WAIT_SELLER_CONFIRM_GOODS",
+              "SELLER_REFUSE_BUYER",
+              "CLOSED",
+              "SUCCESS",
+              "CUSTOMER_SERVICE_IN",
+              "SELLER_REFUSE_BUYER_RETURN_GOODS",
+              "SELLER_RETURN_GOODS"
+            ],
+            "description": "处理状态：WAIT_SELLER_AGREE=等待商家同意，WAIT_BUYER_RETURN_GOODS=等待买家退货，WAIT_SELLER_CONFIRM_GOODS=等待商家确认收货，SELLER_REFUSE_BUYER=商家拒绝退款，CLOSED=退款关闭，SUCCESS=退款成功，CUSTOMER_SERVICE_IN=客满介入，SELLER_REFUSE_BUYER_RETURN_GOODS=商家拒绝收货，SELLER_RETURN_GOODS=商家确认收货并发送换货。成功不代表逐笔资金到账。"
+          },
+          "type": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3,
+              4,
+              5
+            ],
+            "description": "流程类型：1=买家申请退款，2=商家主动退款，3=一键退款，4=零售门店换货，5=微商城换货。不是诉求。"
+          },
+          "phase": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "阶段：1=售中，2=售后。"
+          },
+          "handlingStatus": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "description": "待处理归属：0=待商家处理，1=待买家处理，2=客服介入中；0也会发送。"
+          },
+          "serviceStatus": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3
+            ],
+            "description": "客服筛选：1=不需要客服介入，2=需要客服介入，3=介入结束；不直接套用响应字典。"
+          },
+          "itemTitle": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f](?:[^\\u0000-\\u001f\\u007f-\\u009f]*[^\\s\\u0000-\\u001f\\u007f-\\u009f])?$",
+            "description": "商品名称筛选，不承诺精确匹配或分词；不允许控制字符或首尾空白，预览遮盖为 ***。"
+          },
+          "skuNo": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f](?:[^\\u0000-\\u001f\\u007f-\\u009f]*[^\\s\\u0000-\\u001f\\u007f-\\u009f])?$",
+            "description": "商品规格编码，不是统一商品ID；不允许控制字符或首尾空白。"
+          },
+          "deliveryStatus": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "发货状态筛选：1=未发货，2=已发货，不表示签收。"
+          },
+          "refundMode": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "description": "退款资金类型筛选：0=原路退，1=现金退，2=标记退。不补造返回资金事实。"
+          },
+          "returnStockStatus": {
+            "type": "integer",
+            "enum": [
+              0,
+              10,
+              20
+            ],
+            "description": "退货归还库存状态：0=无需入库，10=待入库，20=归还库存成功。不是商家售后收货确认。"
+          },
+          "saleWay": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "销售渠道：1=门店，2=网店。"
+          },
+          "payType": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8
+            ],
+            "description": "支付类型：0=支付方式与渠道组合，1=无需支付，2=现付，3=部分支付，4=货到付款，5=线下收银，6=单次支付，7=阶段支付，8=外部支付。"
+          }
+        }
+      },
+      "range": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "$ref": "#/definitions/timePair",
+            "description": "创建时间对；未提供时不虚构日期，上游默认近三个月创建的记录，不等同于90天。"
+          },
+          "updated": {
+            "$ref": "#/definitions/timePair",
+            "description": "更新时间对，提供时还必须提供创建时间对。不承诺端点包含性。"
+          }
+        },
+        "dependencies": {
+          "updated": [
+            "created"
+          ]
+        }
+      },
+      "pagination": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "pageNo",
+          "pageSize"
+        ],
+        "properties": {
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "本次请求页码，不能绕过100页及页码乘页大小3000的深度限制。"
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "本页数量，20是CLI有界策略，不声称是接口最大值。"
+          }
+        }
+      }
+    }
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "data"
+    ],
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "cases",
+          "pagination"
+        ],
+        "properties": {
+          "cases": {
+            "type": "array",
+            "maxItems": 20,
+            "items": {
+              "$ref": "#/definitions/case"
+            },
+            "description": "仅本页售后摘要；空数组只表示本页无结果，不保证读完。无每行详情请求。"
+          },
+          "pagination": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "pageNo",
+              "pageSize",
+              "hasMore",
+              "nextPageNo",
+              "windowLimitReached"
+            ],
+            "properties": {
+              "pageNo": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100,
+                "description": "实际请求页码。"
+              },
+              "pageSize": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 20,
+                "description": "实际请求页大小。"
+              },
+              "total": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991,
+                "description": "匹配本次查询条件的总记录数，不是当前页返回条数；上游未提供可确认总数时省略。"
+              },
+              "hasMore": {
+                "type": [
+                  "boolean",
+                  "null"
+                ],
+                "description": "true 表示还有后续页，false 表示已确认没有后续页；无法确定时为 null，不以空页或短页推算。"
+              },
+              "nextPageNo": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "minimum": 1,
+                "maximum": 100,
+                "description": "已确认且未超过页码上限的下一页；无法确认或到达上限时为 null。"
+              },
+              "windowLimitReached": {
+                "type": "boolean",
+                "description": "true表示已到100页CLI窗口且尚未确认取完；保留原筛选并缩小范围，不请求第101页，不表示已读全集。"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "preview": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "requests"
+    ],
+    "properties": {
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "items": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "method",
+              "path",
+              "body"
+            ],
+            "properties": {
+              "method": {
+                "const": "POST"
+              },
+              "path": {
+                "const": "youzan.shop.basic.get/3.0.0"
+              },
+              "body": {
+                "type": "object",
+                "additionalProperties": false
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "method",
+              "path",
+              "body"
+            ],
+            "properties": {
+              "method": {
+                "const": "POST"
+              },
+              "path": {
+                "const": "youzan.trade.refund.search/3.0.1"
+              },
+              "body": {
+                "$ref": "#/definitions/previewBody"
+              }
+            }
+          }
+        ],
+        "additionalItems": false,
+        "description": "纯本地计划，不读凭证、不联网，无token或完整URL；敏感筛选遮盖不影响真实请求。"
+      }
+    }
+  },
+  "error": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "success",
+      "code",
+      "message"
+    ],
+    "properties": {
+      "success": {
+        "const": false
+      },
+      "code": {
+        "const": -10001
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1,
+        "description": "受控错误说明，不拼接业务正文、凭证或个人信息。"
+      },
+      "details": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "category",
+          "stage",
+          "command",
+          "targetScope",
+          "requestState",
+          "nextStep",
+          "errorVersion",
+          "recovery",
+          "execution"
+        ],
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": [
+              "validation",
+              "configuration",
+              "authentication",
+              "permission",
+              "scope_unresolved",
+              "http",
+              "business_rejected",
+              "not_found",
+              "protocol",
+              "transport",
+              "limit"
+            ],
+            "description": "validation=本地输入无效，configuration=配置缺失或无效，authentication=认证失败，permission=权限拒绝，scope_unresolved=范围无法核对，http=其他HTTP错误，business_rejected=业务或网关拒绝，not_found=准确错误码证明不存在，protocol=返回契约冲突，transport=网络失败，limit=资源限制超出。不猜测未核实错误码含义。"
+          },
+          "stage": {
+            "type": "string",
+            "enum": [
+              "input",
+              "context",
+              "configuration",
+              "shop-binding",
+              "cases",
+              "output-model",
+              "transport",
+              "response"
+            ],
+            "description": "input=输入，context=四字段上下文，configuration=传输配置，shop-binding=凭证店铺核验，cases=列表请求或范围核对，output-model=分页与字段投影，transport=网络传输，response=响应读取或解码。"
+          },
+          "command": {
+            "const": "aftersale.case.list"
+          },
+          "targetScope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "kdtId": {
+                "$ref": "#/definitions/shopId"
+              }
+            },
+            "description": "仅已验证的目标店铺，不回显筛选或非法输入。"
+          },
+          "requestState": {
+            "type": "string",
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ],
+            "description": "not_sent=当前阶段尚未发送，sent=已取得响应，unknown=无法确定结果。不授权自动重放。"
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1
+          },
+          "api": {
+            "type": "string",
+            "minLength": 1,
+            "description": "准确API及版本，不含URL或token。"
+          },
+          "httpStatus": {
+            "type": "integer",
+            "minimum": 100,
+            "maximum": 599
+          },
+          "businessCode": {
+            "$ref": "#/definitions/diagnosticCode"
+          },
+          "gatewayCode": {
+            "$ref": "#/definitions/diagnosticCode"
+          },
+          "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": {
+    "shopId": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991,
+      "description": "正安全整数店铺ID。argv必须使用规范十进制文本。"
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kdtId"
+      ],
+      "properties": {
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      }
+    },
+    "timePair": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end"
+      ],
+      "properties": {
+        "start": {
+          "$ref": "#/definitions/time"
+        },
+        "end": {
+          "$ref": "#/definitions/time"
+        }
+      },
+      "description": "北京时间起止时间，须严格先后。argv接受空格分隔秒及1..3位小数秒，但非零毫秒拒绝，不截断、不舍入，不接收Unix数字或T分隔。规范化后为三位零毫秒文本。"
+    },
+    "time": {
+      "type": "string",
+      "format": "beijing-date-time-ms",
+      "description": "北京时间 YYYY-MM-DD HH:mm:ss.SSS，三位毫秒文本。"
+    },
+    "case": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "caseId",
+        "orderNo",
+        "kdtId",
+        "status",
+        "amount"
+      ],
+      "properties": {
+        "caseId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$",
+          "description": "售后单号，用于售后定位，不是订单号。"
+        },
+        "orderNo": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$",
+          "description": "关联交易订单号，不是售后商品行ID。"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId",
+          "description": "必须等于本次目标店铺。"
+        },
+        "nodeKdtId": {
+          "$ref": "#/definitions/shopId",
+          "description": "可选分店引用，不改写为目标店铺。"
+        },
+        "status": {
+          "type": "string",
+          "minLength": 1,
+          "description": "WAIT_SELLER_AGREE=等待商家同意，WAIT_BUYER_RETURN_GOODS=等待买家退货，WAIT_SELLER_CONFIRM_GOODS=等待商家确认收货，SELLER_REFUSE_BUYER=商家拒绝退款，CLOSED=退款关闭，SUCCESS=退款成功，CUSTOMER_SERVICE_IN=客满介入，SELLER_REFUSE_BUYER_RETURN_GOODS=商家拒绝收货，SELLER_RETURN_GOODS=商家确认收货并发送换货。未知非空状态原样保留，不据此自动写入。"
+        },
+        "amount": {
+          "type": "string",
+          "pattern": "^(0|[1-9]\\d*)\\.\\d{2}$",
+          "description": "申请退款金额，默认CNY，元，两位小数，不表示实际到账。精确分值为0..9223372036854775807，CLI有界模型，不声称为接口最大退款额；拒绝空串、负值及无法精确落为整数分的值。"
+        },
+        "hasReturnGoods": {
+          "type": "boolean",
+          "description": "上游是否有退货的事实；缺失省略，不补false。"
+        },
+        "createdAt": {
+          "$ref": "#/definitions/time",
+          "description": "可选售后申请时间，北京时间三位毫秒文本。"
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/time",
+          "description": "可选售后修改时间，北京时间三位毫秒文本。"
+        },
+        "serviceStatus": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "已知1=客满未介入，2=客满介入中；3及其他未知安全整数原样保留，不套用请求或详情字典。"
+        },
+        "deliveryStatus": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "已知1=未发货，2=已发货；未知安全整数原样保留，不表示签收。"
+        }
+      }
+    },
+    "diagnosticCode": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "string",
+          "pattern": "^-?\\d{1,12}$"
+        }
+      ],
+      "description": "当前诊断白名单保留的业务或网关码，不保留错误正文。"
+    },
+    "previewBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "page_no",
+        "page_size"
+      ],
+      "properties": {
+        "page_no": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "page_size": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20
+        },
+        "tid": {
+          "type": "string",
+          "minLength": 1
+        },
+        "refund_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "yz_open_id": {
+          "const": "***"
+        },
+        "buyer_phone": {
+          "const": "***"
+        },
+        "goods_title": {
+          "const": "***"
+        },
+        "sku_no": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "WAIT_SELLER_AGREE",
+            "WAIT_BUYER_RETURN_GOODS",
+            "WAIT_SELLER_CONFIRM_GOODS",
+            "SELLER_REFUSE_BUYER",
+            "CLOSED",
+            "SUCCESS",
+            "CUSTOMER_SERVICE_IN",
+            "SELLER_REFUSE_BUYER_RETURN_GOODS",
+            "SELLER_RETURN_GOODS"
+          ]
+        },
+        "demand": {
+          "type": "integer",
+          "enum": [
+            1,
+            2,
+            3
+          ]
+        },
+        "type": {
+          "type": "integer",
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5
+          ]
+        },
+        "phase": {
+          "type": "integer",
+          "enum": [
+            1,
+            2
+          ]
+        },
+        "search_tag": {
+          "type": "integer",
+          "enum": [
+            0,
+            1,
+            2
+          ]
+        },
+        "cs_status": {
+          "type": "integer",
+          "enum": [
+            1,
+            2,
+            3
+          ]
+        },
+        "delivery_status": {
+          "type": "integer",
+          "enum": [
+            1,
+            2
+          ]
+        },
+        "refund_mode": {
+          "type": "integer",
+          "enum": [
+            0,
+            1,
+            2
+          ]
+        },
+        "return_stock_status": {
+          "type": "integer",
+          "enum": [
+            0,
+            10,
+            20
+          ]
+        },
+        "sale_way": {
+          "type": "integer",
+          "enum": [
+            1,
+            2
+          ]
+        },
+        "pay_type": {
+          "type": "integer",
+          "enum": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8
+          ]
+        },
+        "create_time_start": {
+          "type": "integer",
+          "minimum": -62135625600,
+          "maximum": 253402271999,
+          "description": "创建开始，整数秒，与结束成对。"
+        },
+        "create_time_end": {
+          "type": "integer",
+          "minimum": -62135625600,
+          "maximum": 253402271999,
+          "description": "创建结束，整数秒。"
+        },
+        "update_time_start": {
+          "type": "integer",
+          "minimum": -62135625600,
+          "maximum": 253402271999,
+          "description": "更新开始，整数秒，须有更新结束及创建时间对。"
+        },
+        "update_time_end": {
+          "type": "integer",
+          "minimum": -62135625600,
+          "maximum": 253402271999,
+          "description": "更新结束，整数秒。"
+        }
+      },
+      "dependencies": {
+        "create_time_start": [
+          "create_time_end"
+        ],
+        "create_time_end": [
+          "create_time_start"
+        ],
+        "update_time_start": [
+          "update_time_end",
+          "create_time_start"
+        ],
+        "update_time_end": [
+          "update_time_start",
+          "create_time_start"
+        ]
+      }
+    },
+    "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": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
+        }
+      }
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.trade.refund.search/3.0.1"
+  },
+  "success": {
+    "description": "同店核验及业务成功后返回本页data；预览返回requests。"
+  },
+  "notes": [
+    "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
+    "仅店铺位置可执行，目标店铺省略时使用当前上下文，显式非法值不回退；目标须与当前店铺及凭证核验一致。上下文不是授权证明，应用token不证明员工权限。缺上下文时只允许显式合法店铺的本地预览。",
+    "输入拒绝未知选项、多余参数、重复单值选项、空串及非规范数字。没有旧参数别名，没有include，没有自动翻页。",
+    "可选输出缺失时省略，显式null或错型失败；不从筛选值填充当前诉求、退款模式或其他未返回字段。单页重复售后、缺数组及矛盾total失败。",
+    "至多2次请求，累计响应10MiB，最终输出5MiB；流读取取消超限，不输出部分结果，不自动重试、换店或切身份。",
+    "错误时stdout为空，stderr一份JSON，退出非零。解析错误可能没有details，进入业务执行的错误必须有details。",
+    "列表不提供精确售后商品行、资金流水、库存确认或财务对账，不承诺全集、无遗漏、排序或分页快照。"
+  ],
+  "errors": {
+    "description": "失败 stdout 为空，stderr 为一条安全错误；本地输入问题提供字段诊断，不自动重试、切店或换身份。",
+    "diagnosticsVersion": 2
+  }
+}