@optima-chat/tiktok-cli 0.10.1 → 0.10.2

package/README.md

@@ -44,12 +44,28 @@ tiktok <domain> <verb> --shop <shopId> [--flags]
 | `delivery-options --warehouse <id>` | 仓库交付方式 |
 | `images upload --file <path> --use-case MAIN_IMAGE [--out <f>]` | 上传本地图 → 返回 TikTok CDN `uri`（multipart，供拼 `main_images` 用） |
 
+## 传参写法
+
+`--key value` 与 `--key=value` 等价，随便用哪种：
+
+```bash
+tiktok promotions create-flashsale --shop <id> --price 11.9    # 空格式
+tiktok promotions create-flashsale --shop=<id> --price=11.9    # 等号式
+```
+
+（0.10.2 之前只认空格式，等号式会让那一格参数**静默消失**而命令照报成功，见 #11。）
+
+**开关型 flag**（`--apply` / `--enable` / `--default` / `--unprocessed`）除了裸传，也能带值：
+`true`/`1`/`yes`/`on` 为真，`false`/`0`/`no`/`off`/空串为假（大小写不敏感），
+给它别的值**当场报错**而不是猜。同一个 flag 写两次以后者为准（`--apply=false --apply` 会真发）。
+
 ## 写操作（Phase 2，安全护栏）
 
 写命令三道阀，把 A 轨「填完回读」纪律做进 CLI：
 
 1. **默认 dry-run** —— 不加 `--apply` 只打印将提交的 payload，不碰真实店铺
-2. `--apply` 才真发
+2. `--apply` 才真发。它是开关，写成 `--apply=false` / `=0` / `=no` / `=off` 一样停在 dry-run；
+   `--apply=true` / `=1` / `=yes` / `=on` 才真发；给它一个看不懂的值（`--apply=maybe`）当场报错、不猜
 3. **成功后自动回读** —— 写完 GET 回资源，输出 `readback` 供 agent/人核对是否生效
 
 ```bash

package/dist/index.js

@@ -1045,7 +1045,7 @@ var COMMANDS = [
   // ── 多 App 管理（admin 配置操作，鉴权走 x-admin-token，不走商家 --shop，也不走三道阀 dry-run/--apply）──
   {
     name: "apps add",
-    summary: "\u767B\u8BB0\u4E00\u4E2A TikTok App\uFF08--service-id --app-key --app-secret --type --label\uFF0C[--markets a,b] [--redirect] [--owner-entity]\uFF09",
+    summary: "\u767B\u8BB0\u4E00\u4E2A TikTok App\uFF08--service-id --app-key --app-secret --type --label\uFF0C[--markets a,b] [--redirect] [--owner-entity] [--default]\uFF09",
     run: ({ args: args2 }) => adminApps("POST", {
       body: {
         serviceId: args2["service-id"],
@@ -1165,7 +1165,13 @@ function parseFlags(tokens) {
   const positional2 = [];
   for (let i = 0; i < tokens.length; i++) {
     const t = tokens[i];
+    if (t === "--") continue;
     if (t.startsWith("--")) {
+      const eq = t.indexOf("=");
+      if (eq !== -1) {
+        args2[t.slice(2, eq)] = t.slice(eq + 1);
+        continue;
+      }
       const key = t.slice(2);
       const next = tokens[i + 1];
       if (next && !next.startsWith("--")) {
@@ -1176,6 +1182,33 @@ function parseFlags(tokens) {
   }
   return { args: args2, positional: positional2 };
 }
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["apply", "default", "unprocessed", "enable"]);
+var FLAG_TRUE = /* @__PURE__ */ new Set(["true", "1", "yes", "on"]);
+var FLAG_FALSE = /* @__PURE__ */ new Set(["false", "0", "no", "off", ""]);
+function normalizeBooleanFlags(args2) {
+  for (const key of BOOLEAN_FLAGS) {
+    if (!(key in args2)) continue;
+    const raw = args2[key];
+    const v = raw.toLowerCase();
+    if (FLAG_TRUE.has(v)) {
+      args2[key] = "true";
+      continue;
+    }
+    if (FLAG_FALSE.has(v)) {
+      delete args2[key];
+      continue;
+    }
+    out({
+      ok: false,
+      error: {
+        code: "VALIDATION",
+        message: `--${key} \u662F\u5F00\u5173\uFF0C\u53EA\u63A5\u53D7 true/1/yes/on \u6216 false/0/no/off\uFF0C\u6536\u5230\u300C${raw}\u300D`,
+        retryable: false
+      }
+    });
+    process.exit(1);
+  }
+}
 function out(obj) {
   process.stdout.write(JSON.stringify(obj, null, 2) + "\n");
 }
@@ -1221,6 +1254,7 @@ if (wantsHelp) {
   else usage();
   process.exit(0);
 }
+normalizeBooleanFlags(args);
 if (!match) {
   out({ ok: false, error: { code: "VALIDATION", message: `\u672A\u77E5\u547D\u4EE4: ${positional.join(" ")}`, retryable: false } });
   usage();

package/package.json

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