@optima-chat/tiktok-cli 0.11.0 → 0.13.0

package/README.md

@@ -25,7 +25,7 @@ tiktok <domain> <verb> --shop <shopId> [--flags]
 | `analytics shop` | 店铺经营数据（`--from --to`，默认近30天） |
 | `analytics products` | 商品维度数据（GMV 降序） |
 | `products list` | 商品列表 |
-| `promotions list` | 促销活动（`--status`） |
+| `promotions list` | 促销活动。`--status` **省略 = 全部状态**（`ONGOING`/`NOT_START`/`EXPIRED`/`DEACTIVATED`；⚠️ 值写错平台**静默忽略并返回全部**，故 CLI **本地硬拒未知值**；平台将来新增值可用 `--force-status` 越过）；`--page-size`（默认 20）；`--page-token` 翻页，**末页无 `next_page_token`** |
 | `finance statements` | 结算单 |
 
 ### 建品前置只读辅助（拼商品体用）

package/dist/index.js

@@ -33,7 +33,7 @@ function authHeaders() {
   return {};
 }
 function classify(status, body, shop) {
-  const meta = { shop, tiktok_request_id: body?.request_id };
+  const meta = { shop, tiktok_request_id: body?.request_id, http_status: status };
   if (status === 0 || body?.code === 0) {
     return { ok: true, data: body.data, meta };
   }
@@ -217,6 +217,7 @@ ${cmd.summary}
 var today = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 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 COMMANDS = [
   {
     name: "orders list",
@@ -598,11 +599,34 @@ var COMMANDS = [
   },
   {
     name: "promotions list",
-    summary: "\u4FC3\u9500\u6D3B\u52A8\u5217\u8868\uFF08--status ONGOING/NOT_START/EXPIRED\uFF09",
+    summary: "\u4FC3\u9500\u6D3B\u52A8\u5217\u8868\uFF08--status \u7701\u7565=\u5168\u90E8\u72B6\u6001\uFF5CONGOING/NOT_START/EXPIRED/DEACTIVATED\uFF0C\u53D6\u503C\u533A\u5206\u5927\u5C0F\u5199\u4E14\u4E0D trim\uFF0C\u672A\u77E5\u503C\u672C\u5730\u62D2\u3001\u5E73\u53F0\u4F1A\u9759\u9ED8\u8FD4\u56DE\u5168\u90E8\uFF1B--force-status \u8D8A\u8FC7\u672C\u5730\u6821\u9A8C\uFF1B--page-size \u9ED8\u8BA420\uFF1B--page-token \u7FFB\u9875\uFF0C\u672B\u9875\u65E0 next_page_token\uFF09",
     listKey: "activities",
-    run: ({ shop, args: args2 }) => proxy("POST", shop, "/promotion/202309/activities/search", {
-      body: { status: args2.status ?? "ONGOING", page_size: Number(args2["page-size"] ?? 20) }
-    })
+    run: ({ shop, args: args2 }) => {
+      const st = args2.status ? String(args2.status) : "";
+      if (st && !PROMOTION_STATUSES.has(st) && !args2["force-status"]) {
+        return Promise.resolve({
+          ok: false,
+          error: {
+            code: "VALIDATION",
+            message: `\u672A\u77E5\u7684 --status ${JSON.stringify(st)}\uFF1B\u5DF2\u77E5\u53D6\u503C\uFF1A${[...PROMOTION_STATUSES].join(" / ")}\u3002\u26A0\uFE0F \u5E73\u53F0\u5BF9\u8BA4\u4E0D\u51FA\u7684\u503C**\u4E0D\u62A5\u9519\uFF0C\u800C\u662F\u8FD4\u56DE\u5168\u90E8\u72B6\u6001** \u2014\u2014 \u6240\u4EE5\u8FD9\u91CC\u672C\u5730\u62D2\u6389\uFF0C\u26D4 \u4E0D\u53D1\u8BF7\u6C42\u3002`,
+            retryable: false
+          }
+        });
+      }
+      return proxy("POST", shop, "/promotion/202309/activities/search", {
+        body: {
+          // 🔴 省略 --status ⇒ body **不带 status 字段**（⛔ 不是传空串）⇒ 平台回全部状态。
+          //    实测（2026-09-19 cn-prod，YOHO Finds）：{page_size:100} 无 status → 51 条，
+          //    分布 {DEACTIVATED:38, ONGOING:13}；显式 DEACTIVATED → 38 条。
+          //    ⚠️ 原先硬默认 "ONGOING" 使「查全部」无法表达；已知调用点都显式传 --status，不破坏。
+          ...args2.status ? { status: String(args2.status) } : {},
+          page_size: Number(args2["page-size"] ?? 20),
+          // 照同文件 orders 的写法（有值才带）。实测 next_page_token="2"→"4" 可翻页、两页无重叠；
+          // **末页该键缺席**（不是空串）⇒ 下游可据此判「读全了」。
+          ...args2["page-token"] ? { page_token: String(args2["page-token"]) } : {}
+        }
+      });
+    }
   },
   {
     name: "finance statements",
@@ -742,6 +766,72 @@ var COMMANDS = [
     },
     readback: ({ shop, args: args2 }) => proxy("POST", shop, "/promotion/202309/activities/search", { body: { status: "NOT_START", page_size: 20 } })
   },
+  {
+    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",
+    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) }
+      ];
+    },
+    run: async ({ shop, args: args2 }) => {
+      const { begin, end } = discountWindow(args2);
+      const submitted = submittedSkus(args2);
+      const created = await proxy("POST", shop, "/promotion/202309/activities", { body: discountActivityBody(args2, begin, end) });
+      if (!created.ok) {
+        const err = created.error;
+        switch (createFailureVerdict(created)) {
+          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)}` } };
+          case "rejected":
+            return created;
+        }
+      }
+      const activityId = created.data?.activity_id;
+      if (!activityId) {
+        return {
+          ok: false,
+          error: { code: "TIKTOK_ERROR", message: DISCOUNT_TEXT.noCreateId(args2.title), retryable: false },
+          meta: created.meta
+        };
+      }
+      const withProducts = await proxy("PUT", shop, `/promotion/202309/activities/${activityId}/products`, {
+        body: { ...discountProductsBody(args2), activity_id: activityId }
+        // F5：body 里要重复传
+      });
+      const rb = await proxy("GET", shop, `/promotion/202309/activities/${activityId}`, {});
+      const readback = rb.ok ? rb.data : { error: rb.error };
+      if (!withProducts.ok) {
+        const { retry_after_s: _dropped, ...err } = withProducts.error;
+        let note;
+        const c = rb.ok ? compareReadback(submitted, rb.data) : 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);
+        }
+        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));
+      else {
+        const problems = problemsText(diff);
+        if (problems) ours.push(DISCOUNT_TEXT.readbackDiffers(activityId, problems));
+      }
+      const putData = withProducts.data ?? {};
+      const data = { ...putData, activity_id: activityId, readback };
+      if (ours.length > 0) data.warnings = mergeWarnings(putData.warnings, ours);
+      return { ok: true, data, meta: withProducts.meta };
+    }
+  },
   {
     name: "promotions deactivate",
     summary: "\u7EC8\u6B62/\u505C\u7528\u4FC3\u9500\u6D3B\u52A8\uFF08--id \u5FC5\u586B\uFF09\u3002\u4E0D\u53EF\u9006",
@@ -1157,6 +1247,246 @@ function findCommand(tokens) {
   }
   return null;
 }
+var DISCOUNT_FLAGS = ["shop", "apply", "actor", "title", "product", "price", "days"];
+var PRICE_ITEM = /^(?:([^:,\s/]+)\/)?([^:,\s/]+):(0|[1-9]\d*)(?:\.(\d{1,2}))?$/;
+function parsePriceItems(raw, defaultProduct) {
+  const items = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const part of raw.split(",")) {
+    const m = 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` };
+    }
+    const [, explicitPid, sid, intPart, frac] = 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>` };
+    }
+    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>` };
+    }
+    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}` };
+    seen.add(sid);
+    items.push({ pid, sid, amount });
+  }
+  return { ok: true, items };
+}
+function discountWindow(args2) {
+  const now = Math.floor(Date.now() / 1e3);
+  const begin = now + 900;
+  const end = begin + Number(args2.days ?? 180) * 86400;
+  return { begin, end };
+}
+function discountActivityBody(args2, begin, end) {
+  return {
+    title: args2.title,
+    activity_type: "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 : [];
+  const order = [];
+  const byPid = /* @__PURE__ */ new Map();
+  for (const it of items) {
+    if (!byPid.has(it.pid)) {
+      byPid.set(it.pid, []);
+      order.push(it.pid);
+    }
+    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
+      }))
+    }))
+  };
+}
+function discountHuman(args2) {
+  const parsed = parsePriceItems(args2.price ?? "", args2.product);
+  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";
+  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 { ok: false, message: `\u4E0D\u652F\u6301\u7684\u53C2\u6570 --${k}\uFF1B\u672C\u547D\u4EE4\u53EA\u8BA4 ${DISCOUNT_FLAGS.map((f) => "--" + f).join(" ")}` };
+  }
+  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"` };
+  }
+  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 (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` };
+  }
+  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 --price \u91CC\u5199 <productId>/<skuId>:<\u4EF7>" };
+  }
+  const parsed = parsePriceItems(args2.price, args2.product);
+  if (!parsed.ok) return parsed;
+  if ("days" in args2) {
+    const raw = args2.days;
+    const n = Number(raw);
+    if (!/^\d+$/.test(raw) || !(n >= 1 && n <= 180)) {
+      return { ok: false, message: `--days \u5FC5\u987B\u662F 1\u2013180 \u7684\u6574\u6570\uFF08\u6536\u5230\u300C${raw}\u300D\uFF09` };
+    }
+  }
+  return { ok: true };
+}
+var deactivateCmd = (shop, id) => `\`tiktok promotions deactivate --shop ${shop} --id ${id} --apply\``;
+var DISCOUNT_TEXT = {
+  // ⑤ 建壳可能已落。标题 = 幂等键：原标题重跑，最坏撞一次重名，不会多出一条活动。
+  maybeLanded: "\u26A0\uFE0F \u5EFA\u58F3\u8BF7\u6C42\u53EF\u80FD\u5DF2\u7ECF\u843D\u5230\u5E73\u53F0\u2014\u2014\u522B\u6362\u6807\u9898\uFF0C\u76F4\u63A5\u7528\u539F\u6807\u9898\u91CD\u8DD1\u539F\u547D\u4EE4\uFF1A\u6CA1\u843D\u5C31\u4F1A\u6B63\u5E38\u5EFA\u6210\uFF1B\u82E5\u5DF2\u843D\uFF0C\u91CD\u8DD1\u4F1A\u649E\u91CD\u540D\uFF0C\u90A3\u6761\u63D0\u793A\u4F1A\u544A\u8BC9\u4F60\u4E0B\u4E00\u6B65\u3002",
+  // ⑥
+  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`,
+  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`,
+  // ⑨ 成功路径的 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`,
+  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([
+  36009004,
+  36009009,
+  36009010,
+  17029001,
+  17029004,
+  17029010,
+  17029021,
+  17029022,
+  17029043,
+  17029044,
+  17029063,
+  105002,
+  106001,
+  105005
+]);
+var DUP_NAME_CODE = 17029004;
+function createFailureVerdict(env2) {
+  const err = env2.error;
+  const status = env2.meta?.http_status;
+  if (status === void 0) return "maybe_landed";
+  if (err.code === "RATE_LIMITED") return "maybe_landed";
+  if (status >= 500) return "maybe_landed";
+  const m = err.code === "TIKTOK_ERROR" ? /^\[(\d+)\]/.exec(err.message) : null;
+  const code = m ? Number(m[1]) : void 0;
+  if (status >= 400) return code === DUP_NAME_CODE ? "dup" : "rejected";
+  if (err.code === "AUTH_EXPIRED") return "rejected";
+  if (code !== void 0 && OBSERVED_REJECT_CODES.has(code)) return code === DUP_NAME_CODE ? "dup" : "rejected";
+  return "maybe_landed";
+}
+function submittedSkus(args2) {
+  return discountProductsBody(args2).products.flatMap((p) => p.skus.map((s) => ({ sid: s.id, amount: s.activity_price_amount })));
+}
+function compareReadback(submitted, readback) {
+  const products = readback?.products;
+  if (!Array.isArray(products)) return null;
+  const skus = products.flatMap((p) => Array.isArray(p?.skus) ? p.skus : []);
+  const mine = new Set(submitted.map((s) => s.sid));
+  const byId = /* @__PURE__ */ new Map();
+  const extra = [];
+  for (const s of skus) {
+    const id = String(s?.id);
+    if ((byId.has(id) || !mine.has(id)) && !extra.includes(id)) extra.push(id);
+    if (!byId.has(id)) byId.set(id, s);
+  }
+  const diff = { missing: [], mismatched: [], extra, total: skus.length, productCount: products.length };
+  for (const { sid, amount } of submitted) {
+    const hit = byId.get(sid);
+    if (!hit) {
+      diff.missing.push(sid);
+      continue;
+    }
+    const raw = 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) {
+  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")}`);
+  }
+  return parts.join("\uFF1B");
+}
+function mergeWarnings(existing, ours) {
+  if (existing === null || existing === void 0) return ours;
+  if (Array.isArray(existing)) return [...existing, ...ours];
+  return [existing, ...ours];
+}
+var DUP_SEARCH_MAX_PAGES = 10;
+async function dupSelfCheck(shop, title, submitted) {
+  const found = /* @__PURE__ */ new Map();
+  for (const status of ["NOT_START", "ONGOING"]) {
+    let token;
+    for (let page = 1; ; page++) {
+      const r = await proxy("POST", shop, "/promotion/202309/activities/search", {
+        body: { status, page_size: 50, ...token ? { page_token: token } : {} }
+      });
+      if (!r.ok) return DISCOUNT_TEXT.dupUnclear(title, r.error.message);
+      const d2 = r.data ?? {};
+      for (const a of Array.isArray(d2.activities) ? d2.activities : []) {
+        if (a?.title === title) found.set(String(a.id), { id: String(a.id), status: String(a.status) });
+      }
+      token = d2.next_page_token ? String(d2.next_page_token) : void 0;
+      if (!token) break;
+      if (page === DUP_SEARCH_MAX_PAGES) return DISCOUNT_TEXT.dupUnclear(title, `\u540C\u540D\u81EA\u67E5\u7FFB\u4E86 ${DUP_SEARCH_MAX_PAGES} \u9875\u4ECD\u672A\u7FFB\u5B8C`);
+    }
+  }
+  if (found.size === 0) return DISCOUNT_TEXT.dupRetitle(title);
+  if (found.size > 1) return DISCOUNT_TEXT.dupMulti(title, [...found.values()].sort((a, b) => Number(a.status !== "NOT_START") - Number(b.status !== "NOT_START")));
+  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);
+  if (!d) return DISCOUNT_TEXT.dupUnclear(title, "\u56DE\u8BFB\u7F3A products \u5B57\u6BB5");
+  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")}`);
+}
 
 // src/index.ts
 var NO_SHOP_COMMANDS = /* @__PURE__ */ new Set(["auth link", "apps add", "apps list", "apps disable", "apps available", "apps set-shop"]);
@@ -1182,7 +1512,7 @@ function parseFlags(tokens) {
   }
   return { args: args2, positional: positional2 };
 }
