@optima-chat/tiktok-cli 0.15.0 → 0.16.0

package/README.md

@@ -21,11 +21,12 @@ tiktok <domain> <verb> --shop <shopId> [--flags]
 | `auth link` | 生成店铺绑定授权链接（无需 --shop） |
 | `shops` | 查当前登录用户已授权店铺 |
 | `orders list` | 订单列表（`--status --page-size --since`） |
-| `orders get --id <id>` | 订单详情 |
+| `orders get --id <id>[,<id>]` | 订单详情（多个用英文逗号连） |
 | `analytics shop` | 店铺经营数据（`--from --to`，默认近30天） |
 | `analytics products` | 商品维度数据（GMV 降序）。`--version` 默认 `202509`；`202605` 返回 `total_performance` + 分渠道 `*_performance` 组（**组是可选的、字段名三套变体、`overall_performance` 在新版不存在**，见 spec §3.0）；未知版本本地拒，平台出新版可 `--force-version` 直接试；`--page-token` 翻页，**末页 `next_page_token` 为空串**（不是缺席） |
 | `products list` | 商品列表 |
 | `promotions list` | 促销活动。`--status` **省略 = 全部状态**（`ONGOING`/`NOT_START`/`EXPIRED`/`DEACTIVATED`；⚠️ 值写错平台**静默忽略并返回全部**，故 CLI **本地硬拒未知值**；平台将来新增值可用 `--force-status` 越过）；`--page-size`（默认 20）；`--page-token` 翻页，**末页无 `next_page_token`** |
+| `promotions get` | 按 id 读单个促销活动（`--id`）：类型、状态、时间窗、挂的商品与每个 SKU 的活动价（一口价 / 秒杀价读 `skus[].activity_price.amount`，百分比读 `skus[].discount`）。平台没回 `products` 时补成 `[]` |
 | `finance statements` | 结算单 |
 
 ### 建品前置只读辅助（拼商品体用）
@@ -96,6 +97,8 @@ tiktok products set-price --shop <id> --product <pid> --sku <sid> --price 29.90
 | `products set-price` | 改 SKU 售价（`--product --sku --price [--currency]`）。仅 `ACTIVATE` 商品，且不在进行中的促销里（`update-price-202309` 原文）。改价不触发商品重审、立即生效（依据是 `partial-edit-product-202309` 的「`price`/`inventory` 不需 reaudit」，**本端点自己的文档没写这句、也未单独实测**）。 | ✓ 改价+回读 |
 | `products set-inventory` | 改 SKU 库存（`--product --sku --warehouse --quantity`）。只要商品不在 `FREEZE`/`DELETED` 状态都能改（`update-inventory-202309` 原文）。改库存不触发商品重审、立即生效（同上依据，未单独实测）。⚠️ `DRAFT` 商品**未实测** —— 官方只写了「非 `FREEZE`/`DELETED`」，没说 DRAFT 可以；且草稿 SKU 常常还没分仓，会撞 `12052096`。 | ✓ 49→55→49 可逆 |
 | `promotions create-flashsale` | 建秒杀（`--title --product --sku --price [--limit --per-user --hours]`）。两步:建壳+加品 | ✓ 真实建成 |
+| `promotions create-discount` | 建商品折扣活动：`--price` 一口价（`FIXED_PRICE`）或 `--percent` 减 N%（`DIRECT_DISCOUNT`；`85` = 减 85%、按原价 15% 卖，**打 85 折要传 15**），`--title [--product] [--days 180]`。两步:建壳+加品，可多商品；撞重名 / 加品失败时给可粘贴的下一步命令 | ✓ 真实建成（FP；--percent 待活体） |
+| `promotions add-products` | 往已有折扣活动加新 SKU（`--id <activityId> --price|--percent … [--product]`）。预读先于 PUT：类型 / 状态 / 已在活动里的 SKU 都会被拦下；只加不改 | — |
 | `promotions deactivate` | 终止促销活动（`--id`）。不可逆 | ✓ |
 | `products create --body-file <json>` | **生产级建品**（完整商品体 JSON）。dry-run 内嵌 `listing_check` 预检 → `--apply` 建品 → 回读高亮 warnings。⚠️ `save_mode` 默认 `LISTING`：**不写就是建完直接上架送审**（#1958，见下方「送审语义」）。可在 body 里写 `"save_mode": "AS_DRAFT"` 留草稿（**未实测**）。 | ✓ 真实上架 V.V.Love（ACTIVATE） |
 | `products add-variant --product <id> --body-file <json>` | 加规格 SKU（读现有 skus → merge → partial_edit；新 SKU 自动继承 sku_dimensions/sku_weight）。⚠️ **默认送审**（#1958，见下方「送审语义」）。本命令**自构 body**，body-file 里的 `save_mode` **不透传、写了也无效**；要留草稿只能用 `products partial-edit`。 | ✓ 真加变体成功 |

package/dist/index.js

