@qcplay/cli 1.0.21 → 1.0.22

package/bin/qcplay.js

@@ -3111,6 +3111,10 @@ async function runWithErrorBanner(title, action) {
   try {
     await action();
   } catch (err) {
+    if (err.authorization?.action === "platform_authorization_required") {
+      console.log(JSON.stringify(err.authorization));
+      return;
+    }
     console.error("");
     console.error(chalk.red(`${title}:`));
     console.error(err.message || err);

package/lib/lark-article.js

@@ -2,6 +2,7 @@ import { spawn } from "child_process";
 
 import * as cheerio from "cheerio";
 
+import { larkCliExecutable } from "./lark-cli-command.js";
 import { normalizeArticleColor, sanitizeArticleRichHtml } from "./wechat-article.js";
 
 const LARK_DOCUMENT_PATH = /^\/(?:wiki|docx)\/([A-Za-z0-9_-]+)\/?$/;
@@ -59,7 +60,7 @@ function larkError(output, fallback) {
 
 function runLarkJson(args) {
   return new Promise((resolve, reject) => {
-    const executable = process.platform === "win32" ? "lark-cli.cmd" : "lark-cli";
+    const executable = larkCliExecutable();
     const child = spawn(executable, args, {
       windowsHide: true,
       shell: process.platform === "win32",

package/lib/lark-cli-command.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const moduleDirectory = path.dirname(fileURLToPath(import.meta.url));
+
+export function larkCliExecutable() {
+  const configured = String(process.env.QCPLAY_LARK_CLI || "").trim();
+  if (configured) {
+    return configured;
+  }
+
+  const executableName = process.platform === "win32" ? "lark-cli.cmd" : "lark-cli";
+  const localExecutable = path.resolve(moduleDirectory, "..", "node_modules", ".bin", executableName);
+  return fs.existsSync(localExecutable) ? localExecutable : executableName;
+}

package/lib/platform-publish.js

@@ -9,6 +9,7 @@ import readline from "readline";
 
 import * as cheerio from "cheerio";
 import { applyContentRules } from "./content-rules.js";
+import { larkCliExecutable } from "./lark-cli-command.js";
 import { stripWechatGuidanceHtml } from "./wechat-article.js";
 
 const PLATFORM_CONFIG_URL = "https://t4blw8ys5w.feishu.cn/wiki/OqH7wkx9PiBaTYkKeWNc35SonGf";
@@ -484,7 +485,11 @@ export function normalizePlatformRows(rows) {
 
 function runJson(command, args) {
   return new Promise((resolve, reject) => {
-    const executable = process.platform === "win32" ? `${command}.cmd` : command;
+    const executable = command === "lark-cli"
+      ? larkCliExecutable()
+      : process.platform === "win32"
+        ? `${command}.cmd`
+        : command;
     const child = spawn(executable, args, {
       windowsHide: true,
       shell: process.platform === "win32",
@@ -498,19 +503,95 @@ function runJson(command, args) {
     child.once("close", code => {
       const output = Buffer.concat(stdout).toString("utf8").trim();
       const diagnostics = Buffer.concat(stderr).toString("utf8").trim();
+      const parsed = parseJsonEnvelope(output) || parseJsonEnvelope(diagnostics);
       if (code !== 0) {
-        reject(new Error(diagnostics || output || `${command} 执行失败 (${code})`));
+        const error = new Error(diagnostics || output || `${command} 执行失败 (${code})`);
+        error.exitCode = code;
+        error.payload = parsed;
+        reject(error);
         return;
       }
-      try {
-        resolve(JSON.parse(output));
-      } catch {
+      if (parsed) {
+        resolve(parsed);
+      } else {
         reject(new Error(`${command} 没有返回有效 JSON`));
       }
     });
   });
 }
 
+function parseJsonEnvelope(value) {
+  if (!value) return null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+}
+
+function isAuthFailure(error) {
+  const payload = error?.payload;
+  const serialized = JSON.stringify(payload || {}) + "\n" + String(error?.message || "");
+  return /token_invalid|invalid access token|authentication/i.test(serialized);
+}
+
+async function beginPlatformAuthorization(commandRunner = runJson) {
+  try {
+    const result = await commandRunner("lark-cli", ["auth", "login", "--recommend", "--no-wait", "--json"]);
+    const verificationUrl = normalizeText(result?.verification_url || result?.verification_uri_complete);
+    if (verificationUrl) {
+      return { verificationUrl, deviceCode: normalizeText(result?.device_code) };
+    }
+    return {
+      platformManaged: result?.action === "platform_authorization_required",
+      message: normalizeText(result?.message)
+    };
+  } catch (error) {
+    const verificationUrl = normalizeText(error?.payload?.verification_url || error?.payload?.verification_uri_complete);
+    return {
+      verificationUrl,
+      deviceCode: normalizeText(error?.payload?.device_code),
+      platformManaged: error?.payload?.action === "platform_authorization_required",
+      message: normalizeText(error?.payload?.message || error?.message)
+    };
+  }
+}
+
+async function throwPlatformAuthorizationError(error, commandRunner = runJson) {
+  if (!isAuthFailure(error)) {
+    throw error;
+  }
+  const authorization = await beginPlatformAuthorization(commandRunner);
+  if (authorization.verificationUrl) {
+    const authorizationError = new Error(
+      `飞书授权需要完成，请打开以下地址并完成授权：\n${authorization.verificationUrl}`
+    );
+    authorizationError.authorization = {
+      ok: true,
+      action: "platform_authorization_required",
+      provider: "lark",
+      verification_url: authorization.verificationUrl,
+      ...(authorization.deviceCode ? { device_code: authorization.deviceCode } : {}),
+      message: "请完成飞书授权后重试原命令"
+    };
+    throw authorizationError;
+  }
+  if (authorization.platformManaged) {
+    const authorizationError = new Error(
+      "飞书访问令牌已失效，但当前 lark-cli 由平台托管凭证，无法生成本地授权地址。请在当前平台的飞书/Lark 连接器中重新授权后重试。"
+    );
+    authorizationError.authorization = {
+      ok: true,
+      action: "platform_authorization_required",
+      provider: "lark",
+      managed_by_platform: true,
+      message: "飞书访问令牌已失效，请在当前平台重新授权飞书/Lark 连接器后重试"
+    };
+    throw authorizationError;
+  }
+  throw new Error(`飞书访问令牌已失效，授权启动失败：${authorization.message || "未知错误"}`);
+}
+
 function domesticPlatformRows() {
   return normalizePlatformRows([...DOMESTIC_PLATFORM_ROWS, ...DOMESTIC_STANDARD_PLATFORM_ROWS]);
 }
@@ -530,41 +611,52 @@ export async function loadPlatformEntries(options = {}) {
   }
 
   const domesticEntries = domesticPlatformRows();
+  const commandRunner = options.runJson || runJson;
   const requestedRegion = normalizeKey(options.region || "");
   const requestedProject = normalizeProjectKey(options.project || "");
   if ((!requestedRegion || requestedRegion === normalizeKey(DOMESTIC_REGION)) && (!requestedProject || entriesForProject(domesticEntries, options.project).length > 0)) {
     return domesticEntries;
   }
 
-  const workbook = await runJson("lark-cli", [
-    "sheets",
-    "+workbook-info",
-    "--url",
-    PLATFORM_CONFIG_URL,
-    "--as",
-    "user",
-    "--format",
-    "json"
-  ]);
+  let workbook;
+  try {
+    workbook = await commandRunner("lark-cli", [
+      "sheets",
+      "+workbook-info",
+      "--url",
+      PLATFORM_CONFIG_URL,
+      "--as",
+      "user",
+      "--format",
+      "json"
+    ]);
+  } catch (error) {
+    await throwPlatformAuthorizationError(error, commandRunner);
+  }
   const sheet = workbook?.data?.sheets?.find(candidate => !candidate.is_hidden) || workbook?.data?.sheets?.[0];
   if (!sheet?.sheet_id || !Number.isInteger(sheet.row_count) || sheet.row_count < 1) {
     throw new Error("飞书平台配置没有可读取的工作表");
   }
-  const value = await runJson("lark-cli", [
-    "sheets",
-    "+csv-get",
-    "--url",
-    PLATFORM_CONFIG_URL,
-    "--sheet-id",
-    sheet.sheet_id,
-    "--range",
-    `A1:I${sheet.row_count}`,
-    "--include-row-prefix=false",
-    "--as",
-    "user",
-    "--format",
-    "json"
-  ]);
+  let value;
+  try {
+    value = await commandRunner("lark-cli", [
+      "sheets",
+      "+csv-get",
+      "--url",
+      PLATFORM_CONFIG_URL,
+      "--sheet-id",
+      sheet.sheet_id,
+      "--range",
+      `A1:I${sheet.row_count}`,
+      "--include-row-prefix=false",
+      "--as",
+      "user",
+      "--format",
+      "json"
+    ]);
+  } catch (error) {
+    await throwPlatformAuthorizationError(error, commandRunner);
+  }
   return normalizePlatformRows(rowsFromCsvEnvelope(value));
 }
 
@@ -904,7 +996,7 @@ function plainTextForPlatform(article, platformKey) {
   $("img").each((_, element) => {
     const image = $(element);
     const source = image.attr("src") || image.attr("data-qcplay-src") || image.attr("data-src") || image.attr("data-original");
-    image.replaceWith(source ? `\n${source}\n` : "");
+    image.replaceWith(platformKey === "meta" ? "\n" : source ? `\n${source}\n` : "");
   });
   const markdown = normalizeText($.root().text() || article.markdown)
     .replace(/[ \t]+\n/g, "\n")
@@ -2105,7 +2197,7 @@ export function browserPlatformPageUrl(entry, type = "topic") {
     case "x":
       return "https://x.com/compose/post";
     case "meta":
-      return (
+      return metaComposerUrl(
         configuredUrl(entry.url, url => url.hostname.toLowerCase() === "business.facebook.com") ||
         configuredUrl(entry.url)
       );
@@ -2133,6 +2225,10 @@ function imageSourcesFromArticle(article) {
     .filter(Boolean);
 }
 
+export function resolveMetaPublishingOptions(article = {}) {
+  return { images: imageSourcesFromArticle(article) };
+}
+
 function splitImageSources(value) {
   return normalizeText(value)
     .split(/[,，\r\n]+/)
@@ -6229,6 +6325,114 @@ async function clearWeiboArticleBody(page, bodyInput) {
   }
 }
 
+function metaComposerUrl(value) {
+  const configured = normalizeText(value);
+  if (!configured) return "";
+  try {
+    const source = new URL(configured);
+    if (source.hostname.toLowerCase() !== "business.facebook.com" || !/\/latest\/composer\/?$/i.test(source.pathname)) {
+      return source.toString();
+    }
+    const target = new URL("/latest/composer/", source.origin);
+    for (const name of ["asset_id", "business_id"]) {
+      const parameter = source.searchParams.get(name);
+      if (parameter) target.searchParams.set(name, parameter);
+    }
+    return target.toString();
+  } catch {
+    return configured;
+  }
+}
+
+function genericMetaComposerUrl(value) {
+  try {
+    const url = new URL(value);
+    return new URL("/latest/composer/", url.origin).toString();
+  } catch {
+    return "https://business.facebook.com/latest/composer/";
+  }
+}
+
+export function isMetaUnavailableContent(value) {
+  return /很抱歉.{0,24}(?:无法显示内容|内容不可用)|链接可能已过期|(?:sorry,?\s*)?(?:this|the) content isn['’]t available|content isn['’]t available right now|page may only be visible to an audience/i.test(
+    normalizeText(value)
+  );
+}
+
+async function metaUnavailablePage(page) {
+  if (typeof page?.locator !== "function") return false;
+  const text = await page.locator("body").innerText().catch(() => "");
+  return isMetaUnavailableContent(text);
+}
+
+async function metaUploadedPhotoCount(page) {
+  if (typeof page?.getByText !== "function") return 0;
+  return retryAcrossNavigation(page, () =>
+    page.getByText(/^(?:移除|删除)(?:照片|图片)$|^Remove photo$|^Delete photo$/i, { exact: true }).count()
+  );
+}
+
+async function waitForMetaPhotoUploads(page, expectedCount, timeoutMs = 180000) {
+  const deadline = Date.now() + timeoutMs;
+  let stableChecks = 0;
+  do {
+    const text = await page.locator("body").innerText().catch(() => "");
+    if (/上传失败|无法上传|照片.{0,12}(?:不受支持|格式错误)|处理失败|upload failed|couldn['’]t upload|unsupported/i.test(text)) {
+      throw new Error("Facebook 图片上传失败，请检查页面提示或图片格式");
+    }
+    const uploaded = await metaUploadedPhotoCount(page);
+    const pending = await pendingUploadCount(page);
+    if (uploaded >= expectedCount && pending === 0) {
+      stableChecks += 1;
+      if (stableChecks >= 3) return uploaded;
+    } else {
+      stableChecks = 0;
+    }
+    await new Promise(resolve => setTimeout(resolve, 300));
+  } while (Date.now() < deadline);
+  const uploaded = await metaUploadedPhotoCount(page).catch(() => 0);
+  throw new Error(`Facebook 图片上传未完成，预期 ${expectedCount} 张，页面确认 ${uploaded} 张`);
+}
+
+export async function uploadMetaImages(page, article, options = {}) {
+  const publishing = resolveMetaPublishingOptions(article);
+  if (publishing.images.length === 0) return { images: 0 };
+  if (typeof page?.waitForEvent !== "function") {
+    throw new Error("Facebook 页面不支持文件选择器事件，无法上传正文图片");
+  }
+
+  const payloads = [];
+  for (let index = 0; index < publishing.images.length; index += 1) {
+    payloads.push(await imageUploadPayload(publishing.images[index], article.articleFile, index, "Facebook"));
+    if ((index + 1) % 5 === 0 || index + 1 === publishing.images.length) {
+      options.onProgress?.(`已准备 Facebook 图片 ${index + 1}/${publishing.images.length}`);
+    }
+  }
+
+  const trigger =
+    (await waitForVisibleButton(page, [/添加照片\s*\/\s*视频/i, /Add photos?\s*\/\s*videos?/i], 8000)) ||
+    (await waitForVisibleTextAcrossFrames(page, /添加照片\s*\/\s*视频|Add photos?\s*\/\s*videos?/i, 3000, false));
+  if (!trigger) {
+    throw new Error("Facebook 发布页未找到“添加照片/视频”控件");
+  }
+
+  const chooserPromise = page.waitForEvent("filechooser", { timeout: 10000 }).catch(() => null);
+  await trigger.click();
+  const chooser = await chooserPromise;
+  if (!chooser) {
+    throw new Error("Facebook 点击“添加照片/视频”后未打开文件选择器");
+  }
+  if (payloads.length > 1 && typeof chooser.isMultiple === "function" && !chooser.isMultiple()) {
+    throw new Error(`Facebook 文件选择器不支持多选，无法一次上传 ${payloads.length} 张图片`);
+  }
+
+  options.onProgress?.(`正在上传 Facebook 图片 ${payloads.length} 张`);
+  await chooser.setFiles(payloads);
+  const uploaded = await waitForMetaPhotoUploads(page, payloads.length, options.uploadTimeoutMs);
+  options.onProgress?.(`Facebook 图片上传完成，共 ${uploaded} 张`);
+  return { images: uploaded };
+}
+
 export async function insertWeiboArticleRichContent(page, bodyInput, article, spec, fallbackText, options = {}) {
   if (typeof bodyInput.evaluate !== "function" || typeof bodyInput.locator !== "function") {
     await fillLocator(bodyInput, fallbackText);
@@ -7780,14 +7984,14 @@ async function launchBrowserContext(entry, browserChannel, options = {}) {
   const profileDir = browserProfileDir(entry);
   await fs.promises.mkdir(profileDir, { recursive: true, mode: 0o700 });
   const channel = browserChannel || process.env.QCPLAY_BROWSER_CHANNEL || (process.platform === "win32" ? "msedge" : "chrome");
-  if (options.awaitAIAction) {
-    return launchDetachedBrowserContext(profileDir, channel);
-  }
   const detachedContext = await reconnectDetachedBrowserContext(profileDir, chromium);
   if (detachedContext) {
     options.onProgress?.(`已复用当前 ${entry.platform} 授权编辑页，继续执行已确认的动作`);
     return detachedContext;
   }
+  if (options.awaitAIAction) {
+    return launchDetachedBrowserContext(profileDir, channel);
+  }
   return chromium.launchPersistentContext(profileDir, {
     channel,
     headless: false,
@@ -7971,7 +8175,11 @@ export async function publishWithBrowser(entry, article, options = {}) {
   const ownsContext = !options.context;
   const context = options.context || (await launchBrowserContext(entry, options.browserChannel, options));
   const pages = context.pages();
-  const page = pages[0] || (await context.newPage());
+  // A detached Edge session may briefly restore and then close its first tab.
+  // Use a fresh page for AI-action flows so navigation keeps a stable target.
+  let page = options.awaitAIAction && typeof context.newPage === "function"
+    ? await context.newPage()
+    : pages[0] || (await context.newPage());
   const promptUser = options.waitForUser || (message => waitForUser(message, options.streams));
   let haoyouEditorOpened = false;
   let preserveEditorOnFailure = false;
@@ -7991,13 +8199,29 @@ export async function publishWithBrowser(entry, article, options = {}) {
     if (entry.platformKey === "xiaohongshu") {
       return await publishXiaohongshu(page, entry, preparedArticle, spec, options, promptUser);
     }
-    const editorUrl = browserPlatformPageUrl(entry);
+    let editorUrl = browserPlatformPageUrl(entry);
+    let metaFallbackTried = false;
     let editorReady = false;
     let loginHandled = false;
-    const attempts = entry.platformKey === "haoyou" ? 3 : 2;
+    const attempts = entry.platformKey === "haoyou" || entry.platformKey === "meta" ? 3 : 2;
     for (let attempt = 0; attempt < attempts; attempt += 1) {
+      if (typeof page.isClosed === "function" && page.isClosed()) {
+        const livePages = context.pages().filter(candidate => !(typeof candidate.isClosed === "function" && candidate.isClosed()));
+        page = livePages.at(-1) || (await context.newPage());
+      }
       await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
       await afterNavigation(page);
+      if (entry.platformKey === "meta" && (await metaUnavailablePage(page))) {
+        if (!metaFallbackTried) {
+          metaFallbackTried = true;
+          editorUrl = genericMetaComposerUrl(editorUrl);
+          options.onProgress?.(`${entry.platform} 资产专用链接不可用，正在尝试 Meta 通用发布入口`);
+          continue;
+        }
+        throw new Error(
+          `${entry.platform} 当前账号无法访问配置中的 Meta 资产，请确认该账号已加入 business_id 对应的商务管理平台并拥有 asset_id 对应主页的内容发布权限`
+        );
+      }
       const readyTimeout = attempt === 0 && spec.loginPage ? 3000 : 15000;
       const ready = entry.platformKey === "haoyou"
         ? await waitForHaoyouTargetEditor(page, editorUrl, spec, readyTimeout)
@@ -8039,6 +8263,7 @@ export async function publishWithBrowser(entry, article, options = {}) {
       throw new Error(`${entry.platform} 页面中未找到正文编辑器，页面结构可能已更新`);
     }
     let richContent = null;
+    let platformMedia = null;
     if (entry.platformKey === "haoyou") {
       if (options.previewTextOnly) {
         await fillStableHaoyouValue(page, bodyInput, body, "正文");
@@ -8055,6 +8280,9 @@ export async function publishWithBrowser(entry, article, options = {}) {
     } else {
       await fillLocator(bodyInput, body);
     }
+    if (entry.platformKey === "meta") {
+      platformMedia = await uploadMetaImages(page, preparedArticle, options);
+    }
 
     let submitButton = await waitForVisible(page, spec.submitSelectors, 5000);
     submitButton ||= await waitForVisibleButton(page, spec.submit, 5000);
@@ -8066,7 +8294,7 @@ export async function publishWithBrowser(entry, article, options = {}) {
     }
     const review = await reviewPreparedDraft(page, entry, options);
     if (review) {
-      return { ...review, ...richContent };
+      return { ...review, ...richContent, ...platformMedia };
     }
     if (options.draftOnly) {
       return {
@@ -8075,7 +8303,8 @@ export async function publishWithBrowser(entry, article, options = {}) {
         draftOnly: true,
         approvalRequired: true,
         approvalActions: ["publish", "cancel"],
-        ...richContent
+        ...richContent,
+        ...platformMedia
       };
     }
     if (entry.platformKey === "haoyou") {
@@ -8096,7 +8325,7 @@ export async function publishWithBrowser(entry, article, options = {}) {
     if (options.keepOpen) {
       await promptUser(`${entry.platform} 已提交，浏览器保持打开供检查`);
     }
-    return { url: page.url() };
+    return { url: page.url(), ...platformMedia };
   } catch (error) {
     if ((entry.platformKey === "haoyou" && haoyouEditorOpened) || entry.platformKey === "xiaohongshu") {
       if (!ownsContext) throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "QCPlay CLI",
   "type": "module",
   "bin": {
@@ -38,6 +38,7 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@larksuite/cli": "1.0.96",
     "cheerio": "^1.0.0-rc.12",
     "playwright-core": "1.40.1"
   }