beervid-app-cli 0.2.3 → 0.2.5

package/README.md

@@ -30,6 +30,40 @@ node dist/cli.mjs --help
 node dist/cli.mjs config --show
 ```
 
+### 在 Claude Code / Codex / Antigravity 中使用（以下说明面向 AI Agent）
+
+#### 方式一：通过 `npx skills add` 安装（推荐）
+
+```bash
+npx skills add Lupeiwen0/beervid-app-cli
+```
+
+安装后 Skill 会自动注册到你的 skills 目录中，Claude Code 等 Agent 即可发现和调用。
+
+#### 方式二：手动安装
+
+如果你是 Claude Code、Codex、Antigravity，或任何支持 Skill 的 AI Agent，请严格按下面规则执行：
+
+- 用户把 GitHub 仓库链接发给你，**不等于**这个 Skill 已经安装到你的 skills 目录中。
+- 只有当 `skills/beervid-app-cli/` 目录被完整安装到你的 skills 目录后，才算这个 Skill 可用。
+
+你必须先把以下目录复制到你自己的 skills 目录中：
+
+```text
+skills/beervid-app-cli/
+  SKILL.md
+  references/
+  docs/
+  example/
+```
+
+安装完成后，你应从 skills 目录中的 `SKILL.md` 加载本 Skill，而不是只读取仓库根目录里的 `README.md` 或 `package.json`。
+
+对 AI Agent 来说，应这样区分：
+
+- 目标是使用 CLI：安装 npm 包即可。
+- 目标是使用 Skill：必须额外安装 Skill 文件；仓库链接本身不完成这一步。
+
 ## 配置
 
 ```bash