@@ -134,8 +134,9 @@ function classify(status, body, shop) {
   if (status === 0 || body?.code === 0) {
     return { ok: true, data: body.data, meta };
   }
-  if (status === 404) return { ok: false, error: { code: "SHOP_NOT_AUTHORIZED", message: body?.error ?? "\u5E97\u94FA\u672A\u6388\u6743", retryable: false }, meta };
-  if (status === 403) return { ok: false, error: { code: "VALIDATION", message: body?.error ?? "\u8DEF\u5F84\u4E0D\u5141\u8BB8", retryable: false }, meta };
+  const isBackendEnvelope = typeof body?.code !== "number" && typeof body?.error === "string";
+  if (status === 404 && isBackendEnvelope) return { ok: false, error: { code: "SHOP_NOT_AUTHORIZED", message: body.error, retryable: false }, meta };
+  if (status === 403 && isBackendEnvelope) return { ok: false, error: { code: "VALIDATION", message: body.error, retryable: false }, meta };
   const tc = body?.code;
   const msg = body?.message ?? body?.error ?? `HTTP ${status}`;
   if (tc === 36009002 || status === 429) return { ok: false, error: { code: "RATE_LIMITED", message: msg, retryable: true, retry_after_s: 30 }, meta };
@@ -309,11 +310,12 @@ function commandUsage(cmd) {
   const flags = cmd.flags?.length ? cmd.flags.map((f) => `--${f}`).join(" ") : "\uFF08\u6CA1\u6709\u4E13\u5C5E\u53C2\u6570\uFF09";
   const shop = cmd.noShop ? "" : " --shop <shopId>";
   const globals = cmd.noShop ? "--apply" : "--shop / --apply";
+  const dry = cmd.write ? "\u672C\u547D\u4EE4\u662F\u5199\u64CD\u4F5C\uFF1A\u9ED8\u8BA4 dry-run\uFF08\u53EA\u6253\u5370\u5C06\u53D1\u7684\u8BF7\u6C42\u3001\u4E0D\u53D1\uFF09\uFF0C\u52A0 --apply \u624D\u771F\u53D1\u3002\n" : "";
   return `tiktok ${cmd.name}${shop} [--flags]
 
 ${cmd.summary}
 
-\u8BA4\u7684\u53C2\u6570\uFF1A${flags}\uFF08\u53E6\u6709\u5168\u5C40 ${globals}\uFF09\uFF1B\u4E0D\u8BA4\u7684\u4F1A\u5F53\u573A\u62A5\u9519\u3002
+${dry}\u8BA4\u7684\u53C2\u6570\uFF1A${flags}\uFF08\u53E6\u6709\u5168\u5C40 ${globals}\uFF09\uFF1B\u4E0D\u8BA4\u7684\u4F1A\u5F53\u573A\u62A5\u9519\u3002
 `;
 }
 var today = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -321,6 +323,37 @@ var daysAgo = (n) => new Date(Date.now() - n * 864e5).toISOString().slice(0, 10)
 var toEpoch = (v) => /^\d+$/.test(v) ? Number(v) : Math.floor(Date.parse(v) / 1e3);
 var PROMOTION_STATUSES = /* @__PURE__ */ new Set(["ONGOING", "NOT_START", "EXPIRED", "DEACTIVATED"]);
 var ANALYTICS_PRODUCT_VERSIONS = /* @__PURE__ */ new Set(["202509", "202605"]);
+var ADD_TEXT = {
+  SUM_ADD: "\u5F80\u5DF2\u6709\u6298\u6263\u6D3B\u52A8\u52A0\u65B0 SKU\uFF08--id <activityId> --price <skuId>:<\u4E00\u53E3\u4EF7>|<productId>/<skuId>:<\u4E00\u53E3\u4EF7>[,...] \u6216 --percent <skuId>:<\u51CFN%>[,...] [--product]\uFF09\u3002\u5148\u8BFB\u6D3B\u52A8\u6838\u5BF9\u7C7B\u578B\u4E0E\u5DF2\u6709 SKU \u518D\u52A0\u54C1\u3001\u56DE\u8BFB\uFF1B\u53EA\u52A0\u4E0D\u6539\uFF0C\u5DF2\u5728\u6D3B\u52A8\u91CC\u7684 SKU \u4F1A\u88AB\u62E6\u4E0B\u3002--percent 85 = \u51CF85%\uFF08\u625385\u6298\u8981\u4F2015\uFF09",
+  SUM_GET: "\u6309 id \u8BFB\u5355\u4E2A\u4FC3\u9500\u6D3B\u52A8\uFF08--id <activityId>\uFF09\uFF1A\u7C7B\u578B\u3001\u72B6\u6001\u3001\u65F6\u95F4\u7A97\u3001\u6302\u7684\u5546\u54C1\u4E0E\u6BCF\u4E2A SKU \u7684\u6D3B\u52A8\u4EF7\uFF08\u4E00\u53E3\u4EF7 / \u79D2\u6740\u4EF7\u8BFB skus[].activity_price.amount\uFF0C\u767E\u5206\u6BD4\u8BFB skus[].discount\uFF09",
+  HUMAN_ADD: (id, list) => `\u5F80\u6D3B\u52A8 ${id} \u52A0\uFF1A${list}\u3002\u53EA\u52A0\u65B0 SKU\uFF1B\u5DF2\u5728\u6D3B\u52A8\u91CC\u7684\u4F1A\u5728 --apply \u9884\u8BFB\u65F6\u88AB\u62E6\u4E0B\u3002`,
+  AV2: "\u672C\u547D\u4EE4\u7528 --id \u4F20\u6D3B\u52A8 id\uFF08\u6CA1\u6709 --activity-id\uFF09\uFF0C\u5982 --id 7686081985965900001",
+  AV3: (rest, flag) => `\u591A\u4F59\u7684\u4F4D\u7F6E\u53C2\u6570\u300C${rest}\u300D\u2014\u2014\u6BCF\u4E2A\u53C2\u6570\u53EA\u80FD\u5E26\u4E00\u4E2A\u503C\u3002\u591A\u4E2A SKU \u8981\u7528\u9017\u53F7\u8FDE\u6210\u4E00\u4E2A --${flag}\uFF0C\u5982 --${flag} A:12,B:15\uFF08\u4E0D\u80FD\u7528\u7A7A\u683C\u5206\u9694\uFF09`,
+  GV3: (rest) => `\u591A\u4F59\u7684\u4F4D\u7F6E\u53C2\u6570\u300C${rest}\u300D\u2014\u2014\u6BCF\u4E2A\u53C2\u6570\u53EA\u80FD\u5E26\u4E00\u4E2A\u503C\u3002`,
+  AP1: (shop, id) => `\u6CA1\u8BFB\u5230\u6D3B\u52A8 ${id}\uFF0C\u672A\u52A0\u4EFB\u4F55\u5546\u54C1\uFF1B\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u786E\u8BA4\u6D3B\u52A8\u5B58\u5728\u3002`,
+  AP1N: (id) => `\u8BFB\u53D6\u6D3B\u52A8 ${id} \u5931\u8D25\uFF08\u7F51\u7EDC / \u670D\u52A1\u7AEF\u6682\u65F6\u6027\u9519\u8BEF\uFF09\uFF0C\u672A\u5199\u4EFB\u4F55\u4E1C\u897F\uFF0C\u53EF\u4EE5\u539F\u6837\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
+  AP1M: (shop, id) => `\u9884\u8BFB\u5230\u7684\u6D3B\u52A8 ${id} \u5F62\u72B6\u5F02\u5E38\uFF08\u7F3A activity_type \u6216 products\uFF09\uFF0C\u672A\u5199\u4EFB\u4F55\u4E1C\u897F\uFF1B\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u770B\u6D3B\u52A8\u8BE6\u60C5\uFF08\u6CE8\u610F get \u4F1A\u628A\u5E73\u53F0\u6CA1\u56DE\u7684 products \u8865\u6210 []\uFF0C\u8981\u770B\u5E73\u53F0\u539F\u6837\u54CD\u5E94\u5F97\u76F4\u8FDE\uFF09\u3002`,
+  AT1: (id) => `\u6D3B\u52A8 ${id} \u662F FIXED_PRICE\uFF08\u4E00\u53E3\u4EF7\uFF09\uFF0C\u8981\u7528 --price <skuId>:<\u4E00\u53E3\u4EF7>\uFF1B--percent \u53EA\u7528\u4E8E DIRECT_DISCOUNT \u6D3B\u52A8\u3002`,
+  AT2: (id) => `\u6D3B\u52A8 ${id} \u662F DIRECT_DISCOUNT\uFF08\u767E\u5206\u6BD4\uFF09\uFF0C\u8981\u7528 --percent <skuId>:<\u51CFN%>\uFF1B--price \u53EA\u7528\u4E8E FIXED_PRICE \u6D3B\u52A8\u3002`,
+  AT3: (id) => `\u6D3B\u52A8 ${id} \u662F FLASHSALE\uFF08\u79D2\u6740\uFF09\uFF1A\u79D2\u6740\u6D3B\u52A8\u52A0\u54C1\u4E0D\u5728\u672C\u547D\u4EE4\u8303\u56F4\uFF0C\u53E6\u5EFA\u4E00\u573A\u7528 tiktok promotions create-flashsale\u3002`,
+  AT4: (id, type) => `\u6D3B\u52A8 ${id} \u7684\u7C7B\u578B\u662F ${type}\uFF0C\u672C\u547D\u4EE4\u53EA\u652F\u6301\u5F80 FIXED_PRICE / DIRECT_DISCOUNT \u6D3B\u52A8\u52A0\u54C1\u3002`,
+  AS1: (id, status, allowed) => `\u6D3B\u52A8 ${id} \u7684\u72B6\u6001\u662F ${status}\uFF0C\u53EA\u6709 ${allowed} \u7684\u6D3B\u52A8\u80FD\u7528\u672C\u547D\u4EE4\u52A0\u54C1\u3002`,
+  AL1: (id, level) => `\u6D3B\u52A8 ${id} \u7684 product_level \u662F ${level}\uFF0C\u672C\u547D\u4EE4\u53EA\u652F\u6301 VARIATION\uFF08\u6309 SKU \u5B9A\u4EF7\uFF09\u7684\u6D3B\u52A8\u3002`,
+  AD1: (id, sids) => `\u8FD9\u4E9B SKU \u5DF2\u5728\u6D3B\u52A8 ${id} \u91CC\u3001\u4F46\u503C\u4E0E\u672C\u6B21\u63D0\u4EA4\u4E0D\u540C\uFF1A${sids}\u3002\u6539\u5DF2\u5728\u6D3B\u52A8\u91CC\u7684 SKU \u7684\u4EF7 / \u6298\u6263\u4E0D\u5728\u672C\u547D\u4EE4\u8303\u56F4\uFF08\u91CD\u590D\u63D0\u4EA4\u7684\u5E73\u53F0\u884C\u4E3A\u672A\u5B9E\u6D4B\uFF09\uFF0C\u4ECD\u8D70\u6D4F\u89C8\u5668\u3002`,
+  AD1_REST: (addCmd) => `\u6CA1\u5728\u6D3B\u52A8\u91CC\u7684\u53EF\u4EE5\u8FD9\u6837\u52A0\uFF1A${addCmd}`,
+  AD2: (id, sids, addCmd) => `\u8FD9\u4E9B SKU \u5DF2\u6309\u672C\u6B21\u63D0\u4EA4\u7684\u503C\u5728\u6D3B\u52A8 ${id} \u91CC\uFF0C\u65E0\u9700\u518D\u52A0\uFF1A${sids}\u3002\u5176\u4F59\u7684\u8FD9\u6837\u52A0\uFF1A${addCmd}`,
+  AD3: (n, id) => `\u672C\u6B21\u63D0\u4EA4\u7684 ${n} \u4E2A SKU \u90FD\u5DF2\u6309\u63D0\u4EA4\u7684\u503C\u5728\u6D3B\u52A8 ${id} \u91CC\u2014\u2014\u65E0\u9700\u518D\u52A0\uFF0C\u522B\u91CD\u8DD1\u3002`,
+  AW1: (shop, id) => `\u5DF2\u63D0\u4EA4\u5230\u6D3B\u52A8 ${id}\uFF0C\u4F46\u56DE\u8BFB\u5931\u8D25\uFF0C\u672A\u80FD\u9A8C\u8BC1\u672C\u6B21\u7684 SKU \u662F\u5426\u6302\u4E0A\u2014\u2014\u4E0D\u8981\u91CD\u8DD1\u672C\u547D\u4EE4\uFF1B\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u6838\u5BF9\uFF0C\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u54EA\u4E9B SKU \u672A\u786E\u8BA4\u6302\u4E0A\u3002`,
+  AW2: (id, problems) => `\u5DF2\u63D0\u4EA4\u5230\u6D3B\u52A8 ${id}\uFF0C\u4F46\u56DE\u8BFB\u4E0E\u63D0\u4EA4\u4E0D\u4E00\u81F4\uFF1A${problems}\u2014\u2014\u4E0D\u8981\u91CD\u8DD1\u672C\u547D\u4EE4\uFF1B\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u54EA\u4E9B SKU \u672A\u786E\u8BA4\u6302\u4E0A\u3002`,
+  AW2_MISS: (addCmd) => `\u7F3A\u7684\u53EF\u4EE5\u8FD9\u6837\u8865\uFF1A${addCmd}`,
+  AW3: (shop, id, lost) => `\u26A0\uFE0F \u6D3B\u52A8 ${id} \u539F\u6709\u7684\u5546\u54C1\u5728\u56DE\u8BFB\u91CC\u5BF9\u4E0D\u4E0A\uFF1A${lost}\u2014\u2014\u52A0\u54C1\u53EF\u80FD\u8986\u76D6\u4E86\u539F\u6709\u5546\u54C1\u3002\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\uFF0C\u5E76\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u6838\u5BF9\u3002`,
+  AN1: (n, id) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u4F46\u56DE\u8BFB\u663E\u793A\u63D0\u4EA4\u7684 ${n} \u4E2A SKU \u90FD\u5DF2\u6302\u4E0A\u6D3B\u52A8 ${id}\u2014\u2014\u522B\u91CD\u8DD1\u3002`,
+  AN2: (id) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u663E\u793A\u672C\u6B21\u63D0\u4EA4\u7684 SKU \u4E00\u4E2A\u90FD\u6CA1\u6302\u4E0A\u6D3B\u52A8 ${id}\u3002\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u540E\u91CD\u8DD1\u672C\u547D\u4EE4\u5373\u53EF\uFF08\u53EA\u6709\u9650\u6D41\u3001\u7F51\u7EDC\u7C7B\u62A5\u9519\u624D\u539F\u6837\u91CD\u8DD1\uFF09\u3002`,
+  AN3: (problems) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u56DE\u8BFB\u663E\u793A\u672C\u6B21\u63D0\u4EA4\u7684\u6CA1\u6709\u5168\u90E8\u6302\u4E0A\uFF1A${problems}\u3002`,
+  AN3_MISS: (addCmd) => `\u7F3A\u7684\u8865\u4E0A\uFF1A${addCmd}\uFF08\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u540E\u518D\u8865\uFF09\u3002`,
+  AN3_MIS: "\u503C\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u503C\u751F\u6548\uFF0C\u6539\u4EF7 / \u6539\u6298\u6263\u4E0D\u5728\u672C\u547D\u4EE4\u8303\u56F4\u3002",
+  AN4: (shop, id) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u4E5F\u5931\u8D25\u4E86\uFF0C\u67E5\u4E0D\u5230\u6D3B\u52A8 ${id} \u91CC\u672C\u6B21\u7684 SKU \u6709\u6CA1\u6709\u6302\u4E0A\u3002\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u6838\u5BF9\uFF0C\u518D\u51B3\u5B9A\u662F\u5426\u91CD\u8DD1\uFF08\u5DF2\u6302\u4E0A\u7684\u4F1A\u5728\u9884\u8BFB\u90A3\u6B65\u88AB\u8BC6\u522B\uFF0C\u91CD\u8DD1\u4E0D\u4F1A\u91CD\u590D\u52A0\uFF09\u3002`
+};
 var COMMANDS = [
   {
     name: "orders list",
@@ -346,9 +379,11 @@ var COMMANDS = [
   },
   {
     name: "orders get",
-    summary: "\u8BA2\u5355\u8BE6\u60C5\uFF08--id \u5FC5\u586B\uFF09",
+    summary: "\u8BA2\u5355\u8BE6\u60C5\uFF08--id \u5FC5\u586B\uFF0C\u591A\u4E2A\u7528\u82F1\u6587\u9017\u53F7\u8FDE\uFF09",
     flags: ["id"],
-    run: ({ shop, args: args2 }) => proxy("GET", shop, "/order/202309/orders/detail", { query: { ids: args2.id } })
+    // 🔴 Get Order Detail 是 GET /order/202309/orders?ids=a,b（#42：原来写成 …/orders/detail，
+    //    平台回 36009009 Invalid path；cn-stage 测试店 2026-09-20 实打本路径 200）
+    run: ({ shop, args: args2 }) => proxy("GET", shop, "/order/202309/orders", { query: { ids: args2.id } })
   },
   // ── 售后（退货/取消）只读 ──
   {
@@ -950,20 +985,26 @@ var COMMANDS = [
   },
   {
     name: "promotions create-discount",
-    summary: "\u5EFA\u5546\u54C1\u6298\u6263\u6D3B\u52A8 FIXED_PRICE\uFF08--title [--product] --price <skuId>:<\u4E00\u53E3\u4EF7>|<productId>/<skuId>:<\u4E00\u53E3\u4EF7>[,...] [--days 180]\uFF09\u3002\u4E24\u6B65:\u5EFA\u58F3+\u52A0\u54C1\uFF0C\u53EF\u591A\u5546\u54C1",
-    flags: ["days", "price", "product", "title"],
+    summary: "\u5EFA\u5546\u54C1\u6298\u6263\u6D3B\u52A8 FIXED_PRICE\uFF08--price \u4E00\u53E3\u4EF7\uFF09\u6216 DIRECT_DISCOUNT\uFF08--percent \u51CFN%\uFF09\uFF08--title [--product] --price <skuId>:<\u4E00\u53E3\u4EF7>|<productId>/<skuId>:<\u4E00\u53E3\u4EF7>[,...] \u6216 --percent <skuId>:<\u51CFN%>|<productId>/<skuId>:<\u51CFN%>[,...] [--days 180]\uFF09\u3002--percent 85 = \u51CF85%\u3001\u6309\u539F\u4EF715%\u5356\uFF08\u625385\u6298\u8981\u4F2015\uFF09\u3002\u4E24\u6B65:\u5EFA\u58F3+\u52A0\u54C1\uFF0C\u53EF\u591A\u5546\u54C1",
+    flags: ["days", "percent", "price", "product", "title"],
     write: true,
     validate: validateCreateDiscount,
     preview: ({ args: args2 }) => {
       const { begin, end } = discountWindow(args2);
       return [
         { step: "1/2 \u5EFA\u6D3B\u52A8\u58F3", method: "POST", path: "/promotion/202309/activities", body: discountActivityBody(args2, begin, end) },
-        { step: "2/2 \u52A0\u5546\u54C1+\u4E00\u53E3\u4EF7", method: "PUT", path: "/promotion/202309/activities/{activity_id}/products", body: discountProductsBody(args2), human: discountHuman(args2) }
+        { step: discountValueFlag(args2) === "percent" ? "2/2 \u52A0\u5546\u54C1+\u51CFN%" : "2/2 \u52A0\u5546\u54C1+\u4E00\u53E3\u4EF7", method: "PUT", path: "/promotion/202309/activities/{activity_id}/products", body: discountProductsBody(args2), human: discountHuman(args2) }
       ];
     },
     run: async ({ shop, args: args2 }) => {
       const { begin, end } = discountWindow(args2);
       const submitted = submittedSkus(args2);
+      const dd = discountValueFlag(args2) === "percent";
+      const field = dd ? "discount" : "amount";
+      const flag = discountValueFlag(args2);
+      const rawVal = discountValueRaw(args2);
+      const allItems = rawVal.split(",");
+      const intent = { type: dd ? "DIRECT_DISCOUNT" : "FIXED_PRICE", flag, days: Number(args2.days ?? 180), addCmd: (aid) => addProductsCmd(shop, aid, args2.product, flag, allItems, true) };
       const created = await proxy("POST", shop, "/promotion/202309/activities", { body: discountActivityBody(args2, begin, end) });
       if (!created.ok) {
         const err = created.error;
@@ -971,7 +1012,7 @@ var COMMANDS = [
           case "maybe_landed":
             return { ...created, error: { ...err, message: `${err.message} ${DISCOUNT_TEXT.maybeLanded}` } };
           case "dup":
-            return { ...created, error: { ...err, message: `${err.message} ${await dupSelfCheck(shop, args2.title, submitted)}` } };
+            return { ...created, error: { ...err, message: `${err.message} ${await dupSelfCheck(shop, args2.title, submitted, field, intent)}` } };
           case "rejected":
             return created;
         }
@@ -993,20 +1034,21 @@ var COMMANDS = [
       if (!withProducts.ok) {
         const { retry_after_s: _dropped, ...err } = withProducts.error;
         let note;
-        const c = rb.ok ? compareReadback(submitted, rb.data) : null;
+        const c = rb.ok ? compareReadback(submitted, rb.data, field) : null;
         if (!c) note = DISCOUNT_TEXT.addFailReadbackFailed(shop, activityId);
         else {
-          if (c.missing.length === 0 && c.mismatched.length === 0) note = DISCOUNT_TEXT.addFailAllAttached(submitted.length, activityId);
-          else if (c.missing.length === submitted.length && c.productCount === 0) note = DISCOUNT_TEXT.addFailNoneAttached(shop, activityId);
-          else note = DISCOUNT_TEXT.addFailPartial(problemsText(c), shop, activityId);
+          if (c.missing.length === 0 && c.mismatched.length === 0) note = DISCOUNT_TEXT.addFailAllAttached(submitted.length, activityId, dd);
+          else if (c.missing.length === submitted.length && c.productCount === 0) note = DISCOUNT_TEXT.addFailNoneAttached(shop, activityId, addProductsCmd(shop, activityId, args2.product, flag, allItems, false));
+          else if (c.missing.length === 0) note = DISCOUNT_TEXT.addFailPartialMismatch(problemsText(c, field), shop, activityId, dd);
+          else note = DISCOUNT_TEXT.addFailPartial(problemsText(c, field), shop, activityId, addProductsCmd(shop, activityId, args2.product, flag, rawItemsFor(rawVal, c.missing), false), dd);
         }
         return { ok: false, error: { ...err, retryable: false }, data: { activity_id: activityId, readback, note }, meta: withProducts.meta };
       }
       const ours = [];
-      const diff = rb.ok ? compareReadback(submitted, rb.data) : null;
-      if (!diff) ours.push(DISCOUNT_TEXT.readbackFailed(activityId));
+      const diff = rb.ok ? compareReadback(submitted, rb.data, field) : null;
+      if (!diff) ours.push(DISCOUNT_TEXT.readbackFailed(shop, activityId));
       else {
-        const problems = problemsText(diff);
+        const problems = problemsText(diff, field);
         if (problems) ours.push(DISCOUNT_TEXT.readbackDiffers(activityId, problems));
       }
       const putData = withProducts.data ?? {};
@@ -1015,6 +1057,25 @@ var COMMANDS = [
       return { ok: true, data, meta: withProducts.meta };
     }
   },
+  {
+    name: "promotions add-products",
+    summary: ADD_TEXT.SUM_ADD,
+    flags: ["id", "percent", "price", "product"],
+    write: true,
+    validate: validateAddProducts,
+    // 🔴 命令块只字面读 args.id / args.product，值旗标经 discountValueFlag / discountValueRaw（它们字面读 args.percent / args.price）；
+    //    ⛔ 不得提到 discountHuman / validateCreateDiscount / discountActivityBody / discountWindow（它们读 days / title，本命令没有）
+    preview: ({ args: args2 }) => addProductsPlan(args2.id, discountValueFlag(args2), discountValueRaw(args2), args2.product),
+    run: ({ shop, args: args2 }) => runAddProducts(shop, args2.id, discountValueFlag(args2), discountValueRaw(args2), args2.product)
+  },
+  {
+    name: "promotions get",
+    summary: ADD_TEXT.SUM_GET,
+    flags: ["id"],
+    listKey: "products",
+    validate: validateGet,
+    run: ({ shop, args: args2 }) => runGet(shop, args2.id)
+  },
   {
     name: "promotions deactivate",
     summary: "\u7EC8\u6B62/\u505C\u7528\u4FC3\u9500\u6D3B\u52A8\uFF08--id \u5FC5\u586B\uFF09\u3002\u4E0D\u53EF\u9006",
@@ -1463,27 +1524,41 @@ function findCommand(tokens) {
   }
   return null;
 }
-var DISCOUNT_FLAGS = ["shop", "apply", "actor", "title", "product", "price", "days"];
+var DISCOUNT_FLAGS = ["shop", "apply", "actor", "title", "product", "price", "percent", "days"];
+function discountValueFlag(args2) {
+  return "percent" in args2 ? "percent" : "price";
+}
+function discountValueRaw(args2) {
+  return discountValueFlag(args2) === "percent" ? args2.percent ?? "" : args2.price ?? "";
+}
 var PRICE_ITEM = /^(?:([^:,\s/]+)\/)?([^:,\s/]+):(0|[1-9]\d*)(?:\.(\d{1,2}))?$/;
-function parsePriceItems(raw, defaultProduct) {
+var PCT_ITEM = /^(?:([^:,\s/]+)\/)?([^:,\s/]+):([1-9]\d?)$/;
+function parsePriceItems(raw, defaultProduct, flag = "price") {
   const items = [];
   const seen = /* @__PURE__ */ new Set();
+  const unit = flag === "percent" ? "<\u51CFN%>" : "<\u4EF7>";
   for (const part of raw.split(",")) {
-    const m = PRICE_ITEM.exec(part);
+    const m = (flag === "percent" ? PCT_ITEM : PRICE_ITEM).exec(part);
     if (!m) {
-      return { ok: false, message: `--price \u6BCF\u4E00\u9879\u5FC5\u987B\u662F <skuId>:<\u4E00\u53E3\u4EF7> \u6216 <productId>/<skuId>:<\u4E00\u53E3\u4EF7>\uFF08\u5341\u8FDB\u5236\u6570\u5B57\uFF0C\u6700\u591A\u4E24\u4F4D\u5C0F\u6570\u3001\u4E0D\u8981\u524D\u5BFC\u96F6\uFF0C\u5982 25.42\uFF09\uFF0C\u591A\u9879\u7528\u9017\u53F7\u8FDE\u63A5\u3001\u5404\u9879\u4E4B\u95F4\u4E0D\u8981\u6709\u7A7A\u683C\uFF0C\u5982 --price 173707:29.90,173708:32.00\uFF1B\u6536\u5230\u300C${part}\u300D` };
+      return flag === "percent" ? { ok: false, message: `--percent \u6BCF\u4E00\u9879\u5FC5\u987B\u662F <skuId>:<N> \u6216 <productId>/<skuId>:<N>\uFF0CN \u662F 1\u201399 \u7684\u6574\u6570\uFF0C\u8868\u793A\u300C\u51CF N%\u300D\uFF0885 = \u51CF 85%\uFF0C\u6309\u539F\u4EF7 15% \u5356\uFF1B\u5E97\u4E3B\u8BF4\u300C\u6253 85 \u6298\u300D\u8981\u4F20 15\uFF09\uFF1B\u6536\u5230\u300C${part}\u300D` } : { ok: false, message: `--price \u6BCF\u4E00\u9879\u5FC5\u987B\u662F <skuId>:<\u4E00\u53E3\u4EF7> \u6216 <productId>/<skuId>:<\u4E00\u53E3\u4EF7>\uFF08\u5341\u8FDB\u5236\u6570\u5B57\uFF0C\u6700\u591A\u4E24\u4F4D\u5C0F\u6570\u3001\u4E0D\u8981\u524D\u5BFC\u96F6\uFF0C\u5982 25.42\uFF09\uFF0C\u591A\u9879\u7528\u9017\u53F7\u8FDE\u63A5\u3001\u5404\u9879\u4E4B\u95F4\u4E0D\u8981\u6709\u7A7A\u683C\uFF0C\u5982 --price 173707:29.90,173708:32.00\uFF1B\u6536\u5230\u300C${part}\u300D` };
     }
-    const [, explicitPid, sid, intPart, frac] = m;
+    const [, explicitPid, sid] = m;
     if (explicitPid && defaultProduct && explicitPid !== defaultProduct) {
-      return { ok: false, message: `--price \u7684\u300C${part}\u300D\u6307\u5B9A\u4E86\u5546\u54C1 ${explicitPid}\uFF0C\u4E0E --product ${defaultProduct} \u4E0D\u4E00\u81F4\uFF1B\u591A\u5546\u54C1\u8BF7\u628A --product \u53BB\u6389\u3001\u6BCF\u9879\u90FD\u5199\u6210 <productId>/<skuId>:<\u4EF7>` };
+      return { ok: false, message: `--${flag} \u7684\u300C${part}\u300D\u6307\u5B9A\u4E86\u5546\u54C1 ${explicitPid}\uFF0C\u4E0E --product ${defaultProduct} \u4E0D\u4E00\u81F4\uFF1B\u591A\u5546\u54C1\u8BF7\u628A --product \u53BB\u6389\u3001\u6BCF\u9879\u90FD\u5199\u6210 <productId>/<skuId>:${unit}` };
     }
     const pid = explicitPid ?? defaultProduct;
     if (!pid) {
-      return { ok: false, message: `--price \u7684\u300C${part}\u300D\u6CA1\u5E26 productId\uFF0C\u800C\u4F60\u4E5F\u6CA1\u4F20 --product\uFF1B\u8981\u4E48\u52A0 --product\uFF0C\u8981\u4E48\u5199\u6210 <productId>/<skuId>:<\u4EF7>` };
+      return { ok: false, message: `--${flag} \u7684\u300C${part}\u300D\u6CA1\u5E26 productId\uFF0C\u800C\u4F60\u4E5F\u6CA1\u4F20 --product\uFF1B\u8981\u4E48\u52A0 --product\uFF0C\u8981\u4E48\u5199\u6210 <productId>/<skuId>:${unit}` };
+    }
+    let amount;
+    if (flag === "percent") {
+      amount = m[3];
+    } else {
+      const [, , , intPart, frac] = m;
+      amount = frac === void 0 ? intPart : `${intPart}.${frac}`;
+      if (!(Number(amount) > 0)) return { ok: false, message: `--price \u7684\u4E00\u53E3\u4EF7\u5FC5\u987B\u5927\u4E8E 0\uFF1B\u6536\u5230\u300C${part}\u300D` };
     }
-    const amount = frac === void 0 ? intPart : `${intPart}.${frac}`;
-    if (!(Number(amount) > 0)) return { ok: false, message: `--price \u7684\u4E00\u53E3\u4EF7\u5FC5\u987B\u5927\u4E8E 0\uFF1B\u6536\u5230\u300C${part}\u300D` };
-    if (seen.has(sid)) return { ok: false, message: `--price \u91CC\u540C\u4E00\u4E2A skuId \u91CD\u590D\u51FA\u73B0\uFF1A${sid}` };
+    if (seen.has(sid)) return { ok: false, message: `--${flag} \u91CC\u540C\u4E00\u4E2A skuId \u91CD\u590D\u51FA\u73B0\uFF1A${sid}` };
     seen.add(sid);
     items.push({ pid, sid, amount });
   }
@@ -1498,15 +1573,14 @@ function discountWindow(args2) {
 function discountActivityBody(args2, begin, end) {
   return {
     title: args2.title,
-    activity_type: "FIXED_PRICE",
+    // 🔴 由常量变条件 —— 正是 #9 的根因形态（字段写死）；P1/P2 钉 DD、P9 钉 FP 逐字不变
+    activity_type: discountValueFlag(args2) === "percent" ? "DIRECT_DISCOUNT" : "FIXED_PRICE",
     product_level: "VARIATION",
     begin_time: begin,
     end_time: end
   };
 }
-function discountProductsBody(args2) {
-  const parsed = parsePriceItems(args2.price ?? "", args2.product);
-  const items = parsed.ok ? parsed.items : [];
+function productsBodyFromItems(items, flag, productLimits) {
   const order = [];
   const byPid = /* @__PURE__ */ new Map();
   for (const it of items) {
@@ -1517,49 +1591,62 @@ function discountProductsBody(args2) {
     byPid.get(it.pid).push({ sid: it.sid, amount: it.amount });
   }
   return {
-    products: order.map((pid) => ({
-      id: pid,
-      quantity_limit: -1,
-      quantity_per_user: -1,
-      skus: byPid.get(pid).map((it) => ({
-        id: it.sid,
-        activity_price_amount: it.amount,
-        // 🔴 写侧裸串；读回叫 activity_price.amount（F4）
-        quantity_limit: -1,
-        quantity_per_user: -1
-      }))
-    }))
+    products: order.map((pid) => {
+      const [ql, qpu] = productLimits?.get(pid) ?? [-1, -1];
+      return {
+        id: pid,
+        quantity_limit: ql,
+        quantity_per_user: qpu,
+        skus: byPid.get(pid).map((it) => flag === "percent" ? { id: it.sid, discount: it.amount, quantity_limit: -1, quantity_per_user: -1 } : { id: it.sid, activity_price_amount: it.amount, quantity_limit: -1, quantity_per_user: -1 })
+        // 🔴 写侧裸串；读回叫 activity_price.amount
+      };
+    })
   };
 }
+function discountProductsBody(args2) {
+  const flag = discountValueFlag(args2);
+  const parsed = parsePriceItems(discountValueRaw(args2), args2.product, flag);
+  return productsBodyFromItems(parsed.ok ? parsed.items : [], flag);
+}
+function discountItemsHuman(items, flag) {
+  return items.map((it) => flag === "percent" ? `\u5546\u54C1 ${it.pid} \u7684 SKU ${it.sid} \u51CF ${it.amount}%\uFF08\u6309\u539F\u4EF7 ${100 - Number(it.amount)}% \u552E\u5356\uFF09` : `\u5546\u54C1 ${it.pid} \u7684 SKU ${it.sid} \u552E\u4EF7\u5B9A\u4E3A ${it.amount}`).join("\uFF1B");
+}
 function discountHuman(args2) {
-  const parsed = parsePriceItems(args2.price ?? "", args2.product);
+  const flag = discountValueFlag(args2);
+  const parsed = parsePriceItems(discountValueRaw(args2), args2.product, flag);
   const days = Number(args2.days ?? 180);
-  const list = parsed.ok ? parsed.items.map((it) => `\u5546\u54C1 ${it.pid} \u7684 SKU ${it.sid} \u552E\u4EF7\u5B9A\u4E3A ${it.amount}`).join("\uFF1B") : "\uFF08--price \u89E3\u6790\u5931\u8D25\uFF09";
+  const list = parsed.ok ? discountItemsHuman(parsed.items, flag) : `\uFF08--${flag} \u89E3\u6790\u5931\u8D25\uFF09`;
   return `${list}\u3002\u539F\u4EF7\u5C06\u663E\u793A\u4E3A\u5212\u7EBF\u4EF7\u3002\u6D3B\u52A8\u5171 ${days} \u5929\uFF0C\u4ECE 15 \u5206\u949F\u540E\u5F00\u59CB \u2014\u2014 \u521A\u5EFA\u5B8C\u53BB\u5546\u54C1\u9875\u770B\u4EF7\u683C\u6CA1\u53D8\u662F\u6B63\u5E38\u7684\uFF0C\u90A3\u65F6\u6D3B\u52A8\u8FD8\u662F NOT_START\u3002`;
 }
 function validateCreateDiscount(ctx2) {
   const { args: args2, rest } = ctx2;
   for (const k of Object.keys(args2)) {
     if (DISCOUNT_FLAGS.includes(k)) continue;
-    if (k === "percent") {
-      return { ok: false, message: "\u672C\u7248\u4E0D\u652F\u6301\u767E\u5206\u6BD4\u6298\u6263\uFF08--percent\uFF09\u3002\u8BF7\u5148\u7528 tiktok products get --shop <id> --product <pid> \u53D6 SKU \u6302\u724C\u4EF7\uFF0C\u81EA\u884C\u6298\u7B97\uFF08\u4FDD\u7559\u4E24\u4F4D\u5C0F\u6570\uFF09\u540E\u8D70 --price <skuId>:<\u6298\u540E\u4EF7>" };
-    }
     if (k === "sku") {
-      return { ok: false, message: "\u672C\u547D\u4EE4\u6CA1\u6709 --sku\uFF1AskuId \u5199\u5728 --price \u91CC\uFF0C\u5982 --price 173707:29.90\uFF08\u6CA1\u4F20 --product \u65F6\u6BCF\u9879\u90FD\u8981\u5E26 productId\uFF0C\u5982 --price 1737048/173707:29.90\uFF09" };
+      return "percent" in args2 ? { ok: false, message: "\u672C\u547D\u4EE4\u6CA1\u6709 --sku\uFF1AskuId \u5199\u5728 --percent \u91CC\uFF0C\u5982 --percent 173707:15\uFF08\u6CA1\u4F20 --product \u65F6\u6BCF\u9879\u90FD\u8981\u5E26 productId\uFF0C\u5982 --percent 1737048/173707:15\uFF09" } : { ok: false, message: "\u672C\u547D\u4EE4\u6CA1\u6709 --sku\uFF1AskuId \u5199\u5728 --price \u91CC\uFF0C\u5982 --price 173707:29.90\uFF08\u6CA1\u4F20 --product \u65F6\u6BCF\u9879\u90FD\u8981\u5E26 productId\uFF0C\u5982 --price 1737048/173707:29.90\uFF09" };
     }
     const own = DISCOUNT_FLAGS.filter((f) => !GLOBAL_FLAGS.includes(f));
     const hint = suggestFlag(k, own, args2[k], Date.now(), "promotions create-discount");
     const tip = !hint ? "" : hint.startsWith("--") ? `\uFF08\u4F60\u662F\u60F3\u7528 ${hint} \u5417\uFF1F\uFF09` : `\uFF08${hint}\uFF09`;
     return { ok: false, message: `\u4E0D\u652F\u6301\u7684\u53C2\u6570 --${k}${tip}\uFF1B\u672C\u547D\u4EE4\u53EA\u8BA4 ${DISCOUNT_FLAGS.map((f) => "--" + f).join(" ")}` };
   }
+  const v3flag = "price" in args2 ? "price" : discountValueFlag(args2);
   if (rest && rest.length > 0) {
-    return { ok: false, message: `\u591A\u4F59\u7684\u4F4D\u7F6E\u53C2\u6570\u300C${rest.join(" ")}\u300D\u2014\u2014\u6BCF\u4E2A\u53C2\u6570\u53EA\u80FD\u5E26\u4E00\u4E2A\u503C\u3002\u591A\u4E2A SKU \u8981\u7528\u9017\u53F7\u8FDE\u6210\u4E00\u4E2A --price\uFF0C\u5982 --price A:12,B:15\uFF08\u4E0D\u80FD\u7528\u7A7A\u683C\u5206\u9694\uFF09\uFF1B\u82E5\u662F\u6807\u9898\u7B49\u503C\u91CC\u542B\u7A7A\u683C\uFF0C\u7ED9\u6574\u4E2A\u503C\u52A0\u5F15\u53F7\uFF0C\u5982 --title "Momo Sale"` };
+    return { ok: false, message: `\u591A\u4F59\u7684\u4F4D\u7F6E\u53C2\u6570\u300C${rest.join(" ")}\u300D\u2014\u2014\u6BCF\u4E2A\u53C2\u6570\u53EA\u80FD\u5E26\u4E00\u4E2A\u503C\u3002\u591A\u4E2A SKU \u8981\u7528\u9017\u53F7\u8FDE\u6210\u4E00\u4E2A --${v3flag}\uFF0C\u5982 --${v3flag} A:12,B:15\uFF08\u4E0D\u80FD\u7528\u7A7A\u683C\u5206\u9694\uFF09\uFF1B\u82E5\u662F\u6807\u9898\u7B49\u503C\u91CC\u542B\u7A7A\u683C\uFF0C\u7ED9\u6574\u4E2A\u503C\u52A0\u5F15\u53F7\uFF0C\u5982 --title "Momo Sale"` };
   }
-  for (const k of ["title", "price"]) {
-    const v = args2[k];
-    if (!v || v === "true" || !v.trim()) {
-      return { ok: false, message: `--${k} \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --${k} \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --${k}= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
-    }
+  if ("price" in args2 && "percent" in args2) {
+    return { ok: false, message: "--price \u4E0E --percent \u53EA\u80FD\u4E8C\u9009\u4E00\uFF1A\u4E00\u53E3\u4EF7\u7528 --price\uFF0C\u767E\u5206\u6BD4\u6298\u6263\u7528 --percent\u3002" };
+  }
+  if (!("price" in args2) && !("percent" in args2)) {
+    return { ok: false, message: `--price \u5FC5\u586B\uFF08\u767E\u5206\u6BD4\u6298\u6263\u6539\u7528 --percent\uFF0C\u4E24\u8005\u4E8C\u9009\u4E00\uFF09\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --price \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --price= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
+  }
+  if (!args2.title || args2.title === "true" || !args2.title.trim()) {
+    return { ok: false, message: `--title \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --title \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --title= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
+  }
+  const flag = discountValueFlag(args2);
+  const val = flag === "percent" ? args2.percent : args2.price;
+  if (!val || val === "true" || !val.trim()) {
+    return { ok: false, message: `--${flag} \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --${flag} \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --${flag}= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
   }
   if (args2.title !== args2.title.trim()) {
     return { ok: false, message: `--title \u9996\u5C3E\u4E0D\u80FD\u6709\u7A7A\u767D\uFF08\u6536\u5230\u300C${args2.title}\u300D\uFF09\uFF1A\u649E\u91CD\u540D\u65F6 CLI \u6309\u6807\u9898\u4E25\u683C\u76F8\u7B49\u67E5\u540C\u540D\u6D3B\u52A8\uFF0C\u5E73\u53F0\u82E5\u53BB\u6389\u9996\u5C3E\u7A7A\u767D\u5C31\u4F1A\u5BF9\u4E0D\u4E0A\u3002\u8BF7\u53BB\u6389\u9996\u5C3E\u7A7A\u767D\u540E\u91CD\u8DD1` };
@@ -1568,9 +1655,9 @@ function validateCreateDiscount(ctx2) {
     return { ok: false, message: `--product \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --product \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --product= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
   }
   if (args2.product?.includes(",")) {
-    return { ok: false, message: "--product \u53EA\u6536\u4E00\u4E2A\u5546\u54C1 id\uFF1B\u591A\u5546\u54C1\u8BF7\u5728 --price \u91CC\u5199 <productId>/<skuId>:<\u4EF7>" };
+    return { ok: false, message: `--product \u53EA\u6536\u4E00\u4E2A\u5546\u54C1 id\uFF1B\u591A\u5546\u54C1\u8BF7\u5728 --${flag} \u91CC\u5199 <productId>/<skuId>:${flag === "percent" ? "<\u51CFN%>" : "<\u4EF7>"}` };
   }
-  const parsed = parsePriceItems(args2.price, args2.product);
+  const parsed = parsePriceItems(val, args2.product, flag);
   if (!parsed.ok) return parsed;
   if ("days" in args2) {
     const raw = args2.days;
@@ -1589,18 +1676,21 @@ var DISCOUNT_TEXT = {
   noCreateId: (title) => `\u5EFA\u58F3\u8FD4\u56DE\u6210\u529F\u4F46\u6CA1\u62FF\u5230 activity_id \u2014\u2014 \u26A0\uFE0F \u5E73\u53F0\u4E0A\u5F88\u53EF\u80FD\u5DF2\u7ECF\u6709\u8FD9\u6761\u58F3\u4E86\uFF08\u6807\u9898\u300C${title}\u300D\uFF09\u3002\u522B\u6362\u6807\u9898\uFF0C\u76F4\u63A5\u7528\u539F\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF1A\u91CD\u8DD1\u4F1A\u649E\u91CD\u540D\uFF0C\u90A3\u6761\u63D0\u793A\u4F1A\u544A\u8BC9\u4F60\u4E0B\u4E00\u6B65\u3002`,
   // ⑦ 撞重名后自查的六种结论（前面由调用方拼上平台原文 + 一个半角空格）
   dupSame: (title, aid, status) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF08\u6D3B\u52A8 ${aid}\uFF0C${status}\uFF09\uFF0C\u6302\u7684\u5546\u54C1\u4E0E\u672C\u6B21\u63D0\u4EA4\u5B8C\u5168\u4E00\u81F4\u2014\u2014\u8FD9\u5C31\u662F\u4F60\u8981\u7684\u6D3B\u52A8\uFF0C\u5DF2\u7ECF\u5EFA\u597D\u4E86\uFF1A\u522B\u91CD\u5EFA\u3002`,
-  dupEmpty: (title, aid, status, shop) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF08\u6D3B\u52A8 ${aid}\uFF0C${status}\uFF09\uFF0C\u4F46\u5B83\u662F\u4E00\u6761\u7A7A\u58F3\uFF08\u6CA1\u6709\u4EFB\u4F55\u5546\u54C1\uFF09\u2014\u2014\u5148\u6E05\u7406\uFF1A${deactivateCmd(shop, aid)}\uFF0C\u518D\u7528\u539F\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF1B\u91CD\u8DD1\u82E5\u53C8\u649E\u91CD\u540D\uFF0C\u6362\u4E2A\u6807\u9898\u3002`,
+  dupEmpty: (title, aid, status, addCmd) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF08\u6D3B\u52A8 ${aid}\uFF0C${status}\uFF09\uFF0C\u4F46\u5B83\u662F\u4E00\u6761\u7A7A\u58F3\uFF08\u6CA1\u6709\u4EFB\u4F55\u5546\u54C1\uFF09\u2014\u2014\u76F4\u63A5\u628A\u5546\u54C1\u6302\u4E0A\u53BB\uFF1A${addCmd}\uFF1B\u522B\u91CD\u5EFA\u3002`,
+  // v7 D4 / #36：否定分支 —— ⛔ 不指名具体哪一项（status 那格类型时长可能都对，写「类型或时长不符」是假原因）；措辞由 create-discount 线二轮拍板
+  dupEmptyOther: (title, aid, status, shop) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF08\u6D3B\u52A8 ${aid}\uFF0C${status}\uFF09\uFF0C\u5B83\u662F\u4E00\u6761\u7A7A\u58F3\uFF0C\u4F46\u4E0D\u662F\u4F60\u8FD9\u6B21\u8981\u5EFA\u7684\u90A3\u6761\uFF08\u7C7B\u578B\u3001\u65F6\u957F\u6216\u72B6\u6001\u6709\u51FA\u5165\uFF09\u2014\u2014\u522B\u5F80\u5B83\u91CC\u9762\u52A0\u54C1\uFF08\u6302\u8FDB\u53BB\u7684\u5546\u54C1\u4F1A\u8DDF\u7740\u5B83\u7684\u7C7B\u578B\u3001\u65F6\u957F\u548C\u751F\u6548\u72B6\u6001\u8D70\uFF0C\u4E0D\u662F\u4F60\u8FD9\u6B21\u8981\u7684\uFF09\uFF0C\u4E5F\u522B\u5148\u6E05\u7406\u518D\u7528\u539F\u6807\u9898\u91CD\u8DD1\uFF08\u6E05\u7406\u4E0D\u4F1A\u91CA\u653E\u6807\u9898\uFF09\uFF1A\u6362\u4E00\u4E2A\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF1B\u4E0D\u8981\u8FD9\u6761\u58F3\u4E86\u518D\u6E05\u7406\uFF1A${deactivateCmd(shop, aid)}\u3002`,
   dupOwner: (title, aid, status, problems) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF08\u6D3B\u52A8 ${aid}\uFF0C${status}\uFF09\uFF0C\u6302\u7684\u5546\u54C1\u4E0E\u672C\u6B21\u63D0\u4EA4\u4E0D\u4E00\u81F4\uFF1A${problems}\u2014\u2014\u522B\u52A8\u5B83\uFF0C\u4E5F\u5148\u522B\u91CD\u5EFA\uFF1A\u628A\u5B83\u544A\u8BC9\u5E97\u4E3B\uFF0C\u95EE\u662F\u5C31\u7528\u8FD9\u6761\uFF0C\u8FD8\u662F\u6362\u4E2A\u6807\u9898\u53E6\u5EFA\u3002`,
   dupRetitle: (title) => `\u26A0\uFE0F \u672A\u5F00\u59CB / \u8FDB\u884C\u4E2D\u7684\u6D3B\u52A8\u91CC\u6CA1\u6709\u300C${title}\u300D\u2014\u2014\u8FD9\u4E2A\u6807\u9898\u88AB\u4E00\u6761\u5DF2\u7EC8\u6B62\u6216\u5DF2\u8FC7\u671F\u7684\u6D3B\u52A8\u5360\u7740\uFF0C\u6362\u4E2A\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\u3002`,
   dupUnclear: (title, queryError) => `\u26A0\uFE0F \u540C\u540D\u6D3B\u52A8\u300C${title}\u300D\u5DF2\u5B58\u5728\uFF0C\u4F46\u6CA1\u80FD\u67E5\u6E05\u5B83\u7684\u72B6\u6001\uFF08${queryError}\uFF09\u2014\u2014\u522B\u6362\u6807\u9898\u3001\u522B\u91CD\u5EFA\uFF0C\u7A0D\u540E\u7528\u539F\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\u518D\u770B\uFF1B\u8FDE\u7EED\u4E24\u6B21\u90FD\u662F\u8FD9\u53E5\uFF0C\u5C31\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u300C\u6D3B\u52A8\u53EF\u80FD\u5DF2\u5EFA\uFF0C\u4F46\u67E5\u4E0D\u6E05\u300D\u3002`,
   dupMulti: (title, found) => `\u26A0\uFE0F \u672A\u5F00\u59CB / \u8FDB\u884C\u4E2D\u7684\u6D3B\u52A8\u91CC\u6709 ${found.length} \u6761\u53EB\u300C${title}\u300D\uFF08${found.map((a) => `${a.id}\uFF1A${a.status}`).join("\uFF1B")}\uFF09\u2014\u2014\u522B\u52A8\u5B83\u4EEC\uFF0C\u4E5F\u5148\u522B\u91CD\u5EFA\uFF1A\u628A\u5B83\u4EEC\u544A\u8BC9\u5E97\u4E3B\uFF0C\u95EE\u600E\u4E48\u5904\u7406\u3002`,
   // ⑧ 加品失败后按回读下结论
-  addFailAllAttached: (n, id) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u4F46\u56DE\u8BFB\u663E\u793A\u63D0\u4EA4\u7684 ${n} \u4E2A SKU \u90FD\u5DF2\u6309\u4EF7\u6302\u4E0A\uFF08\u6D3B\u52A8 ${id} \u7EA6 15 \u5206\u949F\u540E\u5F00\u59CB\uFF09\u2014\u2014\u522B\u6E05\u7406\uFF0C\u4E5F\u522B\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
-  addFailNoneAttached: (shop, id) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u663E\u793A\u6CA1\u6709\u4EFB\u4F55\u5546\u54C1\u6302\u4E0A\u2014\u2014\u6D3B\u52A8 ${id} \u662F\u4E00\u6761\u7A7A\u58F3\u3002\u5148\u6E05\u7406\uFF1A${deactivateCmd(shop, id)}\uFF1B\u518D\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u540E\u91CD\u8DD1\u539F\u547D\u4EE4\uFF08\u53EA\u6709\u9650\u6D41\u3001\u7F51\u7EDC\u7C7B\u62A5\u9519\u624D\u539F\u6837\u91CD\u8DD1\uFF09\u3002\u522B\u76F4\u63A5\u91CD\u8DD1\uFF1A\u4F1A\u649E\u91CD\u540D\u6216\u518D\u5EFA\u4E00\u4E2A\u58F3\u3002`,
-  addFailPartial: (problems, shop, id) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u56DE\u8BFB\u663E\u793A\u6CA1\u6709\u5168\u90E8\u6302\u4E0A\uFF1A${problems}\u3002\u672C\u547D\u4EE4\u4E0D\u80FD\u5F80\u5DF2\u6709\u6D3B\u52A8\u8865\u5546\u54C1\uFF0C\u8BF7\u5E97\u4E3B\u4E8C\u9009\u4E00\uFF1A\u4FDD\u7559\u6D3B\u52A8 ${id}\uFF08\u7F3A\u7684 SKU \u4E0D\u6253\u6298\uFF0C\u4EF7\u683C\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u4EF7\u683C\u751F\u6548\uFF09\uFF0C\u6216\u6E05\u7406\u540E\u6574\u6761\u91CD\u5EFA\uFF1A${deactivateCmd(shop, id)}\uFF0C\u6E05\u7406\u540E\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u518D\u91CD\u8DD1\u539F\u547D\u4EE4\u3002\u522B\u76F4\u63A5\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
-  addFailReadbackFailed: (shop, id) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u4E5F\u5931\u8D25\u4E86\uFF0C\u67E5\u4E0D\u5230\u6D3B\u52A8 ${id} \u91CC\u5546\u54C1\u6709\u6CA1\u6709\u6302\u4E0A\u3002\u522B\u91CD\u8DD1\u672C\u547D\u4EE4\uFF08\u4F1A\u518D\u5EFA\u4E00\u4E2A\u58F3\uFF09\uFF0C\u4E5F\u5148\u522B\u6E05\u7406\uFF1A\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u300C\u6D3B\u52A8\u5DF2\u5EFA\uFF0C\u5546\u54C1\u662F\u5426\u6302\u4E0A\u672A\u80FD\u786E\u8BA4\u300D\uFF0C\u8BF7\u5E97\u4E3B\u5728\u5356\u5BB6\u540E\u53F0\u770B\u8FD9\u6761\u6D3B\u52A8\u91CC\u6709\u6CA1\u6709\u5546\u54C1\uFF1B\u786E\u8BA4\u6CA1\u6302\u4E0A\u518D\u6E05\u7406\uFF1A${deactivateCmd(shop, id)}\u3002`,
+  addFailAllAttached: (n, id, dd = false) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u4F46\u56DE\u8BFB\u663E\u793A\u63D0\u4EA4\u7684 ${n} \u4E2A SKU \u90FD\u5DF2\u6309${dd ? "\u6298\u6263" : "\u4EF7"}\u6302\u4E0A\uFF08\u6D3B\u52A8 ${id} \u7EA6 15 \u5206\u949F\u540E\u5F00\u59CB\uFF09\u2014\u2014\u522B\u6E05\u7406\uFF0C\u4E5F\u522B\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
+  addFailNoneAttached: (shop, id, addCmd) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u663E\u793A\u6CA1\u6709\u4EFB\u4F55\u5546\u54C1\u6302\u4E0A\u2014\u2014\u6D3B\u52A8 ${id} \u662F\u4E00\u6761\u7A7A\u58F3\u3002\u522B\u91CD\u8DD1\u672C\u547D\u4EE4\uFF08\u4F1A\u649E\u91CD\u540D\u6216\u518D\u5EFA\u4E00\u4E2A\u58F3\uFF09\uFF1A\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u540E\uFF0C\u7528 ${addCmd} \u628A\u5546\u54C1\u6302\u5230\u8FD9\u6761\u6D3B\u52A8\u4E0A\uFF08\u53EA\u6709\u9650\u6D41\u3001\u7F51\u7EDC\u7C7B\u62A5\u9519\u624D\u539F\u6837\u91CD\u8BD5\uFF09\uFF1B\u4E0D\u6253\u7B97\u7528\u8FD9\u6761\u6D3B\u52A8\u4E86\u518D\u6E05\u7406\uFF1A${deactivateCmd(shop, id)}\u3002`,
+  addFailPartial: (problems, shop, id, addCmd, dd = false) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u56DE\u8BFB\u663E\u793A\u6CA1\u6709\u5168\u90E8\u6302\u4E0A\uFF1A${problems}\u3002\u8BF7\u5E97\u4E3B\u4E09\u9009\u4E00\uFF1A\u8865\u6302\u7F3A\u7684 SKU\uFF1A${addCmd}\uFF08\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u540E\u518D\u8865\uFF09\uFF1B\u4FDD\u7559\u6D3B\u52A8 ${id}\uFF08\u7F3A\u7684 SKU \u4E0D\u6253\u6298\uFF0C${dd ? "\u6298\u6263\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u6298\u6263\u751F\u6548" : "\u4EF7\u683C\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u4EF7\u683C\u751F\u6548"}\uFF09\uFF1B\u6216\u6E05\u7406\u540E\u6574\u6761\u91CD\u5EFA\uFF1A${deactivateCmd(shop, id)}\uFF0C\u6E05\u7406\u540E\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u3001\u6362\u4E00\u4E2A\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF08\u26A0\uFE0F deactivate \u4E0D\u91CA\u653E\u6807\u9898\uFF0C\u7528\u539F\u6807\u9898\u91CD\u8DD1\u5FC5\u649E\u91CD\u540D\uFF09\u3002\u522B\u76F4\u63A5\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
+  addFailPartialMismatch: (problems, shop, id, dd = false) => `\u52A0\u5546\u54C1\u62A5\u4E86\u9519\uFF0C\u56DE\u8BFB\u663E\u793A\u5546\u54C1\u90FD\u6302\u4E0A\u4E86\uFF0C\u4F46\u503C\u4E0E\u63D0\u4EA4\u4E0D\u4E00\u81F4\uFF1A${problems}\u3002\u8BF7\u5E97\u4E3B\u4E8C\u9009\u4E00\uFF1A\u4FDD\u7559\u6D3B\u52A8 ${id}\uFF08${dd ? "\u6298\u6263\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u6298\u6263\u751F\u6548" : "\u4EF7\u683C\u4E0D\u7B26\u7684\u6309\u8BFB\u56DE\u7684\u4EF7\u683C\u751F\u6548"}\uFF09\uFF0C\u6216\u6E05\u7406\u540E\u6574\u6761\u91CD\u5EFA\uFF1A${deactivateCmd(shop, id)}\uFF0C\u6E05\u7406\u540E\u6309\u4E0A\u9762\u7684\u5E73\u53F0\u62A5\u9519\u6539\u6B63\u53C2\u6570\u3001\u6362\u4E00\u4E2A\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF08\u26A0\uFE0F deactivate \u4E0D\u91CA\u653E\u6807\u9898\uFF0C\u7528\u539F\u6807\u9898\u91CD\u8DD1\u5FC5\u649E\u91CD\u540D\uFF09\u3002\u522B\u76F4\u63A5\u91CD\u8DD1\u672C\u547D\u4EE4\u3002`,
+  addFailReadbackFailed: (shop, id) => `\u52A0\u5546\u54C1\u5931\u8D25\uFF0C\u56DE\u8BFB\u4E5F\u5931\u8D25\u4E86\uFF0C\u67E5\u4E0D\u5230\u6D3B\u52A8 ${id} \u91CC\u5546\u54C1\u6709\u6CA1\u6709\u6302\u4E0A\u3002\u522B\u91CD\u8DD1\u672C\u547D\u4EE4\uFF08\u4F1A\u518D\u5EFA\u4E00\u4E2A\u58F3\uFF09\uFF0C\u4E5F\u5148\u522B\u6E05\u7406\uFF1A\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u6838\u5BF9\uFF1B\u4ECD\u67E5\u4E0D\u6E05\u5C31\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u300C\u6D3B\u52A8\u5DF2\u5EFA\uFF0C\u5546\u54C1\u662F\u5426\u6302\u4E0A\u672A\u80FD\u786E\u8BA4\u300D\uFF1B\u786E\u8BA4\u6CA1\u6302\u4E0A\u518D\u6E05\u7406\uFF1A${deactivateCmd(shop, id)}\u3002`,
   // ⑨ 成功路径的 warnings
-  readbackFailed: (id) => `\u6D3B\u52A8 ${id} \u5DF2\u5EFA\u6210\u3001\u5546\u54C1\u5DF2\u63D0\u4EA4\uFF0C\u4F46\u56DE\u8BFB\u5931\u8D25\uFF0C\u672A\u80FD\u9A8C\u8BC1\u5546\u54C1\u662F\u5426\u6302\u4E0A\u2014\u2014\u4E0D\u8981\u91CD\u5EFA\u6D3B\u52A8\uFF1B\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u300C\u5DF2\u5EFA\uFF0C\u5546\u54C1\u662F\u5426\u6302\u4E0A\u672A\u80FD\u786E\u8BA4\u300D\u3002`,
+  readbackFailed: (shop, id) => `\u6D3B\u52A8 ${id} \u5DF2\u5EFA\u6210\u3001\u5546\u54C1\u5DF2\u63D0\u4EA4\uFF0C\u4F46\u56DE\u8BFB\u5931\u8D25\uFF0C\u672A\u80FD\u9A8C\u8BC1\u5546\u54C1\u662F\u5426\u6302\u4E0A\u2014\u2014\u4E0D\u8981\u91CD\u5EFA\u6D3B\u52A8\uFF1B\u5148\u7528 \`tiktok promotions get --shop ${shop} --id ${id}\` \u6838\u5BF9\uFF0C\u4ECD\u67E5\u4E0D\u6E05\u518D\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u300C\u5DF2\u5EFA\uFF0C\u5546\u54C1\u662F\u5426\u6302\u4E0A\u672A\u80FD\u786E\u8BA4\u300D\u3002`,
   readbackDiffers: (id, problems) => `\u6D3B\u52A8 ${id} \u5DF2\u5EFA\u6210\uFF0C\u4F46\u56DE\u8BFB\u4E0E\u63D0\u4EA4\u4E0D\u4E00\u81F4\uFF1A${problems}\u2014\u2014\u4E0D\u8981\u91CD\u5EFA\u6D3B\u52A8\uFF1B\u5982\u5B9E\u544A\u8BC9\u5E97\u4E3B\u54EA\u4E9B SKU \u672A\u786E\u8BA4\u6302\u4E0A\u3002`
 };
 var OBSERVED_REJECT_CODES = /* @__PURE__ */ new Set([
@@ -1634,9 +1724,10 @@ function createFailureVerdict(env2) {
   return "maybe_landed";
 }
 function submittedSkus(args2) {
-  return discountProductsBody(args2).products.flatMap((p) => p.skus.map((s) => ({ sid: s.id, amount: s.activity_price_amount })));
+  const dd = discountValueFlag(args2) === "percent";
+  return discountProductsBody(args2).products.flatMap((p) => p.skus.map((s) => ({ sid: s.id, amount: dd ? s.discount : s.activity_price_amount })));
 }
-function compareReadback(submitted, readback) {
+function compareReadback(submitted, readback, field = "amount") {
   const products = readback?.products;
   if (!Array.isArray(products)) return null;
   const skus = products.flatMap((p) => Array.isArray(p?.skus) ? p.skus : []);
@@ -1655,17 +1746,19 @@ function compareReadback(submitted, readback) {
       diff.missing.push(sid);
       continue;
     }
-    const raw = hit.activity_price?.amount;
+    const raw = field === "discount" ? hit.discount : hit.activity_price?.amount;
     const got = raw === void 0 || raw === null || raw === "" ? void 0 : String(raw);
     if (got === void 0 || Number(got) !== Number(amount)) diff.mismatched.push({ sid, submitted: amount, readback: got });
   }
   return diff;
 }
-function problemsText(d) {
+function problemsText(d, field = "amount") {
   const parts = [];
   if (d.missing.length) parts.push(`\u7F3A ${d.missing.join("\u3001")}`);
   if (d.mismatched.length) {
-    parts.push(`\u91D1\u989D\u4E0D\u7B26 ${d.mismatched.map((m) => `${m.sid}\uFF08\u63D0\u4EA4 ${m.submitted}\uFF0C\u8BFB\u56DE ${m.readback ?? "\u65E0\u91D1\u989D"}\uFF09`).join("\u3001")}`);
+    const label = field === "discount" ? "\u6298\u6263\u4E0D\u7B26" : "\u91D1\u989D\u4E0D\u7B26";
+    const none = field === "discount" ? "\u65E0\u6298\u6263" : "\u65E0\u91D1\u989D";
+    parts.push(`${label} ${d.mismatched.map((m) => `${m.sid}\uFF08\u63D0\u4EA4 ${m.submitted}\uFF0C\u8BFB\u56DE ${m.readback ?? none}\uFF09`).join("\u3001")}`);
   }
   return parts.join("\uFF1B");
 }
@@ -1675,7 +1768,7 @@ function mergeWarnings(existing, ours) {
   return [existing, ...ours];
 }
 var DUP_SEARCH_MAX_PAGES = 10;
-async function dupSelfCheck(shop, title, submitted) {
+async function dupSelfCheck(shop, title, submitted, field, intent) {
   const found = /* @__PURE__ */ new Map();
   for (const status of ["NOT_START", "ONGOING"]) {
     let token;
@@ -1698,13 +1791,220 @@ async function dupSelfCheck(shop, title, submitted) {
   const [hit] = found.values();
   const g = await proxy("GET", shop, `/promotion/202309/activities/${hit.id}`, {});
   if (!g.ok) return DISCOUNT_TEXT.dupUnclear(title, g.error.message);
-  const d = compareReadback(submitted, g.data);
+  const d = compareReadback(submitted, g.data, field);
   if (!d) return DISCOUNT_TEXT.dupUnclear(title, "\u56DE\u8BFB\u7F3A products \u5B57\u6BB5");
+  const gd = g.data;
+  const shellType = gd?.activity_type;
+  const typeNote = (shellType === "FIXED_PRICE" || shellType === "DIRECT_DISCOUNT") && shellType !== intent.type ? `\u7C7B\u578B\u4E0D\u7B26\uFF1A\u540C\u540D\u6D3B\u52A8\u662F ${shellType}\uFF0C\u672C\u6B21 --${intent.flag} \u5BF9\u5E94 ${intent.type}\uFF08\u4E0B\u9762\u7684\u4E0D\u4E00\u81F4\u662F\u7C7B\u578B\u5DEE\u5F02\u3001\u4E0D\u662F\u503C\u5DEE\u5F02\uFF09\uFF1B` : "";
   if (d.missing.length === 0 && d.mismatched.length === 0 && d.total === submitted.length) {
     return DISCOUNT_TEXT.dupSame(title, hit.id, hit.status);
   }
-  if (d.productCount === 0) return DISCOUNT_TEXT.dupEmpty(title, hit.id, hit.status, shop);
-  return DISCOUNT_TEXT.dupOwner(title, hit.id, hit.status, problemsText(d) || `\u591A\u51FA ${d.extra.join("\u3001")}`);
+  if (d.productCount === 0) {
+    const fits = gd?.activity_type === intent.type && Number(gd?.end_time) - Number(gd?.begin_time) === intent.days * 86400 && gd?.status === "NOT_START";
+    const echoStatus = String(gd?.status ?? hit.status);
+    return fits ? DISCOUNT_TEXT.dupEmpty(title, hit.id, echoStatus, intent.addCmd(hit.id)) : DISCOUNT_TEXT.dupEmptyOther(title, hit.id, echoStatus, shop);
+  }
+  return DISCOUNT_TEXT.dupOwner(title, hit.id, hit.status, typeNote + (problemsText(d, field) || `\u591A\u51FA ${d.extra.join("\u3001")}`));
+}
+var GET_FLAGS = ["shop", "actor", "id"];
+function validateGet(ctx2) {
+  const { args: args2, rest } = ctx2;
+  for (const k of Object.keys(args2)) {
+    if (k === "activity-id") return { ok: false, message: ADD_TEXT.AV2 };
+  }
+  for (const k of Object.keys(args2)) {
+    if (GET_FLAGS.includes(k) || k === "help") continue;
+    if (k === "apply") return { ok: false, message: "\u672C\u547D\u4EE4\u662F\u53EA\u8BFB\u547D\u4EE4\uFF0C\u6CA1\u6709 --apply\uFF08\u4E0D\u52A0 --apply \u4E5F\u4F1A\u76F4\u63A5\u8BFB\uFF09\uFF1B\u53BB\u6389\u5B83\u5373\u53EF" };
+    const hint = suggestFlag(k, ["id"], args2[k], Date.now(), "promotions get");
+    const tip = !hint ? "" : hint.startsWith("--") ? `\uFF08\u4F60\u662F\u60F3\u7528 ${hint} \u5417\uFF1F\uFF09` : `\uFF08${hint}\uFF09`;
+    return { ok: false, message: `\u4E0D\u652F\u6301\u7684\u53C2\u6570 --${k}${tip}\uFF1B\u672C\u547D\u4EE4\u53EA\u8BA4 ${GET_FLAGS.map((f) => "--" + f).join(" ")}` };
+  }
+  if (rest && rest.length > 0) return { ok: false, message: ADD_TEXT.GV3(rest.join(" ")) };
+  if (!args2.id || args2.id === "true" || !args2.id.trim()) {
+    return { ok: false, message: `--id \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u6D3B\u52A8 id\uFF0C\u7EAF\u6570\u5B57\uFF0C\u5982 --id 7686081985965900001\uFF09` };
+  }
+  if (!/^\d+$/.test(args2.id)) return { ok: false, message: `--id \u5FC5\u987B\u662F\u7EAF\u6570\u5B57\u7684\u6D3B\u52A8 id\uFF08\u6536\u5230\u300C${args2.id}\u300D\uFF09` };
+  return { ok: true };
+}
+async function runGet(shop, id) {
+  return proxy("GET", shop, `/promotion/202309/activities/${id}`, {});
+}
+var ADD_PRODUCTS_FLAGS = ["shop", "apply", "actor", "id", "product", "price", "percent"];
+var ADD_ALLOWED_STATUS = ["NOT_START", "ONGOING"];
+var addProductsCmd = (shop, aid, product, flag, items, apply) => `\`tiktok promotions add-products --shop ${shop} --id ${aid}${product ? ` --product ${product}` : ""} --${flag} ${items.join(",")}${apply ? " --apply" : ""}\``;
+function rawItemsFor(raw, sids) {
+  const want = new Set(sids);
+  return raw.split(",").filter((part) => want.has(part.split(":")[0].split("/").pop() ?? ""));
+}
+function existingSkuValues(data, field) {
+  const out2 = /* @__PURE__ */ new Map();
+  const products = data?.products;
+  for (const p of Array.isArray(products) ? products : []) {
+    for (const s of Array.isArray(p?.skus) ? p.skus : []) {
+      const raw = field === "discount" ? s?.discount : s?.activity_price?.amount;
+      const id = String(s?.id);
+      if (!out2.has(id)) out2.set(id, raw === void 0 || raw === null || raw === "" ? void 0 : String(raw));
+    }
+  }
+  return out2;
+}
+function productLimitsOf(data) {
+  const out2 = /* @__PURE__ */ new Map();
+  const products = data?.products;
+  for (const p of Array.isArray(products) ? products : []) {
+    if (typeof p?.quantity_limit === "number" && typeof p?.quantity_per_user === "number") out2.set(String(p.id), [p.quantity_limit, p.quantity_per_user]);
+  }
+  return out2;
+}
+function lostText(pre, rb, field) {
+  const parts = [];
+  const rbProducts = Array.isArray(rb?.products) ? rb.products : [];
+  const rbProd = new Map(rbProducts.map((p) => [String(p?.id), p]));
+  const rbVals = existingSkuValues(rb, field);
+  const rbHas = new Set(rbProducts.flatMap((p) => (Array.isArray(p?.skus) ? p.skus : []).map((s) => String(s?.id))));
+  const preVals = existingSkuValues(pre, field);
+  for (const p of Array.isArray(pre?.products) ? pre.products : []) {
+    for (const s of Array.isArray(p?.skus) ? p.skus : []) {
+      const sid = String(s?.id);
+      if (!rbHas.has(sid)) {
+        parts.push(`\u539F\u6709 ${sid} \u7F3A\u5931`);
+        continue;
+      }
+      const was = preVals.get(sid), now = rbVals.get(sid);
+      if (was !== void 0 && (now === void 0 || Number(now) !== Number(was))) parts.push(`\u539F\u6709 ${sid} \u503C\u53D8\u4E86\uFF08\u539F ${was}\uFF0C\u73B0 ${now ?? "\u65E0"}\uFF09`);
+    }
+    const q = rbProd.get(String(p?.id));
+    if (!q) continue;
+    if (typeof p?.quantity_limit === "number" && typeof p?.quantity_per_user === "number" && (q.quantity_limit !== p.quantity_limit || q.quantity_per_user !== p.quantity_per_user)) {
+      parts.push(`\u539F\u6709\u5546\u54C1 ${p.id} \u9650\u8D2D\u53D8\u4E86\uFF08\u539F ${p.quantity_limit}/${p.quantity_per_user}\uFF0C\u73B0 ${q.quantity_limit}/${q.quantity_per_user}\uFF09`);
+    }
+  }
+  return parts.join("\uFF1B");
+}
+function validateAddProducts(ctx2) {
+  const { args: args2, rest } = ctx2;
+  for (const k of Object.keys(args2)) {
+    if (k === "activity-id") return { ok: false, message: ADD_TEXT.AV2 };
+  }
+  for (const k of Object.keys(args2)) {
+    if (ADD_PRODUCTS_FLAGS.includes(k)) continue;
+    const own = ADD_PRODUCTS_FLAGS.filter((f) => !GLOBAL_FLAGS.includes(f));
+    const hint = suggestFlag(k, own, args2[k], Date.now(), "promotions add-products");
+    const tip = !hint ? "" : hint.startsWith("--") ? `\uFF08\u4F60\u662F\u60F3\u7528 ${hint} \u5417\uFF1F\uFF09` : `\uFF08${hint}\uFF09`;
+    return { ok: false, message: `\u4E0D\u652F\u6301\u7684\u53C2\u6570 --${k}${tip}\uFF1B\u672C\u547D\u4EE4\u53EA\u8BA4 ${ADD_PRODUCTS_FLAGS.map((f) => "--" + f).join(" ")}` };
+  }
+  const v3flag = "price" in args2 ? "price" : discountValueFlag(args2);
+  if (rest && rest.length > 0) return { ok: false, message: ADD_TEXT.AV3(rest.join(" "), v3flag) };
+  if ("price" in args2 && "percent" in args2) {
+    return { ok: false, message: "--price \u4E0E --percent \u53EA\u80FD\u4E8C\u9009\u4E00\uFF1A\u4E00\u53E3\u4EF7\u7528 --price\uFF0C\u767E\u5206\u6BD4\u6298\u6263\u7528 --percent\u3002" };
+  }
+  if (!("price" in args2) && !("percent" in args2)) {
+    return { ok: false, message: `--price \u5FC5\u586B\uFF08\u767E\u5206\u6BD4\u6298\u6263\u6539\u7528 --percent\uFF0C\u4E24\u8005\u4E8C\u9009\u4E00\uFF09\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --price \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --price= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
+  }
+  if (!args2.id || args2.id === "true" || !args2.id.trim()) {
+    return { ok: false, message: `--id \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u6D3B\u52A8 id\uFF0C\u7EAF\u6570\u5B57\uFF0C\u5982 --id 7686081985965900001\uFF09` };
+  }
+  if (!/^\d+$/.test(args2.id)) {
+    return { ok: false, message: `--id \u5FC5\u987B\u662F\u7EAF\u6570\u5B57\u7684\u6D3B\u52A8 id\uFF08\u6536\u5230\u300C${args2.id}\u300D\uFF09` };
+  }
+  const flag = discountValueFlag(args2);
+  const val = flag === "percent" ? args2.percent : args2.price;
+  if (!val || val === "true" || !val.trim()) {
+    return { ok: false, message: `--${flag} \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --${flag} \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --${flag}= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
+  }
+  if ("product" in args2 && (!args2.product || args2.product === "true")) {
+    return { ok: false, message: `--product \u5FC5\u586B\uFF0C\u4E14\u5FC5\u987B\u5E26\u503C\uFF08\u53EA\u5199 --product \u4E0D\u7ED9\u503C\u4F1A\u88AB\u89E3\u6790\u6210\u5B57\u7B26\u4E32 "true"\uFF0C\u5199\u6210 --product= \u5219\u662F\u7A7A\u503C\uFF0C\u4E24\u79CD\u90FD\u4E0D\u7B97\uFF09` };
+  }
+  if (args2.product?.includes(",")) {
+    return { ok: false, message: `--product \u53EA\u6536\u4E00\u4E2A\u5546\u54C1 id\uFF1B\u591A\u5546\u54C1\u8BF7\u5728 --${flag} \u91CC\u5199 <productId>/<skuId>:${flag === "percent" ? "<\u51CFN%>" : "<\u4EF7>"}` };
+  }
+  const parsed = parsePriceItems(val, args2.product, flag);
+  if (!parsed.ok) return parsed;
+  return { ok: true };
+}
+function addProductsPlan(id, flag, raw, product) {
+  const parsed = parsePriceItems(raw, product, flag);
+  const items = parsed.ok ? parsed.items : [];
+  return [
+    { step: "1/3 \u9884\u8BFB\u6D3B\u52A8", method: "GET", path: `/promotion/202309/activities/${id}` },
+    {
+      step: flag === "percent" ? "2/3 \u52A0\u5546\u54C1+\u51CFN%" : "2/3 \u52A0\u5546\u54C1+\u4E00\u53E3\u4EF7",
+      method: "PUT",
+      path: `/promotion/202309/activities/${id}/products`,
+      body: { activity_id: id, ...productsBodyFromItems(items, flag) },
+      human: ADD_TEXT.HUMAN_ADD(id, discountItemsHuman(items, flag))
+    },
+    { step: "3/3 \u56DE\u8BFB", method: "GET", path: `/promotion/202309/activities/${id}` }
+  ];
+}
+async function runAddProducts(shop, id, flag, raw, product) {
+  const parsed = parsePriceItems(raw, product, flag);
+  const items = parsed.ok ? parsed.items : [];
+  const field = flag === "percent" ? "discount" : "amount";
+  const submitted = items.map((it) => ({ sid: it.sid, amount: it.amount }));
+  const reject = (message, meta) => ({ ok: false, error: { code: "VALIDATION", message, retryable: false }, ...meta ? { meta } : {} });
+  const pre = await proxy("GET", shop, `/promotion/202309/activities/${id}`, {});
+  if (!pre.ok) {
+    const err = pre.error;
+    const status = pre.meta?.http_status;
+    const transient = status === void 0 || status >= 500 || err.code === "RATE_LIMITED";
+    return { ...pre, error: { ...err, message: `${err.message} ${transient ? ADD_TEXT.AP1N(id) : ADD_TEXT.AP1(shop, id)}` } };
+  }
+  const d = pre.data ?? {};
+  if (typeof d.activity_type !== "string" || !Array.isArray(d.products)) return reject(ADD_TEXT.AP1M(shop, id), pre.meta);
+  const type = String(d.activity_type);
+  if (type === "FIXED_PRICE" && flag === "percent") return reject(ADD_TEXT.AT1(id), pre.meta);
+  if (type === "DIRECT_DISCOUNT" && flag === "price") return reject(ADD_TEXT.AT2(id), pre.meta);
+  if (type === "FLASHSALE") return reject(ADD_TEXT.AT3(id), pre.meta);
+  if (type !== "FIXED_PRICE" && type !== "DIRECT_DISCOUNT") return reject(ADD_TEXT.AT4(id, type), pre.meta);
+  if (!ADD_ALLOWED_STATUS.includes(String(d.status))) return reject(ADD_TEXT.AS1(id, String(d.status), ADD_ALLOWED_STATUS.join(" / ")), pre.meta);
+  if (d.product_level !== "VARIATION") return reject(ADD_TEXT.AL1(id, String(d.product_level)), pre.meta);
+  const existing = existingSkuValues(d, field);
+  const same = [], diff = [];
+  const rest = [];
+  for (const it of items) {
+    if (!existing.has(it.sid)) {
+      rest.push(it);
+      continue;
+    }
+    const cur = existing.get(it.sid);
+    if (cur !== void 0 && Number(cur) === Number(it.amount)) same.push(it.sid);
+    else diff.push(it.sid);
+  }
+  const restCmd = addProductsCmd(shop, id, product, flag, rawItemsFor(raw, rest.map((r) => r.sid)), true);
+  if (diff.length) return reject(ADD_TEXT.AD1(id, diff.join("\u3001")) + (rest.length ? ADD_TEXT.AD1_REST(restCmd) : ""), pre.meta);
+  if (rest.length === 0) {
+    return { ok: true, data: { activity_id: id, readback: pre.data, note: ADD_TEXT.AD3(items.length, id) }, meta: pre.meta };
+  }
+  if (same.length) return reject(ADD_TEXT.AD2(id, same.join("\u3001"), restCmd), pre.meta);
+  const body = { activity_id: id, ...productsBodyFromItems(items, flag, productLimitsOf(d)) };
+  const put = await proxy("PUT", shop, `/promotion/202309/activities/${id}/products`, { body });
+  const rb = await proxy("GET", shop, `/promotion/202309/activities/${id}`, {});
+  const readback = rb.ok ? rb.data : { error: rb.error };
+  const c = rb.ok ? compareReadback(submitted, rb.data, field) : null;
+  const lost = c ? lostText(d, rb.data, field) : "";
+  const missingCmd = (apply) => addProductsCmd(shop, id, product, flag, rawItemsFor(raw, c?.missing ?? []), apply);
+  if (!put.ok) {
+    const { retry_after_s: _dropped, ...err } = put.error;
+    let note;
+    if (!c) note = ADD_TEXT.AN4(shop, id);
+    else if (c.missing.length === 0 && c.mismatched.length === 0) note = ADD_TEXT.AN1(submitted.length, id);
+    else if (c.missing.length === submitted.length) note = ADD_TEXT.AN2(id);
+    else note = ADD_TEXT.AN3(problemsText(c, field)) + (c.missing.length ? ADD_TEXT.AN3_MISS(missingCmd(false)) : "") + (c.mismatched.length ? ADD_TEXT.AN3_MIS : "");
+    if (lost) note += " " + ADD_TEXT.AW3(shop, id, lost);
+    return { ok: false, error: { ...err, retryable: false }, data: { activity_id: id, readback, note }, meta: put.meta };
+  }
+  const ours = [];
+  if (!c) ours.push(ADD_TEXT.AW1(shop, id));
+  else {
+    const problems = problemsText(c, field);
+    if (problems) ours.push(ADD_TEXT.AW2(id, problems) + (c.missing.length ? ADD_TEXT.AW2_MISS(missingCmd(true)) : ""));
+    if (lost) ours.push(ADD_TEXT.AW3(shop, id, lost));
+  }
+  const putData = put.data ?? {};
+  const data = { ...putData, activity_id: id, readback };
+  if (ours.length > 0) data.warnings = mergeWarnings(putData.warnings, ours);
+  return { ok: true, data, meta: put.meta };
 }
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/tiktok-cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "TikTok Shop CLI for Optima agents — 经 tiktok-backend 操作店铺",
   "type": "module",
   "bin": {