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

package/src/commands/native/item/item/scan/schema.json

@@ -0,0 +1,1046 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "kdtId",
+      "channel",
+      "maxItems",
+      "maxRequests",
+      "createdAt"
+    ],
+    "properties": {
+      "kdtId": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 9007199254740991,
+        "description": "目标店铺 ID。"
+      },
+      "channel": {
+        "type": "integer",
+        "minimum": -9007199254740991,
+        "maximum": 9007199254740991,
+        "description": "渠道，0 网店、1 门店。",
+        "enum": [
+          0,
+          1
+        ]
+      },
+      "classificationIds": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "商品分类 ID 列表，最多 20 项。"
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "商品分类 ID 列表，最多 20 项。"
+      },
+      "item_ids": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "指定商品 ID 列表，最多 20 项。"
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "新版商品 ID 集合，同一商品在分店和渠道间保持相同；不是渠道商品 ID。接收 --item-ids 的 CSV、空白分隔或 JSON 数组文本，规范化后为去重的正安全整数数组，最多20项。"
+      },
+      "groupIds": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "一级商品分组 ID 列表，最多 20 项。"
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "一级商品分组 ID 列表，最多 20 项。"
+      },
+      "secondGroupIds": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "二级商品分组 ID 列表，最多 20 项。"
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "二级商品分组 ID 列表，最多 20 项。"
+      },
+      "notExcludeAbilityCodes": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 2147483647,
+          "description": "不排除的能力标编码，10033 使套餐商品可被搜索，不表示只查询套餐。"
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "不排除的能力标编码，10033 使套餐商品可被搜索，不表示只查询套餐。"
+      },
+      "isDisplays": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "上下架筛选，0 仓库中、1 出售中及已售罄；省略时查询两种状态。",
+          "enum": [
+            0,
+            1
+          ]
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "上下架筛选，0 仓库中、1 出售中及已售罄；省略时查询两种状态。"
+      },
+      "soldStatusList": {
+        "type": "array",
+        "items": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "销售状态筛选：0 非有赞平台出售商品，1 全部在售，2 全部售罄，3 部分售罄；须结合 isDisplays 判断，不能单独推断在售。",
+          "enum": [
+            0,
+            1,
+            2,
+            3
+          ]
+        },
+        "minItems": 1,
+        "maxItems": 20,
+        "description": "销售状态筛选：0 非有赞平台出售商品，1 全部在售，2 全部售罄，3 部分售罄；须结合 isDisplays 判断，不能单独推断在售。"
+      },
+      "keyword": {
+        "type": "string",
+        "description": "商品标题、商品或 SKU 编码和条码关键词，标题支持模糊匹配。"
+      },
+      "itemType": {
+        "type": "string",
+        "description": "规范化的 17 位发布码；CLI 文案对应关系：实物商品 00000000000000000，蛋糕烘焙 01000000000100000，生鲜果蔬 01000000004204200，海淘商品 01000000004304300，虚拟商品 00000000000000002，电子卡券 00000000000000003，付费优惠券 01000000005100002，酒店商品 00000000003503500，付费会员卡或权益卡 00000000002002002，服务商品 10000000000000002。其他合法 17 位码原样使用，但拒绝 10000000000000003 和 10000000000000004；合法编码不表示当前店铺支持。",
+        "pattern": "^\\d{17}$"
+      },
+      "maxItems": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 50000,
+        "description": "去重结果预算，1 至 50000；超限整体失败"
+      },
+      "maxRequests": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 2000,
+        "description": "搜索与分片探测请求预算，1 至 2000；不含后续 H5 角色及组织查询，预算不足整体失败，不返回部分商品。"
+      },
+      "createdAt": {
+        "type": "object",
+        "additionalProperties": false,
+        "minProperties": 1,
+        "properties": {
+          "start": {
+            "type": "string",
+            "format": "beijing-date-time-ms",
+            "description": "窗口起点，北京时间 YYYY-MM-DD HH:mm:ss.SSS，省略时不补值。"
+          },
+          "end": {
+            "type": "string",
+            "format": "beijing-date-time-ms",
+            "description": "窗口终点，北京时间 YYYY-MM-DD HH:mm:ss.SSS，省略时不补值。"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "description": "--created-at \"START..END\" 解析后的创建时间闭区间；北京时间、毫秒精度，不早于 Unix 起点。必须显式两端且开始早于结束，不补零或当前时间。"
+      },
+      "updatedAt": {
+        "type": "object",
+        "additionalProperties": false,
+        "minProperties": 1,
+        "properties": {
+          "start": {
+            "type": "string",
+            "format": "beijing-date-time-ms",
+            "description": "窗口起点，北京时间 YYYY-MM-DD HH:mm:ss.SSS，省略时不补值。"
+          },
+          "end": {
+            "type": "string",
+            "format": "beijing-date-time-ms",
+            "description": "窗口终点，北京时间 YYYY-MM-DD HH:mm:ss.SSS，省略时不补值。"
+          }
+        },
+        "description": "--updated-at \"START..END\" 解析后的更新时间闭区间；北京时间、毫秒精度，不早于 Unix 起点，可省略一端，两端齐备允许相等。"
+      }
+    },
+    "description": "CLI 解析参数并完成必要上下文补全后的业务输入；不是直接传入 CLI 的 JSON。原始选项、必填条件和默认值见 options。"
+  },
+  "output": {
+    "type": "object",
+    "required": [
+      "data"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "required": [
+          "items",
+          "scope"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "type": "array",
+            "maxItems": 50000,
+            "items": {
+              "$ref": "#/definitions/item"
+            }
+          },
+          "scope": {
+            "$ref": "#/definitions/scope",
+            "description": "本次实际查询的店铺和渠道；只代表该渠道内符合本次筛选的商品，各渠道可能重叠，不能将数量相加作为全店去重商品数。"
+          }
+        }
+      }
+    }
+  },
+  "preview": {
+    "type": "object",
+    "required": [
+      "requests",
+      "conditionalRequests",
+      "mode",
+      "limits",
+      "strategy"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "requests": {
+        "type": "array",
+        "items": {
+          "$ref": "#/definitions/request"
+        }
+      },
+      "conditionalRequests": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "condition",
+            "request",
+            "maxRequests"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "type": "string"
+            },
+            "request": {
+              "$ref": "#/definitions/request"
+            },
+            "maxRequests": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100
+            }
+          }
+        }
+      },
+      "mode": {
+        "const": "scan"
+      },
+      "limits": {
+        "$ref": "#/definitions/limits"
+      },
+      "strategy": {
+        "type": "string"
+      }
+    }
+  },
+  "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",
+              "transport",
+              "authentication",
+              "permission",
+              "http",
+              "protocol",
+              "business_rejected",
+              "not_found",
+              "scope_unresolved",
+              "pagination_stalled",
+              "budget_exceeded",
+              "missing_alias",
+              "pagination_limit"
+            ]
+          },
+          "stage": {
+            "type": "string",
+            "minLength": 1
+          },
+          "command": {
+            "const": "item.item.scan"
+          },
+          "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": [
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              {
+                "type": "string",
+                "pattern": "^-?\\d{1,12}$"
+              }
+            ]
+          },
+          "gatewayCode": {
+            "oneOf": [
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              {
+                "type": "string",
+                "pattern": "^-?\\d{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。"
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "出错的搜索请求页码；issues 中 /data/items/N 的 N 是该请求页内从 0 开始的记录索引，不是扫描累计索引。"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "scope": {
+      "type": "object",
+      "required": [
+        "kdtId",
+        "channel"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "kdtId": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "本次实际查询的店铺 ID。"
+        },
+        "channel": {
+          "type": "integer",
+          "enum": [
+            0,
+            1
+          ],
+          "description": "销售渠道：0 网店，1 门店。同一商品可在两个渠道出现。"
+        }
+      }
+    },
+    "limits": {
+      "type": "object",
+      "required": [
+        "maxItems",
+        "maxRequests",
+        "maxResponseBytes",
+        "maxOutputBytes"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "maxItems": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 50000
+        },
+        "maxRequests": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2000
+        },
+        "maxResponseBytes": {
+          "const": 10485760
+        },
+        "maxOutputBytes": {
+          "const": 5242880
+        }
+      }
+    },
+    "item": {
+      "type": "object",
+      "properties": {
+        "kdt_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "店铺在有赞的id标识，有赞平台生成，在有赞平台唯一，用于判断信息属于哪一个店铺"
+        },
+        "item_id": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991,
+          "description": "统一商品 ID（OneID），同一商品在各分店和渠道使用相同值；与目标店铺和渠道一起定位，不接受渠道商品 ID 替代。"
+        },
+        "channel_item_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "渠道商品 ID，标识目标分店和渠道下的商品，对应旧商品接口的 item_id；数值可能与统一商品 ID 相同，不能据此互换。未返回时省略，不用 item_id 补齐；有值时须符合本字段整数约束。"
+        },
+        "root_kdt_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "有赞连锁总部店铺id，仅供有赞连锁场景下使用。有赞平台生成，在有赞平台唯一，用于判断信息属于哪一个总部"
+        },
+        "item_type": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "商品类型。0实物商品，1虚拟商品、2服务商品"
+        },
+        "publish_code": {
+          "type": "string",
+          "description": "商品发布类型。对应商品发布页面的商品类型。值：00000000000000000(实物商品)、01000000000100000(蛋糕烘焙)、01000000004204200(生鲜果蔬)、01000000004304300(海淘商品)、00000000000000002(虚拟商品)、00000000000000003(电子卡券)、01000000005100002(付费优惠券)、00000000003503500(酒店商品)。"
+        },
+        "title": {
+          "type": "string",
+          "description": "商品名称"
+        },
+        "share_description": {
+          "type": "string",
+          "description": "分享描述"
+        },
+        "sell_point": {
+          "type": "string",
+          "description": "商品卖点"
+        },
+        "alias": {
+          "type": "string",
+          "description": "商品别名"
+        },
+        "display": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "上下架状态。0-下架、1-上架、8-不可售。"
+        },
+        "start_sold_time": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "$comment": "upstream-time:seconds",
+          "description": "开售时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。"
+        },
+        "sold_status": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "发售状态：1发售中，2已售罄，3部分售罄"
+        },
+        "delete": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "是否已删除。0否，1是"
+        },
+        "item_code": {
+          "type": "string",
+          "description": "商品编码"
+        },
+        "item_barcode": {
+          "type": "string",
+          "description": "商品条码"
+        },
+        "channel": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "渠道：0网店，1门店"
+        },
+        "leaf_category_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "类目ID"
+        },
+        "classification_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "分类ID"
+        },
+        "brand_id": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "品牌ID"
+        },
+        "origin_price": {
+          "type": "string",
+          "description": "划线价，单位：元 输出固定两位小数字符串；空字符串保持空字符串。",
+          "$comment": "upstream-money:yuan",
+          "pattern": "^(?:|-?(?:0|[1-9]\\d*)\\.\\d{2})$"
+        },
+        "media": {
+          "type": "object",
+          "properties": {
+            "images": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "image_id": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "图片ID"
+                  },
+                  "width": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "宽度"
+                  },
+                  "height": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "高度"
+                  },
+                  "url": {
+                    "type": "string",
+                    "description": "图片url"
+                  }
+                },
+                "additionalProperties": true
+              },
+              "description": "商品主图"
+            },
+            "main_video_id": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991,
+              "description": "主视频ID"
+            },
+            "explain_video_id": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991,
+              "description": "讲解视频ID"
+            }
+          },
+          "additionalProperties": true,
+          "description": "商品媒体包含主图、主图视频、视频讲解"
+        },
+        "message_settings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "datetime": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991,
+                "description": "是否含日期。0 否 1是。目前只有Type=time 会设置。"
+              },
+              "multiple": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991,
+                "description": "是否多选。0-否、1-是。"
+              },
+              "name": {
+                "type": "string",
+                "description": "留言名称。不能多于10个字。"
+              },
+              "required": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991,
+                "description": "是否必填。0-否、1-是。"
+              },
+              "type": {
+                "type": "string",
+                "description": "留言数据类型。值：text(文本格式)、tel(数字格式)、email(邮箱格式)、date(日期格式)、id_no(身份证号格式)、image(图片格式)、mobile(手机号格式)、time(时间格式)。"
+              }
+            },
+            "additionalProperties": true
+          },
+          "description": "留言信息"
+        },
+        "join_member_discount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "是否参与会员折扣。值：0-否、1-是。"
+        },
+        "created_time": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "$comment": "upstream-time:milliseconds",
+          "description": "创建时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。"
+        },
+        "update_time": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "$comment": "upstream-time:milliseconds",
+          "description": "更新时间；北京时间 YYYY-MM-DD HH:mm:ss.SSS。"
+        },
+        "price": {
+          "type": "string",
+          "description": "商品最小价，单位：元 输出固定两位小数字符串。",
+          "$comment": "upstream-money:fen",
+          "pattern": "^-?(?:0|[1-9]\\d*)\\.\\d{2}$"
+        },
+        "h5_url": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "CLI 默认提供的买家H5；根据已确认角色/渠道规则生成，已确认不适用时为null。搜索接口字段定义本身不包含此字段。"
+        }
+      },
+      "additionalProperties": true,
+      "required": [
+        "item_id",
+        "h5_url"
+      ]
+    },
+    "request": {
+      "type": "object",
+      "required": [
+        "method",
+        "path",
+        "body"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "type": "string"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "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.item.base.search/1.0.0"
+  },
+  "success": {
+    "description": "全部必要分页及 H5 成功，去重结果满足模型、预算及遍历停止条件后整体输出为 data.items；不保证快照全集。"
+  },
+  "errors": {
+    "description": "失败 stdout 为空，stderr 为一份脱敏错误 JSON，退出码非零；不返回部分成功，不自动重试、切换身份或目标。按 error 模型及安全下一步处理。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "固定每页 50 条，按创建时间和 ID 降序串行读取并按商品 ID 去重；必须用 --created-at 显式提供完整创建窗口，开始严格早于结束，不补零或当前时间。",
+    "达到 5000 条窗口时按创建时间拆分；max-items 默认 1000、最多 50000，max-requests 默认 100、最多 2000，只包含搜索与探测请求，不含后续 H5 角色及组织查询。预算不足整体失败。",
+    "列表可用逗号、空白分隔或 JSON 数组编码，最多 20 项并去重；商品类型可用已支持文案或 17 位发布码。",
+    "创建和更新时间分别使用 --created-at/--updated-at \"START..END\"；必须包含 ..，省略边界不补值；不接受旧成对参数或时间 JSON。",
+    "时间按北京时间文本输入，可带 1 至 3 位毫秒，不接受时间戳、T 或时区后缀；预览请求中的时间为毫秒整数。",
+    "默认补适用 H5，不返回库存数量，不提供 group/content 扩展；已定义金额为元固定两位字符串，不得再次除以 100。",
+    "搜索数据累计最多 10 MiB、完整输出最多 5 MiB；超预算或无进展整体失败，不输出部分商品。成功返回 data.items 与本次 data.scope，不提供续游标或快照保证。",
+    "不支持 search_after 和 NUM/UPDATE_TIME/SCORE 排序；服务商品发布码仅为历史兼容，未在真实样本验收。",
+    "本地 --dry-run 不读取凭证、不联网；预览只证明构造计划，不证明对象存在或权限有效。真实执行仍需有效上下文及目标范围授权，at 声明不替代服务端授权。",
+    "本命令已定义金额的币种默认人民币（CNY）；字段、结果或明确父对象上下文声明其他币种时按该声明处理，不执行换汇。",
+    "商品标识采用新版口径：item_id/sku_id 跨分店和渠道统一，channel_item_id/channel_sku_id 对应目标店铺渠道的旧标识。商品查询使用统一商品 ID 和渠道，不接受旧渠道 ID 替代，不因标识数值相等而互换。",
+    "商品记录或字段不符合模型时整体失败，不跳过记录；issues 指出字段和页内索引，pageNo 指出搜索请求页码，不包含原始商品字段值。"
+  ]
+}