@qcplay/cli 1.0.20 → 1.0.22

package/bin/qcplay.js

@@ -2433,7 +2433,10 @@ async function parseArticleFile(file) {
   }
 
   const raw = await fs.promises.readFile(articleFile, "utf8");
-  if (path.extname(articleFile).toLowerCase() === ".html") {
+  const looksLikeQcplayHtml =
+    /^(?:\uFEFF)?\s*(?:<!doctype\s+html\b|<html\b)/i.test(raw) &&
+    /(?:id=["']qcplay-article-meta["']|data-qcplay-article-content=["']1["'])/i.test(raw);
+  if (path.extname(articleFile).toLowerCase() === ".html" || looksLikeQcplayHtml) {
     const { meta, richHtml } = parseRichArticleUploadFile(raw);
     return {
       articleFile,
@@ -2705,9 +2708,12 @@ async function publishPlatformsCommand(file, options) {
     parsedArticle = await parseArticleFile(file);
     parsedArticle = applyPublishOverrides(parsedArticle, options);
   }
-  const allEntries = await loadPlatformEntries({ configFile: options.configFile });
-
   const project = inferDistributionProject(parsedArticle?.payload, options.project, parsedArticle?.meta);
+  const allEntries = await loadPlatformEntries({
+    configFile: options.configFile,
+    project,
+    region: options.region
+  });
   if (!project) {
     if (options.listPlatforms) {
       printPlatformEntries(allEntries);
@@ -3105,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,9 +9,62 @@ 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";
+const DOMESTIC_REGION = "国内";
+const DOMESTIC_PLATFORM_ROWS = [
+  {
+    项目: "最强蜗牛",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=187376&group_id=227162&show_activity=1"
+  },
+  {
+    项目: "提灯与地下城",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=149961&group_id=177149&show_activity=1"
+  },
+  {
+    项目: "阿瑞斯病毒2",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=387841&group_id=663910&show_activity=1"
+  },
+  {
+    项目: "迷途之光",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=moment&app_id=600170&show_activity=1"
+  },
+  {
+    项目: "最强蜗牛",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=12201&type=1"
+  },
+  {
+    项目: "新仙剑",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=24008&type=1"
+  },
+  {
+    项目: "阿瑞斯病毒2",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=20313&type=1"
+  }
+];
+const DOMESTIC_STANDARD_PLATFORM_ROWS = ["最强蜗牛", "提灯与地下城", "阿瑞斯病毒2", "新仙剑", "迷途之光", "魔卡少女樱"].flatMap(
+  项目 => [
+    { 项目, 区域: DOMESTIC_REGION, 平台: "B站", 页面URL链接: "https://member.bilibili.com/platform/upload/text/new-edit" },
+    { 项目, 区域: DOMESTIC_REGION, 平台: "微博", 页面URL链接: "https://card.weibo.com/article/v5/editor" },
+    { 项目, 区域: DOMESTIC_REGION, 平台: "小红书", 页面URL链接: "https://creator.xiaohongshu.com/publish/publish?from=menu&target=image" }
+  ]
+);
 const DISCORD_MESSAGE_LIMIT = 2000;
 const DISCORD_MESSAGE_STATE_FILE = path.join(os.homedir(), ".qcplay", "discord-messages.json");
 const BROWSER_SUBMISSION_COOLDOWN_MS = 60_000;
@@ -432,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",
@@ -446,19 +503,99 @@ 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]);
+}
+
 export async function loadPlatformEntries(options = {}) {
   if (options.configFile) {
     const configFile = path.resolve(process.cwd(), options.configFile);
@@ -473,35 +610,53 @@ export async function loadPlatformEntries(options = {}) {
     return normalizePlatformRows(rows);
   }
 
-  const workbook = await runJson("lark-cli", [
-    "sheets",
-    "+workbook-info",
-    "--url",
-    PLATFORM_CONFIG_URL,
-    "--as",
-    "user",
-    "--format",
-    "json"
-  ]);
+  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;
+  }
+
+  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));
 }
 
@@ -841,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")
@@ -1763,6 +1918,8 @@ export function resolveWeiboSuperTopic(article, entry = {}) {
 }
 
 export function resolveWeiboShareCopy(article, entry = {}) {
+  const configured = weiboMeta(article, "weibo_share_copy", "weibo_share_text");
+  if (configured) return configured;
   const title = resolveWeiboArticleTitle(article);
   const project = normalizeText(entry.project);
   if (project === "最强蜗牛") {
@@ -2040,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)
       );
@@ -2068,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]+/)
@@ -2758,11 +2919,74 @@ function normalizeNumberedSectionHeadings(items) {
 }
 
 export function buildBilibiliRichContent(article) {
-  return buildPlatformRichContent(article, {
+  const content = buildPlatformRichContent(article, {
     preserveBackground: true,
     preserveBlockStyles: true,
     structuredTables: true
   });
+  // Bilibili can drop the first paragraph's CSS alignment when it follows an
+  // inline image node. Keep an explicit align attribute on that first text
+  // block so the source formatting survives the editor's initial normalization.
+  const firstTextIndex = content.items.findIndex(item => item.type === "html" && item.plain);
+  if (firstTextIndex < 0) return content;
+  const firstText = content.items[firstTextIndex];
+  const alignment = normalizeText(firstText.align).toLowerCase();
+  if (!alignment) return content;
+  const $ = cheerio.load(firstText.html, null, false);
+  const root = $.root().children().first();
+  if (!root.length) return content;
+  root.attr("align", alignment);
+  return {
+    ...content,
+    items: content.items.map((item, index) => (index === firstTextIndex ? { ...item, html: $.html(root) } : item))
+  };
+}
+
+async function enforceBilibiliFirstTextAlignment(bodyInput, content) {
+  const firstText = content.items.find(item => item.type === "html" && item.plain);
+  const alignment = normalizeText(firstText?.align).toLowerCase();
+  const expectedText = normalizeText(firstText?.plain);
+  if (!alignment || !expectedText || typeof bodyInput.evaluate !== "function") return false;
+  return bodyInput
+    .evaluate(
+      (element, payload) => {
+        const normalize = value => String(value || "").replace(/\s+/g, " ").trim();
+        const blocks = [...element.querySelectorAll("p,h1,h2,h3,h4,h5,h6,div")].filter(block => {
+          const text = normalize(block.textContent);
+          return text === payload.text || text.includes(payload.text) || payload.text.includes(text);
+        });
+        // Prefer the smallest matching block. The outer editor container often
+        // contains the same text, but formatting it does not update the actual
+        // paragraph node stored by Bilibili's rich-text model.
+        blocks.sort((left, right) => normalize(left.textContent).length - normalize(right.textContent).length);
+        const target = blocks[0];
+        if (!target) return false;
+        const range = document.createRange();
+        range.selectNodeContents(target);
+        const selection = window.getSelection();
+        selection.removeAllRanges();
+        selection.addRange(range);
+        try {
+          document.execCommand("justifyCenter", false, null);
+        } catch {
+          // Some Chromium builds disable execCommand; the explicit style below
+          // still provides a deterministic fallback for the editor DOM.
+        }
+        target.style.textAlign = payload.alignment;
+        target.setAttribute("align", payload.alignment);
+        target.setAttribute("data-align", payload.alignment);
+        target.dispatchEvent(
+          new InputEvent("input", {
+            bubbles: true,
+            inputType: "formatBlock",
+            data: null
+          })
+        );
+        return getComputedStyle(target).textAlign === payload.alignment;
+      },
+      { text: expectedText, alignment }
+    )
+    .catch(() => false);
 }
 
 export function buildHaoyouRichContent(article) {
@@ -3369,6 +3593,7 @@ export async function insertBilibiliRichContent(page, bodyInput, article, spec,
       plain: plainParts.join("\n")
     });
     await page.waitForTimeout(100);
+    await enforceBilibiliFirstTextAlignment(bodyInput, content);
     options.onProgress?.("B站 文字正文已写入，正在回读校验");
     options.onProgress?.(`B站 已写入 ${content.items.length} 个正文区块，准备处理 ${imageMarkers.length} 张正文图片`);
   }
@@ -3432,6 +3657,9 @@ export async function insertBilibiliRichContent(page, bodyInput, article, spec,
     }
   }
 
