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

package/internal/registry/manifest.json

@@ -30,7 +30,7 @@
       "indexFile": "benefit/commands.index.json",
       "commandCount": 5,
       "indexSize": 1584,
-      "indexSha256": "a528ed46344e3f751e45e492e4be4e95df229516df381cd1eae2352048d7248e"
+      "indexSha256": "fef946b05d691ffdc0e016c4def2c922d29b8f8000e199a4a1a39e80f6c5c50c"
     },
     {
       "name": "coupon",
@@ -157,7 +157,7 @@
     {
       "name": "zan-saas",
       "type": "entry",
-      "description": "有赞 SaaS CLI 入口。用户希望通过 zan-saas 查询商家业务数据或执行当前版本提供的操作时使用；按已发行领域选择指引，再用 help 和 schema 核实命令。",
+      "description": "有赞 SaaS 产品的命令行工具入口。用户需要查询有赞店铺的商品、订单、客户、会员、营销、库存等业务数据，或执行当前版本支持的店铺操作时使用。具体能力与适用范围以当前安装版指引为准。",
       "dependsOn": [
         "zan-saas-shared"
       ],
@@ -165,7 +165,7 @@
         "SKILL.md",
         "references/host-entry.md"
       ],
-      "fingerprint": "501e06cc8c97bd9a2352fed7779e7609f97266a8c4b1b29dd25ec9a6e93668cf"
+      "fingerprint": "6fd2bb9b078420651fc470a57b64a7a64e16e565ee5ca5f29445348a5a342031"
     },
     {
       "name": "zan-saas-shared",

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@youzan-cloud/zan-saas-cli",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@youzan-cloud/zan-saas-cli",
-      "version": "0.1.0-beta.3",
+      "version": "0.1.0-beta.4",
       "license": "MIT",
       "dependencies": {
         "ajv": "8.20.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youzan-cloud/zan-saas-cli",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "description": "Youzan SaaS CLI preview",
   "license": "MIT",
   "engines": {

package/skills/zan-saas/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: zan-saas
-description: 有赞 SaaS CLI 入口。用户希望通过 zan-saas 查询商家业务数据或执行当前版本提供的操作时使用；按已发行领域选择指引，再用 help 和 schema 核实命令。
+description: 有赞 SaaS 产品的命令行工具入口。用户需要查询有赞店铺的商品、订单、客户、会员、营销、库存等业务数据，或执行当前版本支持的店铺操作时使用。具体能力与适用范围以当前安装版指引为准。
 ---
 
-# zan-saas 入口
+# 有赞 SaaS CLI 入口
 
 ## 人机交接
 

package/skills/zan-saas/references/host-entry.md

@@ -7,10 +7,10 @@
 ```markdown
 ---
 name: zan-saas
-description: 用户希望通过 zan-saas 查询商家业务或使用当前版本提供的操作时使用。读取当前安装 CLI 的指引，再按领域 help 和 schema 继续。
+description: 有赞 SaaS 产品的命令行工具入口。用户需要查询有赞店铺的商品、订单、客户、会员、营销、库存等业务数据，或执行当前版本支持的店铺操作时使用。具体能力与适用范围以当前安装版指引为准。
 ---
 
-# zan-saas
+# 有赞 SaaS CLI
 
 开始时运行 `zan-saas --version` 和 `zan-saas skills read zan-saas`。
 使用 CLI 返回的同版正文，再按其中的共享规则与领域指引继续。

package/src/commands/native/benefit/card-definition/list/command.js

@@ -64,14 +64,15 @@ function createCommand({ context } = {}) {
       .choices(['json', 'pretty']).default('json'))
     .option('--dry-run', '本地预览店铺核验和单页查询，不读凭证、不联网')
     .addHelpText('after', `
-total 只描述本次筛选的接口总数，不保证跨页快照；按 nextPageNo 继续并保留店铺、筛选和容量。
+total 只描述本次筛选的接口总数，不保证跨页快照；按 nextPageNo 继续并保留店铺和筛选。
 nextPageNo=null 不能单独解释为结束；windowLimitReached=true 表示达到页码上限，仍有后续。
 时间点统一输出北京时间 YYYY-MM-DD HH:mm:ss.SSS，字段声明的业务哨兵保留。
-输出 data.cards 和 data.pagination（含 total、nextPageNo、windowLimitReached），容量使用实际响应，不自动翻页或重试。
+输出 data.cards 和 data.pagination（含 total、nextPageNo、windowLimitReached），不自动翻页或重试。
+分页仅支持 --page-no；页容量由服务端决定，不支持 --page-size。
 仅查询商家卡定义，不表示客户持卡、发卡资格或详情权益；不按名称、类型或状态过滤。
 hasMore 表示是否还有下一页；空页或短页不表示耗尽，不承诺跨页快照。
 服务端最多允许 100 页；第 100 页仍有 hasMore=true 时不能继续遍历，不请求第 101 页。
-不提供 --name、--page-size 或 scan；最多一次店铺核验与一次业务请求。
+不提供 --name 或 scan；最多一次店铺核验与一次业务请求。
 真实执行需有效四字段上下文和同店授权凭证；店铺核验不证明员工 OAuth。
 支持微商城单店、零售单店、有赞连锁 D 总部/网店/合伙人，不承诺教育多校区总部。
 契约：zan-saas schema benefit.card-definition.list

package/src/commands/native/benefit/card-definition/list/schema.json

@@ -680,7 +680,7 @@
     "diagnosticsVersion": 2
   },
   "notes": [
-    "每次只查询一页权益卡定义，默认第 1 页，最大第 100 页；保留返回顺序和禁用卡。",
+    "每次只查询一页权益卡定义，默认第 1 页，最大第 100 页；页容量由服务端决定，不支持 --page-size。保留返回顺序和禁用卡。",
     "pageSize 为本次实际页容量，returned 为本次卡定义条数；不按空页或短页判断结束。第 100 页仍有更多时不能继续第 101 页，也不能宣称全量。",
     "可选字段缺失保持省略，已选字段 null 或错型失败；保留空字符串和 false。",
     "支持微商城单店、零售单店、连锁 D 总部、网店及合伙人，不承诺跨页快照。",

package/src/commands/native/benefit/commands.index.json

@@ -18,7 +18,7 @@
       "availability": "available",
       "at": "all",
       "module": "benefit/card-definition/list/command.js",
-      "fingerprint": "7ae054562f154e27f37ac58a06c547cde7ee3457c7382a1d3086d93e7976f4cd"
+      "fingerprint": "6e1e404d0773b8360796d76c850f5913b0db5cf17556625bccb3bc1a90a4ef48"
     },
     {
       "path": "benefit.card-grant.list",
@@ -45,7 +45,7 @@
       "availability": "available",
       "at": "all",
       "module": "benefit/customer-card/list/command.js",
-      "fingerprint": "a2db429e8c0c2d46e8f74db4d1a8a6e862670cb5340038ac8946769d26c12b1e"
+      "fingerprint": "99950d67fbfed296117eb6ad44be1fb6bae4875128847757ebd958c38a570189"
     }
   ]
 }