-var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["apply", "default", "unprocessed", "enable"]);
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["apply", "default", "unprocessed", "enable", "force-status"]);
 var FLAG_TRUE = /* @__PURE__ */ new Set(["true", "1", "yes", "on"]);
 var FLAG_FALSE = /* @__PURE__ */ new Set(["false", "0", "no", "off", ""]);
 function normalizeBooleanFlags(args2) {
@@ -1260,11 +1590,16 @@ if (!match) {
   usage();
   process.exit(1);
 }
+var ctx = { shop: args.shop ?? "", args, actor: args.actor, rest: match.rest };
+var verdict = match.cmd.validate?.(ctx);
+if (verdict && !verdict.ok) {
+  out({ ok: false, error: { code: "VALIDATION", message: verdict.message, retryable: false } });
+  process.exit(1);
+}
 if (!args.shop && !NO_SHOP_COMMANDS.has(match.cmd.name)) {
   out({ ok: false, error: { code: "VALIDATION", message: "\u7F3A\u5C11 --shop\uFF08\u591A\u5E97\u663E\u5F0F\u8DEF\u7531\uFF09", retryable: false } });
   process.exit(1);
 }
-var ctx = { shop: args.shop ?? "", args, actor: args.actor };
 if (match.cmd.write && !("apply" in args)) {
   if (match.cmd.precheck) {
     const pc = await match.cmd.precheck(ctx);
@@ -1290,7 +1625,7 @@ fillEmptyList(env.data, match.cmd.listKey);
 if (match.cmd.write && env.ok) {
   const result = { ...env, applied: true };
   if (env.data?.warnings?.length) {
-    result.warnings_alert = "\u26A0\uFE0F \u6709\u5B57\u6BB5\u88AB\u9759\u9ED8\u5904\u7406\uFF0C\u89C1 warnings";
+    result.warnings_alert = "\u26A0\uFE0F \u6709\u8B66\u544A\uFF0C\u89C1 data.warnings";
   }
   if (match.cmd.readback) {
     const rb = await match.cmd.readback(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/tiktok-cli",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "TikTok Shop CLI for Optima agents — 经 tiktok-backend 操作店铺",
   "type": "module",
   "bin": {
@@ -30,7 +30,8 @@
     "directory": "tiktok-cli"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "engines": {
     "node": ">=20"