+  // Media insertion may rerender the first paragraph and drop its alignment.
+  // Reapply it after all images are settled, immediately before final reading.
+  await enforceBilibiliFirstTextAlignment(bodyInput, content);
   options.onProgress?.("B站 正文媒体已处理，正在最终回读校验");
   let state = null;
   let previousTextLength = -1;
@@ -4378,6 +4606,24 @@ async function openPlatformLogin(page, entry, spec) {
   return false;
 }
 
+export function browserSessionLoginPrompt(platform) {
+  return `${platform} 尚未登录。请仅在 CLI 刚打开的自动化浏览器窗口中完成登录（扫码或账号密码均可），不要改用其他浏览器；完成后保持该窗口打开并回复“已登录”。`;
+}
+
+async function waitForExisting(page, selectors, timeoutMs = 15000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const locator = await firstExisting(page, selectors);
+    if (locator) return locator;
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+function browserSessionLoginFailure(platform) {
+  return `${platform} 登录完成后仍未进入发布编辑器。请确认登录发生在 CLI 刚打开的自动化浏览器窗口中，并检查账号是否拥有发布权限`;
+}
+
 async function ensureBrowserLogin(page, entry, spec, promptUser) {
   const alreadyLoggedIn = await openPlatformLogin(page, entry, spec);
   if (alreadyLoggedIn) {
@@ -4385,7 +4631,7 @@ async function ensureBrowserLogin(page, entry, spec, promptUser) {
   }
 
   if (spec.manualLogin) {
-    await promptUser(`${entry.platform} 尚未登录，请在浏览器中手动完成登录（可自行填写账号密码或扫码）`);
+    await promptUser(browserSessionLoginPrompt(entry.platform));
     return true;
   }
 
@@ -4999,7 +5245,7 @@ async function publishTapTap(page, entry, article, spec, options, promptUser) {
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => tapTapCreatorReady(page, spec), 15000))) {
-    throw new Error("TapTap 登录完成后仍未进入创作者发布页，请确认账号拥有发布权限");
+    throw new Error(browserSessionLoginFailure("TapTap"));
   }
   const resumedDraft = await resumeMatchingTapTapDraft(page, spec, preparedArticle.title, editorUrl);
   if (options.publishDraft) {
@@ -5506,7 +5752,7 @@ async function publishBilibili(page, entry, article, spec, options, promptUser)
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => bilibiliEditorIsReady(page, spec, settings), 15000))) {
-    throw new Error(`B站登录完成后仍未进入${settings.typeLabel}投稿页，请确认账号拥有投稿权限`);
+    throw new Error(browserSessionLoginFailure("B站"));
   }
 
   let titleInput;
