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

package/src/commands/native/valuecard/transaction/scan/schema.json

@@ -0,0 +1,954 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "kdtId",
+      "bizType",
+      "occurredAt",
+      "filters",
+      "pageNo",
+      "pageSize",
+      "format",
+      "dryRun"
+    ],
+    "properties": {
+      "kdtId": {
+        "$ref": "#/definitions/shopId"
+      },
+      "bizType": {
+        "$ref": "#/definitions/bizType"
+      },
+      "occurredAt": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "start",
+          "end"
+        ],
+        "properties": {
+          "start": {
+            "$ref": "#/definitions/time"
+          },
+          "end": {
+            "$ref": "#/definitions/time"
+          }
+        },
+        "description": "显式业务时间范围，开始严格早于结束，零毫秒规范化为三位，不支持非零毫秒。"
+      },
+      "filters": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "mobile": {
+            "type": "string",
+            "pattern": "^\\+?[0-9]{5,20}$",
+            "description": "流水中的完整手机号，可选 + 和 5..20 位数字，保留前导零及国家码；不等于 yzOpenId。"
+          },
+          "billCardNo": {
+            "$ref": "#/definitions/identifier",
+            "description": "流水记载卡号，不等于 card.cardNo。"
+          },
+          "transactionNo": {
+            "$ref": "#/definitions/identifier",
+            "description": "储值业务流水号，不承诺全局唯一。"
+          },
+          "tradeNo": {
+            "$ref": "#/definitions/identifier",
+            "description": "有赞交易单号，不是外部支付请求号，不限定 E 前缀。"
+          }
+        },
+        "description": "至少一个精确匹配条件，多条件为 AND，仅匹配流水原始字符串，不推断历史身份。",
+        "minProperties": 1
+      },
+      "pageNo": {
+        "$ref": "#/definitions/pageNo"
+      },
+      "pageSize": {
+        "$ref": "#/definitions/pageSize"
+      },
+      "format": {
+        "type": "string",
+        "enum": [
+          "json",
+          "pretty"
+        ],
+        "description": "只改变 JSON 缩进。"
+      },
+      "dryRun": {
+        "type": "boolean",
+        "description": "本地脱敏预览，不读取凭证或联网。"
+      }
+    },
+    "description": "CLI 解析及上下文补全后的规范化业务输入，不是 argv 或服务端请求体；固定内部预算不属于 input。"
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "data"
+    ],
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "transactions",
+          "pagination"
+        ],
+        "properties": {
+          "transactions": {
+            "type": "array",
+            "maxItems": 200,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "transactionNo",
+                "billCardNo",
+                "occurredAt",
+                "bizType",
+                "validity",
+                "amount",
+                "reportedBalance"
+              ],
+              "properties": {
+                "transactionNo": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "原始储值流水号，保留前导零，不承诺全局唯一。"
+                },
+                "billCardNo": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "流水记录卡号，不自动关联到当前系统资产卡号。"
+                },
+                "occurredAt": {
+                  "$ref": "#/definitions/time",
+                  "description": "流水业务时间，北京时间固定毫秒文本。"
+                },
+                "bizType": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "保留原始非空字符串。已知代码 RECHARGE 充值、GROUP_GIVE_RECHARGE 赠送、REFUND 退款、RECHARGE_REFUND 充值退款、PAY 消费或支付、ADJUSTMENT 调账、CARD_BALANCE_IMPORT 导入、RECEDE_CARD 退卡、GIFT_CARD_ACTIVE 激活或礼品卡激活、RECHARGE_BONUS 充值赠送、REFUND_CLOSE_TRANSFER 退款销卡转出或转入、COMBINE 卡换绑转出或转入。也可能返回中文原值，未知非空字符串保留，不用请求类型覆盖。"
+                },
+                "validity": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "原始记录有效性，JSON string \"0\" 或 \"无效\" 为无效，\"1\" 或 \"有效\" 为有效；未知非空字符串保留，不自动转数字或推断处理状态。"
+                },
+                "amount": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "totalAmount",
+                    "principalAmount",
+                    "bonusAmount"
+                  ],
+                  "properties": {
+                    "totalAmount": {
+                      "$ref": "#/definitions/money",
+                      "description": "本次业务总金额，CNY 元两位字符串，保留源符号。"
+                    },
+                    "principalAmount": {
+                      "$ref": "#/definitions/money",
+                      "description": "本次业务本金金额，CNY 元两位字符串。"
+                    },
+                    "bonusAmount": {
+                      "$ref": "#/definitions/money",
+                      "description": "本次业务赠送金金额，CNY 元两位字符串。"
+                    }
+                  },
+                  "description": "本次业务金额，不等于统一余额增量，不依据业务类型改变符号，不强制分项加总。"
+                },
+                "reportedBalance": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "totalBalance",
+                    "principalBalance",
+                    "bonusBalance"
+                  ],
+                  "properties": {
+                    "totalBalance": {
+                      "$ref": "#/definitions/money",
+                      "description": "附带总余额，CNY 元两位字符串。"
+                    },
+                    "principalBalance": {
+                      "$ref": "#/definitions/money",
+                      "description": "附带本金余额，CNY 元两位字符串。"
+                    },
+                    "bonusBalance": {
+                      "$ref": "#/definitions/money",
+                      "description": "附带赠送金余额，CNY 元两位字符串。"
+                    }
+                  },
+                  "description": "记录附带的余额，时点未明确，不能推算交易前后余额；总额等于本金加赠送金。"
+                },
+                "kdtId": {
+                  "type": "string",
+                  "pattern": "^[1-9][0-9]*$",
+                  "description": "可选记录所属店铺 ID，正安全整数精确转文本，不推断为受理店铺 ID。"
+                },
+                "mobile": {
+                  "type": "string",
+                  "description": "可选流水手机号，使用 mobile 筛选时必需且非空；不保证明文或稳定客户关联。"
+                },
+                "tradeNo": {
+                  "type": "string",
+                  "description": "可选有赞交易单号，使用 tradeNo 筛选时必需且非空；不限定 E 前缀。"
+                },
+                "externalRequestNo": {
+                  "type": "string",
+                  "description": "可选外部储值支付请求传入的 pay_request_no，不当成交易单号。"
+                },
+                "remark": {
+                  "type": "string",
+                  "description": "可选业务备注，原值保留。"
+                },
+                "externalRemark": {
+                  "type": "string",
+                  "description": "可选外部储值支付请求备注，原值保留。"
+                },
+                "nickname": {
+                  "type": "string",
+                  "description": "可选用户昵称，不用于身份关联。"
+                },
+                "acceptShopName": {
+                  "type": "string",
+                  "description": "可选受理店铺名称，不替代店铺或机构 ID。"
+                }
+              },
+              "description": "已经满足全部本地条件的单条流水；保留重复项、无效记录及未知字典值，不代表完整历史。"
+            },
+            "description": "本地 AND 精确匹配的完整记录，服务端取得顺序不变，无去重，不返回同页其它记录。"
+          },
+          "pagination": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "startPageNo",
+              "pageSize",
+              "scannedPages",
+              "scannedRecords",
+              "returned",
+              "requestCount",
+              "hasMore",
+              "nextPageNo",
+              "traversalCompleted",
+              "stopReason"
+            ],
+            "properties": {
+              "startPageNo": {
+                "$ref": "#/definitions/pageNo"
+              },
+              "pageSize": {
+                "$ref": "#/definitions/pageSize"
+              },
+              "scannedPages": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 20,
+                "description": "本轮完整检查并接纳的页数。"
+              },
+              "scannedRecords": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 1000,
+                "description": "本轮检查并接纳的原始流水条数，包含不匹配记录。"
+              },
+              "returned": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 200,
+                "description": "transactions 长度，不超过固定 200 条。"
+              },
+              "requestCount": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 21,
+                "description": "业务 API 请求次数，包括一次店铺绑定及未接纳的漂移页；不含认证准备。"
+              },
+              "hasMore": {
+                "type": [
+                  "boolean",
+                  "null"
+                ],
+                "description": "最后接纳页之后服务端原始查询是否有后页，不指还有匹配记录；未知或漂移为 null。"
+              },
+              "nextPageNo": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "minimum": 1,
+                "maximum": 5000,
+                "description": "未完成且窗口内可继续时的下一完整页；漂移指向未接纳页；耗尽、窗口满、总数未知为 null。"
+              },
+              "traversalCompleted": {
+                "type": "boolean",
+                "description": "仅表示指定起始页之后已走完本次可观察范围，不代表全历史、稳定身份或完整账本。"
+              },
+              "stopReason": {
+                "type": "string",
+                "enum": [
+                  "pages_exhausted",
+                  "max_items",
+                  "max_requests",
+                  "window_limit",
+                  "total_unknown",
+                  "inconsistent_page"
+                ],
+                "description": "pages_exhausted 可靠总数确认耗尽；max_items 200 条预算无法容纳最坏整页；max_requests 达 21 次；window_limit 达页容量乘积 5000；total_unknown 缺可靠总数；inconsistent_page 跨页总数漂移，未接纳该页。仅 pages_exhausted 表示完成。"
+              }
+            },
+            "description": "只描述本次起始页之后的观察，不提供匹配 total；筛选空集不代表无历史。"
+          }
+        },
+        "description": "有界精确匹配结果及扫描停止状态。"
+      }
+    },
+    "description": "成功时只返回 data，不回显筛选、时间或凭证。"
+  },
+  "preview": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "command",
+      "kind",
+      "risk",
+      "target",
+      "requests",
+      "localFilters",
+      "limits"
+    ],
+    "properties": {
+      "command": {
+        "const": "valuecard.transaction.scan",
+        "description": "命令点路径。"
+      },
+      "kind": {
+        "const": "atomic",
+        "description": "固定原子查询职责。"
+      },
+      "risk": {
+        "const": "read",
+        "description": "只读操作。"
+      },
+      "target": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kdtId"
+        ],
+        "properties": {
+          "kdtId": {
+            "$ref": "#/definitions/shopId"
+          }
+        },
+        "description": "固定目标店铺。"
+      },
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "method",
+            "path",
+            "body"
+          ],
+          "properties": {
+            "method": {
+              "const": "POST",
+              "description": "只读接口使用 POST。"
+            },
+            "path": {
+              "type": "string",
+              "description": "绑定或首个流水页的接口路径。"
+            },
+            "body": {
+              "type": "object",
+              "description": "绑定为空对象；流水页仅包含 biz_type、begin_time、end_time、page、page_size，无本地筛选。",
+              "additionalProperties": false,
+              "properties": {
+                "biz_type": {
+                  "type": "string",
+                  "description": "单一业务类型的大写代码。"
+                },
+                "begin_time": {
+                  "type": "string",
+                  "description": "北京时间开始秒文本。"
+                },
+                "end_time": {
+                  "type": "string",
+                  "description": "北京时间结束秒文本。"
+                },
+                "page": {
+                  "$ref": "#/definitions/pageNo"
+                },
+                "page_size": {
+                  "$ref": "#/definitions/pageSize"
+                }
+              }
+            }
+          },
+          "description": "预览中的首批只读请求，不预造依赖响应的后续页。"
+        },
+        "description": "一次绑定与首个流水页请求。"
+      },
+      "localFilters": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "mobile": {
+            "const": "***",
+            "description": "已提供条件的遮盖值。"
+          },
+          "billCardNo": {
+            "const": "***",
+            "description": "已提供条件的遮盖值。"
+          },
+          "transactionNo": {
+            "const": "***",
+            "description": "已提供条件的遮盖值。"
+          },
+          "tradeNo": {
+            "const": "***",
+            "description": "已提供条件的遮盖值。"
+          }
+        },
+        "description": "仅包含实际提供的条件名称，全部值遮盖为 ***。"
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "maxItems",
+          "maxRequests",
+          "pageSize"
+        ],
+        "properties": {
+          "maxItems": {
+            "const": 200,
+            "description": "固定最多 200 条匹配记录，按整页预留。"
+          },
+          "maxRequests": {
+            "const": 21,
+            "description": "固定最多 21 次业务请求，包含一次绑定。"
+          },
+          "pageSize": {
+            "$ref": "#/definitions/pageSize"
+          }
+        },
+        "description": "固定内部执行计划摘要，不属于规范化 input，也不能通过选项调参。"
+      }
+    },
+    "description": "零认证零请求的脱敏执行计划；只展示绑定及首个流水页。"
+  },
+  "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": [
+              "validation",
+              "configuration",
+              "parameter",
+              "permission",
+              "authentication",
+              "scope_unresolved",
+              "transport",
+              "http",
+              "protocol",
+              "business_rejected",
+              "not_found",
+              "limit"
+            ]
+          },
+          "stage": {
+            "type": "string",
+            "minLength": 1
+          },
+          "command": {
+            "const": "valuecard.transaction.scan"
+          },
+          "targetScope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "kdtId": {
+                "$ref": "#/definitions/shopId"
+              }
+            }
+          },
+          "requestState": {
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ]
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1
+          },
+          "api": {
+            "type": "string",
+            "minLength": 1
+          },
+          "httpStatus": {
+            "type": "integer",
+            "minimum": 100,
+            "maximum": 599
+          },
+          "businessCode": {
+            "$ref": "#/definitions/code"
+          },
+          "gatewayCode": {
+            "$ref": "#/definitions/code"
+          },
+          "trace_id": {
+            "$ref": "#/definitions/trace"
+          },
+          "request_id": {
+            "$ref": "#/definitions/trace"
+          },
+          "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
+    },
+    "code": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "string",
+          "pattern": "^-?[0-9]{1,12}$"
+        }
+      ]
+    },
+    "trace": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_-]{1,128}$"
+    },
+    "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": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
+        }
+      }
+    },
+    "bizType": {
+      "type": "string",
+      "enum": [
+        "recharge",
+        "group_give_recharge",
+        "refund",
+        "recharge_refund",
+        "pay",
+        "card_account_adjustment_add",
+        "card_account_adjustment_subtract",
+        "card_balance_import_add",
+        "card_balance_import_subtract",
+        "recede_card",
+        "gift_card_active",
+        "recharge_bonus",
+        "refund_close_transfer_in",
+        "refund_close_transfer_out",
+        "combine_in",
+        "combine_out"
+      ],
+      "description": "recharge 充值；group_give_recharge 赠送；refund 退款；recharge_refund 充值退款；pay 消费；card_account_adjustment_add 调账增加；card_account_adjustment_subtract 调账减少；card_balance_import_add 导入增加；card_balance_import_subtract 导入减少；recede_card 退卡；gift_card_active 激活；recharge_bonus 充值赠送；refund_close_transfer_in 退款销卡转入；refund_close_transfer_out 退款销卡转出；combine_in 卡换绑转入；combine_out 卡换绑转出。单次只选一种，不支持 all 或 CSV。"
+    },
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f](?:[^\\u0000-\\u001f\\u007f-\\u009f]*[^\\s\\u0000-\\u001f\\u007f-\\u009f])?$",
+      "description": "完整原始标识，最长 200 字符，不含首尾空白或控制字符，保留前导零和大小写。"
+    },
+    "pageNo": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5000,
+      "description": "本轮起始页码；与 pageSize 的乘积不大于 5000，不证明前页已经核实。"
+    },
+    "pageSize": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "description": "单个服务端页的固定容量；同次扫描不改变。"
+    },
+    "time": {
+      "type": "string",
+      "format": "beijing-date-time-ms",
+      "description": "北京时间 YYYY-MM-DD HH:mm:ss.SSS，固定三位毫秒。"
+    },
+    "money": {
+      "type": "string",
+      "pattern": "^-?(?:0|[1-9][0-9]*)\\.[0-9]{2}$",
+      "description": "默认 CNY 人民币元，固定两位，保留源符号，范围 ±90071992547409.91，不执行换汇。"
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.cardvoucher.giftcard.bill.query/3.0.0"
+  },
+  "notes": [
+    "四个本地条件至少一个，多条件为 AND，保留前导零、大小写及国家码；不会发送客户、卡号或交易单号作为服务端筛选。手机号不是 yzOpenId，流水卡号不等于 card.cardNo。",
+    "固定最多 200 条匹配记录、21 次业务请求，包含一次同凭证店铺绑定；固定串行，不自动重试、二分、后台执行、换身份或切店。不提供 --max-items、--max-requests，input 不含 limits。",
+    "每次读取前为最坏完整页预留匹配容量，返回可能少于 200 条，不截断半页。可靠末页耗尽优先于预算；否则依次检查漂移、总数未知、窗口、匹配条数及请求预算。",
+    "未完成且 nextPageNo 非空时，保持同店铺、类型、时间、筛选和 pageSize，以 --page-no 继续；不是稳定断点，可能重复或遗漏。窗口满需缩小时间范围；总数漂移建议缩小范围从第一页重查。",
+    "空页、短页或匹配数组为空均不单独证明耗尽或无历史。只用可靠总数确认耗尽，不提供匹配 total、不汇总资产，不承诺稳定降序、快照或完整历史。",
+    "金额为 CNY 元两位字符串，六个金额保留源符号；reportedBalance 时点未明确，不推算交易前后余额，不按类型猜增减，不进行自动对账。",
+    "所有记录先验证核心模型和当前筛选字段再匹配，缺匹配字段不得视为不匹配；必需字符串非空且无控制字符。可选文本省略则省略、空串原样保留、null 或错型失败；未知附加字段不透传。",
+    "单响应最多 10 MiB，累计业务响应最多 20 MiB，最终 UTF-8 输出含换行最多 5 MiB；超限或后页业务、网络、模型错误整体失败，不输出前页结果。",
+    "真实调用需要有效四字段上下文及同店凭证；at: all 不证明员工 OAuth、所有产品或跨机构权限。预览所有条件值遮盖，不读取凭证、不联网。",
+    "新储值商家支持全部卡交易查询，老储值商家仅支持礼品卡流水；不把当前查询范围扩大为所有资产或全历史。"
+  ],
+  "success": {
+    "description": "绑定及全部已执行请求成功，整页模型有效，输出已观察的精确匹配记录及六种停止原因之一；预算、漂移或未知总数不伪装完成。"
+  },
+  "errors": {
+    "description": "失败 stdout 为空，stderr 为脱敏错误 JSON，退出非零；保持原店铺和条件核查，时间或大窗口错误应缩小范围，不自动重试。",
+    "diagnosticsVersion": 2
+  }
+}