beervid-app-cli 0.2.1 → 0.2.3

package/README.md

@@ -2,21 +2,32 @@
 
 BEERVID 第三方应用 Open API 的 TypeScript CLI 和 Claude Code Skill，提供 TikTok 视频发布、账号授权、数据查询等完整能力。
 
-## 安装
+## 安装与调用
 
-### npm CLI
+### 全局安装
 
 ```bash
 npm install -g beervid-app-cli
 beervid --help
 ```
 
-### Claude Code Skill
+### npx 免安装调用
 
-将本仓库克隆到 Claude Code 的 skills 目录：
+```bash
+npx beervid-app-cli --help
+npx beervid-app-cli config --show
+npx beervid-app-cli upload --file ./video.mp4
+```
+
+### node 直接调用
 
 ```bash
-git clone <repo-url> ~/.claude/skills/beervid-app-cli
+# 克隆仓库后先构建
+npm install && npm run build
+
+# 通过 node 运行入口文件
+node dist/cli.mjs --help
+node dist/cli.mjs config --show
 ```
 
 ## 配置

package/dist/cli.mjs

@@ -169,11 +169,11 @@ function register(cli2) {
       if (type === "tt") {
         const data = await openApiGet("/api/v1/open/thirdparty-auth/tt-url");
         console.log("TT OAuth \u6388\u6743\u94FE\u63A5:");
-        printResult({ type: "tt", url: data });
+        printResult(data);
       } else {
         const data = await openApiGet("/api/v1/open/thirdparty-auth/tts-url");
         console.log("TTS OAuth \u6388\u6743\u94FE\u63A5:");
-        printResult({ type: "tts", url: data.crossBorderUrl });
+        printResult(data);
       }
     } catch (err) {
       rethrowIfProcessExit(err);
@@ -451,7 +451,7 @@ function register5(cli2) {
 
 // src/commands/query-video.ts
 function register6(cli2) {
-  cli2.command("query-video", "\u67E5\u8BE2\u89C6\u9891\u7EDF\u8BA1\u6570\u636E").option("--business-id <id>", "TT \u8D26\u53F7 businessId\uFF08\u5FC5\u586B\uFF09").option("--item-ids <ids>", "\u89C6\u9891 ID\uFF0C\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF08\u5FC5\u586B\uFF09").action(
+  cli2.command("query-video", "\u67E5\u8BE2\u89C6\u9891\u7EDF\u8BA1\u6570\u636E").option("--business-id <id>", "TT \u8D26\u53F7 businessId\uFF08\u5FC5\u586B\uFF09").option("--item-ids <ids>", "\u89C6\u9891 ID\uFF0C\u652F\u6301\u91CD\u590D\u4F20\u53C2\u6216\u9017\u53F7\u5206\u9694\uFF08\u5FC5\u586B\uFF09").action(
     async (options) => {
       if (!options.businessId || !options.itemIds) {
         const missing = [
@@ -465,7 +465,7 @@ function register6(cli2) {
         );
         process.exit(1);
       }
-      const itemIds = options.itemIds.split(",").map((id) => id.trim()).filter(Boolean);
+      const itemIds = (Array.isArray(options.itemIds) ? options.itemIds : [options.itemIds]).flatMap((value) => value.split(",")).map((id) => id.trim()).filter(Boolean);
       if (itemIds.length === 0) {
         console.error("\u9519\u8BEF: --item-ids \u4E0D\u80FD\u4E3A\u7A7A");
         process.exit(1);
@@ -501,7 +501,7 @@ function register6(cli2) {
           if (v.shareUrl) console.log(`    \u94FE\u63A5: ${v.shareUrl}`);
           console.log("");
         }
-        printResult({ videos: normalized, _raw: data });
+        printResult(data);
       } catch (err) {
         rethrowIfProcessExit(err);
         console.error("\u67E5\u8BE2\u89C6\u9891\u6570\u636E\u5931\u8D25:", err.message);
@@ -511,134 +511,6 @@ function register6(cli2) {
   );
 }
 
-// src/commands/query-products.ts
-var VALID_PRODUCT_TYPES = ["shop", "showcase", "all"];
-function extractImageUrl(imageStr) {
-  const match = imageStr.match(/url=([^,}]+)/);
-  return match?.[1]?.trim() ?? imageStr;
-}
-async function queryProducts(creatorId, type, pageSize, pageToken) {
-  return openApiPost("/api/v1/open/tts/products/query", {
-    creatorUserOpenId: creatorId,
-    productType: type,
-    pageSize,
-    pageToken
-  });
-}
-function register7(cli2) {
-  cli2.command("query-products", "\u67E5\u8BE2 TTS \u5546\u54C1\u5217\u8868").option("--creator-id <id>", "TTS \u8D26\u53F7 creatorUserOpenId\uFF08\u5FC5\u586B\uFF09").option("--product-type <type>", "\u5546\u54C1\u6765\u6E90: shop / showcase / all\uFF08\u9ED8\u8BA4 all\uFF09").option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u9ED8\u8BA4 20\uFF09").option("--cursor <cursor>", "\u5206\u9875\u6E38\u6807\uFF08\u9996\u9875\u4E0D\u4F20\uFF09").action(
-    async (options) => {
-      if (!options.creatorId) {
-        console.error("\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: --creator-id\n");
-        console.error("\u7528\u6CD5: beervid query-products --creator-id <id>");
-        process.exit(1);
-      }
-      const creatorId = options.creatorId;
-      const productType = (options.productType ?? "all").toLowerCase();
-      const pageSize = parseInt(options.pageSize ?? "20", 10);
-      const cursor = options.cursor ?? "";
-      if (!VALID_PRODUCT_TYPES.includes(productType)) {
-        console.error("\u9519\u8BEF: --product-type \u5FC5\u987B\u4E3A shop\u3001showcase \u6216 all");
-        process.exit(1);
-      }
-      if (Number.isNaN(pageSize) || pageSize <= 0) {
-        console.error("\u9519\u8BEF: --page-size \u5FC5\u987B\u4E3A\u5927\u4E8E 0 \u7684\u6574\u6570");
-        process.exit(1);
-      }
-      try {
-        let shopToken = "";
-        let showcaseToken = "";
-        if (cursor) {
-          try {
-            const decoded = JSON.parse(
-              Buffer.from(cursor, "base64").toString()
-            );
-            shopToken = decoded.shopToken ?? "";
-            showcaseToken = decoded.showcaseToken ?? "";
-          } catch {
-            console.error("\u9519\u8BEF: \u65E0\u6548\u7684 cursor \u683C\u5F0F");
-            process.exit(1);
-          }
-        }
-        const typesToQuery = productType === "all" ? ["shop", "showcase"] : [productType];
-        const allProducts = /* @__PURE__ */ new Map();
-        let nextShopToken = null;
-        let nextShowcaseToken = null;
-        let successCount = 0;
-        const results = await Promise.allSettled(
-          typesToQuery.map(async (type) => {
-            const token = type === "shop" ? shopToken : showcaseToken;
-            const data = await queryProducts(creatorId, type, pageSize, token);
-            return { type, data };
-          })
-        );
-        for (const result of results) {
-          if (result.status === "rejected") {
-            console.error("\u67E5\u8BE2\u5931\u8D25:", result.reason?.message);
-            continue;
-          }
-          const { type, data } = result.value;
-          successCount += 1;
-          const items = Array.isArray(data) ? data : [data];
-          for (const group of items) {
-            if (type === "shop") nextShopToken = group.nextPageToken ?? null;
-            if (type === "showcase") nextShowcaseToken = group.nextPageToken ?? null;
-            for (const product of group.products ?? []) {
-              if (!allProducts.has(product.id)) {
-                allProducts.set(product.id, {
-                  id: product.id,
-                  title: product.title,
-                  price: product.price,
-                  images: (product.images ?? []).map(extractImageUrl),
-                  salesCount: product.salesCount ?? 0,
-                  brandName: product.brandName ?? "",
-                  shopName: product.shopName ?? "",
-                  source: product.source ?? type,
-                  reviewStatus: product.reviewStatus,
-                  inventoryStatus: product.inventoryStatus
-                });
-              }
-            }
-          }
-        }
-        if (successCount === 0) {
-          console.error("\u67E5\u8BE2\u5546\u54C1\u5931\u8D25: \u6240\u6709\u5546\u54C1\u6E90\u90FD\u8BF7\u6C42\u5931\u8D25");
-          process.exit(1);
-        }
-        const productList = Array.from(allProducts.values());
-        let nextCursor = null;
-        if (nextShopToken || nextShowcaseToken) {
-          nextCursor = Buffer.from(
-            JSON.stringify({
-              shopToken: nextShopToken ?? "",
-              showcaseToken: nextShowcaseToken ?? ""
-            })
-          ).toString("base64");
-        }
-        console.log(`\u67E5\u8BE2\u5230 ${productList.length} \u4E2A\u5546\u54C1:
-`);
-        for (const p of productList) {
-          console.log(`  [${p.source}] ${p.title}`);
-          console.log(`    ID: ${p.id}  \u9500\u91CF: ${p.salesCount}  \u54C1\u724C: ${p.brandName}`);
-          if (p.images.length > 0) console.log(`    \u56FE\u7247: ${p.images[0]}`);
-          console.log("");
-        }
-        if (nextCursor) {
-          console.log(`\u4E0B\u4E00\u9875\u6E38\u6807: ${nextCursor}`);
-          console.log(`\u4F7F\u7528: beervid query-products --creator-id ${creatorId} --cursor ${nextCursor}`);
-        } else {
-          console.log("\u5DF2\u5230\u6700\u540E\u4E00\u9875");
-        }
-        printResult({ products: productList, nextCursor });
-      } catch (err) {
-        rethrowIfProcessExit(err);
-        console.error("\u67E5\u8BE2\u5546\u54C1\u5931\u8D25:", err.message);
-        process.exit(1);
-      }
-    }
-  );
-}
-
 // src/workflows/index.ts
 import { createInterface } from "readline/promises";
 import { stdin as input, stdout as output } from "process";
@@ -709,23 +581,6 @@ async function pollNormalVideoStatus(businessId, shareId, intervalSec, maxPolls)
     raw: lastData
   };
 }
-function normalizeVideoQuery(data) {
-  const list = data.videoList ?? data.videos ?? [];
-  const videos = list.map((video) => ({
-    itemId: video.itemId ?? video.item_id,
-    videoViews: video.videoViews ?? video.video_views ?? 0,
-    likes: video.likes ?? 0,
-    comments: video.comments ?? 0,
-    shares: video.shares ?? 0,
-    thumbnailUrl: video.thumbnailUrl ?? video.thumbnail_url ?? "",
-    shareUrl: video.shareUrl ?? video.share_url ?? ""
-  }));
-  return {
-    attempts: 1,
-    videos,
-    raw: data
-  };
-}
 async function queryVideoWithRetry(businessId, itemId, intervalSec, maxAttempts) {
   const warnings = [];
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
@@ -733,10 +588,9 @@ async function queryVideoWithRetry(businessId, itemId, intervalSec, maxAttempts)
       businessId,
       itemIds: [itemId]
     });
-    const normalized = normalizeVideoQuery(data);
-    normalized.attempts = attempt;
-    if (normalized.videos.length > 0) {
-      return { query: normalized, warnings };
+    const list = data.videoList ?? data.videos ?? [];
+    if (list.length > 0) {
+      return { query: data, warnings };
     }
     if (attempt < maxAttempts) {
       await sleep2(intervalSec * 1e3);
@@ -748,25 +602,31 @@ async function queryVideoWithRetry(businessId, itemId, intervalSec, maxAttempts)
   });
   return { query: null, warnings };
 }
-function extractImageUrl2(imageStr) {
+function extractImageUrl(imageStr) {
   const match = imageStr.match(/url=([^,}]+)/);
   return match?.[1]?.trim() ?? imageStr;
 }
 function decodeCursor(cursor) {
   const decoded = JSON.parse(Buffer.from(cursor, "base64").toString());
   return {
-    shopToken: decoded.shopToken ?? "",
-    showcaseToken: decoded.showcaseToken ?? ""
+    shopToken: decoded.shopToken === void 0 ? "" : decoded.shopToken,
+    showcaseToken: decoded.showcaseToken === void 0 ? "" : decoded.showcaseToken
   };
 }
 function encodeCursor(cursor) {
+  if (cursor.shopToken === null && cursor.showcaseToken === null) return null;
   return Buffer.from(JSON.stringify(cursor)).toString("base64");
 }
 async function queryProductsPage(creatorId, productType, pageSize, cursor) {
-  const typesToQuery = productType === "all" ? ["shop", "showcase"] : [productType];
+  const allTypesToQuery = productType === "all" ? ["shop", "showcase"] : [productType];
+  const typesToQuery = allTypesToQuery.filter((type) => {
+    const token = type === "shop" ? cursor.shopToken : cursor.showcaseToken;
+    return token !== null;
+  });
   const allProducts = /* @__PURE__ */ new Map();
-  let nextShopToken = "";
-  let nextShowcaseToken = "";
+  const rawGroups = [];
+  let nextShopToken = cursor.shopToken;
+  let nextShowcaseToken = cursor.showcaseToken;
   let successCount = 0;
   const failedSources = [];
   const results = await Promise.allSettled(
@@ -776,7 +636,7 @@ async function queryProductsPage(creatorId, productType, pageSize, cursor) {
         creatorUserOpenId: creatorId,
         productType: type,
         pageSize,
-        pageToken
+        pageToken: pageToken ?? ""
       });
       return { type, data };
     })
