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

package/src/commands/native/order/order/get/command.js

@@ -10,7 +10,7 @@ const { readContext } = require('../../../../../identity/context');
 const { queryDefinition, validateCommandValue } = require('../../../../../execution/command-schema');
 const { object } = require('../../../../../execution/query-api');
 const { discloseFields, validReason } = require('../../../../../execution/privacy');
-const { bindingPath, targetScope, createOrderQuery, reject, serialize } = require('../../shared/query');
+const { bindingPreview, targetScope, createOrderQuery, reject, serialize } = require('../../shared/query');
 const projection = require('../../shared/projection');
 const schema = require('./schema.json');
 
@@ -43,9 +43,9 @@ function normalizedInput(options, target) {
   return input;
 }
 
-function preview(input) {
+function preview(input, context) {
   const result = { requests: [
-    { method: 'POST', path: bindingPath, body: {} },
+    ...bindingPreview(input.scope, context),
     { method: 'POST', path: schema.api.path, body: { tid: input.scope.orderNo } }
   ] };
   if (input.decrypt) result.privacy = {
@@ -96,12 +96,14 @@ function createCommand({ context, privacyProvider } = {}) {
     .option('--reason <text>', '仅解密时必填：1 至 200 个 Unicode 码点，无控制字符或换行，不含个人信息')
     .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进')
       .choices(['json', 'pretty']).default('json'))
-    .option('--dry-run', '纯本地校验和两步计划，不读凭证、不联网')
+    .option('--dry-run', '纯本地校验和条件请求计划，不读凭证、不联网')
     .addHelpText('after', `
 固定返回 data.order、items、payment，include 只能追加模块，不能移除基础视图。
 订单号通常为 E/V/C 开头加 23 位数字，仅供核对；不按该格式拒绝输入或响应，不改写订单号。
-先用同一凭证核验店铺，再以 tid 读详情，最多两请求；核对订单号、node 店铺及已返回的 root 店铺。
-非总部目标须等于 context.shopId，总部也不跨凭证店铺；执行需要有效四字段上下文。
+省略 --kdt-id 只查 context.shopId，总部默认只查总部本身，不含分店。非总部目标须等于 context.shopId。
+总部普通读取可显式指定同连锁门店或网店，先核实总部sid及角色、下级目录成员，再绑定分店sid；已返回的总部字段须一致。查询不保存位置。
+同店最多两请求；总部显式分店含总部1次、目录每页50条最多20页、分店绑定1次、详情1次，共最多23次，均计入累计响应预算。
+目录读完未命中与预算内未读完分别拒绝；接口拒绝、字段异常与归属冲突保留实际阶段。不初始化分店应用，不重试；执行需要有效四字段上下文。
 ID 输出十进制字符串，交易行 oid 不是商品 ID。元金额仅无损补齐两位，不再除以 100。
 payment 是整单应付，realPayment 是实付，不扣退款或推导到账；按用户确认默认以 CNY 计价。
 基础 order 可返回支付时间 paidAt 和支付标记 isPaid；缺失不推断，零实付不等于未支付。
@@ -123,7 +125,10 @@ payment 是整单应付，realPayment 是实付，不扣退款或推导到账；
     .action(async options => {
       const state = readContext(context);
       const input = buildInput(options, context);
-      const plan = preview(input);
+      if (input.decrypt && state.status === 'ready' && input.scope.kdtId !== state.context.shopId) {
+        throw reject(command, 'permission', 'sensitive-authorization', input.scope);
+      }
+      const plan = preview(input, state.context);
       let output = plan;
       if (!input.dryRun) {
         if (input.decrypt) {
@@ -142,8 +147,8 @@ payment 是整单应付，realPayment 是实付，不扣退款或推导到账；
           });
           output = disclosedOutput(result, input, state.context, sourceFacts);
         } else {
-          const read = await createOrderQuery(input.scope, command, { shopApp: false });
-          const request = plan.requests[1];
+          const read = await createOrderQuery(input.scope, command, { shopApp: false, context: state.context });
+          const request = plan.requests.at(-1);
           const { data, facts } = await read(request.path, request.body);
           output = adapt(data, input, state.context, facts);
         }

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

@@ -179,61 +179,112 @@
         "description": "仅显式解密时出现。只列字段和调用上限，不含用途、凭证或密文，不表示权限已通过。"
       },
       "requests": {
-        "type": "array",
-        "minItems": 2,
-        "maxItems": 2,
-        "additionalItems": false,
-        "items": [
+        "description": "同店保留原计划；总部显式分店先核实总部、在其目录中有界核实成员、绑定分店，再读订单。目录项展示第一页模板，最多20页，不表示已核实。",
+        "anyOf": [
           {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "method": {
-                "const": "POST"
-              },
-              "path": {
-                "const": "youzan.shop.basic.get/3.0.0"
+            "type": "array",
+            "minItems": 2,
+            "maxItems": 2,
+            "additionalItems": false,
+            "items": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "method": {
+                    "const": "POST"
+                  },
+                  "path": {
+                    "const": "youzan.shop.basic.get/3.0.0"
+                  },
+                  "body": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {},
+                    "required": []
+                  }
+                },
+                "required": [
+                  "method",
+                  "path",
+                  "body"
+                ]
               },
-              "body": {
+              {
                 "type": "object",
                 "additionalProperties": false,
-                "properties": {},
-                "required": []
+                "properties": {
+                  "method": {
+                    "const": "POST"
+                  },
+                  "path": {
+                    "const": "youzan.trade.get/4.0.2"
+                  },
+                  "body": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "tid": {
+                        "$ref": "#/definitions/orderNo"
+                      }
+                    },
+                    "required": [
+                      "tid"
+                    ]
+                  }
+                },
+                "required": [
+                  "method",
+                  "path",
+                  "body"
+                ]
               }
-            },
-            "required": [
-              "method",
-              "path",
-              "body"
             ]
           },
           {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "method": {
-                "const": "POST"
+            "type": "array",
+            "minItems": 4,
+            "maxItems": 4,
+            "additionalItems": false,
+            "items": [
+              {
+                "$ref": "#/definitions/headquartersBindingRequest"
               },
-              "path": {
-                "const": "youzan.trade.get/4.0.2"
+              {
+                "$ref": "#/definitions/membershipRequest"
+              },
+              {
+                "$ref": "#/definitions/targetBindingRequest"
               },
-              "body": {
+              {
                 "type": "object",
                 "additionalProperties": false,
                 "properties": {
-                  "tid": {
-                    "$ref": "#/definitions/orderNo"
+                  "method": {
+                    "const": "POST"
+                  },
+                  "path": {
+                    "const": "youzan.trade.get/4.0.2"
+                  },
+                  "body": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "tid": {
+                        "$ref": "#/definitions/orderNo"
+                      }
+                    },
+                    "required": [
+                      "tid"
+                    ]
                   }
                 },
                 "required": [
-                  "tid"
+                  "method",
+                  "path",
+                  "body"
                 ]
               }
-            },
-            "required": [
-              "method",
-              "path",
-              "body"
             ]
           }
         ]
@@ -308,7 +359,9 @@
               "ciphertext-verification",
               "decryption",
               "sensitive-audit",
-              "output-model"
+              "output-model",
+              "headquarters-binding",
+              "target-membership"
             ]
           },
           "command": {
@@ -1075,6 +1128,106 @@
           "description": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
         }
       }
+    },
+    "headquartersBindingRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.basic.get/3.0.0"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {},
+          "required": []
+        },
+        "stage": {
+          "const": "headquarters-binding"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId"
+      ]
+    },
+    "targetBindingRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.basic.get/3.0.0"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {},
+          "required": []
+        },
+        "stage": {
+          "const": "shop-binding"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId"
+      ]
+    },
+    "membershipRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.chain.descendent.organization.list/1.0.1"
+        },
+        "body": {
+          "const": {
+            "page_num": 1,
+            "page_size": 50,
+            "with_dept_info": false,
+            "with_shop_status_and_lifecycle_end_time": false,
+            "with_crm_shop": false
+          }
+        },
+        "stage": {
+          "const": "target-membership"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        },
+        "maxPages": {
+          "const": 20
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId",
+        "maxPages"
+      ]
     }
   },
   "modules": {
@@ -1153,8 +1306,8 @@
   "notes": [
     "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
     "订单号通常为 E/V/C 开头加 23 位数字，仅供核对，不限定前缀、数字组合或 24 位长度；按原值传递。仅保留非空、无空白或控制字符和最多 128 字符的文本保护；服务端仍判断支持范围和对象归属。",
-    "必须提供 --order-no；--kdt-id 省略时使用当前上下文店铺，显式非法值不回退；非总部目标须等于 context.shopId；总部也限定 当前调用所绑定的目标店铺，at:all 不表示跨店读取。",
-    "输出 ID 是字符串；只有请求适配在安全范围转为 number。include 仅投影，普通读取所有组合最多两请求，无关联详情、跨店或重试。显式 decrypt 时最多四次有赞业务请求，禁用 1106 自动初始化及重发。",
+    "必须提供 --order-no；--kdt-id 省略时使用当前上下文店铺，显式非法值不回退；非总部目标须等于 context.shopId；总部普通读取支持经本次目录核验的同连锁显式分店目标，不保存位置；at:all 不免除核验。",
+    "输出 ID 是字符串；只有请求适配在安全范围转为 number。include 仅投影，同店普通读取最多两请求，无关联详情或重试；总部显式分店增加有界成员前置。显式 decrypt 时最多四次有赞业务请求，禁用 1106 自动初始化及重发。",
     "累计业务响应 10MiB、最终序列化 UTF-8 输出含换行 5MiB，超限整体失败；不承诺全链路恒定内存。",
     "默认不主动解密。decrypt 仅收货姓名、联系方式和详细地址，必须 include address 并提供 reason。打星值不能恢复；字段缺失、空值或平台未确认为密文均整体拒绝。所有选定字段和可靠审计完成后才原位输出；失败 stdout 为空。",
     "当前安装版尚未接通可信员工字段授权、来源绑定和可靠审计服务，实际解密拒绝，不能以应用 token、订单读取成功或本地上下文代替；普通读取与离线预览不受影响。",
@@ -1162,6 +1315,9 @@
     "本地上下文与查询成功不替代服务端业务授权或权限隔离验证。",
     "本批默认以 CNY 计价，金额保留两位小数字符串，不新增币种字段或换汇；该默认不用于确认上游逐订单币种或跨币种结算事实。",
     "商品行 item_id/sku_id 为OneID，channel_item_id/channel_sku_id 为历史渠道身份；oid仍为交易行，不用当前档案重写历史。",
-    "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。"
+    "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。",
+    "省略 --kdt-id 只查 context.shopId，总部默认仅总部本身，不包含分店。总部显式分店目标先核验总部角色及sid，再查下级组织目录，最后绑定分店sid；已返回的总部字段必须一致。查询不保存位置，不扩大解密权限。",
+    "成员核验每页50条、最多20页。目录完整未命中为permission，未读完为scope_unresolved，字段异常为protocol；接口拒绝保留阶段与安全诊断。空订单也不能绕过前置。新增请求共享累计响应预算，同店请求保持兼容。",
+    "总部显式分店最多23次业务请求，含总部1次、目录最多20次、分店绑定1次、订单1次；前置失败不发订单，不初始化分店应用，不重试。"
   ]
 }

package/src/commands/native/order/order/list/command.js

@@ -10,7 +10,7 @@ const { readContext } = require('../../../../../identity/context');
 const { parseDateTime } = require('../../../../../execution/datetime');
 const { parseDateTimeRange } = require('../../../../../execution/range');
 const { queryDefinition, validateCommandValue } = require('../../../../../execution/command-schema');
-const { bindingPath, targetScope, reject, serialize } = require('../../shared/query');
+const { bindingPreview, targetScope, reject, serialize } = require('../../shared/query');
 const { toRequestBody, toPreviewBody, adaptPage: adapt, createOrderPageReader } = require('../../shared/search');
 const schema = require('./schema.json');
 
@@ -156,9 +156,9 @@ function normalizedInput(options, target) {
   return input;
 }
 
-function preview(input) {
+function preview(input, context) {
   const result = { requests: [
-    { method: 'POST', path: bindingPath, body: {} },
+    ...bindingPreview(input.scope, context),
     { method: 'POST', path: listPath, body: toPreviewBody(input) }
   ] };
   validateCommandValue(schema, 'preview', result);
@@ -195,11 +195,14 @@ function createCommand({ context } = {}) {
     .option('--page-size <n>', '每页条数，1 至 100', '20')
     .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进')
       .choices(['json', 'pretty']).default('json'))
-    .option('--dry-run', '纯本地两步计划，收货电话、姓名及关键词全部遮盖为 ***；不读凭证、不联网')
+    .option('--dry-run', '纯本地条件计划，收货电话、姓名及关键词全部遮盖为 ***；不读凭证、不联网')
     .addHelpText('after', `
 商品行 item_id/sku_id 是OneID，channel_item_id/channel_sku_id 为历史渠道身份。
 --item-id沿用统一商品筛选，不把上游goods_id机械视为旧item_id，不增加渠道映射查询。
-店铺省略 --kdt-id 时使用当前上下文店铺；显式传入时必须与当前店铺范围一致。至少提供一个明确筛选条件；一次只读取一页，最多一次列表请求，默认第1页20条，页码和每页条数上限100。
+省略 --kdt-id 只查 context.shopId，总部默认只查总部本身，不含分店；非总部不可跨店。
+总部可显式指定同连锁门店或网店，先核实总部、目录成员、分店sid及已返回的总部字段，不保存新位置。
+同店核验及列表共两请求；总部显式分店目录每页50条最多20页，总请求最多23次，均计入累计响应预算，不初始化分店应用或重试。
+至少提供一个明确筛选条件；一次只读取一页，最多一次列表请求，默认第1页20条，页码和每页条数上限100。只查数量时第1页、每页1条且不追加模块，以可靠pagination.total计数，缺失不补零。
 订单号通常为 E/V/C 开头加 23 位数字，仅供核对；不按该格式拒绝筛选值或返回订单，不改写订单号。
 基础每行固定返回 order，include 可追加 items、payment、buyer、address、remark、source、aftersale、fulfillment。
 order 默认含可取得的 paidAt/isPaid，不需 include payment；缺失不表示未支付，不从状态或金额推算。
@@ -214,7 +217,7 @@ order 默认含可取得的 paidAt/isPaid，不需 include payment；缺失不
     .action(async options => {
       const state = readContext(context);
       const input = buildInput(options, context);
-      const plan = preview(input);
+      const plan = preview(input, state.context);
       let output = plan;
       if (!input.dryRun) {
         const readPage = await createOrderPageReader(input.scope, state.context, command);

package/src/commands/native/order/order/list/schema.json

@@ -225,19 +225,44 @@
   },
   "preview": {
     "type": "object",
-    "description": "纯本地两步请求计划；receiver_phone、receiver_name、keywords 若存在均替换为 ***。不读取凭证、不联网，不修改规范化输入或实际请求筛选。",
+    "description": "纯本地条件请求计划；receiver_phone、receiver_name、keywords 若存在均替换为 ***。不读取凭证、不联网，不修改规范化输入或实际请求筛选。",
     "additionalProperties": false,
     "properties": {
       "requests": {
-        "type": "array",
-        "minItems": 2,
-        "maxItems": 2,
-        "items": [
+        "description": "同店保留原计划；总部显式分店先核实总部、在其目录中有界核实成员、绑定分店，再读订单。目录项展示第一页模板，最多20页，不表示已核实。",
+        "anyOf": [
           {
-            "$ref": "#/definitions/bindingRequest"
+            "type": "array",
+            "minItems": 2,
+            "maxItems": 2,
+            "items": [
+              {
+                "$ref": "#/definitions/bindingRequest"
+              },
+              {
+                "$ref": "#/definitions/listRequest"
+              }
+            ]
           },
           {
-            "$ref": "#/definitions/listRequest"
+            "type": "array",
+            "minItems": 4,
+            "maxItems": 4,
+            "additionalItems": false,
+            "items": [
+              {
+                "$ref": "#/definitions/headquartersBindingRequest"
+              },
+              {
+                "$ref": "#/definitions/membershipRequest"
+              },
+              {
+                "$ref": "#/definitions/targetBindingRequest"
+              },
+              {
+                "$ref": "#/definitions/listRequest"
+              }
+            ]
           }
         ]
       }
@@ -306,7 +331,9 @@
               "order",
               "orders",
               "scan",
-              "output-model"
+              "output-model",
+              "headquarters-binding",
+              "target-membership"
             ]
           },
           "command": {
@@ -1278,6 +1305,106 @@
           "description": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
         }
       }
+    },
+    "headquartersBindingRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.basic.get/3.0.0"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {},
+          "required": []
+        },
+        "stage": {
+          "const": "headquarters-binding"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId"
+      ]
+    },
+    "targetBindingRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.basic.get/3.0.0"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {},
+          "required": []
+        },
+        "stage": {
+          "const": "shop-binding"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId"
+      ]
+    },
+    "membershipRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.shop.chain.descendent.organization.list/1.0.1"
+        },
+        "body": {
+          "const": {
+            "page_num": 1,
+            "page_size": 50,
+            "with_dept_info": false,
+            "with_shop_status_and_lifecycle_end_time": false,
+            "with_crm_shop": false
+          }
+        },
+        "stage": {
+          "const": "target-membership"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        },
+        "maxPages": {
+          "const": 20
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body",
+        "stage",
+        "kdtId",
+        "maxPages"
+      ]
     }
   },
   "modules": {
@@ -1350,7 +1477,7 @@
   "notes": [
     "基础 order 可返回 paidAt、isPaid。paidAt 未取得、空文本或 null 时省略，不证明未支付；非空错型、非法日期或非零毫秒失败。isPaid 未取得时省略，false 原样保留，非 boolean 失败；两者不从状态或金额推算。",
     "订单号通常为 E/V/C 开头加 23 位数字，仅供核对，不限定前缀、数字组合或 24 位长度；按原值传递。仅保留非空、无空白或控制字符和最多 128 字符的文本保护；服务端仍判断支持范围和对象归属。",
-    "省略 --kdt-id 时使用当前上下文店铺；显式目标须满足当前店铺范围约束。至少一个明确筛选；include仅投影，最多一次店铺核验加一次列表请求。不自动重试、翻页、换身份或逐单详情补齐。",
+    "省略 --kdt-id 时使用当前上下文店铺；显式目标须满足当前店铺范围约束。至少一个明确筛选；include仅投影，同店一次核验加一次列表请求。不自动重试、翻页、换身份或逐单详情补齐。",
     "本批默认以 CNY 计价，源为元的金额无损补齐两位十进制字符串，不新增币种字段、不换汇或跨币种汇总；这是用户确认的批次约定，不是官方币种保证。",
     "payment保留列表应付/支付价格含义，不提供详情realPayment、优惠或独立退款集合。",
     "累计响应10MiB、最终UTF-8输出含换行5MiB，超限整体失败；非流式内存保证。",
@@ -1358,6 +1485,9 @@
     "应用凭证实测不证明店铺员工身份授权与权限隔离。",
     "商品行 item_id/sku_id 为OneID，channel_item_id/channel_sku_id 为历史渠道身份；oid仍为交易行，不用当前档案重写历史。",
     "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。",
-    "时间区间必须包含 .. 并显式两端；不接受旧成对参数或裸时间等值，非零毫秒在请求前拒绝。"
+    "时间区间必须包含 .. 并显式两端；不接受旧成对参数或裸时间等值，非零毫秒在请求前拒绝。",
+    "省略 --kdt-id 只查 context.shopId，总部默认仅总部本身，不包含分店。总部显式分店目标先核验总部角色及sid，再查下级组织目录，最后绑定分店sid；已返回的总部字段必须一致。查询不保存位置，不扩大解密权限。",
+    "成员核验每页50条、最多20页。目录完整未命中为permission，未读完为scope_unresolved，字段异常为protocol；接口拒绝保留阶段与安全诊断。空订单也不能绕过前置。新增请求共享累计响应预算，同店请求保持兼容。",
+    "总部显式分店最多23次业务请求，含总部1次、目录最多20次、分店绑定1次、订单1次；前置失败不发订单，不初始化分店应用，不重试。"
   ]
 }