package/src/commands/native/benefit/customer-card/list/command.js

@@ -66,6 +66,7 @@ function createCommand({ context } = {}) {
     .addHelpText('after', `
 当前接口未提供可靠的匹配总数，因此省略 total，hasMore 为 null、nextPageNo 为 null，不自动续页。
 返回 data.customerCards 和 data.pagination；returned 为本次客户持卡条数。
+分页仅支持 --page-no；页容量由服务端决定，不支持 --page-size。
 cardNo 是完整字符串实例号；cardAlias 仅关联定义，不按定义合并持卡。
 保留源 cardState；时间点统一为北京时间 YYYY-MM-DD HH:mm:ss.SSS，包括 9999 年永久哨兵。
 空页不证明耗尽；all 不保证删除历史完整或跨页快照。

package/src/commands/native/benefit/customer-card/list/schema.json

@@ -721,7 +721,7 @@
     "diagnosticsVersion": 2
   },
   "notes": [
-    "固定一个店铺和客户，每次读取一页持卡实例，默认第 1 页；页内卡号唯一，容量取本次结果。",
+    "固定一个店铺和客户，每次读取一页持卡实例，默认第 1 页；页内卡号唯一，页容量由服务端决定，不支持 --page-size。",
     "--status available 查询可用卡，all 查询返回范围内所有状态；all 不保证已删除历史完整或跨页快照。",
     "只返回模型中的五个实例字段，不返回客户资料，不按日期推算状态；缺必需字段、null 或错型整体失败。",
     "支持微商城单店、零售单店、连锁 D 总部、网店及合伙人。",