siluzan-tso-cli 1.1.22-beta.14 → 1.1.22-beta.15

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.22-beta.14），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.22-beta.15），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -114697,6 +114697,26 @@ async function uploadPmaxLocalVideo(opts) {
     }
   );
 }
+function resolvePmaxVideoAbsPath(relOrAbs, baseDir = process.cwd()) {
+  const trimmed = relOrAbs.trim();
+  if (isAbsolute5(trimmed)) return trimmed;
+  return resolve9(baseDir, trimmed);
+}
+function validatePmaxVideoPathQuick(absPath) {
+  if (!VIDEO_UPLOAD_SUFFIX.test(absPath)) {
+    return `videoPath \u6269\u5C55\u540D\u4E0D\u53D7\u652F\u6301\uFF0C\u8BF7\u4F7F\u7528 .mp4 / .mov / .webm / .avi / .mpeg / .mpg`;
+  }
+  if (!existsSync3(absPath)) {
+    return `\u89C6\u9891\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${absPath}`;
+  }
+  try {
+    if (readFileSync8(absPath).length === 0) return `\u89C6\u9891\u6587\u4EF6\u4E3A\u7A7A\uFF1A${absPath}`;
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return `\u65E0\u6CD5\u8BFB\u53D6\u89C6\u9891\u6587\u4EF6\uFF08${absPath}\uFF09\uFF1A${msg}`;
+  }
+  return null;
+}
 
 // src/commands/ad/pmax-create.ts
 async function runAdPmaxCreate(opts) {
@@ -115281,12 +115301,35 @@ async function runAdPmaxAssetsUpdate(opts) {
 async function runAdPmaxYoutubeLink(opts) {
   const accountId = requireAccountId(opts.account);
   const assetGroupId = opts.assetGroupId.trim();
+  const youtubeInput = opts.youtubeUrlOrId?.trim();
+  const videoPathInput = opts.videoPath?.trim();
+  if (!opts.bodyFile) {
+    if (youtubeInput && videoPathInput) {
+      console.error("\n\u274C --youtube \u4E0E --video-path \u53EA\u80FD\u4E8C\u9009\u4E00\n");
+      process.exit(1);
+    }
+    if (!youtubeInput && !videoPathInput) {
+      console.error("\n\u274C \u8BF7\u6307\u5B9A --youtube\u3001--video-path \u6216 --body-file\n");
+      process.exit(1);
+    }
+    if (videoPathInput) {
+      const pathErr = validatePmaxVideoPathQuick(resolvePmaxVideoAbsPath(videoPathInput));
+      if (pathErr) {
+        console.error(`
+\u274C ${pathErr}
+`);
+        process.exit(1);
+      }
+    }
+  }
   await withGoogleApi(opts, async (config, googleApiUrl) => {
     let data;
+    let linkedTarget = youtubeInput;
     try {
       if (opts.bodyFile) {
         const url = pmaxAssetGroupUrl(googleApiUrl, accountId, assetGroupId, "youtube");
         const body = loadPmaxJsonFile(opts.bodyFile);
+        linkedTarget = typeof body["youtubeUrlOrId"] === "string" ? body["youtubeUrlOrId"].trim() : linkedTarget;
         const raw = await pmaxApiFetch(
           url,
           config,
@@ -115295,12 +115338,28 @@ async function runAdPmaxYoutubeLink(opts) {
         );
         data = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : { data: raw };
       } else {
+        if (videoPathInput) {
+          const absVideo = resolvePmaxVideoAbsPath(videoPathInput);
+          if (!opts.jsonOut) console.log(`
+\u{1F4E4} \u4E0A\u4F20\u672C\u5730\u89C6\u9891\uFF08PyAPI\uFF09\u2026`);
+          linkedTarget = await uploadPmaxLocalVideo({
+            config,
+            googleApiUrl,
+            accountId,
+            absVideoPath: absVideo,
+            title: opts.videoTitle,
+            description: opts.videoDescription,
+            verbose: opts.verbose,
+            onProgress: opts.jsonOut ? void 0 : (msg) => console.log(`   ${msg}`)
+          });
+          if (!opts.jsonOut) console.log(`   video_id\uFF1A${linkedTarget}`);
+        }
         data = await postPmaxYoutubeLink({
           config,
           googleApiUrl,
           accountId,
           assetGroupId,
-          youtubeUrlOrId: opts.youtubeUrlOrId,
+          youtubeUrlOrId: linkedTarget,
           campaignId: opts.campaignId,
           assetName: opts.assetName,
           verbose: opts.verbose
@@ -115309,7 +115368,7 @@ async function runAdPmaxYoutubeLink(opts) {
     } catch (err) {
       console.error(
         `
-\u274C \u94FE\u63A5 YouTube \u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+\u274C \u94FE\u63A5/\u66FF\u6362 YouTube \u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
 `
       );
       process.exit(1);
@@ -115324,7 +115383,8 @@ async function runAdPmaxYoutubeLink(opts) {
       return;
     }
     console.log(`
-\u2705 \u5DF2\u94FE\u63A5 YouTube \u5230\u8D44\u4EA7\u7EC4 ${assetGroupId}`);
+\u2705 \u5DF2\u94FE\u63A5/\u66FF\u6362 YouTube \u5230\u8D44\u4EA7\u7EC4 ${assetGroupId}`);
+    if (linkedTarget) console.log(`   youtube\uFF1A${linkedTarget}`);
     console.log(`   assetResourceName\uFF1A${data["assetResourceName"] ?? "\u2014"}
 `);
   });
@@ -116269,18 +116329,19 @@ function register20(program2) {
     }
   );
   addPmaxJsonOptions(
-    adCmd.command("pmax-youtube-link").description("\u4E3A\u8D44\u4EA7\u7EC4\u94FE\u63A5 YouTube \u89C6\u9891\uFF08POST .../youtube\uFF09").requiredOption("-a, --account <id>", "Google \u5A92\u4F53\u5BA2\u6237 ID").requiredOption("--asset-group-id <id>", "\u8D44\u4EA7\u7EC4 ID").option("--campaign-id <id>", "\u6240\u5C5E\u6D3B\u52A8 ID\uFF08\u5EFA\u8BAE\u4F20\uFF09").option("--youtube <urlOrId>", "YouTube URL \u6216 11 \u4F4D\u89C6\u9891 ID").option("--asset-name <name>", "\u8D44\u4EA7\u663E\u793A\u540D").option("--body-file <path>", "\u5B8C\u6574 JSON body\uFF08\u8986\u76D6 --youtube\uFF09").option("-t, --token <token>", "Auth Token")
+    adCmd.command("pmax-youtube-link").description(
+      "\u4E3A\u8D44\u4EA7\u7EC4\u94FE\u63A5\u6216\u66FF\u6362 YouTube \u89C6\u9891\uFF08POST .../youtube\uFF1B\u4F1A\u5148\u79FB\u9664\u5DF2\u6709 YOUTUBE_VIDEO \u518D\u6302\u65B0\u7247\uFF09\n  --youtube\uFF1A\u5DF2\u6709 URL/ID\uFF1B--video-path\uFF1A\u672C\u5730\u6587\u4EF6\u7ECF PyAPI \u4E0A\u4F20\u540E\u94FE\u63A5"
+    ).requiredOption("-a, --account <id>", "Google \u5A92\u4F53\u5BA2\u6237 ID").requiredOption("--asset-group-id <id>", "\u8D44\u4EA7\u7EC4 ID").option("--campaign-id <id>", "\u6240\u5C5E\u6D3B\u52A8 ID\uFF08\u5EFA\u8BAE\u4F20\uFF09").option("--youtube <urlOrId>", "YouTube URL \u6216 11 \u4F4D\u89C6\u9891 ID\uFF08\u4E0E --video-path \u4E8C\u9009\u4E00\uFF09").option("--video-path <path>", "\u672C\u5730\u89C6\u9891\u8DEF\u5F84\uFF08PyAPI \u4E0A\u4F20\uFF1B\u4E0E --youtube \u4E8C\u9009\u4E00\uFF09").option("--video-title <title>", "PyAPI \u4E0A\u4F20\u6807\u9898\uFF08\u9ED8\u8BA4\u6587\u4EF6\u540D\uFF09").option("--video-description <text>", "PyAPI \u4E0A\u4F20\u63CF\u8FF0").option("--asset-name <name>", "\u8D44\u4EA7\u663E\u793A\u540D").option("--body-file <path>", "\u5B8C\u6574 JSON body\uFF08\u542B youtubeUrlOrId\uFF1B\u8986\u76D6 --youtube/--video-path\uFF09").option("-t, --token <token>", "Auth Token")
   ).action(
     async (opts) => {
-      if (!opts.bodyFile && !opts.youtube?.trim()) {
-        console.error("\n\u274C \u8BF7\u6307\u5B9A --youtube \u6216 --body-file\n");
-        process.exit(1);
-      }
       await runAdPmaxYoutubeLink({
         account: opts.account,
         assetGroupId: opts.assetGroupId,
         campaignId: opts.campaignId,
-        youtubeUrlOrId: opts.youtube ?? "",
+        youtubeUrlOrId: opts.youtube,
+        videoPath: opts.videoPath,
+        videoTitle: opts.videoTitle,
+        videoDescription: opts.videoDescription,
         assetName: opts.assetName,
         bodyFile: opts.bodyFile,
         token: opts.token,

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.22-beta.14",
-  "publishedAt": 1779963596845
+  "version": "1.1.22-beta.15",
+  "publishedAt": 1779965706071
 }

package/dist/skill/assets/pmax-create-template.md

@@ -16,7 +16,7 @@
 | 文案超长 | `pmax-validate --json-out` 读 `lengthViolations`（含完整 `text`）；**勿自动截断**，列改写方案给用户确认后再改 JSON 并重跑 validate（同 Search `campaign-validate`） |
 | 金额 | JSON 填**主币种「元」**；CLI 提交前 `budget`、`targetCpa_BidingAmount` ×100 |
 | 图片 | **只填 `imagePaths`** 指向本地 PNG/JPEG；`pmax-create` 会自动 multipart 上传并用 assetId 创建（勿把 Base64 提交进 Git） |
-| 视频 | **`videoPath`**（本地，PyAPI 上传）或 **`youtubeUrlOrId`**（已有 YouTube）二选一；`pmax-create` 成功后自动链接；或 `ad pmax-youtube-link` |
+| 视频 | 创建：`videoPath` / `youtubeUrlOrId`（二选一，`pmax-create` 后自动链接）。**换片**：`ad pmax-youtube-link --youtube …` 或 `--video-path …`（会替换资产组内已有 YouTube 视频） |
 | 改已上线 PMax | `ad pmax-get` / `pmax-edit` / `pmax-assets-update` 等（见 `references/google-ads/pmax-api.md`） |
 | 列表复核 | `ad campaigns -a <id> --json-out ./snap`，`channelTypeV2` 应为 `PERFORMANCE_MAX` |
 

package/dist/skill/references/google-ads/google-ads.md

@@ -62,7 +62,7 @@
 | 改资产组 | `ad pmax-asset-group-edit` |
 | 删资产组 | `ad pmax-asset-group-edit --status REMOVED`（软删；网关无 DELETE 端点） |
 | 改资产 | `ad pmax-assets-update --config-file …` |
-| YouTube | `ad pmax-youtube-link` |
+| YouTube 链接/替换 | `ad pmax-youtube-link`（`--youtube` 或 `--video-path`） |
 | 信号 | `ad pmax-signals-get` / `ad pmax-signals-set`；受众下拉 `ad pmax-audiences` |
 | 图片库 | `ad pmax-image-upload` |
 | 报表 | `ad pmax-report-asset-groups` / `ad pmax-report-geo` |

package/dist/skill/references/google-ads/pmax-api.md

@@ -23,7 +23,7 @@
 | `ad pmax-asset-group-create` | 新建资产组 |
 | `ad pmax-asset-group-edit` | 编辑资产组 |
 | `ad pmax-assets-update` | 更新资产 |
-| `ad pmax-youtube-link` | 关联 YouTube |
+| `ad pmax-youtube-link` | 关联/替换 YouTube（会移除资产组内已有视频再挂新片） |
 | `ad pmax-signals-get` / `ad pmax-signals-set` | 读/写信号（**全量** PUT） |
 | `ad pmax-audiences` | 受众列表 |
 | `ad pmax-image-upload` | 单张图片上传 |
@@ -42,7 +42,9 @@
 
 - **`videoPath`**：本地 `.mp4` 等；`pmax-create` 经 **GoogleAdsPyAPI** `POST {googleApiUrl}/pyapi/video/upload` 上传，轮询 `GET .../upload/status` 得 `video_id`，再 `POST .../asset-group/{id}/youtube` 链接（与 `youtubeUrlOrId` 二选一）。
 - **`youtubeUrlOrId`**：已有 YouTube URL 或 11 位 ID；创建成功后自动链接。
-- 或创建后：`ad pmax-youtube-link -a <id> --asset-group-id <agId> --campaign-id <cid> --youtube "<url或ID>"`。
+- **已创建系列换视频**：`ad pmax-youtube-link`（同一接口；后端先删旧 `YOUTUBE_VIDEO` 再链接新片）：
+  - `--youtube "<url或ID>"` 或 `--video-path ./new.mp4`（可选 `--video-title`）
+  - 示例：`siluzan-tso ad pmax-youtube-link -a <id> --asset-group-id <agId> --campaign-id <cid> --video-path ./promo-v2.mp4`
 
 ---
 

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.22-beta.14'
+$PKG_VERSION = '1.1.22-beta.15'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.22-beta.14"
+readonly PKG_VERSION="1.1.22-beta.15"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.22-beta.14",
+  "version": "1.1.22-beta.15",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",