package/src/commands/native/order/order/scan/command.js

@@ -10,7 +10,7 @@ const { readContext } = require('../../../../../identity/context');
 const { parseDateTime } = require('../../../../../execution/datetime');
 const { parseDateTimeRange } = require('../../../../../execution/range');
 const { queryDefinition, validateCommandValue } = require('../../../../../execution/command-schema');
-const { bindingPath, targetScope, reject, serialize } = require('../../shared/query');
+const { bindingPreview, targetScope, reject, serialize } = require('../../shared/query');
 const { listPath, toPreviewBody, filterOptions } = require('../../shared/search');
 const { scan, initialRanges, pageInput, addCalendarMonths } = require('./scan');
 const schema = require('./schema.json');
@@ -76,10 +76,10 @@ function normalizedInput(options, scope) {
   return input;
 }
 
-function preview(input) {
+function preview(input, context) {
   const ranges = initialRanges(input.range);
   const output = {
-    requests: [{ method: 'POST', path: bindingPath, body: {} }],
+    requests: bindingPreview(input.scope, context),
     initialRanges: ranges.map(({ start, end }) => ({ start, end })),
     requestTemplate: { method: 'POST', path: listPath, body: toPreviewBody(pageInput(input, ranges[0])) },
     limits: { ...input.limits, pageSize: Math.min(100, input.limits.maxItems) }
@@ -109,11 +109,14 @@ function createCommand({ context } = {}) {
     .option('--keyword <text>', '订单号、收货人手机或后四位搜索')
     .option('--include <modules>', `追加模块：${includeModules.join(', ')}；仅投影，不增加请求`)
     .option('--max-items <n>', '去重结果上限，1至10000，不裁切整页', '1000')
-    .option('--max-requests <n>', '总请求预算，2至500，含店铺核验、探测和翻页', '100')
+    .option('--max-requests <n>', '总请求预算，2至500，含总部/目录/分店核验、探测和翻页', '100')
     .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进').choices(['json', 'pretty']).default('json'))
     .option('--dry-run', '纯本地预览，收货电话、姓名及关键词全部遮盖为 ***；不读凭证、不联网')
     .addHelpText('after', `
 商品行 item_id/sku_id 是OneID，channel_item_id/channel_sku_id 为历史渠道身份。
+省略 --kdt-id 只查 context.shopId，总部默认仅总部本身，不含分店；非总部不可跨店。
+总部可显式指定同连锁门店或网店，先核实总部、目录成员及分店sid，已返回的总部字段须一致，查询不保存位置。
+目录每页50条最多20页，全部前置共享maxRequests与累计响应预算，每次发送前检查；前置未完成即耗尽预算时失败，不输出未核实订单。不初始化分店应用或重试。
 --item-id沿用统一商品筛选，不把上游goods_id机械视为旧item_id，不增加渠道映射查询。
 示例：zan-saas order order scan --kdt-id 63077 --created-at "2026-10-01 00:00:00..2026-10-02 00:00:00" --max-requests 2 --dry-run
 创建时间或支付时间必须二选一，用 .. 分隔且包含两端，开始早于结束；结束不晚于当前时刻，跨度最多一日历年，非零毫秒拒绝。
@@ -134,7 +137,7 @@ range_exhausted 只表示本次观测的范围走完，不保证端点开闭、
     .action(async options => {
       const state = readContext(context);
       const input = buildInput(options, context);
-      const plan = preview(input);
+      const plan = preview(input, state.context);
       const output = input.dryRun ? plan : await scan(input, state.context);
       if (!input.dryRun) {
         try { validateCommandValue(schema, 'output', output); }

package/src/commands/native/order/order/scan/scan.js

@@ -43,7 +43,7 @@ async function scan(input, context, readerFactory = createOrderPageReader) {
   let requests = 0;
   let halt;
   const read = await readerFactory(input.scope, context, 'order.order.scan', {
-    responseLimit: 20 * 1024 * 1024, bounded: true,
+    responseLimit: 20 * 1024 * 1024, bounded: true, maxRequests,
     onRequest: () => { requests++; }
   });
   while (true) {