@@ -792,16 +652,18 @@ async function queryProductsPage(creatorId, productType, pageSize, cursor) {
     successCount += 1;
     const { data } = result.value;
     const groups = Array.isArray(data) ? data : [data];
+    rawGroups.push(...groups);
     for (const group of groups) {
-      if (type === "shop") nextShopToken = group.nextPageToken ?? "";
-      if (type === "showcase") nextShowcaseToken = group.nextPageToken ?? "";
+      const token = group.nextPageToken === void 0 ? null : group.nextPageToken;
+      if (type === "shop") nextShopToken = token;
+      if (type === "showcase") nextShowcaseToken = token;
       for (const product of group.products ?? []) {
         if (!allProducts.has(product.id)) {
           allProducts.set(product.id, {
             id: product.id,
             title: product.title,
             price: product.price,
-            images: (product.images ?? []).map(extractImageUrl2),
+            images: (product.images ?? []).map(extractImageUrl),
             salesCount: product.salesCount ?? 0,
             brandName: product.brandName ?? "",
             shopName: product.shopName ?? "",
@@ -813,9 +675,10 @@ async function queryProductsPage(creatorId, productType, pageSize, cursor) {
       }
     }
   }
-  const nextCursor = nextShopToken || nextShowcaseToken ? encodeCursor({ shopToken: nextShopToken, showcaseToken: nextShowcaseToken }) : null;
+  const nextCursor = encodeCursor({ shopToken: nextShopToken, showcaseToken: nextShowcaseToken });
   return {
     products: Array.from(allProducts.values()),
+    rawGroups,
     nextCursor,
     successCount,
     failedSources
@@ -823,6 +686,7 @@ async function queryProductsPage(creatorId, productType, pageSize, cursor) {
 }
 async function fetchProductPool(creatorId, productType, pageSize, maxPages) {
   const allProducts = /* @__PURE__ */ new Map();
+  const rawGroups = [];
   let cursor = { shopToken: "", showcaseToken: "" };
   let nextCursor = null;
   let pagesScanned = 0;
@@ -836,6 +700,7 @@ async function fetchProductPool(creatorId, productType, pageSize, maxPages) {
       failedSourcesSet.add(src);
     }
     pagesScanned = page;
+    rawGroups.push(...pageResult.rawGroups);
     for (const product of pageResult.products) {
       if (!allProducts.has(product.id)) {
         allProducts.set(product.id, product);
@@ -849,6 +714,7 @@ async function fetchProductPool(creatorId, productType, pageSize, maxPages) {
   }
   return {
     products: Array.from(allProducts.values()),
+    rawGroups,
     summary: {
       productType,
       pageSize,
@@ -860,27 +726,23 @@ async function fetchProductPool(creatorId, productType, pageSize, maxPages) {
     }
   };
 }
-function sortProductsForSelection(products) {
-  return [...products].sort((a, b) => b.salesCount - a.salesCount);
+function isProductPublishable(product) {
+  if (product.reviewStatus && product.reviewStatus.toUpperCase() !== "APPROVED") return false;
+  if (product.inventoryStatus && product.inventoryStatus.toUpperCase() !== "IN_STOCK") return false;
+  return true;
 }
-function buildSelectedProductSummary(product, selectionMode) {
-  return {
-    selectionMode,
-    id: product.id,
-    title: product.title,
-    salesCount: product.salesCount,
-    source: product.source,
-    price: product.price,
-    brandName: product.brandName,
-    shopName: product.shopName
-  };
+function sortProductsForSelection(products) {
+  return products.filter(isProductPublishable).sort((a, b) => b.salesCount - a.salesCount);
 }
 async function promptForProductSelection(products) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("\u4EA4\u4E92\u6A21\u5F0F\u9700\u8981\u5728 TTY \u7EC8\u7AEF\u4E2D\u8FD0\u884C");
   }
-  const candidates = sortProductsForSelection(products).slice(0, 20);
-  console.log(`\u53EF\u9009\u5546\u54C1\uFF08\u5C55\u793A\u524D ${candidates.length} \u4E2A\uFF0C\u6309\u9500\u91CF\u964D\u5E8F\uFF09\uFF1A`);
+  const candidates = products.filter(isProductPublishable).sort((a, b) => b.salesCount - a.salesCount).slice(0, 20);
+  if (candidates.length === 0) {
+    throw new Error("\u5F53\u524D\u5546\u54C1\u6C60\u4E2D\u6CA1\u6709\u53EF\u53D1\u5E03\u5546\u54C1\uFF08\u5BA1\u6838\u672A\u901A\u8FC7\u6216\u65E0\u5E93\u5B58\uFF09\uFF0C\u5982\u9700\u5F3A\u5236\u6307\u5B9A\u8BF7\u4F7F\u7528 --product-id/--product-title");
+  }
+  console.log(`\u53EF\u9009\u5546\u54C1\uFF08\u5C55\u793A\u524D ${candidates.length} \u4E2A\uFF0C\u6309\u9500\u91CF\u964D\u5E8F\uFF0C\u5DF2\u8FC7\u6EE4\u4E0D\u53EF\u53D1\u5E03\u5546\u54C1\uFF09\uFF1A`);
   for (const [index, product] of candidates.entries()) {
     console.log(
       `${index + 1}. [${product.source}] ${product.title} | ID: ${product.id} | \u9500\u91CF: ${product.salesCount}`
@@ -904,6 +766,73 @@ async function promptForProductSelection(products) {
   }
 }
 
+// src/commands/query-products.ts
+var VALID_PRODUCT_TYPES = ["shop", "showcase", "all"];
+function register7(cli2) {
+  cli2.command("query-products", "\u67E5\u8BE2 TTS \u5546\u54C1\u5217\u8868").option("--creator-id <id>", "TTS \u8D26\u53F7 creatorUserOpenId\uFF08\u5FC5\u586B\uFF09").option("--product-type <type>", "\u5546\u54C1\u6765\u6E90: shop / showcase / all\uFF08\u9ED8\u8BA4 all\uFF09").option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u9ED8\u8BA4 20\uFF09").option("--cursor <cursor>", "\u5206\u9875\u6E38\u6807\uFF08\u9996\u9875\u4E0D\u4F20\uFF09").action(
+    async (options) => {
+      if (!options.creatorId) {
+        console.error("\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: --creator-id\n");
+        console.error("\u7528\u6CD5: beervid query-products --creator-id <id>");
+        process.exit(1);
+      }
+      const creatorId = options.creatorId;
+      const productType = (options.productType ?? "all").toLowerCase();
+      const pageSize = parseInt(options.pageSize ?? "20", 10);
+      const cursor = options.cursor ?? "";
+      if (!VALID_PRODUCT_TYPES.includes(productType)) {
+        console.error("\u9519\u8BEF: --product-type \u5FC5\u987B\u4E3A shop\u3001showcase \u6216 all");
+        process.exit(1);
+      }
+      if (Number.isNaN(pageSize) || pageSize <= 0) {
+        console.error("\u9519\u8BEF: --page-size \u5FC5\u987B\u4E3A\u5927\u4E8E 0 \u7684\u6574\u6570");
+        process.exit(1);
+      }
+      try {
+        let inputCursor = { shopToken: "", showcaseToken: "" };
+        if (cursor) {
+          try {
+            inputCursor = decodeCursor(cursor);
+          } catch {
+            console.error("\u9519\u8BEF: \u65E0\u6548\u7684 cursor \u683C\u5F0F");
+            process.exit(1);
+          }
+        }
+        const pageResult = await queryProductsPage(
+          creatorId,
+          productType,
+          pageSize,
+          inputCursor
+        );
+        if (pageResult.successCount === 0 && pageResult.failedSources.length > 0) {
+          console.error("\u67E5\u8BE2\u5546\u54C1\u5931\u8D25: \u6240\u6709\u5546\u54C1\u6E90\u90FD\u8BF7\u6C42\u5931\u8D25");
+          process.exit(1);
+        }
+        const productList = pageResult.products;
+        console.log(`\u67E5\u8BE2\u5230 ${productList.length} \u4E2A\u5546\u54C1:
+`);
+        for (const p of productList) {
+          console.log(`  [${p.source}] ${p.title}`);
+          console.log(`    ID: ${p.id}  \u9500\u91CF: ${p.salesCount}  \u54C1\u724C: ${p.brandName}`);
+          if (p.images.length > 0) console.log(`    \u56FE\u7247: ${p.images[0]}`);
+          console.log("");
+        }
+        if (pageResult.nextCursor) {
+          console.log(`\u4E0B\u4E00\u9875\u6E38\u6807: ${pageResult.nextCursor}`);
+          console.log(`\u4F7F\u7528: beervid query-products --creator-id ${creatorId} --cursor ${pageResult.nextCursor}`);
+        } else {
+          console.log("\u5DF2\u5230\u6700\u540E\u4E00\u9875");
+        }
+        printResult(pageResult.rawGroups);
+      } catch (err) {
+        rethrowIfProcessExit(err);
+        console.error("\u67E5\u8BE2\u5546\u54C1\u5931\u8D25:", err.message);
+        process.exit(1);
+      }
+    }
+  );
+}
+
 // src/commands/publish-tt-flow.ts
 function parsePositiveInt(value, optionName, defaultValue) {
   const parsed = parseInt(value ?? `${defaultValue}`, 10);
@@ -953,7 +882,6 @@ function register8(cli2) {
           intervalSec,
           maxPolls
         );
-        const warnings = [];
         const videoId = status.postIds[0] ?? null;
         let query = null;
         if (status.finalStatus === "PUBLISH_COMPLETE" && videoId) {
@@ -965,18 +893,16 @@ function register8(cli2) {
             queryMaxAttempts
           );
           query = queryResult.query;
-          warnings.push(...queryResult.warnings);
+          for (const warning of queryResult.warnings) {
+            console.warn(warning.message);
+          }
         }
-        const result = {
-          flowType: "tt",
+        printResult({
           upload,
           publish,
-          status,
-          videoId,
-          query,
-          warnings
-        };
-        printResult(result);
+          status: status.raw,
+          query
+        });
         if (status.finalStatus === "FAILED") {
           process.exit(1);
         }
@@ -1059,58 +985,62 @@ function register9(cli2) {
       );
       try {
         console.log("\u5F00\u59CB\u6267\u884C TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B...");
-        console.log("1/4 \u6B63\u5728\u67E5\u8BE2\u5546\u54C1\u5217\u8868...");
-        const productPool = await fetchProductPool(
-          options.creatorId,
-          productType,
-          pageSize,
-          maxProductPages
-        );
-        const warnings = [];
-        if (productPool.summary.reachedPageLimit && productPool.summary.nextCursor) {
-          warnings.push({
-            code: "PRODUCT_SCAN_LIMIT_REACHED",
-            message: `\u5546\u54C1\u626B\u63CF\u5DF2\u8FBE\u5230\u9875\u6570\u4E0A\u9650 ${maxProductPages}\uFF0C\u4ECD\u5B58\u5728\u672A\u62C9\u53D6\u5206\u9875`
-          });
-        }
-        if (productPool.summary.failedSources.length > 0) {
-          warnings.push({
-            code: "PRODUCT_SOURCE_PARTIAL_FAILURE",
-            message: `\u4EE5\u4E0B\u5546\u54C1\u6E90\u8BF7\u6C42\u5931\u8D25: ${productPool.summary.failedSources.join(", ")}\uFF0C\u5546\u54C1\u6C60\u53EF\u80FD\u4E0D\u5B8C\u6574`
-          });
-        }
-        if (productPool.products.length === 0) {
-          console.error("TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\u5931\u8D25: \u5F53\u524D\u5546\u54C1\u6C60\u4E3A\u7A7A\uFF0C\u65E0\u6CD5\u9009\u62E9\u5546\u54C1");
-          process.exit(1);
-        }
-        let selectionMode = "automatic";
         let selectedProduct;
-        if (options.productId) {
-          selectionMode = "manual";
-          const matchedProduct = productPool.products.find(
-            (product) => product.id === options.productId
+        let queriedProducts = null;
+        if (options.productId && options.productTitle) {
+          console.log("1/4 \u5DF2\u624B\u52A8\u6307\u5B9A\u5546\u54C1\uFF0C\u8DF3\u8FC7\u5546\u54C1\u67E5\u8BE2...");
+          selectedProduct = buildManualProduct(options.productId, options.productTitle);
+        } else {
+          console.log("1/4 \u6B63\u5728\u67E5\u8BE2\u5546\u54C1\u5217\u8868...");
+          const productPool = await fetchProductPool(
+            options.creatorId,
+            productType,
+            pageSize,
+            maxProductPages
           );
-          const resolvedTitle = options.productTitle ?? matchedProduct?.title;
-          if (!resolvedTitle) {
-            console.error(
-              "\u9519\u8BEF: \u624B\u52A8\u6307\u5B9A --product-id \u65F6\uFF0C\u5982\u65E0\u6CD5\u4ECE\u5DF2\u626B\u63CF\u5546\u54C1\u6C60\u8865\u9F50\u6807\u9898\uFF0C\u5219\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 --product-title"
+          queriedProducts = productPool.rawGroups;
+          if (productPool.summary.reachedPageLimit && productPool.summary.nextCursor) {
+            console.warn(`\u5546\u54C1\u626B\u63CF\u5DF2\u8FBE\u5230\u9875\u6570\u4E0A\u9650 ${maxProductPages}\uFF0C\u4ECD\u5B58\u5728\u672A\u62C9\u53D6\u5206\u9875`);
+          }
+          if (productPool.summary.failedSources.length > 0) {
+            console.warn(
+              `\u4EE5\u4E0B\u5546\u54C1\u6E90\u8BF7\u6C42\u5931\u8D25: ${productPool.summary.failedSources.join(", ")}\uFF0C\u5546\u54C1\u6C60\u53EF\u80FD\u4E0D\u5B8C\u6574`
             );
-            process.exit(1);
           }
-          selectedProduct = buildManualProduct(options.productId, resolvedTitle, matchedProduct);
-          if (!matchedProduct) {
-            warnings.push({
-              code: "PRODUCT_NOT_IN_SCANNED_POOL",
-              message: "\u624B\u52A8\u6307\u5B9A\u7684\u5546\u54C1 ID \u672A\u51FA\u73B0\u5728\u5DF2\u626B\u63CF\u5546\u54C1\u6C60\u4E2D\uFF0C\u5DF2\u4F7F\u7528\u663E\u5F0F\u53C2\u6570\u7EE7\u7EED\u53D1\u5E03"
-            });
+          if (options.productId) {
+            const matchedProduct = productPool.products.find(
+              (product) => product.id === options.productId
+            );
+            const resolvedTitle = matchedProduct?.title;
+            if (!resolvedTitle) {
+              console.error(
+                "\u9519\u8BEF: \u624B\u52A8\u6307\u5B9A --product-id \u65F6\uFF0C\u5982\u65E0\u6CD5\u4ECE\u5DF2\u626B\u63CF\u5546\u54C1\u6C60\u8865\u9F50\u6807\u9898\uFF0C\u5219\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 --product-title"
+              );
+              process.exit(1);
+            }
+            selectedProduct = buildManualProduct(options.productId, resolvedTitle, matchedProduct);
+          } else if (options.interactive) {
+            if (productPool.products.length === 0) {
+              console.error("TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\u5931\u8D25: \u5F53\u524D\u5546\u54C1\u6C60\u4E3A\u7A7A\uFF0C\u65E0\u6CD5\u9009\u62E9\u5546\u54C1");
+              process.exit(1);
+            }
+            console.log("2/4 \u8BF7\u9009\u62E9\u8981\u6302\u8F66\u7684\u5546\u54C1...");
+            selectedProduct = await promptForProductSelection(productPool.products);
+          } else {
+            if (productPool.products.length === 0) {
+              console.error("TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\u5931\u8D25: \u5F53\u524D\u5546\u54C1\u6C60\u4E3A\u7A7A\uFF0C\u65E0\u6CD5\u9009\u62E9\u5546\u54C1");
+              process.exit(1);
+            }
+            console.log("2/4 \u6B63\u5728\u81EA\u52A8\u9009\u62E9\u5546\u54C1\uFF08\u6309\u9500\u91CF\u6700\u9AD8\u4F18\u5148\uFF09...");
+            const publishable = sortProductsForSelection(productPool.products);
+            if (publishable.length === 0) {
+              console.error(
+                "TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\u5931\u8D25: \u5546\u54C1\u6C60\u4E2D\u6CA1\u6709\u53EF\u53D1\u5E03\u5546\u54C1\uFF08\u5BA1\u6838\u672A\u901A\u8FC7\u6216\u65E0\u5E93\u5B58\uFF09\uFF0C\u5982\u9700\u5F3A\u5236\u6307\u5B9A\u8BF7\u4F7F\u7528 --product-id/--product-title"
+              );
+              process.exit(1);
+            }
+            selectedProduct = publishable[0];
           }
-        } else if (options.interactive) {
-          selectionMode = "interactive";
-          console.log("2/4 \u8BF7\u9009\u62E9\u8981\u6302\u8F66\u7684\u5546\u54C1...");
-          selectedProduct = await promptForProductSelection(productPool.products);
-        } else {
-          console.log("2/4 \u6B63\u5728\u81EA\u52A8\u9009\u62E9\u5546\u54C1\uFF08\u6309\u9500\u91CF\u6700\u9AD8\u4F18\u5148\uFF09...");
-          selectedProduct = sortProductsForSelection(productPool.products)[0];
         }
         console.log("3/4 \u6B63\u5728\u4E0A\u4F20\u6302\u8F66\u89C6\u9891...");
         const upload = await uploadTtsVideo(options.file, options.creatorId, options.token);
@@ -1123,20 +1053,14 @@ function register9(cli2) {
           options.caption
         );
         if (publishResult.productTitle !== selectedProduct.title) {
-          warnings.push({
-            code: "PRODUCT_TITLE_TRUNCATED",
-            message: "\u5546\u54C1\u6807\u9898\u8D85\u8FC7 29 \u5B57\u7B26\uFF0C\u53D1\u5E03\u65F6\u5DF2\u81EA\u52A8\u622A\u65AD"
-          });
+          console.warn("\u5546\u54C1\u6807\u9898\u8D85\u8FC7 29 \u5B57\u7B26\uFF0C\u53D1\u5E03\u65F6\u5DF2\u81EA\u52A8\u622A\u65AD");
         }
-        const result = {
-          flowType: "tts",
-          productQuery: productPool.summary,
-          selectedProduct: buildSelectedProductSummary(selectedProduct, selectionMode),
+        printResult({
+          products: queriedProducts,
+          selectedProduct,
           upload,
-          publish: publishResult.publish,
-          warnings
-        };
-        printResult(result);
+          publish: publishResult.publish
+        });
       } catch (err) {
         rethrowIfProcessExit(err);
         console.error("TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\u5931\u8D25:", err.message);
@@ -1187,7 +1111,7 @@ function register10(cli2) {
 
 // src/cli.ts
 var cli = cac("beervid");
-var cliVersion = true ? "0.2.1" : pkg.version;
+var cliVersion = true ? "0.2.3" : pkg.version;
 register10(cli);
 register(cli);
 register2(cli);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beervid-app-cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "BEERVID App CLI — TikTok video publish, account auth, and data query",
   "type": "module",
   "engines": {