@@ -5650,7 +5896,10 @@ async function waitForWeiboArticleInlineImage(bodyInput, previousCount, source)
     if (failed > 0) {
       throw new Error(`微博文章正文图片上传失败: ${source}`);
     }
-    if (count > previousCount && pending === 0) {
+    if (count > previousCount + 1) {
+      throw new Error(`微博正文图片疑似重复插入: ${source}`);
+    }
+    if (count === previousCount + 1 && pending === 0) {
       stableChecks += 1;
       if (stableChecks >= 3) {
         return;
@@ -5767,10 +6016,24 @@ async function visibleWeiboCropDialog(page) {
 
 async function clearExistingWeiboArticleImages(page, scope) {
   const items = scope.locator(".image-list .image-item");
+  // The gallery list is populated asynchronously after the dialog opens. Give
+  // existing items a short window to appear before treating the library as empty.
+  let previousCount = await items.count().catch(() => 0);
+  if (previousCount === 0) {
+    const deadline = Date.now() + 5000;
+    do {
+      await page.waitForTimeout(200);
+      previousCount = await items.count().catch(() => 0);
+      if (previousCount > 0) break;
+    } while (Date.now() < deadline);
+  }
+  if (previousCount === 0) {
+    return 0;
+  }
   let cleared = 0;
   while (cleared < 200) {
-    const previousCount = await items.count().catch(() => 0);
-    if (previousCount === 0) {
+    const currentCount = await items.count().catch(() => 0);
+    if (currentCount === 0) {
       return cleared;
     }
     const item = items.first();
@@ -5783,10 +6046,10 @@ async function clearExistingWeiboArticleImages(page, scope) {
     }
     await remove.click();
     const deadline = Date.now() + 10000;
-    let currentCount = previousCount;
+    let afterDeleteCount = currentCount;
     do {
-      currentCount = await items.count().catch(() => previousCount);
-      if (currentCount < previousCount) {
+      afterDeleteCount = await items.count().catch(() => currentCount);
+      if (afterDeleteCount < currentCount) {
         break;
       }
       const text = typeof scope.innerText === "function" ? await scope.innerText().catch(() => "") : "";
@@ -5795,14 +6058,26 @@ async function clearExistingWeiboArticleImages(page, scope) {
       }
       await page.waitForTimeout(200);
     } while (Date.now() < deadline);
-    if (currentCount >= previousCount) {
+    if (afterDeleteCount >= currentCount) {
       throw new Error("微博头条文章图片库旧图片删除后未消失");
     }
-    cleared += previousCount - currentCount;
+    cleared += currentCount - afterDeleteCount;
   }
   throw new Error("微博头条文章图片库旧图片超过 200 张，已停止清理");
 }
 
+async function waitForWeiboArticleImageList(page, scope, timeoutMs = 10000) {
+  const list = scope.locator(".image-list");
+  const deadline = Date.now() + timeoutMs;
+  do {
+    if ((await list.count().catch(() => 0)) > 0) {
+      return true;
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return false;
+}
+
 async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, source, options = {}) {
   options.onProgress?.("正在打开图片库");
   const imageButton = await weiboArticleImageButton(page);
@@ -5810,7 +6085,7 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
     throw new Error("微博头条文章编辑器中未找到图片库按钮");
   }
   await imageButton.click();
-  const input = await firstExisting(page, spec.imageInputs);
+  const input = await waitForExisting(page, spec.imageInputs, 15000);
   if (!input || typeof input.setInputFiles !== "function") {
     throw new Error("微博头条文章图片库中未找到上传控件");
   }
@@ -5818,7 +6093,7 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
     'xpath=ancestor::*[.//*[normalize-space(text())="图片库"] and .//*[normalize-space(text())="插入"]][1]'
   );
   const scope = (await modal.count().catch(() => 0)) > 0 ? modal : page;
-  const structuredLibrary = (await scope.locator(".image-list").count().catch(() => 0)) > 0;
+  const structuredLibrary = await waitForWeiboArticleImageList(page, scope, 10000);
   if (structuredLibrary && options.clearExistingLibrary) {
     options.onProgress?.("正在清理图片库旧图");
     await clearExistingWeiboArticleImages(page, scope);
@@ -5839,6 +6114,9 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
           .catch(() => [])
       : [];
   const previousImages = await bodyInput.locator("img:not(.ProseMirror-separator)").count();
+  if (options.clearExistingLibrary && (await previews.count().catch(() => 0)) !== 0) {
+    throw new Error(`微博图片库旧图未清空，已停止上传: ${source}`);
+  }
   options.onProgress?.("正在上传正文图片");
   await input.setInputFiles([payload]);
 
@@ -5885,10 +6163,12 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
   if (candidateIndexes.length === 0 && previewCount > previousPreviews) {
     candidateIndexes = Array.from({ length: previewCount - previousPreviews }, (_, offset) => previousPreviews + offset);
   }
-  if (candidateIndexes.length === 0 && previewCount > 0) {
-    candidateIndexes = [previewCount - 1];
+  if (candidateIndexes.length === 0) {
+    throw new Error(`微博文章图片上传后未识别到本次上传的缩略图: ${source}`);
   }
-  if (structuredLibrary && candidateIndexes.length > 0) {
+  if (options.clearExistingLibrary && previewCount === 1) {
+    uploadedPreview = previews.first();
+  } else if (structuredLibrary && candidateIndexes.length > 0) {
     // Let the common click-and-verify path below perform the selection once.
     uploadedPreview = previews.nth(candidateIndexes[0]);
   }
@@ -5950,12 +6230,19 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
   await insertButton.click();
   await page.waitForTimeout(300);
   if (scope !== page && typeof scope.isVisible === "function" && (await scope.isVisible().catch(() => false))) {
-    const retryInsert = typeof scope.getByRole === "function"
-      ? scope.getByRole("button", { name: "插入", exact: true }).last()
-      : insertButton;
-    if ((await retryInsert.count().catch(() => 0)) > 0 && !(await weiboControlDisabled(retryInsert))) {
-      await retryInsert.click({ force: true });
-      await page.waitForTimeout(300);
+    // A successful click normally closes the library or opens the crop dialog.
+    // Only retry when neither happened and the editor image count is unchanged;
+    // an unconditional second click can insert the same image twice.
+    const cropStarted = await visibleWeiboCropDialog(page);
+    const currentImages = await bodyInput.locator("img:not(.ProseMirror-separator)").count().catch(() => previousImages);
+    if (!cropStarted && currentImages === previousImages) {
+      const retryInsert = typeof scope.getByRole === "function"
+        ? scope.getByRole("button", { name: "插入", exact: true }).last()
+        : insertButton;
+      if ((await retryInsert.count().catch(() => 0)) > 0 && !(await weiboControlDisabled(retryInsert))) {
+        await retryInsert.click({ force: true });
+        await page.waitForTimeout(300);
+      }
     }
   }
 
@@ -6011,10 +6298,15 @@ async function clearWeiboArticleBody(page, bodyInput) {
     await page.waitForTimeout(100);
   }
 
-  let remaining = await bodyInput
-    .evaluate(element => String(element.innerText || element.textContent || "").trim())
-    .catch(() => "");
-  if (typeof remaining === "string" && remaining) {
+  const readBodyState = async () =>
+    bodyInput
+      .evaluate(element => ({
+        text: String(element.innerText || element.textContent || "").trim(),
+        images: element.querySelectorAll("img:not(.ProseMirror-separator)").length
+      }))
+      .catch(() => ({ text: "", images: 0 }));
+  let remaining = await readBodyState();
+  if (remaining.text || remaining.images > 0) {
     await bodyInput.evaluate(element => {
       element.replaceChildren(document.createElement("p"));
       element.dispatchEvent(
@@ -6026,15 +6318,121 @@ async function clearWeiboArticleBody(page, bodyInput) {
       );
     });
     await page.waitForTimeout(100);
-    remaining = await bodyInput
-      .evaluate(element => String(element.innerText || element.textContent || "").trim())
-      .catch(() => "");
+    remaining = await readBodyState();
   }
-  if (typeof remaining === "string" && remaining) {
+  if (remaining.text || remaining.images > 0) {
     throw new Error("微博文章正文未能清空，已停止发布以避免复用旧草稿内容");
   }
 }
 
+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);
@@ -6248,7 +6646,7 @@ export async function insertWeiboArticleRichContent(page, bodyInput, article, sp
       payloadCache.set(item.source, payload);
     }
     await uploadWeiboArticleInlineImage(page, activeBodyInput, spec, payload, item.source, {
-      clearExistingLibrary: imageIndex === 0,
+      clearExistingLibrary: true,
       onProgress: options.onProgress
     });
   }
@@ -6786,6 +7184,43 @@ async function findWeiboShareSubmitButton(page, dialog) {
   return findIn(page);
 }
 
+async function preparedWeiboArticleState(page, spec, article, title) {
+  if (!(await waitForEditorReady(page, () => editorIsReady(page, spec), 5000))) return null;
+  const titleInput = await waitForVisible(page, spec.title, 3000);
+  const bodyInput = await waitForVisible(page, spec.body, 3000);
+  if (!titleInput || !bodyInput) return null;
+  if (normalizeText(await readFilledValue(titleInput)) !== normalizeText(title)) return null;
+
+  const expected = buildWeiboRichContent(article);
+  const state =
+    typeof bodyInput.evaluate === "function"
+      ? await bodyInput
+          .evaluate(element => ({
+            text: element.innerText || element.textContent || "",
+            images: element.querySelectorAll("img:not(.ProseMirror-separator)").length,
+            links: element.querySelectorAll("a[href]").length,
+            failedImages: element.querySelectorAll('[class*="upload-fail"], [class*="upload-error"]').length
+          }))
+          .catch(() => null)
+      : null;
+  const actualText = normalizedPresenceText(state?.text || normalizeText(await readFilledValue(bodyInput)));
+  if (!actualText || state?.failedImages > 0) return null;
+  if (state && state.images < expected.images.length) return null;
+  const expectedFragments = expected.items
+    .filter(item => item.type === "html" && item.plain)
+    .map(item => normalizedPresenceText(item.plain))
+    .filter(Boolean);
+  if (expectedFragments.length > 0 && !hasOrderedTextFragments(actualText, expectedFragments)) return null;
+  return {
+    richContent: {
+      rich: true,
+      images: state?.images ?? expected.images.length,
+      links: state?.links ?? expected.links.length,
+      plainText: expected.plainText
+    }
+  };
+}
+
 async function publishWeibo(page, entry, article, spec, options, promptUser) {
   const progress = message => options.onProgress?.(message);
   const preparedArticle = prepareWeiboArticleForProject(article, entry);
@@ -6800,6 +7235,24 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
   }
 
   const editorUrl = weiboArticleEditorUrl(entry.url);
+  if (options.directPublish) {
+    const context = typeof page.context === "function" ? page.context() : null;
+    const preparedPage = context ? await findPreparedEditorPage(context, spec) : null;
+    if (preparedPage) page = preparedPage;
+  }
+  const directPrepared = options.directPublish
+    ? await preparedWeiboArticleState(page, spec, preparedArticle, title)
+    : null;
+  if (options.directPublish && !directPrepared) {
+    throw new Error("微博待发布编辑页未找到与当前文章一致的已准备内容；请重新准备后再授权发布");
+  }
+  let richContent = directPrepared?.richContent || null;
+  let cover = {};
+  let column = "";
+  if (options.directPublish) {
+    progress("已复用当前微博待发内容，正在提交，不重复上传正文图片或封面");
+  }
+  if (!options.directPublish) {
   await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
   await afterNavigation(page);
   if (!(await waitForEditorReady(page, () => editorIsReady(page, spec)))) {
@@ -6808,7 +7261,7 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => editorIsReady(page, spec), 120000))) {
-    throw new Error("微博登录完成后仍未进入头条文章编辑器，请确认账号拥有文章发布权限");
+    throw new Error(browserSessionLoginFailure("微博"));
   }
 
   const draftMode = await ensureWeiboArticleDraft(page, title);
@@ -6825,12 +7278,13 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
   }
   await fillStableWeiboField(page, spec.title, title, "标题");
   const stableBodyInput = (await waitForVisible(page, spec.body, 3000)) || bodyInput;
-  const richContent = await insertWeiboArticleRichContent(page, stableBodyInput, preparedArticle, spec, body, {
+  richContent = await insertWeiboArticleRichContent(page, stableBodyInput, preparedArticle, spec, body, {
     onProgress: progress
   });
   progress("正文已写入，正在设置封面");
-  const cover = await applyWeiboArticleCover(page, preparedArticle, settings, { onProgress: progress });
-  const column = await applyWeiboArticleColumn(page, settings.column, { onProgress: progress });
+  cover = await applyWeiboArticleCover(page, preparedArticle, settings, { onProgress: progress });
+  column = await applyWeiboArticleColumn(page, settings.column, { onProgress: progress });
+  }
 
   const nextButton = await waitForVisibleButton(page, spec.next, 5000);
   if (!nextButton) {
@@ -6927,7 +7381,26 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
       }
       const shareSubmit = await findWeiboShareSubmitButton(page, shareComposer.dialog);
       if (!shareSubmit) {
-        throw new Error("微博分享发布弹窗中未找到“发布”按钮");
+        // The article submit can navigate to publish history while the share
+        // composer is still being torn down. Treat that navigation as a
+        // successful article submission instead of reporting a false failure.
+        const historyDeadline = Date.now() + 3000;
+        while (!/\/history\//i.test(page.url()) && Date.now() < historyDeadline) {
+          await page.waitForTimeout(200);
+        }
+        if (/\/history\//i.test(page.url())) {
+          progress("微博文章已提交，分享弹窗已自动关闭");
+          confirmation = { confirmation: "navigation" };
+        } else {
+          throw new Error("微博分享发布弹窗中未找到“发布”按钮");
+        }
+      }
+      if (confirmation) {
+        progress("已收到微博发布成功回执");
+        if (options.keepOpen) {
+          await promptUser("微博头条文章已收到发布成功回执，浏览器保持打开供检查");
+        }
+        return { url: page.url(), status: "published", type: "article", title, ...richContent, ...cover, column, ...confirmation };
       }
       if (typeof shareSubmit.isDisabled === "function" && (await shareSubmit.isDisabled().catch(() => false))) {
         throw new Error("微博分享发布弹窗中的“发布”按钮不可用");
@@ -7511,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,
@@ -7702,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;
@@ -7722,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)
@@ -7770,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, "正文");
@@ -7786,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);
@@ -7797,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 {
@@ -7806,7 +8303,8 @@ export async function publishWithBrowser(entry, article, options = {}) {
         draftOnly: true,
         approvalRequired: true,
         approvalActions: ["publish", "cancel"],
-        ...richContent
+        ...richContent,
+        ...platformMedia
       };
     }
     if (entry.platformKey === "haoyou") {
@@ -7827,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.20",
+  "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"
   }