@@ -83,4 +117,26 @@ beervid publish-tts-flow --creator-id open_user_abc --file ./video.mp4 --interac
 beervid publish-tts-flow --creator-id open_user_abc --file ./video.mp4 --product-id prod_123 --product-title "Widget"
 ```
 
-详细用法见 [SKILL.md](./SKILL.md)。完整 API 参考见 [references/api-reference.md](./references/api-reference.md)。
+详细用法见 [SKILL.md](./skills/beervid-app-cli/SKILL.md)。完整 API 参考见 [references/api-reference.md](./skills/beervid-app-cli/references/api-reference.md)。
+
+## 落地文档
+
+面向接入方后端工程师的项目落地建议：
+
+| 文档 | 内容 |
+|------|------|
+| [数据表字段建议](./skills/beervid-app-cli/docs/database-schema.md) | accounts/videos/products 表结构设计 |
+| [OAuth 回调存储建议](./skills/beervid-app-cli/docs/oauth-callback.md) | State Token 防 CSRF、回调持久化、异步头像同步 |
+| [TT 轮询任务建议](./skills/beervid-app-cli/docs/tt-poll-task.md) | 阶梯递增轮询间隔、Cron/队列三层保障 |
+| [TTS 商品缓存建议](./skills/beervid-app-cli/docs/tts-product-cache.md) | 全量拉取、缓存过期、图片 URL 解析 |
+| [失败重试与幂等建议](./skills/beervid-app-cli/docs/retry-and-idempotency.md) | 各 API 幂等性分析、指数退避、幂等键设计 |
+
+## 示例工程
+
+三种接入场景的可运行示例：
+
+| 示例 | 场景 | 入口 |
+|------|------|------|
+| [Standard](./skills/beervid-app-cli/example/standard/) | 纯 Node.js 脚本，快速验证 | `npx tsx tt-publish-flow.ts` |
+| [Express](./skills/beervid-app-cli/example/express/) | Express 后端服务，含 OAuth 回调 | `npx tsx server.ts` |
+| [Next.js](./skills/beervid-app-cli/example/nextjs/) | Next.js App Router API Route | `npm run dev` |

package/dist/cli.mjs

@@ -151,6 +151,28 @@ function rethrowIfProcessExit(error) {
     throw error;
   }
 }
+function getRawOptionValues(rawArgs, optionName) {
+  const values = [];
+  const prefix = `${optionName}=`;
+  for (let i = 0; i < rawArgs.length; i++) {
+    const arg = rawArgs[i];
+    if (arg === optionName) {
+      const next = rawArgs[i + 1];
+      if (typeof next === "string" && !next.startsWith("-")) {
+        values.push(next);
+        i++;
+      }
+      continue;
+    }
+    if (arg.startsWith(prefix)) {
+      values.push(arg.slice(prefix.length));
+    }
+  }
+  return values;
+}
+function getRawOptionValue(rawArgs, optionName) {
+  return getRawOptionValues(rawArgs, optionName).at(-1);
+}
 
 // src/commands/oauth.ts
 function register(cli2) {
@@ -186,8 +208,9 @@ function register(cli2) {
 // src/commands/account.ts
 function register2(cli2) {
   cli2.command("get-account-info", "\u67E5\u8BE2 TikTok \u8D26\u53F7\u4FE1\u606F").option("--type <type>", "\u8D26\u53F7\u7C7B\u578B: TT \u6216 TTS").option("--account-id <id>", "\u8D26\u53F7 ID").action(async (options) => {
-    if (!options.type || !options.accountId) {
-      const missing = [!options.type && "--type", !options.accountId && "--account-id"].filter(Boolean).join(", ");
+    const accountId = getRawOptionValue(cli2.rawArgs, "--account-id");
+    if (!options.type || !accountId) {
+      const missing = [!options.type && "--type", !accountId && "--account-id"].filter(Boolean).join(", ");
       console.error(`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${missing}
 `);
       console.error("\u7528\u6CD5: beervid get-account-info --type <TT|TTS> --account-id <id>");
@@ -201,7 +224,7 @@ function register2(cli2) {
     try {
       const data = await openApiPost("/api/v1/open/account/info", {
         accountType,
-        accountId: options.accountId
+        accountId
       });
       printResult(data);
     } catch (err) {
@@ -256,19 +279,20 @@ function register3(cli2) {
         process.exit(1);
       }
       const uploadType = (options.type ?? "normal").toLowerCase();
+      const creatorId = getRawOptionValue(cli2.rawArgs, "--creator-id");
       if (!VALID_UPLOAD_TYPES.includes(uploadType)) {
         console.error("\u9519\u8BEF: --type \u5FC5\u987B\u4E3A normal \u6216 tts");
         process.exit(1);
       }
-      if (uploadType === "tts" && !options.creatorId) {
+      if (uploadType === "tts" && !creatorId) {
         console.error("\u9519\u8BEF: TTS \u4E0A\u4F20\u6A21\u5F0F\u9700\u8981 --creator-id \u53C2\u6570");
         process.exit(1);
       }
       try {
         let data;
         if (uploadType === "tts") {
-          console.log(`TTS \u4E0A\u4F20\u6A21\u5F0F\uFF0CcreatorUserOpenId: ${options.creatorId}`);
-          data = await uploadTtsVideo(options.file, options.creatorId, options.token);
+          console.log(`TTS \u4E0A\u4F20\u6A21\u5F0F\uFF0CcreatorUserOpenId: ${creatorId}`);
+          data = await uploadTtsVideo(options.file, creatorId, options.token);
         } else {
           console.log("\u666E\u901A\u4E0A\u4F20\u6A21\u5F0F");
           data = await uploadNormalVideo(options.file, options.token);
@@ -293,6 +317,10 @@ function register4(cli2) {
   }).option("--caption <text>", "\u89C6\u9891\u63CF\u8FF0/\u6587\u6848\uFF08\u53EF\u9009\uFF09").action(
     async (options) => {
       const publishType = (options.type ?? "normal").toLowerCase();
+      const businessId = getRawOptionValue(cli2.rawArgs, "--business-id");
+      const creatorId = getRawOptionValue(cli2.rawArgs, "--creator-id");
+      const fileId = getRawOptionValue(cli2.rawArgs, "--file-id");
+      const productId = getRawOptionValue(cli2.rawArgs, "--product-id");
       if (!VALID_PUBLISH_TYPES.includes(publishType)) {
         console.error("\u9519\u8BEF: --type \u5FC5\u987B\u4E3A normal \u6216 shoppable");
         process.exit(1);
@@ -301,9 +329,9 @@ function register4(cli2) {
         let data;
         if (publishType === "shoppable") {
           const missing = [
-            !options.creatorId && "--creator-id",
-            !options.fileId && "--file-id",
-            !options.productId && "--product-id",
+            !creatorId && "--creator-id",
+            !fileId && "--file-id",
+            !productId && "--product-id",
             !options.productTitle && "--product-title"
           ].filter(Boolean);
           if (missing.length > 0) {
@@ -325,17 +353,17 @@ function register4(cli2) {
           data = await openApiPost(
             "/api/v1/open/tts/shoppable-video/publish",
             {
-              creatorUserOpenId: options.creatorId,
-              fileId: options.fileId,
+              creatorUserOpenId: creatorId,
+              fileId,
               title: options.caption ?? "",
-              productId: options.productId,
+              productId,
               productTitle
             }
           );
           console.log("\n\u53D1\u5E03\u6210\u529F\uFF08\u6302\u8F66\u89C6\u9891\u7ACB\u5373\u5B8C\u6210\uFF09:");
         } else {
           const missing = [
-            !options.businessId && "--business-id",
+            !businessId && "--business-id",
             !options.videoUrl && "--video-url"
           ].filter(Boolean);
           if (missing.length > 0) {
@@ -350,14 +378,14 @@ function register4(cli2) {
           data = await openApiPost(
             "/api/v1/open/tiktok/video/publish",
             {
-              businessId: options.businessId,
+              businessId,
               videoUrl: options.videoUrl,
               caption: options.caption ?? ""
             }
           );
           console.log("\n\u53D1\u5E03\u5DF2\u63D0\u4EA4\uFF08\u9700\u8F6E\u8BE2\u72B6\u6001\uFF09:");
           console.log(
-            `\u63D0\u793A: \u4F7F\u7528 beervid poll-status --business-id ${options.businessId} --share-id ${data.shareId} \u8F6E\u8BE2\u8FDB\u5EA6`
+            `\u63D0\u793A: \u4F7F\u7528 beervid poll-status --business-id ${businessId} --share-id ${data.shareId} \u8F6E\u8BE2\u8FDB\u5EA6`
           );
         }
         printResult(data);
@@ -377,10 +405,12 @@ function sleep(ms) {
 function register5(cli2) {
   cli2.command("poll-status", "\u8F6E\u8BE2\u666E\u901A\u89C6\u9891\u53D1\u5E03\u72B6\u6001").option("--business-id <id>", "TT \u8D26\u53F7 businessId\uFF08\u5FC5\u586B\uFF09").option("--share-id <id>", "\u53D1\u5E03\u65F6\u8FD4\u56DE\u7684 shareId\uFF08\u5FC5\u586B\uFF09").option("--interval <sec>", "\u8F6E\u8BE2\u95F4\u9694\u79D2\u6570\uFF08\u9ED8\u8BA4 5\uFF09").option("--max-polls <n>", "\u6700\u5927\u8F6E\u8BE2\u6B21\u6570\uFF08\u9ED8\u8BA4 60\uFF09").action(
     async (options) => {
-      if (!options.businessId || !options.shareId) {
+      const businessId = getRawOptionValue(cli2.rawArgs, "--business-id");
+      const shareId = getRawOptionValue(cli2.rawArgs, "--share-id");
+      if (!businessId || !shareId) {
         const missing = [
-          !options.businessId && "--business-id",
-          !options.shareId && "--share-id"
+          !businessId && "--business-id",
+          !shareId && "--share-id"
         ].filter(Boolean);
         console.error(`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${missing.join(", ")}
 `);
@@ -399,14 +429,14 @@ function register5(cli2) {
       }
       try {
         console.log(`\u5F00\u59CB\u8F6E\u8BE2\u53D1\u5E03\u72B6\u6001 (\u95F4\u9694 ${intervalSec}s, \u6700\u591A ${maxPolls} \u6B21)`);
-        console.log(`businessId: ${options.businessId}`);
-        console.log(`shareId: ${options.shareId}
+        console.log(`businessId: ${businessId}`);
+        console.log(`shareId: ${shareId}
 `);
         let lastStatus = "UNKNOWN";
         for (let i = 1; i <= maxPolls; i++) {
           const data = await openApiPost("/api/v1/open/tiktok/video/status", {
-            businessId: options.businessId,
-            shareId: options.shareId
+            businessId,
+            shareId
           });
           const status = data.status ?? data.Status ?? "UNKNOWN";
           const postIds = data.post_ids ?? [];
@@ -423,7 +453,7 @@ function register5(cli2) {
             console.log("\u53D1\u5E03\u6210\u529F!");
             console.log(`\u89C6\u9891 ID: ${postIds[0]}`);
             console.log(
-              `\u63D0\u793A: \u4F7F\u7528 beervid query-video --business-id ${options.businessId} --item-ids ${postIds[0]} \u67E5\u8BE2\u6570\u636E`
+              `\u63D0\u793A: \u4F7F\u7528 beervid query-video --business-id ${businessId} --item-ids ${postIds[0]} \u67E5\u8BE2\u6570\u636E`
             );
             printResult(data);
             process.exit(0);
@@ -452,11 +482,13 @@ 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\u652F\u6301\u91CD\u590D\u4F20\u53C2\u6216\u9017\u53F7\u5206\u9694\uFF08\u5FC5\u586B\uFF09").action(
-    async (options) => {
-      if (!options.businessId || !options.itemIds) {
+    async () => {
+      const businessId = getRawOptionValue(cli2.rawArgs, "--business-id");
+      const rawItemIdArgs = getRawOptionValues(cli2.rawArgs, "--item-ids");
+      if (!businessId || rawItemIdArgs.length === 0) {
         const missing = [
-          !options.businessId && "--business-id",
-          !options.itemIds && "--item-ids"
+          !businessId && "--business-id",
+          rawItemIdArgs.length === 0 && "--item-ids"
         ].filter(Boolean);
         console.error(`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${missing.join(", ")}
 `);
@@ -465,7 +497,7 @@ function register6(cli2) {
         );
         process.exit(1);
       }
-      const itemIds = (Array.isArray(options.itemIds) ? options.itemIds : [options.itemIds]).flatMap((value) => value.split(",")).map((id) => id.trim()).filter(Boolean);
+      const itemIds = rawItemIdArgs.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);
@@ -474,7 +506,7 @@ function register6(cli2) {
         console.log(`\u67E5\u8BE2 ${itemIds.length} \u4E2A\u89C6\u9891\u7684\u6570\u636E...
 `);
         const data = await openApiPost("/api/v1/open/tiktok/video/query", {
-          businessId: options.businessId,
+          businessId,
           itemIds
         });
         const list = data.videoList ?? data.videos ?? [];
@@ -771,12 +803,12 @@ 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) {
+      const creatorId = getRawOptionValue(cli2.rawArgs, "--creator-id");
+      if (!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 ?? "";
@@ -845,9 +877,10 @@ function parsePositiveInt(value, optionName, defaultValue) {
 function register8(cli2) {
   cli2.command("publish-tt-flow", "\u6267\u884C TT \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\uFF1A\u4E0A\u4F20\u3001\u53D1\u5E03\u3001\u8F6E\u8BE2\u3001\u67E5\u8BE2\u6570\u636E").option("--business-id <id>", "TT \u8D26\u53F7 businessId\uFF08\u5FC5\u586B\uFF09").option("--file <path>", "\u89C6\u9891\u6587\u4EF6\u8DEF\u5F84\u6216 URL\uFF08\u5FC5\u586B\uFF09").option("--caption <text>", "\u89C6\u9891\u63CF\u8FF0/\u6587\u6848\uFF08\u53EF\u9009\uFF09").option("--token <token>", "\u5DF2\u6709\u4E0A\u4F20\u51ED\u8BC1\uFF08\u53EF\u9009\uFF09").option("--interval <sec>", "\u8F6E\u8BE2\u95F4\u9694\u79D2\u6570\uFF08\u9ED8\u8BA4 5\uFF09").option("--max-polls <n>", "\u6700\u5927\u8F6E\u8BE2\u6B21\u6570\uFF08\u9ED8\u8BA4 60\uFF09").option("--query-interval <sec>", "\u89C6\u9891\u6570\u636E\u67E5\u8BE2\u91CD\u8BD5\u95F4\u9694\u79D2\u6570\uFF08\u9ED8\u8BA4 5\uFF09").option("--query-max-attempts <n>", "\u89C6\u9891\u6570\u636E\u67E5\u8BE2\u6700\u5927\u91CD\u8BD5\u6B21\u6570\uFF08\u9ED8\u8BA4 3\uFF09").action(
     async (options) => {
-      if (!options.businessId || !options.file) {
+      const businessId = getRawOptionValue(cli2.rawArgs, "--business-id");
+      if (!businessId || !options.file) {
         const missing = [
-          !options.businessId && "--business-id",
+          !businessId && "--business-id",
           !options.file && "--file"
         ].filter(Boolean);
         console.error(`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${missing.join(", ")}
@@ -870,28 +903,14 @@ function register8(cli2) {
         console.log("1/4 \u6B63\u5728\u4E0A\u4F20\u89C6\u9891...");
         const upload = await uploadNormalVideo(options.file, options.token);
         console.log("2/4 \u6B63\u5728\u53D1\u5E03\u89C6\u9891...");
-        const publish = await publishNormalVideo(
-          options.businessId,
-          upload.fileUrl,
-          options.caption
-        );
+        const publish = await publishNormalVideo(businessId, upload.fileUrl, options.caption);
         console.log("3/4 \u6B63\u5728\u8F6E\u8BE2\u53D1\u5E03\u72B6\u6001...");
-        const status = await pollNormalVideoStatus(
-          options.businessId,
-          publish.shareId,
-          intervalSec,
-          maxPolls
-        );
+        const status = await pollNormalVideoStatus(businessId, publish.shareId, intervalSec, maxPolls);
         const videoId = status.postIds[0] ?? null;
         let query = null;
         if (status.finalStatus === "PUBLISH_COMPLETE" && videoId) {
           console.log("4/4 \u6B63\u5728\u67E5\u8BE2\u89C6\u9891\u6570\u636E...");
-          const queryResult = await queryVideoWithRetry(
-            options.businessId,
-            videoId,
-            queryIntervalSec,
-            queryMaxAttempts
-          );
+          const queryResult = await queryVideoWithRetry(businessId, videoId, queryIntervalSec, queryMaxAttempts);
           query = queryResult.query;
           for (const warning of queryResult.warnings) {
             console.warn(warning.message);
@@ -952,9 +971,11 @@ function buildManualProduct(productId, productTitle, matchedProduct) {
 function register9(cli2) {
   cli2.command("publish-tts-flow", "\u6267\u884C TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B\uFF1A\u67E5\u5546\u54C1\u3001\u9009\u5546\u54C1\u3001\u4E0A\u4F20\u3001\u53D1\u5E03").option("--creator-id <id>", "TTS \u8D26\u53F7 creatorUserOpenId\uFF08\u5FC5\u586B\uFF09").option("--file <path>", "\u89C6\u9891\u6587\u4EF6\u8DEF\u5F84\u6216 URL\uFF08\u5FC5\u586B\uFF09").option("--caption <text>", "\u89C6\u9891\u6807\u9898/\u6587\u6848\uFF08\u53EF\u9009\uFF09").option("--token <token>", "\u5DF2\u6709\u4E0A\u4F20\u51ED\u8BC1\uFF08\u53EF\u9009\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("--max-product-pages <n>", "\u5546\u54C1\u626B\u63CF\u6700\u5927\u9875\u6570\uFF08\u9ED8\u8BA4 5\uFF09").option("--product-id <id>", "\u624B\u52A8\u6307\u5B9A\u5546\u54C1 ID").option("--product-title <title>", "\u624B\u52A8\u6307\u5B9A\u5546\u54C1\u6807\u9898").option("--interactive", "\u4EA4\u4E92\u5F0F\u9009\u62E9\u5546\u54C1").action(
     async (options) => {
-      if (!options.creatorId || !options.file) {
+      const creatorId = getRawOptionValue(cli2.rawArgs, "--creator-id");
+      const productId = getRawOptionValue(cli2.rawArgs, "--product-id");
+      if (!creatorId || !options.file) {
         const missing = [
-          !options.creatorId && "--creator-id",
+          !creatorId && "--creator-id",
           !options.file && "--file"
         ].filter(Boolean);
         console.error(`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${missing.join(", ")}
@@ -969,11 +990,11 @@ function register9(cli2) {
         console.error("\u9519\u8BEF: --product-type \u5FC5\u987B\u4E3A shop\u3001showcase \u6216 all");
         process.exit(1);
       }
-      if (options.productId && options.interactive) {
+      if (productId && options.interactive) {
         console.error("\u9519\u8BEF: --product-id \u4E0E --interactive \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528");
         process.exit(1);
       }
-      if (options.productTitle && !options.productId) {
+      if (options.productTitle && !productId) {
         console.error("\u9519\u8BEF: --product-title \u9700\u8981\u4E0E --product-id \u4E00\u8D77\u4F7F\u7528");
         process.exit(1);
       }
@@ -987,13 +1008,13 @@ function register9(cli2) {
         console.log("\u5F00\u59CB\u6267\u884C TTS \u5B8C\u6574\u53D1\u5E03\u6D41\u7A0B...");
         let selectedProduct;
         let queriedProducts = null;
-        if (options.productId && options.productTitle) {
+        if (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);
+          selectedProduct = buildManualProduct(productId, options.productTitle);
         } else {
           console.log("1/4 \u6B63\u5728\u67E5\u8BE2\u5546\u54C1\u5217\u8868...");
           const productPool = await fetchProductPool(
-            options.creatorId,
+            creatorId,
             productType,
             pageSize,
             maxProductPages
@@ -1007,10 +1028,8 @@ function register9(cli2) {
               `\u4EE5\u4E0B\u5546\u54C1\u6E90\u8BF7\u6C42\u5931\u8D25: ${productPool.summary.failedSources.join(", ")}\uFF0C\u5546\u54C1\u6C60\u53EF\u80FD\u4E0D\u5B8C\u6574`
             );
           }
-          if (options.productId) {
-            const matchedProduct = productPool.products.find(
-              (product) => product.id === options.productId
-            );
+          if (productId) {
+            const matchedProduct = productPool.products.find((product) => product.id === productId);
             const resolvedTitle = matchedProduct?.title;
             if (!resolvedTitle) {
               console.error(
@@ -1018,7 +1037,7 @@ function register9(cli2) {
               );
               process.exit(1);
             }
-            selectedProduct = buildManualProduct(options.productId, resolvedTitle, matchedProduct);
+            selectedProduct = buildManualProduct(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");
@@ -1043,10 +1062,10 @@ function register9(cli2) {
           }
         }
         console.log("3/4 \u6B63\u5728\u4E0A\u4F20\u6302\u8F66\u89C6\u9891...");
-        const upload = await uploadTtsVideo(options.file, options.creatorId, options.token);
+        const upload = await uploadTtsVideo(options.file, creatorId, options.token);
         console.log("4/4 \u6B63\u5728\u53D1\u5E03\u6302\u8F66\u89C6\u9891...");
         const publishResult = await publishTtsVideo(
-          options.creatorId,
+          creatorId,
           upload.videoFileId,
           selectedProduct.id,
           selectedProduct.title,
@@ -1111,7 +1130,7 @@ function register10(cli2) {
 
 // src/cli.ts
 var cli = cac("beervid");
-var cliVersion = true ? "0.2.3" : pkg.version;
+var cliVersion = true ? "0.2.5" : pkg.version;
 register10(cli);
 register(cli);
 register2(cli);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beervid-app-cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "BEERVID App CLI — TikTok video publish, account auth, and data query",
   "type": "module",
   "engines": {
@@ -11,9 +11,7 @@
   },
   "files": [
     "dist/",
-    "agents/",
-    "references/",
-    "SKILL.md",
+    "skills/",
     "README.md"
   ],
   "scripts": {