@qcplay/cli 1.0.12 → 1.0.14

package/lib/platform-publish.js

@@ -0,0 +1,4473 @@
+import { spawn } from "child_process";
+import fs from "fs";
+import http from "http";
+import https from "https";
+import os from "os";
+import path from "path";
+import readline from "readline";
+
+import * as cheerio from "cheerio";
+
+const PLATFORM_CONFIG_URL = "https://t4blw8ys5w.feishu.cn/wiki/OqH7wkx9PiBaTYkKeWNc35SonGf";
+const DISCORD_MESSAGE_LIMIT = 2000;
+
+const PLATFORM_ALIASES = new Map([
+  ["官网", "website"],
+  ["website", "website"],
+  ["taptap", "taptap"],
+  ["好游快爆", "haoyou"],
+  ["haoyou", "haoyou"],
+  ["b站", "bilibili"],
+  ["哔哩哔哩", "bilibili"],
+  ["bilibili", "bilibili"],
+  ["微博", "weibo"],
+  ["weibo", "weibo"],
+  ["discord", "discord"],
+  ["reddit", "reddit"],
+  ["x", "x"],
+  ["x（旧twitter）", "x"],
+  ["twitter", "x"],
+  ["facebook&ins", "meta"],
+  ["facebook＆ins", "meta"],
+  ["meta（主instagram）", "meta"],
+  ["meta", "meta"],
+  ["instagram", "instagram"],
+  ["ins", "instagram"],
+  ["line", "line"],
+  ["youtube", "youtube"]
+]);
+
+const BROWSER_PLATFORM_SPECS = {
+  taptap: {
+    manualLogin: true,
+    username: ['input[type="tel"]', 'input[name="phone"]', 'input[placeholder*="手机号"]'],
+    password: ['input[type="password"]'],
+    loginTriggerButtons: [/登录/, /Log in/i],
+    loginButtons: [/登录/, /Log in/i],
+    title: ['input[placeholder^="有意义的标题"]', 'input[placeholder*="标题"]', 'textarea[placeholder*="标题"]'],
+    body: ['#tap-editor__slate-context', '.tap-editor[contenteditable="true"]', '[contenteditable="true"]'],
+    submitSelectors: ['button.tap-button__editor.tap-button--primary'],
+    submit: [/^发布$/, /^发表$/]
+  },
+  haoyou: {
+    manualLogin: true,
+    loginPage: "https://www.3839.com/",
+    loginTriggerSelectors: ["#bannerU .avatar a", "#login_4399user"],
+    loggedInSelectors: ["#bannerU .loginInfoDiv .avatar a", "#bannerU .loginInfoDiv", ".loginInfoDiv .avatar"],
+    passwordLoginSelectors: ["#show_pwd_login_tc"],
+    username: ["#login_accout"],
+    password: ["#login_pwd"],
+    loginSubmitSelectors: ["#login_pwd_btn"],
+    loginButtons: [/登录/],
+    title: [
+      '#threadTitle[contenteditable="true"]',
+      'input[name="subject"]',
+      'input[name="title"]',
+      'input[placeholder*="标题"]'
+    ],
+    body: [
+      '.ql-editor[contenteditable="true"][data-placeholder*="请输入内容"]',
+      'textarea[name="content"]',
+      'textarea[name="message"]',
+      '[contenteditable="true"]'
+    ],
+    submitSelectors: [".editSubmit.active"],
+    submit: [/^发布$/, /^发表$/, /^提交$/]
+  },
+  bilibili: {
+    manualLogin: true,
+    username: ['input[placeholder*="账号"]', 'input[placeholder*="手机号"]', 'input[type="tel"]'],
+    password: ['input[placeholder*="密码"]', 'input[type="password"]'],
+    loginButtons: [/登录/],
+    title: [
+      'input[placeholder*="稿件标题"]',
+      'input[placeholder*="文章标题"]',
+      'input[placeholder*="标题"]',
+      'textarea[placeholder*="标题"]'
+    ],
+    body: [
+      '.ql-editor[contenteditable="true"]',
+      '.ProseMirror[contenteditable="true"]',
+      '.article-editor [contenteditable="true"]',
+      '[contenteditable="true"][role="textbox"]'
+    ],
+    videoBody: [
+      'textarea[placeholder*="简介"]',
+      'textarea[placeholder*="描述"]',
+      '.desc-text-wrp textarea',
+      '.ql-editor[contenteditable="true"]',
+      '[contenteditable="true"][data-placeholder*="简介"]',
+      '[contenteditable="true"][aria-label*="简介"]',
+      '[contenteditable="true"][role="textbox"]'
+    ],
+    articleImageButtons: [
+      'eva3-toolbar-image',
+      '.eva3-toolbar eva3-toolbar-image.eva3-toolbar-item',
+      'button.ql-image',
+      '.ql-toolbar .ql-image',
+      '[data-title="图片"]',
+      '[aria-label*="图片"]'
+    ],
+    articleImageInputs: [
+      '.article-editor input[type="file"][accept*="image"]',
+      '.ql-toolbar input[type="file"][accept*="image"]',
+      '.editor-toolbar input[type="file"][accept*="image"]'
+    ],
+    videoInputs: [
+      'input[type="file"][accept*="video"]',
+      '.upload-v2-container input[type="file"]',
+      '.video-upload input[type="file"]'
+    ],
+    coverInputs: [
+      '.cover-v2-container input[type="file"][accept*="image"]',
+      '.cover-upload input[type="file"][accept*="image"]',
+      '.cover-box input[type="file"][accept*="image"]'
+    ],
+    category: [
+      'input[placeholder*="分区"]',
+      '[class*="partition"] .select-controller',
+      '[class*="partition"] [role="combobox"]'
+    ],
+    tags: [
+      '.tag-input-wrp input',
+      'input[placeholder*="回车"][placeholder*="标签"]',
+      'input[placeholder*="标签"]'
+    ],
+    topic: [
+      'input[placeholder*="搜索话题"]',
+      'input[placeholder*="添加话题"]',
+      'input[placeholder*="选择话题"]',
+      '.topic-selector input',
+      '[class*="topic"] input[placeholder]'
+    ],
+    submitSelectors: ['button.submit-add', 'button.submit-btn', '.submit-add', '.submit-btn'],
+    submit: [/^发布$/, /^立即发布$/, /^提交文章$/, /^立即投稿$/, /^投稿$/]
+  },
+  weibo: {
+    manualLogin: true,
+    username: ['input[name="username"]', 'input[placeholder*="手机号"]'],
+    password: ['input[name="password"]', 'input[type="password"]'],
+    loginButtons: [/登录/],
+    title: ['textarea[placeholder="请输入标题"]', 'textarea[placeholder*="请输入标题"]'],
+    intro: ['textarea[placeholder*="导语"]'],
+    body: ['.tiptap.ProseMirror[contenteditable="true"]', '.wb-editor.ProseMirror[contenteditable="true"]'],
+    imageInputs: ['input[type="file"][accept*=".jpg"]', 'input[type="file"][accept*="image"]'],
+    next: [/^下一步$/],
+    submit: [/^发布$/, /^确认发布$/, /^立即发布$/]
+  },
+  x: {
+    username: ['input[autocomplete="username"]', 'input[name="text"]'],
+    password: ['input[name="password"]', 'input[type="password"]'],
+    loginButtons: [/Next/i, /Log in/i],
+    body: ['[data-testid="tweetTextarea_0"]', '[contenteditable="true"]'],
+    submitSelectors: ['[data-testid="tweetButton"]', '[data-testid="tweetButtonInline"]'],
+    submit: [/^Post$/i]
+  },
+  meta: {
+    username: ['input[name="email"]', 'input[type="email"]'],
+    password: ['input[name="pass"]', 'input[type="password"]'],
+    loginButtons: [/Log in/i, /登录/],
+    body: ['[contenteditable="true"]', 'textarea'],
+    submit: [/^Publish$/i, /^Post$/i, /^发布$/]
+  },
+  instagram: {
+    username: ['input[name="username"]'],
+    password: ['input[name="password"]'],
+    loginButtons: [/Log in/i, /登录/],
+    body: ['textarea', '[contenteditable="true"]'],
+    submit: [/^Share$/i, /^分享$/]
+  }
+};
+
+function normalizeText(value) {
+  return String(value ?? "").trim();
+}
+
+function normalizeKey(value) {
+  return normalizeText(value).toLowerCase().replace(/\s+/g, "");
+}
+
+function normalizeAccount(value) {
+  const text = normalizeText(value);
+  if (text === "/") {
+    return "";
+  }
+  if (/^\d+(?:\.\d+)?e\+\d+$/i.test(text)) {
+    const number = Number(text);
+    if (Number.isSafeInteger(number)) {
+      return number.toFixed(0);
+    }
+  }
+  return text;
+}
+
+export function canonicalPlatformName(value) {
+  const key = normalizeKey(value);
+  return PLATFORM_ALIASES.get(key) || key;
+}
+
+export function authModeForEntry(entry) {
+  const platformKey = entry.platformKey || canonicalPlatformName(entry.platform);
+  if (platformKey === "website" || (platformKey === "discord" && discordWebhookFromEntry(entry))) {
+    return "api";
+  }
+  if (BROWSER_PLATFORM_SPECS[platformKey]?.manualLogin) {
+    return "manual";
+  }
+  const account = normalizeText(entry.account);
+  const password = normalizeText(entry.password);
+  const requirements = normalizeText(entry.requirements);
+  const combined = `${account}\n${password}\n${requirements}`;
+  if (/扫码/.test(combined)) {
+    return "qr";
+  }
+  if (/验证码|验证器|手机验证/.test(combined)) {
+    return "verification";
+  }
+  if (account && password && !/^(密码登录|验证码登录)$/i.test(password)) {
+    return "password";
+  }
+  return "session";
+}
+
+export function platformPublisherForEntry(entry) {
+  if (entry.platformKey === "website") {
+    return "official-api";
+  }
+  if (entry.platformKey === "discord" && discordWebhookFromEntry(entry)) {
+    return "discord-webhook";
+  }
+  if (entry.platformKey === "reddit") {
+    return "blocked";
+  }
+  if (BROWSER_PLATFORM_SPECS[entry.platformKey]) {
+    return "browser";
+  }
+  return "unavailable";
+}
+
+function rowsFromLarkEnvelope(value) {
+  const sheet = value?.data?.sheets?.[0];
+  if (!sheet || !Array.isArray(sheet.columns) || !Array.isArray(sheet.data)) {
+    throw new Error("飞书平台配置返回格式不正确");
+  }
+  return sheet.data.map(row =>
+    Object.fromEntries(sheet.columns.map((column, index) => [column, row[index] ?? null]))
+  );
+}
+
+export function normalizePlatformRows(rows) {
+  return rows
+    .map((row, index) => {
+      const platform = normalizeText(row["平台"] ?? row.platform);
+      const project = normalizeText(row["项目"] ?? row.project);
+      if (!platform || !project) {
+        return null;
+      }
+      const platformKey = canonicalPlatformName(platform);
+      const manualLogin = Boolean(BROWSER_PLATFORM_SPECS[platformKey]?.manualLogin);
+      const entry = {
+        rowNumber: index + 2,
+        project,
+        region: normalizeText(row["区域"] ?? row.region) || "未指定",
+        source: normalizeText(row["分发来源"] ?? row.source),
+        platform,
+        platformKey,
+        url: normalizeText(row["页面URL链接"] ?? row.url),
+        account: manualLogin ? "" : normalizeAccount(row["账号"] ?? row.account),
+        password: manualLogin ? "" : normalizeAccount(row["密码"] ?? row.password),
+        requirements: normalizeText(row["特殊要求"] ?? row.requirements)
+      };
+      entry.authMode = authModeForEntry(entry);
+      entry.publisher = platformPublisherForEntry(entry);
+      return entry;
+    })
+    .filter(Boolean);
+}
+
+function runJson(command, args) {
+  return new Promise((resolve, reject) => {
+    const executable = process.platform === "win32" ? `${command}.cmd` : command;
+    const child = spawn(executable, args, {
+      windowsHide: true,
+      shell: process.platform === "win32",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const stdout = [];
+    const stderr = [];
+    child.stdout.on("data", chunk => stdout.push(chunk));
+    child.stderr.on("data", chunk => stderr.push(chunk));
+    child.once("error", error => reject(new Error(`无法启动 ${command}: ${error.message}`)));
+    child.once("close", code => {
+      const output = Buffer.concat(stdout).toString("utf8").trim();
+      const diagnostics = Buffer.concat(stderr).toString("utf8").trim();
+      if (code !== 0) {
+        reject(new Error(diagnostics || output || `${command} 执行失败 (${code})`));
+        return;
+      }
+      try {
+        resolve(JSON.parse(output));
+      } catch {
+        reject(new Error(`${command} 没有返回有效 JSON`));
+      }
+    });
+  });
+}
+
+export async function loadPlatformEntries(options = {}) {
+  let value;
+  if (options.configFile) {
+    const configFile = path.resolve(process.cwd(), options.configFile);
+    value = JSON.parse(await fs.promises.readFile(configFile, "utf8"));
+  } else {
+    value = await runJson("lark-cli", [
+      "sheets",
+      "+table-get",
+      "--url",
+      PLATFORM_CONFIG_URL,
+      "--as",
+      "user",
+      "--format",
+      "json"
+    ]);
+  }
+
+  const rows = Array.isArray(value) ? value : Array.isArray(value.rows) ? value.rows : rowsFromLarkEnvelope(value);
+  return normalizePlatformRows(rows);
+}
+
+function entryLabel(entry) {
+  return `${entry.platform}（${entry.region}）`;
+}
+
+export function availableProjects(entries) {
+  return [...new Set(entries.map(entry => entry.project))];
+}
+
+export function entriesForProject(entries, project, region = "") {
+  const projectKey = normalizeKey(project);
+  const regionKey = normalizeKey(region);
+  return entries.filter(
+    entry => normalizeKey(entry.project) === projectKey && (!regionKey || normalizeKey(entry.region) === regionKey)
+  );
+}
+
+export function selectRequestedEntries(entries, requestedPlatforms) {
+  const selected = [];
+  for (const requested of requestedPlatforms) {
+    const key = canonicalPlatformName(requested);
+    const matches = entries.filter(entry => entry.platformKey === key);
+    if (matches.length === 0) {
+      throw new Error(`当前项目没有平台: ${requested}`);
+    }
+    if (matches.length > 1) {
+      throw new Error(`平台 ${requested} 对应多个区域，请同时使用 --region 指定区域`);
+    }
+    if (!selected.includes(matches[0])) {
+      selected.push(matches[0]);
+    }
+  }
+  return selected;
+}
+
+function question(rl, prompt) {
+  return new Promise(resolve => rl.question(prompt, answer => resolve(answer.trim())));
+}
+
+export async function promptForPlatformEntries(entries, streams = {}) {
+  const input = streams.input || process.stdin;
+  const output = streams.output || process.stdout;
+  if (!input.isTTY || !output.isTTY) {
+    const choices = entries.map(entry => entryLabel(entry)).join("、");
+    throw new Error(`未指定发布平台。可用平台: ${choices}。请使用 --platform <平台> 指定`);
+  }
+
+  output.write("\n可发布平台:\n\n");
+  entries.forEach((entry, index) => {
+    output.write(`  ${index + 1}. ${entryLabel(entry)} [${entry.publisher}]\n`);
+  });
+  output.write("\n");
+
+  const rl = readline.createInterface({ input, output });
+  try {
+    const answer = await question(rl, "请选择平台编号（多个用逗号分隔，all 表示全部）: ");
+    if (normalizeKey(answer) === "all") {
+      return [...entries];
+    }
+    const indexes = answer
+      .split(/[,，\s]+/)
+      .filter(Boolean)
+      .map(value => Number(value));
+    if (indexes.length === 0 || indexes.some(index => !Number.isInteger(index) || index < 1 || index > entries.length)) {
+      throw new Error("平台编号无效");
+    }
+    return [...new Set(indexes)].map(index => entries[index - 1]);
+  } finally {
+    rl.close();
+  }
+}
+
+export function publicEntrySummary(entry) {
+  return {
+    project: entry.project,
+    region: entry.region,
+    platform: entry.platform,
+    auth: entry.authMode,
+    publisher: entry.publisher,
+    configured: Boolean(entry.url || entry.publisher === "official-api")
+  };
+}
+
+function discordWebhookFromEntry(entry) {
+  const match = `${entry.url}\n${entry.requirements}`.match(/https:\/\/(?:canary\.|ptb\.)?discord(?:app)?\.com\/api\/webhooks\/[^\s]+/i);
+  return match?.[0] || "";
+}
+
+function splitDiscordContent(title, markdown) {
+  const source = `**${title}**\n\n${normalizeText(markdown)}`.trim();
+  const chunks = [];
+  let remaining = source;
+  while (remaining.length > DISCORD_MESSAGE_LIMIT) {
+    let splitAt = remaining.lastIndexOf("\n", DISCORD_MESSAGE_LIMIT);
+    if (splitAt < DISCORD_MESSAGE_LIMIT / 2) {
+      splitAt = DISCORD_MESSAGE_LIMIT;
+    }
+    chunks.push(remaining.slice(0, splitAt).trim());
+    remaining = remaining.slice(splitAt).trim();
+  }
+  if (remaining) {
+    chunks.push(remaining);
+  }
+  return chunks;
+}
+
+function postJson(urlValue, payload) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(urlValue);
+    const body = JSON.stringify(payload);
+    const request = https.request(
+      url,
+      {
+        method: "POST",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(body),
+          "User-Agent": "qcplay-cli"
+        }
+      },
+      response => {
+        const chunks = [];
+        response.on("data", chunk => chunks.push(chunk));
+        response.on("end", () => {
+          const responseBody = Buffer.concat(chunks).toString("utf8");
+          if ((response.statusCode || 0) < 200 || (response.statusCode || 0) >= 300) {
+            reject(new Error(`Discord webhook 返回 ${response.statusCode}: ${responseBody.slice(0, 160)}`));
+            return;
+          }
+          resolve();
+        });
+      }
+    );
+    request.once("error", reject);
+    request.end(body);
+  });
+}
+
+export async function publishDiscord(entry, article, options = {}) {
+  const webhook = discordWebhookFromEntry(entry);
+  if (!webhook) {
+    throw new Error("Discord 配置缺少 webhook，无法使用 API 发布");
+  }
+  const chunks = splitDiscordContent(article.title, article.markdown);
+  const send = options.postJson || postJson;
+  for (const chunk of chunks) {
+    await send(webhook, { content: chunk, allowed_mentions: { parse: [] } });
+  }
+  return { messages: chunks.length };
+}
+
+function plainTextForPlatform(article, platformKey) {
+  const $ = cheerio.load(article.html || "", null, false);
+  $("br").replaceWith("\n");
+  $("p,section,div,h1,h2,h3,h4,h5,h6,li,blockquote,tr").each((_, element) => {
+    $(element).append("\n");
+  });
+  $("img").each((_, element) => {
+    const image = $(element);
+    image.replaceWith(image.attr("src") ? `\n${image.attr("src")}\n` : "");
+  });
+  const markdown = normalizeText($.root().text() || article.markdown)
+    .replace(/[ \t]+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n");
+  if (platformKey === "x") {
+    return `${article.title}\n\n${markdown}`.trim();
+  }
+  return markdown;
+}
+
+const TAPTAP_TYPES = new Map([
+  ["long-post", "topic"],
+  ["longpost", "topic"],
+  ["topic", "topic"],
+  ["长帖", "topic"],
+  ["长贴", "topic"],
+  ["image-text", "moment"],
+  ["imagetext", "moment"],
+  ["moment", "moment"],
+  ["图文", "moment"],
+  ["video", "video"],
+  ["视频", "video"]
+]);
+
+function boolLike(value) {
+  return /^(?:1|true|yes|on|是|启用|需要|定时|草稿)$/i.test(normalizeText(value));
+}
+
+function falseLike(value) {
+  return /^(?:0|false|no|off|否|禁用|不添加|无)$/i.test(normalizeText(value));
+}
+
+function tapTapMeta(article, ...keys) {
+  for (const key of keys) {
+    const value = article.meta?.[key];
+    if (normalizeText(value)) {
+      return normalizeText(value);
+    }
+  }
+  return "";
+}
+
+function splitTapTapFiles(value) {
+  return normalizeText(value)
+    .split(/[,，;；|]/)
+    .map(item => item.trim())
+    .filter(Boolean);
+}
+
+export function resolveTapTapPublishingOptions(article, entry = {}) {
+  const requestedType = normalizeKey(tapTapMeta(article, "taptap_type", "taptap_mode") || "long-post");
+  const type = TAPTAP_TYPES.get(requestedType);
+  if (!type) {
+    throw new Error("taptap_type 仅支持 long-post、image-text 或 video");
+  }
+
+  const forumValue = tapTapMeta(article, "taptap_forum");
+  const forum = falseLike(forumValue)
+    ? ""
+    : boolLike(forumValue) || !forumValue
+      ? normalizeText(entry.project)
+      : forumValue;
+  const scheduled = boolLike(tapTapMeta(article, "taptap_scheduled", "taptap_schedule"));
+  const draft = boolLike(tapTapMeta(article, "taptap_draft"));
+  if (scheduled && draft) {
+    throw new Error("taptap_scheduled 与 taptap_draft 不能同时启用");
+  }
+  return {
+    type,
+    typeLabel: type === "topic" ? "长帖" : type === "moment" ? "图文" : "视频",
+    forum,
+    scheduled,
+    draft,
+    images: splitTapTapFiles(tapTapMeta(article, "taptap_images")),
+    video: tapTapMeta(article, "taptap_video") || normalizeText(article.payload?.video_link),
+    cover: tapTapMeta(article, "taptap_cover")
+  };
+}
+
+export function tapTapPublishingPlan(article, entry = {}) {
+  const settings = resolveTapTapPublishingOptions(article, entry);
+  const imageCount = settings.images.length
+    ? settings.images.length
+    : [...new Set([...imageSourcesFromArticle(article), normalizeText(article.payload?.thumbnail)].filter(Boolean))].length;
+  return {
+    type: settings.typeLabel,
+    forum: settings.forum || "",
+    scheduled: settings.scheduled,
+    draft: settings.draft,
+    media: settings.type === "video" ? Boolean(settings.video) : settings.type === "moment" ? Math.min(imageCount, 18) : 0,
+    cover: settings.type === "topic" && Boolean(settings.cover)
+  };
+}
+
+function weiboMeta(article, ...keys) {
+  for (const key of keys) {
+    const value = article.meta?.[key];
+    if (normalizeText(value)) {
+      return normalizeText(value);
+    }
+  }
+  return "";
+}
+
+export function buildWeiboText(article) {
+  return buildTapTapRichContent(article).plainText || plainTextForPlatform(article, "weibo");
+}
+
+export function buildWeiboRichContent(article) {
+  const content = buildPlatformRichContent(article, {
+    preserveBackground: true,
+    preserveBlockStyles: true,
+    structuredTables: true
+  });
+  const seenImages = new Set();
+  const items = content.items.filter(item => {
+    if (item.type !== "image") {
+      return true;
+    }
+    const key = weiboImageSourceKey(item.source);
+    if (!key || seenImages.has(key)) {
+      return false;
+    }
+    seenImages.add(key);
+    return true;
+  });
+  return {
+    ...content,
+    items,
+    images: items.filter(item => item.type === "image")
+  };
+}
+
+export function resolveWeiboPublishingOptions(article) {
+  return {
+    intro: weiboMeta(article, "weibo_intro") || normalizeText(article.payload?.article_excerpt),
+    cover: weiboMeta(article, "weibo_cover")
+  };
+}
+
+export function weiboPublishingPlan(article) {
+  const settings = resolveWeiboPublishingOptions(article);
+  const richContent = buildWeiboRichContent(article);
+  return {
+    type: "头条文章",
+    characters: richContent.plainText.length,
+    images: richContent.images.length,
+    links: richContent.links.length,
+    intro: Boolean(settings.intro),
+    cover: settings.cover ? "explicit" : richContent.images.length > 0 ? "first-image" : ""
+  };
+}
+
+const BILIBILI_TYPES = new Map([
+  ["article", "article"],
+  ["text", "article"],
+  ["column", "article"],
+  ["专栏", "article"],
+  ["图文", "article"],
+  ["video", "video"],
+  ["视频", "video"]
+]);
+
+function bilibiliMeta(article, ...keys) {
+  for (const key of keys) {
+    const value = article.meta?.[key];
+    if (normalizeText(value)) {
+      return normalizeText(value);
+    }
+  }
+  return "";
+}
+
+export function resolveBilibiliPublishingOptions(article) {
+  const requestedType = normalizeKey(bilibiliMeta(article, "bilibili_type", "bilibili_mode") || "article");
+  const type = BILIBILI_TYPES.get(requestedType);
+  if (!type) {
+    throw new Error("bilibili_type 仅支持 article 或 video");
+  }
+  return {
+    type,
+    typeLabel: type === "video" ? "视频" : "专栏",
+    video: bilibiliMeta(article, "bilibili_video") || normalizeText(article.payload?.video_link),
+    cover: bilibiliMeta(article, "bilibili_cover"),
+    category: bilibiliMeta(article, "bilibili_category"),
+    tags: splitTapTapFiles(bilibiliMeta(article, "bilibili_tags")),
+    topic: bilibiliMeta(article, "bilibili_topic")
+  };
+}
+
+export function bilibiliPublishingPlan(article) {
+  const settings = resolveBilibiliPublishingOptions(article);
+  const richContent = buildBilibiliRichContent(article);
+  return {
+    type: settings.typeLabel,
+    video: settings.type === "video" && Boolean(settings.video),
+    cover: Boolean(settings.cover),
+    category: settings.category || "",
+    tags: settings.tags.length,
+    topic: settings.topic || "",
+    images: settings.type === "article" ? richContent.images.length : 0,
+    links: richContent.links.length
+  };
+}
+
+function bilibiliEditorUrl(entryUrl, type) {
+  const url = new URL(entryUrl);
+  url.pathname = type === "video" ? "/platform/upload/video/frame" : "/platform/upload/text/new-edit";
+  url.search = "";
+  url.hash = "";
+  return url.toString();
+}
+
+function tapTapEditorUrl(entryUrl, type) {
+  const url = new URL(entryUrl);
+  url.searchParams.set("type", type);
+  return url.toString();
+}
+
+function haoyouEditorUrl(entryUrl) {
+  let url;
+  try {
+    url = new URL(entryUrl);
+  } catch {
+    throw new Error("好游快爆配置的发布页面 URL 无效");
+  }
+  if (url.hostname.toLowerCase() !== "bbs.3839.com") {
+    throw new Error("好游快爆配置必须使用 bbs.3839.com 对应游戏的发布链接");
+  }
+  const fid = normalizeText(url.searchParams.get("fid"));
+  if (!fid || fid === "0") {
+    throw new Error("好游快爆配置缺少对应游戏的有效 fid");
+  }
+  url.pathname = "/index.php";
+  url.searchParams.set("m", "api");
+  url.searchParams.set("c", "thread");
+  url.searchParams.set("a", "sendThreadShow");
+  url.searchParams.set("fid", fid);
+  url.searchParams.set("type", "1");
+  url.hash = "";
+  return url.toString();
+}
+
+function weiboArticleEditorUrl() {
+  return "https://card.weibo.com/article/v5/editor";
+}
+
+function imageSourcesFromArticle(article) {
+  const $ = cheerio.load(article.html || "", null, false);
+  return $("img[src]")
+    .map((_, element) => normalizeText($(element).attr("src")))
+    .get()
+    .filter(Boolean);
+}
+
+const TAPTAP_BLOCK_TAGS = new Set([
+  "article",
+  "aside",
+  "blockquote",
+  "div",
+  "figcaption",
+  "figure",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "header",
+  "li",
+  "main",
+  "ol",
+  "p",
+  "section",
+  "table",
+  "td",
+  "th",
+  "tr",
+  "ul"
+]);
+const TAPTAP_INLINE_TAGS = new Map([
+  ["b", "strong"],
+  ["strong", "strong"],
+  ["i", "em"],
+  ["em", "em"],
+  ["u", "u"],
+  ["s", "s"],
+  ["del", "s"],
+  ["code", "code"]
+]);
+
+function escapeTapTapHtml(value) {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function safeTapTapHref(value) {
+  try {
+    const url = new URL(normalizeText(value));
+    return /^(?:https?):$/.test(url.protocol) ? url.toString() : "";
+  } catch {
+    return "";
+  }
+}
+
+function normalizedTapTapText(value) {
+  return normalizeText(value)
+    .replace(/[\u200b-\u200d\ufeff]/g, "")
+    .replace(/\s+/g, " ");
+}
+
+function normalizedStructuredEditorText(value) {
+  return normalizedTapTapText(value).replace(/\s*：\s*/g, "：");
+}
+
+function safeRichTextColor(value) {
+  const color = normalizeText(value);
+  return /^(?:#[0-9a-f]{3,8}|rgba?\([\d\s.,%]+\)|[a-z]+)$/i.test(color) ? color : "";
+}
+
+function tapTapInlineWrappers(tag, styleValue = "", options = {}) {
+  const wrappers = [];
+  const add = name => {
+    if (!wrappers.includes(name)) {
+      wrappers.push(name);
+    }
+  };
+  const mappedTag = TAPTAP_INLINE_TAGS.get(tag);
+  if (mappedTag) add(mappedTag);
+  if (/font-weight\s*:\s*(?:bold|[6-9]00)/i.test(styleValue)) add("strong");
+  if (/font-style\s*:\s*italic/i.test(styleValue)) add("em");
+  if (/text-decoration[^;]*underline/i.test(styleValue)) add("u");
+  if (/text-decoration[^;]*line-through/i.test(styleValue)) add("s");
+  const safeColor = safeRichTextColor(styleValue.match(/(?:^|;)\s*color\s*:\s*([^;]+)/i)?.[1]);
+  const safeBackground = options.preserveBackground
+    ? safeRichTextColor(styleValue.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i)?.[1])
+    : "";
+  const spanStyles = [safeColor ? `color:${safeColor}` : "", safeBackground ? `background-color:${safeBackground}` : ""]
+    .filter(Boolean)
+    .join(";");
+  return {
+    open: wrappers.map(name => `<${name}>`).join("") + (spanStyles ? `<span style="${spanStyles}">` : ""),
+    close: (spanStyles ? "</span>" : "") + [...wrappers].reverse().map(name => `</${name}>`).join("")
+  };
+}
+
+export function buildTapTapRichContent(article) {
+  return buildPlatformRichContent(article);
+}
+
+function buildPlatformRichContent(article, options = {}) {
+  const $ = cheerio.load(article.html || "", null, false);
+  $("script,style,noscript,iframe,svg,audio,video").remove();
+  const items = [];
+  const links = [];
+  const images = [];
+  let html = "";
+  let plain = "";
+  let blockContext = { tag: "p", align: "", style: "" };
+
+  const appendText = value => {
+    let collapsed = String(value ?? "").replace(/\s+/g, " ");
+    if (!collapsed.trim()) {
+      if (plain && !plain.endsWith(" ")) {
+        html += " ";
+        plain += " ";
+      }
+      return;
+    }
+    if (!plain) {
+      collapsed = collapsed.trimStart();
+    }
+    html += escapeTapTapHtml(collapsed);
+    plain += collapsed;
+  };
+
+  const blockStyleAttribute = (styleValue, alignmentValue = "") => {
+    const blockStyles = [];
+    if (/^(?:left|center|right|justify)$/.test(alignmentValue)) {
+      blockStyles.push(`text-align:${alignmentValue}`);
+    }
+    if (options.preserveBlockStyles) {
+      const color = safeRichTextColor(styleValue.match(/(?:^|;)\s*color\s*:\s*([^;]+)/i)?.[1]);
+      const background = safeRichTextColor(
+        styleValue.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i)?.[1]
+      );
+      if (color) blockStyles.push(`color:${color}`);
+      if (background) blockStyles.push(`background-color:${background}`);
+    }
+    return blockStyles.length > 0 ? ` style="${blockStyles.join(";")}"` : "";
+  };
+
+  const flushHtml = () => {
+    const normalizedPlain = normalizedTapTapText(plain);
+    if (normalizedPlain) {
+      const style = blockStyleAttribute(blockContext.style, blockContext.align);
+      const blockTag = /^h[1-3]$/.test(blockContext.tag)
+        ? blockContext.tag
+        : blockContext.tag === "blockquote"
+          ? "blockquote"
+          : "p";
+      const blockHtml = blockTag === "blockquote" ? `<em>${html.trim()}</em>` : html.trim();
+      const outputTag = blockTag === "blockquote" ? options.quoteTag || blockTag : blockTag;
+      items.push({
+        type: "html",
+        html: `<${outputTag}${style}>${blockHtml}</${outputTag}>`,
+        plain: normalizedPlain,
+        block: blockTag,
+        align: blockContext.align
+      });
+    }
+    html = "";
+    plain = "";
+  };
+
+  const inlineFragment = node => {
+    if (node.type === "text") {
+      const value = String(node.data ?? "").replace(/\s+/g, " ");
+      return { html: escapeTapTapHtml(value), plain: value };
+    }
+    if (node.type !== "tag") {
+      return { html: "", plain: "" };
+    }
+    const tag = String(node.name || node.tagName || "").toLowerCase();
+    const element = $(node);
+    if (/display\s*:\s*none/i.test(element.attr("style") || "")) {
+      return { html: "", plain: "" };
+    }
+    if (tag === "br") {
+      return { html: "<br>", plain: "\n" };
+    }
+    if (tag === "a") {
+      const label = normalizedTapTapText(element.text());
+      const href = safeTapTapHref(element.attr("href"));
+      if (label && href) {
+        links.push({ href, label });
+        return {
+          html: `<a href="${escapeTapTapHtml(href)}">${escapeTapTapHtml(label)}</a>`,
+          plain: label
+        };
+      }
+    }
+    const children = (node.children || []).map(inlineFragment);
+    const childHtml = children.map(child => child.html).join("");
+    const childPlain = children.map(child => child.plain).join("");
+    const wrappers = tapTapInlineWrappers(tag, element.attr("style") || "", options);
+    return { html: `${wrappers.open}${childHtml}${wrappers.close}`, plain: childPlain };
+  };
+
+  const tableGrid = table => {
+    const rows = [];
+    let activeRowspans = [];
+    for (const row of $(table).find("tr").toArray()) {
+      const cells = [];
+      const nextRowspans = [];
+      for (let column = 0; column < activeRowspans.length; column += 1) {
+        const active = activeRowspans[column];
+        if (!active) continue;
+        cells[column] = active.node;
+        if (active.remaining > 1) {
+          nextRowspans[column] = { node: active.node, remaining: active.remaining - 1 };
+        }
+      }
+      let column = 0;
+      for (const cell of $(row).children("th,td").toArray()) {
+        while (cells[column]) column += 1;
+        const colspan = Math.max(1, Number.parseInt($(cell).attr("colspan"), 10) || 1);
+        const rowspan = Math.max(1, Number.parseInt($(cell).attr("rowspan"), 10) || 1);
+        for (let offset = 0; offset < colspan; offset += 1) {
+          cells[column + offset] = cell;
+          if (rowspan > 1) {
+            nextRowspans[column + offset] = { node: cell, remaining: rowspan - 1 };
+          }
+        }
+        column += colspan;
+      }
+      rows.push(cells);
+      activeRowspans = nextRowspans;
+    }
+    return rows;
+  };
+
+  const tableCellContent = cell => {
+    const cellElement = $(cell);
+    const parts = [];
+    const plainParts = [];
+    const renderInlineChildren = node => {
+      const fragments = (node.children || []).map(inlineFragment);
+      return {
+        html: fragments.map(fragment => fragment.html).join(""),
+        plain: normalizedTapTapText(fragments.map(fragment => fragment.plain).join(""))
+      };
+    };
+    for (const child of cellElement.contents().toArray()) {
+      if (child.type === "text") {
+        const value = normalizedTapTapText(child.data);
+        if (value) {
+          parts.push(`<p>${escapeTapTapHtml(value)}</p>`);
+          plainParts.push(value);
+        }
+        continue;
+      }
+      if (child.type !== "tag") continue;
+      const tag = String(child.name || child.tagName || "").toLowerCase();
+      const childElement = $(child);
+      if (tag === "ol" || tag === "ul") {
+        const listItems = childElement
+          .children("li")
+          .toArray()
+          .map(item => renderInlineChildren(item))
+          .filter(item => item.plain);
+        if (listItems.length > 0) {
+          const start = tag === "ol" && /^\d+$/.test(normalizeText(childElement.attr("start")))
+            ? ` start="${normalizeText(childElement.attr("start"))}"`
+            : "";
+          parts.push(`<${tag}${start}>${listItems.map(item => `<li>${item.html}</li>`).join("")}</${tag}>`);
+          plainParts.push(listItems.map(item => item.plain).join("\n"));
+        }
+        continue;
+      }
+      const fragment = renderInlineChildren(child);
+      if (!fragment.plain) continue;
+      const styleValue = childElement.attr("style") || "";
+      const alignment =
+        normalizeText(childElement.attr("align")) ||
+        normalizeText(styleValue.match(/(?:^|;)\s*text-align\s*:\s*([^;]+)/i)?.[1]);
+      const alignmentStyle = /^(?:left|center|right|justify)$/i.test(alignment)
+        ? ` style="text-align:${alignment.toLowerCase()}"`
+        : "";
+      const blockTag = /^h[1-3]$/.test(tag) ? tag : tag === "blockquote" ? options.quoteTag || "blockquote" : "p";
+      parts.push(`<${blockTag}${alignmentStyle}>${fragment.html}</${blockTag}>`);
+      plainParts.push(fragment.plain);
+    }
+    return {
+      html: parts.join(""),
+      plain: plainParts.filter(Boolean).join("\n")
+    };
+  };
+
+  const appendStructuredTable = table => {
+    const rows = tableGrid(table);
+    if (rows.length === 0) return;
+    const headers = rows[0].map((cell, index) => {
+      const fragment = inlineFragment(cell);
+      const plain = normalizedTapTapText(fragment.plain) || `第 ${index + 1} 列`;
+      return { plain, html: normalizedTapTapText(fragment.plain) ? fragment.html : escapeTapTapHtml(plain) };
+    });
+    const dataRows = rows.length > 1 ? rows.slice(1) : rows;
+    const tableImages = new Set();
+    const tableTag = options.structuredTableTag || "blockquote";
+    if (rows.length > 1) {
+      items.push({
+        type: "html",
+        html: `<${tableTag}><p>${headers.map(header => header.html).join(" / ")}</p></${tableTag}>`,
+        plain: headers.map(header => header.plain).join(" / "),
+        block: "table-header",
+        align: "",
+        structuredTableHeader: true
+      });
+    }
+    for (const row of dataRows) {
+      const fields = [];
+      const seenCells = new Set();
+      for (let column = 0; column < row.length; column += 1) {
+        const cell = row[column];
+        if (!cell || seenCells.has(cell)) continue;
+        seenCells.add(cell);
+        for (const image of $(cell).find("img").toArray()) {
+          tableImages.add(image);
+        }
+        const content = tableCellContent(cell);
+        if (!content.plain) continue;
+        fields.push({
+          label: headers[column]?.plain || `第 ${column + 1} 列`,
+          ...content
+        });
+      }
+      if (fields.length === 0) continue;
+      const title = fields.shift();
+      const rowHtml = [
+        `<p><strong>${escapeTapTapHtml(title.label)}：</strong></p>${title.html}`,
+        ...fields.map(field => `<p><strong>${escapeTapTapHtml(field.label)}：</strong></p>${field.html}`)
+      ].join("");
+      const rowPlain = [
+        `${title.label}：${title.plain}`,
+        ...fields.map(field => `${field.label}：${field.plain}`)
+      ].join("\n");
+      items.push({
+        type: "html",
+        html: `<${tableTag}>${rowHtml}</${tableTag}>`,
+        plain: rowPlain,
+        block: "table-row",
+        align: "",
+        structuredTable: true
+      });
+    }
+    for (const element of tableImages) {
+      const source = normalizeText($(element).attr("src") || $(element).attr("data-src"));
+      if (!source) continue;
+      const image = {
+        type: "image",
+        source,
+        alt: normalizeText($(element).attr("alt")).slice(0, 50)
+      };
+      items.push(image);
+      images.push(image);
+    }
+  };
+
+  const walk = node => {
+    if (node.type === "text") {
+      appendText(node.data);
+      return;
+    }
+    if (node.type !== "tag") {
+      return;
+    }
+    const tag = String(node.name || node.tagName || "").toLowerCase();
+    const element = $(node);
+    if (/display\s*:\s*none/i.test(element.attr("style") || "")) {
+      return;
+    }
+    if (tag === "img") {
+      flushHtml();
+      const source = normalizeText(element.attr("src") || element.attr("data-src"));
+      if (source) {
+        const image = {
+          type: "image",
+          source,
+          alt: normalizeText(element.attr("alt")).slice(0, 50)
+        };
+        items.push(image);
+        images.push(image);
+      }
+      return;
+    }
+    if (tag === "br") {
+      html += "<br>";
+      plain += "\n";
+      return;
+    }
+    if (tag === "a") {
+      const label = normalizedTapTapText(element.text());
+      const href = safeTapTapHref(element.attr("href"));
+      const linkedImages = element.find("img").toArray();
+      if (!label && linkedImages.length === 0) {
+        return;
+      }
+      if (label && href) {
+        html += `<a href="${escapeTapTapHtml(href)}">${escapeTapTapHtml(label)}</a>`;
+        plain += label;
+        links.push({ href, label });
+      } else if (label) {
+        appendText(label);
+      }
+      if (linkedImages.length > 0) {
+        flushHtml();
+        for (const image of linkedImages) {
+          walk(image);
+        }
+      }
+      return;
+    }
+
+    if (tag === "table" && options.structuredTables) {
+      flushHtml();
+      appendStructuredTable(node);
+      return;
+    }
+
+    if (tag === "blockquote" && options.preserveBlockStyles) {
+      flushHtml();
+      const content = tableCellContent(node);
+      if (content.plain) {
+        const styleValue = element.attr("style") || "";
+        const alignment =
+          normalizeText(element.attr("align")) ||
+          normalizeText(styleValue.match(/(?:^|;)\s*text-align\s*:\s*([^;]+)/i)?.[1]);
+        items.push({
+          type: "html",
+          html: `<${options.quoteTag || "blockquote"}${blockStyleAttribute(styleValue, alignment.toLowerCase())}>${content.html}</${options.quoteTag || "blockquote"}>`,
+          plain: content.plain,
+          block: "blockquote",
+          align: alignment.toLowerCase()
+        });
+      }
+      return;
+    }
+
+    const isBlock = TAPTAP_BLOCK_TAGS.has(tag);
+    if (isBlock) {
+      flushHtml();
+      if ((tag === "ul" || tag === "ol") && element.find("img").length === 0) {
+        const listItems = element
+          .children("li")
+          .toArray()
+          .map(item => inlineFragment(item));
+        if (listItems.length > 0) {
+          items.push({
+            type: "html",
+            html: `<${tag}>${listItems.map(item => `<li>${item.html}</li>`).join("")}</${tag}>`,
+            plain: listItems.map(item => normalizedTapTapText(item.plain)).join("\n"),
+            block: tag,
+            align: blockContext.align
+          });
+        }
+        return;
+      }
+      const previousContext = blockContext;
+      const styleValue = element.attr("style") || "";
+      const alignment =
+        normalizeText(element.attr("align")) ||
+        normalizeText(styleValue.match(/(?:^|;)\s*text-align\s*:\s*([^;]+)/i)?.[1]) ||
+        previousContext.align;
+      blockContext = {
+        tag: /^h[1-3]$/.test(tag) ? tag : /^h[4-6]$/.test(tag) ? "h3" : tag === "blockquote" ? tag : "p",
+        align: alignment.toLowerCase(),
+        style: styleValue
+      };
+      for (const child of node.children || []) {
+        walk(child);
+      }
+      flushHtml();
+      blockContext = previousContext;
+      return;
+    }
+    const wrappers = tapTapInlineWrappers(tag, element.attr("style") || "", options);
+    const canWrapInline = wrappers.open && element.find("img").length === 0;
+    if (canWrapInline) {
+      html += wrappers.open;
+    }
+    for (const child of node.children || []) {
+      walk(child);
+    }
+    if (canWrapInline) {
+      html += wrappers.close;
+    }
+  };
+
+  for (const node of $.root().contents().toArray()) {
+    walk(node);
+  }
+  flushHtml();
+  if (items.length === 0 && normalizeText(article.markdown)) {
+    const fallback = normalizeText(article.markdown);
+    items.push({ type: "html", html: `<p>${escapeTapTapHtml(fallback)}</p>`, plain: fallback });
+  }
+  return {
+    items,
+    images,
+    links,
+    plainText: items
+      .filter(item => item.type === "html")
+      .map(item => item.plain)
+      .join("\n")
+  };
+}
+
+export function buildBilibiliRichContent(article) {
+  return buildPlatformRichContent(article, {
+    preserveBackground: true,
+    preserveBlockStyles: true,
+    structuredTables: true
+  });
+}
+
+export function buildHaoyouRichContent(article) {
+  return buildPlatformRichContent(article, {
+    preserveBackground: true,
+    preserveBlockStyles: true,
+    quoteTag: "div",
+    structuredTableTag: "div",
+    structuredTables: true
+  });
+}
+
+function contentTypeForFile(fileName, fallback = "application/octet-stream") {
+  const extension = path.extname(fileName).toLowerCase();
+  return (
+    {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".bmp": "image/bmp",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime",
+      ".wmv": "video/x-ms-wmv",
+      ".avi": "video/x-msvideo",
+      ".mkv": "video/x-matroska"
+    }[extension] || fallback
+  );
+}
+
+function downloadBuffer(urlValue, redirects = 5) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(urlValue);
+    const client = url.protocol === "http:" ? http : https;
+    const request = client.get(
+      url,
+      { headers: { "User-Agent": "qcplay-cli" } },
+      response => {
+        if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+          response.resume();
+          if (redirects <= 0) {
+            reject(new Error(`媒体下载重定向次数过多: ${urlValue}`));
+            return;
+          }
+          resolve(downloadBuffer(new URL(response.headers.location, url).toString(), redirects - 1));
+          return;
+        }
+        if ((response.statusCode || 0) < 200 || (response.statusCode || 0) >= 300) {
+          response.resume();
+          reject(new Error(`媒体下载失败 (${response.statusCode}): ${urlValue}`));
+          return;
+        }
+        const chunks = [];
+        let size = 0;
+        response.on("data", chunk => {
+          size += chunk.length;
+          if (size > 30 * 1024 * 1024) {
+            request.destroy(new Error(`图片超过 30MB: ${urlValue}`));
+            return;
+          }
+          chunks.push(chunk);
+        });
+        response.once("end", () =>
+          resolve({
+            buffer: Buffer.concat(chunks),
+            contentType: normalizeText(response.headers["content-type"]).split(";")[0]
+          })
+        );
+      }
+    );
+    request.once("error", reject);
+  });
+}
+
+async function imageUploadPayload(source, articleFile, index, platform = "平台") {
+  const dataImage = source.match(/^data:([^;,]+);base64,([a-z0-9+/=\s]+)$/i);
+  if (dataImage) {
+    return {
+      name: `image-${index + 1}.${dataImage[1].split("/")[1] || "png"}`,
+      mimeType: dataImage[1],
+      buffer: Buffer.from(dataImage[2].replace(/\s+/g, ""), "base64")
+    };
+  }
+  if (source.startsWith("//")) {
+    source = `https:${source}`;
+  }
+  if (/^https?:\/\//i.test(source)) {
+    const downloaded = await downloadBuffer(source);
+    const url = new URL(source);
+    const baseName = path.basename(decodeURIComponent(url.pathname)) || `image-${index + 1}.png`;
+    return {
+      name: baseName.replace(/[^a-zA-Z0-9._-]/g, "-") || `image-${index + 1}.png`,
+      mimeType: downloaded.contentType || contentTypeForFile(baseName, "image/png"),
+      buffer: downloaded.buffer
+    };
+  }
+  const absolutePath = path.resolve(articleFile ? path.dirname(articleFile) : process.cwd(), source);
+  const buffer = await fs.promises.readFile(absolutePath).catch(error => {
+    throw new Error(`${platform} 图片文件无法读取: ${absolutePath} (${error.message})`);
+  });
+  return {
+    name: path.basename(absolutePath),
+    mimeType: contentTypeForFile(absolutePath, "image/png"),
+    buffer
+  };
+}
+
+async function pasteRichHtml(bodyInput, item) {
+  await bodyInput.evaluate(
+    (element, payload) => {
+      element.focus();
+      const clipboard = new DataTransfer();
+      clipboard.setData("text/html", payload.html);
+      clipboard.setData("text/plain", payload.plain);
+      element.dispatchEvent(
+        new ClipboardEvent("paste", {
+          bubbles: true,
+          cancelable: true,
+          clipboardData: clipboard
+        })
+      );
+    },
+    item
+  );
+}
+
+async function waitForTapTapInlineImage(bodyInput, previousCount, source) {
+  const deadline = Date.now() + 90000;
+  const startedAt = Date.now();
+  let stableChecks = 0;
+  do {
+    const count = await bodyInput.locator(".tap-editor-image").count();
+    const failed = await bodyInput.locator(".tap-editor-image__retry").count();
+    const pending = await pendingUploadCount(bodyInput);
+    if (failed > 0) {
+      throw new Error(`TapTap 正文图片上传失败: ${source}`);
+    }
+    if (count > previousCount && pending === 0 && Date.now() - startedAt >= 1500) {
+      stableChecks += 1;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+    }
+    await new Promise(resolve => setTimeout(resolve, 300));
+  } while (Date.now() < deadline);
+  throw new Error(`TapTap 正文图片上传超时: ${source}`);
+}
+
+export async function insertTapTapRichContent(page, bodyInput, article, settings, fallbackText) {
+  if (typeof bodyInput.evaluate !== "function" || typeof bodyInput.locator !== "function") {
+    await fillLocator(bodyInput, fallbackText);
+    await verifyFilledValue(bodyInput, fallbackText, "正文");
+    return { rich: false, images: 0, links: 0 };
+  }
+
+  const content = buildTapTapRichContent(article);
+  const inlineImages = settings.type === "topic";
+  const toolbarImageInput = inlineImages
+    ? await firstExisting(page, ['.tap-editor-toolbar input[type="file"][accept*="image"]'])
+    : null;
+  if (inlineImages && content.images.length > 0 && (!toolbarImageInput || typeof toolbarImageInput.setInputFiles !== "function")) {
+    throw new Error("TapTap 长帖编辑器中未找到正文图片上传控件");
+  }
+
+  await bodyInput.fill("");
+  await bodyInput.click();
+  const markerPrefix = `QCPLAY_IMAGE_${Date.now()}_`;
+  const imageMarkers = [];
+  const htmlParts = [];
+  const plainParts = [];
+  for (let index = 0; index < content.items.length; index += 1) {
+    const item = content.items[index];
+    if (item.type === "html") {
+      htmlParts.push(item.html);
+      plainParts.push(item.plain);
+      continue;
+    }
+    if (inlineImages) {
+      const marker = `${markerPrefix}${imageMarkers.length}`;
+      htmlParts.push(`<p>${marker}</p>`);
+      plainParts.push(marker);
+      imageMarkers.push({ marker, item, index });
+    }
+  }
+  if (htmlParts.length > 0) {
+    await pasteRichHtml(bodyInput, {
+      html: htmlParts.join("<br><br>"),
+      plain: plainParts.join("\n")
+    });
+    await page.waitForTimeout(100);
+  }
+
+  const payloadCache = new Map();
+  let uploadedImages = 0;
+  for (const { marker, item, index } of imageMarkers) {
+    const markerText = bodyInput.locator('[data-slate-string="true"]').filter({ hasText: marker }).first();
+    if ((await markerText.count()) === 0) {
+      throw new Error(`TapTap 正文图片占位位置丢失: ${item.source}`);
+    }
+    const selected = await markerText.evaluate((element, markerValue) => {
+      const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+      let textNode = walker.nextNode();
+      while (textNode) {
+        const start = textNode.data.indexOf(markerValue);
+        if (start >= 0) {
+          const range = document.createRange();
+          range.setStart(textNode, start);
+          range.setEnd(textNode, start + markerValue.length);
+          const selection = window.getSelection();
+          selection.removeAllRanges();
+          selection.addRange(range);
+          document.dispatchEvent(new Event("selectionchange", { bubbles: true }));
+          return true;
+        }
+        textNode = walker.nextNode();
+      }
+      return false;
+    }, marker);
+    if (!selected) {
+      throw new Error(`TapTap 正文图片占位文本无法选中: ${item.source}`);
+    }
+    await page.waitForTimeout(50);
+    await page.keyboard.press("Backspace");
+    await page.waitForTimeout(50);
+    let payload = payloadCache.get(item.source);
+    if (!payload) {
+      payload = await imageUploadPayload(item.source, article.articleFile, index, "TapTap");
+      payloadCache.set(item.source, payload);
+    }
+    const previousCount = await bodyInput.locator(".tap-editor-image").count();
+    await toolbarImageInput.setInputFiles([payload]);
+    await waitForTapTapInlineImage(bodyInput, previousCount, item.source);
+    uploadedImages += 1;
+    if (item.alt) {
+      const captions = bodyInput.locator("textarea.tap-editor-image__text");
+      const captionCount = await captions.count();
+      if (captionCount > 0) {
+        await captions.nth(captionCount - 1).fill(item.alt);
+      }
+    }
+  }
+
+  const state = await bodyInput.evaluate(element => ({
+    text: element.innerText,
+    images: element.querySelectorAll(".tap-editor-image").length,
+    failedImages: element.querySelectorAll(".tap-editor-image__retry").length,
+    links: [...element.querySelectorAll("a.tap-editor-link[href]")].map(link => ({
+      href: link.href,
+      label: link.innerText
+    }))
+  }));
+  if (state.failedImages > 0 || (inlineImages && state.images < content.images.length)) {
+    throw new Error(`TapTap 正文图片写入不完整，预期 ${content.images.length} 张，实际 ${state.images} 张`);
+  }
+  const actualText = normalizedTapTapText(state.text);
+  if (actualText.includes(markerPrefix)) {
+    throw new Error("TapTap 正文图片占位符未正确替换");
+  }
+  for (const item of content.items) {
+    if (item.type === "html" && item.plain && !actualText.includes(normalizedTapTapText(item.plain))) {
+      throw new Error("TapTap 正文文字未完整写入编辑器");
+    }
+  }
+  const actualLinks = new Set(state.links.map(link => safeTapTapHref(link.href)));
+  for (const link of content.links) {
+    if (!actualLinks.has(link.href)) {
+      throw new Error(`TapTap 正文超链接未正确写入: ${link.href}`);
+    }
+  }
+  return { rich: true, images: uploadedImages, links: content.links.length, plainText: content.plainText };
+}
+
+async function uploadBilibiliInlineImage(page, spec, payload) {
+  let input = await firstExisting(page, spec.articleImageInputs);
+  if (input && typeof input.setInputFiles === "function") {
+    await input.setInputFiles([payload]);
+    return;
+  }
+
+  const imageButton = await firstVisible(page, spec.articleImageButtons);
+  if (imageButton) {
+    const fileChooserPromise =
+      typeof page.waitForEvent === "function"
+        ? page.waitForEvent("filechooser", { timeout: 5000 }).catch(() => null)
+        : Promise.resolve(null);
+    await imageButton.click();
+    const fileChooser = await fileChooserPromise;
+    if (fileChooser) {
+      await fileChooser.setFiles([payload]);
+      return;
+    }
+  }
+
+  input = await firstExisting(page, [
+    '[role="dialog"] input[type="file"][accept*="image"]',
+    '.bcc-dialog input[type="file"][accept*="image"]',
+    '.image-upload input[type="file"][accept*="image"]',
+    'input[type="file"][accept*="image"]'
+  ]);
+  if (!input || typeof input.setInputFiles !== "function") {
+    throw new Error("B站专栏编辑器中未找到正文图片上传控件");
+  }
+  await input.setInputFiles([payload]);
+}
+
+async function waitForBilibiliInlineImage(bodyInput, previousCount, source) {
+  const deadline = Date.now() + 120000;
+  const startedAt = Date.now();
+  let stableChecks = 0;
+  do {
+    const count = await bodyInput.locator("img").count();
+    const failed = await bodyInput
+      .locator('.upload-fail, .image-upload-error, [class*="upload-error"], [class*="retry"]')
+      .count();
+    const pending = await pendingUploadCount(bodyInput);
+    if (failed > 0) {
+      throw new Error(`B站正文图片上传失败: ${source}`);
+    }
+    if (count > previousCount && pending === 0 && Date.now() - startedAt >= 1200) {
+      stableChecks += 1;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+    }
+    await new Promise(resolve => setTimeout(resolve, 300));
+  } while (Date.now() < deadline);
+  throw new Error(`B站正文图片上传超时: ${source}`);
+}
+
+export async function insertBilibiliRichContent(page, bodyInput, article, spec, fallbackText) {
+  if (typeof bodyInput.evaluate !== "function" || typeof bodyInput.locator !== "function") {
+    await fillLocator(bodyInput, fallbackText);
+    await verifyFilledValue(bodyInput, fallbackText, "正文", "B站");
+    return { rich: false, images: 0, links: 0 };
+  }
+
+  const content = buildBilibiliRichContent(article);
+  await bodyInput.fill("");
+  await bodyInput.click();
+  const markerPrefix = `QCPLAY_BILIBILI_IMAGE_${Date.now()}_`;
+  const imageMarkers = [];
+  const htmlParts = [];
+  const plainParts = [];
+  for (let index = 0; index < content.items.length; index += 1) {
+    const item = content.items[index];
+    if (item.type === "html") {
+      htmlParts.push(item.html);
+      plainParts.push(item.plain);
+      continue;
+    }
+    const marker = `${markerPrefix}${imageMarkers.length}`;
+    htmlParts.push(`<p>${marker}</p>`);
+    plainParts.push(marker);
+    imageMarkers.push({ marker, item, index });
+  }
+  if (htmlParts.length > 0) {
+    await pasteRichHtml(bodyInput, {
+      html: htmlParts.join(""),
+      plain: plainParts.join("\n")
+    });
+    await page.waitForTimeout(100);
+  }
+
+  const payloadCache = new Map();
+  for (const { marker, item, index } of imageMarkers) {
+    const selected = await bodyInput.evaluate((element, markerValue) => {
+      const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+      let textNode = walker.nextNode();
+      while (textNode) {
+        const start = textNode.data.indexOf(markerValue);
+        if (start >= 0) {
+          const range = document.createRange();
+          range.setStart(textNode, start);
+          range.setEnd(textNode, start + markerValue.length);
+          const selection = window.getSelection();
+          selection.removeAllRanges();
+          selection.addRange(range);
+          document.dispatchEvent(new Event("selectionchange", { bubbles: true }));
+          return true;
+        }
+        textNode = walker.nextNode();
+      }
+      return false;
+    }, marker);
+    if (!selected) {
+      throw new Error(`B站正文图片占位位置丢失: ${item.source}`);
+    }
+    await page.keyboard.press("Backspace");
+    let payload = payloadCache.get(item.source);
+    if (!payload) {
+      payload = await imageUploadPayload(item.source, article.articleFile, index, "B站");
+      payloadCache.set(item.source, payload);
+    }
+    const previousCount = await bodyInput.locator("img").count();
+    await uploadBilibiliInlineImage(page, spec, payload);
+    await waitForBilibiliInlineImage(bodyInput, previousCount, item.source);
+  }
+
+  let state = null;
+  let previousTextLength = -1;
+  let stableChecks = 0;
+  for (let attempt = 0; attempt < 40; attempt += 1) {
+    state = await bodyInput.evaluate(element => ({
+      text: element.innerText,
+      images: element.querySelectorAll("img").length,
+      failedImages: element.querySelectorAll('.upload-fail, .image-upload-error, [class*="upload-error"]').length,
+      links: [...element.querySelectorAll("a[href]")].map(link => ({ href: link.href, label: link.innerText }))
+    }));
+    const currentLength = normalizeText(state.text).length;
+    stableChecks = currentLength === previousTextLength ? stableChecks + 1 : 0;
+    previousTextLength = currentLength;
+    if (stableChecks >= 3) break;
+    await page.waitForTimeout(250);
+  }
+  if (state.failedImages > 0 || state.images < content.images.length) {
+    throw new Error(`B站正文图片写入不完整，预期 ${content.images.length} 张，实际 ${state.images} 张`);
+  }
+  const actualText = normalizedStructuredEditorText(state.text);
+  if (actualText.includes(markerPrefix)) {
+    throw new Error("B站正文图片占位符未正确替换");
+  }
+  for (const item of content.items) {
+    if (item.type === "html" && item.plain && !actualText.includes(normalizedStructuredEditorText(item.plain))) {
+      const missing = normalizedStructuredEditorText(item.plain).slice(0, 80);
+      throw new Error(
+        `B站正文文字未完整写入编辑器，首个缺失片段“${missing}”（预期 ${content.plainText.length} 字，实际 ${state.text.length} 字）`
+      );
+    }
+  }
+  const actualLinks = new Set(state.links.map(link => safeTapTapHref(link.href)));
+  for (const link of content.links) {
+    if (!actualLinks.has(link.href)) {
+      throw new Error(`B站正文超链接未正确写入: ${link.href}`);
+    }
+  }
+  return { rich: true, images: content.images.length, links: content.links.length, plainText: content.plainText };
+}
+
+function haoyouImageUploadPayload(payload, index) {
+  if (payload.buffer.length > 12 * 1024 * 1024) {
+    throw new Error(`好游快爆正文第 ${index + 1} 张图片超过 12MB，无法上传`);
+  }
+  const supportedExtensions = new Set([".jpg", ".jpeg", ".png", ".gif"]);
+  const extensionByMime = new Map([
+    ["image/jpeg", ".jpg"],
+    ["image/png", ".png"],
+    ["image/gif", ".gif"]
+  ]);
+  const sourceExtension = path.extname(payload.name).toLowerCase();
+  const nativeExtension = supportedExtensions.has(sourceExtension)
+    ? sourceExtension
+    : extensionByMime.get(normalizeText(payload.mimeType).toLowerCase());
+  const reportedMimeType = normalizeText(payload.mimeType).toLowerCase();
+  const inferredMimeType = contentTypeForFile(payload.name, "");
+  const sourceMimeType = reportedMimeType.startsWith("image/") ? reportedMimeType : inferredMimeType;
+  if (!nativeExtension && !sourceMimeType.startsWith("image/")) {
+    throw new Error(`好游快爆正文第 ${index + 1} 张图片格式无法识别`);
+  }
+  const stem = path.basename(payload.name, path.extname(payload.name)).replace(/[^a-zA-Z0-9._-]/g, "-") || `image-${index + 1}`;
+  const extension = nativeExtension || ".png";
+  return {
+    name: `${stem}${extension}`,
+    mimeType: nativeExtension
+      ? extension === ".jpg" || extension === ".jpeg"
+        ? "image/jpeg"
+        : `image/${extension.slice(1)}`
+      : sourceMimeType,
+    convertToPng: !nativeExtension,
+    base64: payload.buffer.toString("base64")
+  };
+}
+
+async function waitForHaoyouInlineImage(page, bodyInput, imageId, source) {
+  const deadline = Date.now() + 90000;
+  let placeholderSeen = false;
+  do {
+    const state = await bodyInput.evaluate((element, id) => {
+      const image = document.getElementById(id);
+      if (!image || !element.contains(image)) {
+        return { exists: false, complete: false, failed: false };
+      }
+      return {
+        exists: true,
+        complete: Boolean(image.querySelector("img[src]")),
+        failed: Boolean(image.querySelector(".fail"))
+      };
+    }, imageId);
+    if (state.exists) {
+      placeholderSeen = true;
+    }
+    if (state.failed) {
+      throw new Error(`好游快爆正文图片上传失败: ${source}`);
+    }
+    if (state.complete) {
+      return;
+    }
+    if (placeholderSeen && !state.exists) {
+      throw new Error(`好游快爆正文图片上传失败，图片占位卡片已被移除: ${source}`);
+    }
+    await page.waitForTimeout(300);
+  } while (Date.now() < deadline);
+  throw new Error(`好游快爆正文图片上传超时: ${source}`);
+}
+
+export async function insertHaoyouRichContent(page, bodyInput, article, fallbackText) {
+  const content = buildHaoyouRichContent(article);
+  if (typeof bodyInput.evaluate !== "function") {
+    await fillStableHaoyouValue(page, bodyInput, fallbackText, "正文");
+    return { rich: false, images: 0, links: 0, plainText: fallbackText };
+  }
+
+  const markerPrefix = `QCPLAY_HAOYOU_IMAGE_${Date.now()}_`;
+  const imageMarkers = [];
+  const htmlParts = [];
+  for (let index = 0; index < content.items.length; index += 1) {
+    const item = content.items[index];
+    if (item.type === "html") {
+      htmlParts.push(item.html);
+    } else {
+      const imageIndex = imageMarkers.length;
+      const marker = `${markerPrefix}${imageIndex}`;
+      htmlParts.push(`<p>${marker}</p>`);
+      imageMarkers.push({ marker, item, index: imageIndex });
+    }
+  }
+  const html = htmlParts.join("") || `<p>${escapeTapTapHtml(fallbackText)}</p>`;
+  const initialized = await bodyInput.evaluate((element, richHtml) => {
+    const quill = element.parentElement?.__quill;
+    if (!quill?.clipboard?.dangerouslyPasteHTML) {
+      return false;
+    }
+    quill.setText("", "silent");
+    quill.clipboard.dangerouslyPasteHTML(0, richHtml, "api");
+    quill.setSelection(quill.getLength(), 0, "silent");
+    quill.history?.clear?.();
+    return true;
+  }, html);
+  if (!initialized) {
+    if (imageMarkers.length > 0) {
+      throw new Error("好游快爆富文本编辑器接口不可用，无法安全上传正文图片");
+    }
+    await fillStableHaoyouValue(page, bodyInput, fallbackText, "正文");
+    return { rich: false, images: 0, links: 0, plainText: fallbackText };
+  }
+  await page.waitForTimeout(200);
+
+  const payloadCache = new Map();
+  for (const { marker, item, index } of imageMarkers) {
+    let upload = payloadCache.get(item.source);
+    if (!upload) {
+      upload = haoyouImageUploadPayload(
+        await imageUploadPayload(item.source, article.articleFile, index, "好游快爆"),
+        index
+      );
+      payloadCache.set(item.source, upload);
+    }
+    const imageId = await bodyInput
+      .evaluate(
+        async (element, payload) => {
+          const quill = element.parentElement?.__quill;
+          const editor = globalThis.RE;
+          if (!quill || !editor?.insertPicDelta || !editor?.cb?.picUpload || !editor?.tool?.idRandom) {
+            return "";
+          }
+          const markerIndex = quill.getText().indexOf(payload.marker);
+          if (markerIndex < 0) {
+            return "";
+          }
+          quill.deleteText(markerIndex, payload.marker.length, "api");
+          quill.setSelection(markerIndex, 0, "silent");
+          const binary = atob(payload.base64);
+          const bytes = Uint8Array.from(binary, character => character.charCodeAt(0));
+          let imageBlob = new Blob([bytes], { type: payload.mimeType });
+          if (payload.convertToPng) {
+            const bitmap = await createImageBitmap(imageBlob);
+            const canvas = document.createElement("canvas");
+            canvas.width = bitmap.width;
+            canvas.height = bitmap.height;
+            const context = canvas.getContext("2d");
+            if (!context) {
+              throw new Error("图片转换画布不可用");
+            }
+            context.drawImage(bitmap, 0, 0);
+            bitmap.close?.();
+            imageBlob = await new Promise(resolve => canvas.toBlob(resolve, "image/png"));
+            if (!imageBlob) {
+              throw new Error("图片转换为 PNG 失败");
+            }
+          }
+          if (imageBlob.size > 12 * 1024 * 1024) {
+            throw new Error("图片处理后超过 12MB");
+          }
+          const file = new File([imageBlob], payload.name, {
+            type: payload.convertToPng ? "image/png" : payload.mimeType
+          });
+          const id = editor.tool.idRandom();
+          editor.insertPicDelta(id);
+          editor.cb.picUpload(id, file);
+          return id;
+        },
+        { ...upload, marker }
+      )
+      .catch(error => {
+        throw new Error(`好游快爆正文图片转换或上传初始化失败: ${item.source} (${error.message})`);
+      });
+    if (!imageId) {
+      throw new Error(`好游快爆正文图片占位位置丢失或图片上传接口不可用: ${item.source}`);
+    }
+    await waitForHaoyouInlineImage(page, bodyInput, imageId, item.source);
+  }
+
+  let state = null;
+  let previousTextLength = -1;
+  let stableChecks = 0;
+  for (let attempt = 0; attempt < 40; attempt += 1) {
+    state = await bodyInput.evaluate(element => ({
+      text: element.innerText,
+      images: element.querySelectorAll('.panel-pic img[src]').length,
+      failedImages: element.querySelectorAll('.panel-pic .fail').length,
+      pendingImages: element.querySelectorAll('.panel-pic .ing').length,
+      links: element.querySelectorAll('a[href]').length,
+      headings: element.querySelectorAll('h1,h2,h3').length,
+      formatted: element.querySelectorAll('strong,b,em,i,ul,ol,blockquote').length
+    }));
+    const currentLength = normalizeText(state.text).length;
+    stableChecks = currentLength === previousTextLength ? stableChecks + 1 : 0;
+    previousTextLength = currentLength;
+    if (stableChecks >= 3) break;
+    await page.waitForTimeout(250);
+  }
+  if (state.failedImages > 0 || state.pendingImages > 0 || state.images < content.images.length) {
+    throw new Error(`好游快爆正文图片写入不完整，预期 ${content.images.length} 张，实际 ${state.images} 张`);
+  }
+  const actualText = normalizedStructuredEditorText(state.text);
+  if (actualText.includes(markerPrefix)) {
+    throw new Error("好游快爆正文图片占位符未正确替换");
+  }
+  for (const item of content.items) {
+    if (item.type === "html" && item.plain && !actualText.includes(normalizedStructuredEditorText(item.plain))) {
+      const missing = normalizedStructuredEditorText(item.plain).slice(0, 80);
+      throw new Error(
+        `好游快爆正文文字未完整写入富文本编辑器，首个缺失片段“${missing}”（预期 ${content.plainText.length} 字，实际 ${state.text.length} 字）`
+      );
+    }
+  }
+  return {
+    rich: true,
+    images: state.images,
+    links: state.links,
+    headings: state.headings,
+    formatted: state.formatted,
+    plainText: content.plainText
+  };
+}
+
+function safeProfileName(entry) {
+  return `${entry.platformKey}-${entry.project}-${entry.region}`
+    .normalize("NFKD")
+    .replace(/[^a-zA-Z0-9\u4e00-\u9fff_-]+/g, "-")
+    .slice(0, 80);
+}
+
+function isNavigationContextError(error) {
+  const message = String(error?.message || error);
+  return /execution context was destroyed|cannot find context with specified id|frame was detached|navigation.*interrupted/i.test(
+    message
+  );
+}
+
+async function afterNavigation(page) {
+  await page.waitForLoadState("domcontentloaded", { timeout: 5000 }).catch(() => {});
+  await page.waitForTimeout(250).catch(() => {});
+}
+
+async function retryAcrossNavigation(page, action, attempts = 8) {
+  let lastError;
+  for (let attempt = 1; attempt <= attempts; attempt += 1) {
+    try {
+      return await action();
+    } catch (error) {
+      if (!isNavigationContextError(error)) {
+        throw error;
+      }
+      lastError = error;
+      if (attempt < attempts) {
+        await afterNavigation(page);
+      }
+    }
+  }
+  throw lastError;
+}
+
+function locatorScopes(page) {
+  if (typeof page.frames !== "function") {
+    return [page];
+  }
+  const frames = page.frames();
+  return [page, ...frames.filter(frame => frame !== page.mainFrame?.())];
+}
+
+async function firstVisible(page, selectors) {
+  return retryAcrossNavigation(page, async () => {
+    for (const scope of locatorScopes(page)) {
+      for (const selector of selectors || []) {
+        const locator = scope.locator(selector).first();
+        if ((await locator.count()) > 0 && (await locator.isVisible())) {
+          return locator;
+        }
+      }
+    }
+    return null;
+  });
+}
+
+async function firstVisibleButton(page, names) {
+  return retryAcrossNavigation(page, async () => {
+    for (const scope of locatorScopes(page)) {
+      for (const name of names || []) {
+        const locator = scope.getByRole("button", { name }).first();
+        if ((await locator.count()) > 0 && (await locator.isVisible())) {
+          return locator;
+        }
+      }
+    }
+    return null;
+  });
+}
+
+async function firstExisting(page, selectors) {
+  return retryAcrossNavigation(page, async () => {
+    for (const scope of locatorScopes(page)) {
+      for (const selector of selectors || []) {
+        const locator = scope.locator(selector).first();
+        if ((await locator.count()) > 0) {
+          return locator;
+        }
+      }
+    }
+    return null;
+  });
+}
+
+async function firstVisibleText(page, text, exact = true) {
+  if (typeof page.getByText !== "function") {
+    return null;
+  }
+  return retryAcrossNavigation(page, async () => {
+    for (const scope of locatorScopes(page)) {
+      if (typeof scope.getByText !== "function") {
+        continue;
+      }
+      const locator = scope.getByText(text, { exact }).first();
+      if ((await locator.count()) > 0 && (await locator.isVisible())) {
+        return locator;
+      }
+    }
+    return null;
+  });
+}
+
+async function waitForVisibleTextAcrossFrames(page, text, timeoutMs = 8000, exact = true) {
+  if (typeof page.getByText !== "function") {
+    return null;
+  }
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const locator = await firstVisibleText(page, text, exact);
+    if (locator) {
+      return locator;
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+async function waitForVisible(page, selectors, timeoutMs = 8000) {
+  if (!selectors?.length) {
+    return null;
+  }
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const locator = await firstVisible(page, selectors);
+    if (locator) {
+      return locator;
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+async function waitForVisibleButton(page, names, timeoutMs = 8000) {
+  if (!names?.length) {
+    return null;
+  }
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const locator = await firstVisibleButton(page, names);
+    if (locator) {
+      return locator;
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+async function visibleLocatorCount(locator) {
+  if (!locator) {
+    return 0;
+  }
+  if (typeof locator.evaluateAll === "function") {
+    return locator
+      .evaluateAll(elements =>
+        elements.filter(element => {
+          const style = window.getComputedStyle(element);
+          const rect = element.getBoundingClientRect();
+          return style.display !== "none" && style.visibility !== "hidden" && rect.width > 0 && rect.height > 0;
+        }).length
+      )
+      .catch(() => 0);
+  }
+  return locator.count().catch(() => 0);
+}
+
+async function pendingUploadCount(scope) {
+  if (!scope || typeof scope.locator !== "function") {
+    return 0;
+  }
+  return visibleLocatorCount(
+    scope.locator(
+        '[aria-busy="true"], [class*="upload"][class*="loading"], [class*="upload"][class*="progress"], ' +
+        '[class*="image"][class*="loading"], [class*="image"][class*="progress"], ' +
+        '[class*="spinner"], [class~="spin"], [class$="-spin"], svg[class*="loading"]'
+    )
+  );
+}
+
+async function waitForUploadsSettled(scope, label, timeoutMs = 120000, minimumWaitMs = 1200) {
+  const deadline = Date.now() + timeoutMs;
+  const startedAt = Date.now();
+  let stableChecks = 0;
+  do {
+    const text = typeof scope?.innerText === "function" ? await scope.innerText().catch(() => "") : "";
+    if (/上传失败|处理失败|转码失败|格式不支持|重新上传|upload failed/i.test(text)) {
+      throw new Error(`${label}上传失败，请检查页面提示`);
+    }
+    const pending = await pendingUploadCount(scope);
+    if (pending === 0 && Date.now() - startedAt >= minimumWaitMs) {
+      stableChecks += 1;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+    }
+    await new Promise(resolve => setTimeout(resolve, 250));
+  } while (Date.now() < deadline);
+  throw new Error(`${label}上传超时，已停止发布以避免提交未完成内容`);
+}
+
+function explicitLoginPage(page) {
+  const url = typeof page?.url === "function" ? page.url() : "";
+  return /(?:accounts?|passport|login|signin|sso)[./]/i.test(url) || /\/(?:login|signin)(?:[/?#]|$)/i.test(url);
+}
+
+async function waitForEditorReady(page, ready, timeoutMs = 12000) {
+  const intervalMs = 300;
+  const attempts = Math.max(1, Math.ceil(timeoutMs / intervalMs));
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    if (await ready()) {
+      return true;
+    }
+    if (explicitLoginPage(page)) {
+      return false;
+    }
+    if (attempt + 1 < attempts) {
+      await page.waitForTimeout(intervalMs);
+    }
+  }
+  return false;
+}
+
+async function fillLocator(locator, value) {
+  await locator.fill(value);
+}
+
+async function verifyFilledValue(locator, expected, label, platform = "TapTap") {
+  let actual = "";
+  if (typeof locator.inputValue === "function") {
+    actual = await locator.inputValue().catch(() => "");
+  }
+  if (!actual && typeof locator.innerText === "function") {
+    actual = await locator.innerText().catch(() => "");
+  }
+  if (typeof locator.inputValue !== "function" && typeof locator.innerText !== "function") {
+    return;
+  }
+  const normalizedActual = normalizeText(actual).replace(/\r\n/g, "\n");
+  const normalizedExpected = normalizeText(expected).replace(/\r\n/g, "\n");
+  if (!normalizedActual || normalizedActual !== normalizedExpected) {
+    throw new Error(`${platform} ${label}未正确写入编辑器`);
+  }
+}
+
+function normalizeEditorText(value) {
+  return normalizeText(value).replace(/\s+/g, " ");
+}
+
+async function readFilledValue(locator) {
+  let actual = "";
+  if (typeof locator.inputValue === "function") {
+    actual = await locator.inputValue().catch(() => "");
+  }
+  if (!actual && typeof locator.innerText === "function") {
+    actual = await locator.innerText().catch(() => "");
+  }
+  return actual;
+}
+
+async function fillStableHaoyouValue(page, locator, expected, label) {
+  const normalizedExpected = normalizeEditorText(expected);
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    await fillLocator(locator, expected);
+    let stableChecks = 0;
+    for (let check = 0; check < 4; check += 1) {
+      await page.waitForTimeout(200);
+      const normalizedActual = normalizeEditorText(await readFilledValue(locator));
+      if (normalizedActual && normalizedActual === normalizedExpected) {
+        stableChecks += 1;
+        if (stableChecks >= 2) {
+          return;
+        }
+      } else {
+        stableChecks = 0;
+      }
+    }
+  }
+  throw new Error(`好游快爆 ${label}未正确写入编辑器`);
+}
+
+async function waitForUser(message, streams = {}) {
+  const input = streams.input || process.stdin;
+  const output = streams.output || process.stdout;
+  if (!input.isTTY || !output.isTTY) {
+    throw new Error(`${message}。当前不是交互终端，请在本地终端重新执行该命令`);
+  }
+  const rl = readline.createInterface({ input, output });
+  try {
+    await question(rl, `${message}，完成后按 Enter 继续: `);
+  } finally {
+    rl.close();
+  }
+}
+
+function reviewApprovalAccepted(answer) {
+  return ["", "发布", "可以发布", "publish", "yes", "y"].includes(normalizeKey(answer));
+}
+
+function reviewApprovalCancelled(answer) {
+  return ["取消", "停止", "cancel", "quit", "q", "no", "n"].includes(normalizeKey(answer));
+}
+
+async function waitForReviewApproval(message, options = {}) {
+  if (typeof options.waitForReview === "function") {
+    const answer = normalizeText(await options.waitForReview(message));
+    if (reviewApprovalAccepted(answer)) return;
+    if (reviewApprovalCancelled(answer)) {
+      throw new Error("用户已取消正式发布，草稿未提交");
+    }
+    throw new Error(`无法识别草稿确认输入“${answer}”，请输入“可以发布”或直接回车`);
+  }
+  const input = options.streams?.input || process.stdin;
+  const output = options.streams?.output || process.stdout;
+  if (!input.isTTY || !output.isTTY) {
+    throw new Error(`${message}。当前不是交互终端，无法确认草稿，请移除 --review-draft 直接发布或在本地 CMD 重试`);
+  }
+  const rl = readline.createInterface({ input, output });
+  try {
+    for (;;) {
+      const answer = await question(
+        rl,
+        `${message}\n输入“可以发布”或直接按 Enter 继续，输入“取消”停止: `
+      );
+      if (reviewApprovalAccepted(answer)) return;
+      if (reviewApprovalCancelled(answer)) {
+        throw new Error("用户已取消正式发布，草稿未提交");
+      }
+      output.write("无法识别输入，请输入“可以发布”、直接按 Enter 或输入“取消”。\n");
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+async function reviewPreparedDraft(page, entry, options) {
+  if (!options.reviewDraft) {
+    return;
+  }
+  await page.waitForTimeout(500);
+  await waitForReviewApproval(
+    `${entry.platform} 待发布稿已准备，请在浏览器中预览标题、正文、图片和发布设置`,
+    options
+  );
+  options.onProgress?.(`${entry.platform} 草稿预览已确认，正在正式发布`);
+}
+
+async function editorIsReady(page, spec) {
+  const titleInput = spec.title ? await firstVisible(page, spec.title) : true;
+  if (!titleInput) {
+    return false;
+  }
+  return Boolean(await firstVisible(page, spec.body));
+}
+
+async function openPlatformLogin(page, entry, spec) {
+  if (spec.loginPage) {
+    await page.goto(spec.loginPage, { waitUntil: "domcontentloaded", timeout: 60000 });
+    await afterNavigation(page);
+    const loggedIn = await waitForVisible(page, spec.loggedInSelectors, 2000);
+    if (loggedIn) {
+      return true;
+    }
+  }
+
+  if (entry.authMode === "qr" && /\/(?:login|signin)(?:[/?#]|$)/i.test(page.url())) {
+    return false;
+  }
+
+  if (explicitLoginPage(page)) {
+    return false;
+  }
+
+  let trigger = await waitForVisible(page, spec.loginTriggerSelectors, 5000);
+  if (!trigger && !spec.manualLogin) {
+    trigger = await waitForVisibleButton(page, spec.loginTriggerButtons, 5000);
+  }
+  if (spec.loginPage && !trigger) {
+    throw new Error(`${entry.platform} 官方首页中未找到登录入口，页面结构可能已更新`);
+  }
+  if (trigger) {
+    await trigger.click();
+    await page.waitForTimeout(500);
+  }
+  return false;
+}
+
+async function ensureBrowserLogin(page, entry, spec, promptUser) {
+  const alreadyLoggedIn = await openPlatformLogin(page, entry, spec);
+  if (alreadyLoggedIn) {
+    return true;
+  }
+
+  if (spec.manualLogin) {
+    await promptUser(`${entry.platform} 尚未登录，请在浏览器中手动完成登录（可自行填写账号密码或扫码）`);
+    return true;
+  }
+
+  if (entry.authMode === "qr") {
+    await promptUser(`${entry.platform} 需要扫码登录，请在浏览器中完成扫码`);
+    return true;
+  }
+
+  const passwordLogin = await waitForVisible(page, spec.passwordLoginSelectors, 3000);
+  if (passwordLogin) {
+    await passwordLogin.click();
+    await page.waitForTimeout(250);
+  }
+  const usernameInput = await waitForVisible(page, spec.username);
+  const passwordInput = await waitForVisible(page, spec.password);
+  const hasAccount = entry.account && !/扫码登录|验证码登录/.test(entry.account);
+  const hasPassword = entry.password && !/验证码登录|密码登录/.test(entry.password);
+  if (hasAccount && usernameInput) {
+    await fillLocator(usernameInput, entry.account);
+  }
+  if (hasPassword && passwordInput) {
+    await fillLocator(passwordInput, entry.password);
+  }
+  if (hasAccount || hasPassword) {
+    let loginButton = await waitForVisible(page, spec.loginSubmitSelectors, 3000);
+    loginButton ||= await waitForVisibleButton(page, spec.loginButtons, 3000);
+    if (loginButton) {
+      await loginButton.click();
+    }
+  }
+
+  const reason = entry.authMode === "verification" ? "验证码或二次验证" : "登录确认";
+  await promptUser(`${entry.platform} 需要${reason}，请在浏览器中完成`);
+  return true;
+}
+
+async function tapTapCreatorReady(page, spec) {
+  if (await firstVisible(page, [".creator-publish__tab", 'a[href*="/creator/edit?type="]'])) {
+    return true;
+  }
+  return editorIsReady(page, spec);
+}
+
+async function waitForTapTapEditor(page, spec, timeoutMs = 15000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    if (await editorIsReady(page, spec)) {
+      return true;
+    }
+    await page.waitForTimeout(300);
+  } while (Date.now() < deadline);
+  return false;
+}
+
+async function uploadTapTapImages(page, sources, articleFile) {
+  if (sources.length === 0) {
+    throw new Error("TapTap 图文至少需要 1 张图片；请在 taptap_images 中填写本地路径或图片 URL");
+  }
+  if (sources.length > 18) {
+    throw new Error(`TapTap 图文最多支持 18 张图片，当前为 ${sources.length} 张`);
+  }
+  const input = await firstExisting(page, ['input[type="file"][accept*="image"]', ".upload-img-v2__btn-input-file"]);
+  if (!input || typeof input.setInputFiles !== "function") {
+    throw new Error("TapTap 页面中未找到图片上传控件，页面结构可能已更新");
+  }
+  const payloads = [];
+  for (let index = 0; index < sources.length; index += 1) {
+    payloads.push(await imageUploadPayload(sources[index], articleFile, index, "TapTap"));
+  }
+  await input.setInputFiles(payloads);
+
+  const deadline = Date.now() + 120000;
+  const startedAt = Date.now();
+  let stableChecks = 0;
+  do {
+    const bodyText = await page.locator("body").innerText().catch(() => "");
+    if (/上传失败|图片格式不支持|重新上传/.test(bodyText)) {
+      throw new Error("TapTap 图片上传失败，请检查页面提示");
+    }
+    const counter = bodyText.match(/上传图片\s*(\d+)\s*\/\s*\d+/);
+    const previewCount = await page
+      .locator('.upload-img-v2__item, .upload-img-v2__preview, [class*="upload-img"] [class*="preview"]')
+      .count()
+      .catch(() => 0);
+    const uploadedCount = counter ? Number(counter[1]) : previewCount;
+    const pending = await pendingUploadCount(page);
+    if (uploadedCount >= sources.length && pending === 0 && Date.now() - startedAt >= 1200) {
+      stableChecks += 1;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+    }
+    await page.waitForTimeout(500);
+  } while (Date.now() < deadline);
+  throw new Error(`TapTap 图片上传超时，预期 ${sources.length} 张图片全部完成，已停止发布`);
+}
+
+async function uploadTapTapVideo(page, source, articleFile) {
+  if (!source) {
+    throw new Error("TapTap 视频模式缺少视频；请设置 taptap_video 为本地视频文件路径");
+  }
+  if (/^https?:\/\//i.test(source)) {
+    throw new Error("TapTap 视频上传仅支持本地文件，请把 taptap_video 设置为本地视频路径");
+  }
+  const videoPath = path.resolve(articleFile ? path.dirname(articleFile) : process.cwd(), source);
+  await fs.promises.access(videoPath, fs.constants.R_OK).catch(error => {
+    throw new Error(`TapTap 视频文件无法读取: ${videoPath} (${error.message})`);
+  });
+  const input = await firstExisting(page, ['input[type="file"][accept*="video"]', 'input[type="file"]']);
+  if (!input || typeof input.setInputFiles !== "function") {
+    throw new Error("TapTap 页面中未找到视频上传控件，页面结构可能已更新");
+  }
+  await input.setInputFiles(videoPath);
+}
+
+async function tapTapForumAction(page, scope, label) {
+  const scopes = scope === page ? [page] : [scope, page];
+  for (const currentScope of scopes) {
+    if (typeof currentScope.getByRole === "function") {
+      const buttons = currentScope.getByRole("button", { name: new RegExp(`^${label}$`) });
+      const count = await buttons.count().catch(() => 0);
+      for (let index = 0; index < count; index += 1) {
+        const button = buttons.nth(index);
+        if (await button.isVisible().catch(() => false)) {
+          return button;
+        }
+      }
+    }
+    if (typeof currentScope.getByText !== "function") {
+      continue;
+    }
+    const labels = currentScope.getByText(label, { exact: true });
+    const count = await labels.count().catch(() => 0);
+    for (let index = 0; index < count; index += 1) {
+      const text = labels.nth(index);
+      if (!(await text.isVisible().catch(() => false))) {
+        continue;
+      }
+      if (typeof text.locator === "function") {
+        const control = text.locator('xpath=ancestor-or-self::*[self::button or @role="button"][1]');
+        if ((await control.count().catch(() => 0)) > 0 && (await control.isVisible().catch(() => false))) {
+          return control;
+        }
+      }
+      return text;
+    }
+  }
+  return null;
+}
+
+async function tapTapControlDisabled(action) {
+  if (typeof action.isDisabled === "function" && (await action.isDisabled().catch(() => false))) {
+    return true;
+  }
+  if (typeof action.evaluate !== "function") {
+    return false;
+  }
+  return action
+    .evaluate(element =>
+      element.getAttribute("aria-disabled") === "true" ||
+      element.classList.contains("tap-button--disabled") ||
+      element.classList.contains("is-disabled")
+    )
+    .catch(() => false);
+}
+
+async function clickTapTapForumAction(page, scope, search, label, expectClose) {
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const action = await tapTapForumAction(page, scope, label);
+    if (!action) {
+      return false;
+    }
+    if (await tapTapControlDisabled(action)) {
+      await page.waitForTimeout(250);
+      continue;
+    }
+    if (typeof action.scrollIntoViewIfNeeded === "function") {
+      await action.scrollIntoViewIfNeeded().catch(() => {});
+    }
+    try {
+      if (attempt === 0) {
+        await action.click();
+      } else if (attempt === 1) {
+        await action.click({ force: true });
+      } else if (typeof action.evaluate === "function") {
+        await action.evaluate(element => element.click());
+      } else {
+        await action.click({ force: true });
+      }
+    } catch (error) {
+      if (attempt === 2) {
+        throw new Error(`TapTap 论坛选择弹窗的“${label}”按钮点击失败: ${error.message}`);
+      }
+    }
+    await page.waitForTimeout(500);
+    if (!expectClose || !(await search.isVisible().catch(() => false))) {
+      return true;
+    }
+  }
+  if (await tapTapForumAction(page, scope, label)) {
+    throw new Error(`TapTap 论坛选择弹窗的“${label}”按钮点击后未生效`);
+  }
+  return false;
+}
+
+export async function applyTapTapForum(page, forum, promptUser) {
+  if (!forum) {
+    return;
+  }
+  const existingForums = page.locator(".create-config__forum-name");
+  if (typeof existingForums.filter === "function") {
+    const existingForum = existingForums.filter({ hasText: forum }).first();
+    if ((await existingForum.count().catch(() => 0)) > 0 && (await existingForum.isVisible().catch(() => false))) {
+      return;
+    }
+  }
+  const openButton = await firstVisibleText(page, "添加发布的游戏论坛");
+  if (!openButton) {
+    if (typeof promptUser !== "function") {
+      throw new Error("TapTap 页面中未找到“添加发布的游戏论坛”入口");
+    }
+    await promptUser(`TapTap 页面结构已更新，请在浏览器中手动选择游戏论坛“${forum}”并确认`);
+    const selected = await firstVisibleText(page, forum);
+    if (!selected) {
+      throw new Error(`TapTap 手动选择后仍未回读到游戏论坛: ${forum}`);
+    }
+    return;
+  }
+  await openButton.click();
+  const search = await waitForVisible(page, ['input[placeholder="搜索论坛"]'], 5000);
+  if (!search) {
+    throw new Error("TapTap 论坛选择窗口未正常打开");
+  }
+  await search.fill(forum);
+  await page.waitForTimeout(500);
+  const dialog = search.locator(
+    'xpath=ancestor::*[.//*[normalize-space(text())="选择发布的论坛"]][1]'
+  );
+  const scope = (await dialog.count().catch(() => 0)) > 0 ? dialog : page;
+  const results = scope.getByText(forum, { exact: true });
+  let result = null;
+  const resultCount = await results.count();
+  for (let index = 0; index < resultCount; index += 1) {
+    const candidate = results.nth(index);
+    if (await candidate.isVisible().catch(() => false)) {
+      result = candidate;
+      break;
+    }
+  }
+  if (!result) {
+    throw new Error(`TapTap 中未找到游戏论坛: ${forum}`);
+  }
+  let suggestion = result;
+  let usedSuggestion = false;
+  if (typeof result.locator === "function") {
+    const suggestionRow = result.locator(
+      'xpath=ancestor-or-self::*[contains(concat(" ", normalize-space(@class), " "), " select-multi-forums__suggest-item ")][1]'
+    );
+    if ((await suggestionRow.count().catch(() => 0)) > 0) {
+      suggestion = suggestionRow;
+      usedSuggestion = true;
+    }
+  }
+  await suggestion.click();
+  await page.waitForTimeout(300);
+
+  if (typeof scope.locator === "function") {
+    const forumRows = scope.locator(".select-multi-forums__row").filter({ hasText: forum });
+    let forumRow = null;
+    const rowCount = await forumRows.count().catch(() => 0);
+    for (let index = 0; index < rowCount; index += 1) {
+      const candidate = forumRows.nth(index);
+      if (await candidate.isVisible().catch(() => false)) {
+        forumRow = candidate;
+        break;
+      }
+    }
+    if (forumRow) {
+      await forumRow.click();
+      await page.waitForTimeout(300);
+    } else if (usedSuggestion) {
+      throw new Error(`TapTap 搜索到论坛“${forum}”，但未加载可选择的论坛结果行`);
+    }
+  }
+  if (await search.isVisible().catch(() => false)) {
+    const done = await tapTapForumAction(page, scope, "完成");
+    if (!done) {
+      const returned = await clickTapTapForumAction(page, scope, search, "返回", false);
+      if (!returned) {
+        throw new Error(`TapTap 已选择论坛“${forum}”，但弹窗中未找到“返回”按钮`);
+      }
+      await page.waitForTimeout(300);
+    }
+    const completed = await clickTapTapForumAction(page, scope, search, "完成", true);
+    if (!completed) {
+      throw new Error(`TapTap 已选择论坛“${forum}”，但弹窗中未找到“完成”按钮`);
+    }
+  }
+  const deadline = Date.now() + 5000;
+  do {
+    if (!(await search.isVisible().catch(() => false))) {
+      const selected = await firstVisibleText(page, forum);
+      if (!selected) {
+        throw new Error(`TapTap 论坛弹窗已关闭，但未回读到已选论坛: ${forum}`);
+      }
+      return;
+    }
+    await page.waitForTimeout(100);
+  } while (Date.now() < deadline);
+  throw new Error(`TapTap 选择论坛“${forum}”后弹窗未关闭`);
+}
+
+async function applyTapTapSchedule(page, scheduled, promptUser) {
+  if (!scheduled) {
+    return;
+  }
+  const schedule = await firstVisibleText(page, "定时发布");
+  if (!schedule) {
+    throw new Error("TapTap 页面中未找到“定时发布”设置");
+  }
+  await schedule.click();
+  await page.waitForTimeout(300);
+  if (!(await firstVisibleText(page, "选择发布的日期与时间"))) {
+    throw new Error("TapTap 定时发布未成功勾选");
+  }
+  await promptUser("TapTap 已勾选定时发布，请在页面中确认具体日期与时间");
+}
+
+export function tapTapMutationResponse(response, action = "publish") {
+  const request = response.request();
+  if (!/^(?:POST|PUT|PATCH)$/i.test(request.method())) {
+    return false;
+  }
+  const url = response.url();
+  if (!/taptap\.cn/i.test(url)) {
+    return false;
+  }
+  let pathname;
+  try {
+    pathname = new URL(url).pathname.toLowerCase().replace(/\/+$/, "");
+  } catch {
+    return false;
+  }
+  if (action === "draft") {
+    return /\/(?:moment|topic|review)-draft\/v\d+\/(?:create|update)(?:-topic)?$/.test(pathname);
+  }
+  return (
+    /\/(?:moment|topic)-draft\/v\d+\/publish(?:-topic)?$/.test(pathname) ||
+    /\/moment\/v\d+\/create-topic$/.test(pathname) ||
+    /\/topic\/v\d+\/create$/.test(pathname)
+  );
+}
+
+async function waitForTapTapSubmission(page, initialUrl, action, mutationPromise, options) {
+  if (options.skipSubmissionVerification) {
+    return { confirmation: "test" };
+  }
+  const successPattern = action === "draft" ? /草稿(?:保存)?成功|已保存至草稿/i : /发布成功|提交成功|已发布/i;
+  const outcomes = [];
+  if (typeof page.waitForURL === "function") {
+    outcomes.push(
+      page
+        .waitForURL(url => url.toString() !== initialUrl && !/\/creator\/edit(?:[/?#]|$)/i.test(url.toString()), {
+          timeout: 12000
+        })
+        .then(() => ({ confirmation: "navigation" }))
+        .catch(() => null)
+    );
+  }
+  if (typeof page.getByText === "function") {
+    outcomes.push(
+      page
+        .getByText(successPattern)
+        .first()
+        .waitFor({ state: "visible", timeout: 12000 })
+        .then(() => ({ confirmation: "message" }))
+        .catch(() => null)
+    );
+  }
+  outcomes.push(
+    mutationPromise.then(async response => {
+      if (!response || response.status() < 200 || response.status() >= 300) {
+        return null;
+      }
+      const payload = await response.json().catch(() => null);
+      if (payload && typeof payload === "object") {
+        if (payload.success === false) {
+          return null;
+        }
+        if (payload.code !== undefined && ![0, 200, "0", "200"].includes(payload.code)) {
+          return null;
+        }
+        if (/失败|错误|fail|error/i.test(normalizeText(payload.message))) {
+          return null;
+        }
+      }
+      return { confirmation: "response", responseUrl: response.url() };
+    })
+  );
+  outcomes.push(page.waitForTimeout(20500).then(() => null));
+
+  const pending = new Set(outcomes);
+  while (pending.size > 0) {
+    const tagged = [...pending].map(promise => promise.then(value => ({ promise, value })));
+    const { promise, value } = await Promise.race(tagged);
+    pending.delete(promise);
+    if (value) {
+      return value;
+    }
+  }
+  throw new Error(
+    `TapTap ${action === "draft" ? "草稿保存" : "发布"}后未检测到成功回执，不能判定为成功`
+  );
+}
+
+async function submitTapTap(page, settings, options, promptUser) {
+  let actionButton;
+  if (settings.draft) {
+    actionButton = await firstVisibleText(page, "保存草稿");
+  } else {
+    actionButton = await firstVisible(page, ["button.tap-button__editor.tap-button--primary"]);
+  }
+  if (!actionButton && !settings.draft) {
+    actionButton = await waitForVisibleButton(page, [/^发布$/], 3000);
+  }
+  if (!actionButton) {
+    throw new Error(`TapTap 页面中未找到${settings.draft ? "保存草稿" : "发布"}按钮`);
+  }
+  if (typeof actionButton.isDisabled === "function" && (await actionButton.isDisabled().catch(() => false))) {
+    throw new Error(`TapTap ${settings.draft ? "保存草稿" : "发布"}按钮不可用，请检查必填内容和媒体上传状态`);
+  }
+
+  const initialUrl = page.url();
+  const action = settings.draft ? "draft" : "publish";
+  const mutationPromise =
+    typeof page.waitForResponse === "function"
+      ? page.waitForResponse(response => tapTapMutationResponse(response, action), { timeout: 20000 }).catch(() => null)
+      : Promise.resolve(null);
+  await actionButton.click();
+  try {
+    return await waitForTapTapSubmission(page, initialUrl, action, mutationPromise, options);
+  } catch (error) {
+    if (options.keepOpen) {
+      await promptUser(`${error.message}，请在浏览器中检查页面提示`);
+    }
+    throw error;
+  }
+}
+
+async function resumeMatchingTapTapDraft(page, spec, articleTitle) {
+  if (typeof page.getByText !== "function") {
+    return false;
+  }
+  const prompt = page.getByText(/你还有上次未发布的内容，是否继续编辑/).first();
+  if ((await prompt.count().catch(() => 0)) === 0 || !(await prompt.isVisible().catch(() => false))) {
+    return false;
+  }
+  const resume = page.getByText("继续编辑", { exact: true }).first();
+  if ((await resume.count().catch(() => 0)) === 0 || !(await resume.isVisible().catch(() => false))) {
+    throw new Error("TapTap 检测到未发布内容，但页面中未找到“继续编辑”按钮");
+  }
+  await resume.click();
+  await afterNavigation(page);
+  const titleInput = await waitForVisible(page, spec.title, 10000);
+  if (!titleInput) {
+    throw new Error("TapTap 继续编辑草稿后未找到标题控件");
+  }
+  let draftTitle = "";
+  const deadline = Date.now() + 5000;
+  do {
+    draftTitle =
+      typeof titleInput.inputValue === "function"
+        ? normalizeText(await titleInput.inputValue().catch(() => ""))
+        : normalizeText(await titleInput.innerText?.().catch(() => ""));
+    if (draftTitle) break;
+    await page.waitForTimeout(100);
+  } while (Date.now() < deadline);
+  if (draftTitle && draftTitle !== articleTitle) {
+    throw new Error(`TapTap 存在其他未发布草稿“${draftTitle}”，已停止以避免覆盖或产生额外草稿`);
+  }
+  return true;
+}
+
+async function uploadTapTapCover(page, source, articleFile) {
+  const coverInput = await firstExisting(page, [
+    'input.editor-post-setting-cover-upload__option-upload-button[type="file"][accept*="image"]',
+    '.editor-post-setting-cover-upload__option input[type="file"][accept*="image"]',
+    '[class*="cover-upload"] input[type="file"][accept*="image"]'
+  ]);
+  if (!coverInput || typeof coverInput.setInputFiles !== "function") {
+    throw new Error("TapTap 长帖页面中未找到独立封面上传控件");
+  }
+  await coverInput.setInputFiles([await imageUploadPayload(source, articleFile, 0, "TapTap")]);
+  let coverScope = page;
+  if (typeof coverInput.locator === "function") {
+    const candidate = coverInput.locator(
+      'xpath=ancestor::*[contains(concat(" ", normalize-space(@class), " "), " editor-post-setting-cover-upload ")][1]'
+    );
+    if ((await candidate.count().catch(() => 0)) > 0) {
+      coverScope = candidate;
+    }
+  }
+  await waitForUploadsSettled(coverScope, "TapTap 封面", 60000);
+}
+
+async function publishTapTap(page, entry, article, spec, options, promptUser) {
+  const settings = resolveTapTapPublishingOptions(article, entry);
+  const titleLimit = settings.type === "moment" ? 20 : 30;
+  if (article.title.length > titleLimit) {
+    throw new Error(`TapTap ${settings.typeLabel}标题最多 ${titleLimit} 个字符，当前为 ${article.title.length} 个字符`);
+  }
+  const richContent = buildTapTapRichContent(article);
+  const body = richContent.plainText || plainTextForPlatform(article, "taptap");
+  if (settings.type === "moment" && body.length > 5000) {
+    throw new Error(`TapTap 图文正文最多 5000 个字符，当前为 ${body.length} 个字符`);
+  }
+
+  await page.goto(tapTapEditorUrl(entry.url, settings.type), {
+    waitUntil: "domcontentloaded",
+    timeout: 60000
+  });
+  await afterNavigation(page);
+  if (!(await waitForEditorReady(page, () => tapTapCreatorReady(page, spec)))) {
+    await ensureBrowserLogin(page, entry, spec, promptUser);
+    await page.goto(tapTapEditorUrl(entry.url, settings.type), {
+      waitUntil: "domcontentloaded",
+      timeout: 60000
+    });
+    await afterNavigation(page);
+  }
+  if (!(await waitForEditorReady(page, () => tapTapCreatorReady(page, spec), 15000))) {
+    throw new Error("TapTap 登录完成后仍未进入创作者发布页，请确认账号拥有发布权限");
+  }
+  await resumeMatchingTapTapDraft(page, spec, article.title);
+
+  if (settings.type === "moment") {
+    const imageSources = settings.images.length
+      ? settings.images
+      : [...new Set([...imageSourcesFromArticle(article), normalizeText(article.payload?.thumbnail)].filter(Boolean))];
+    await uploadTapTapImages(page, settings.images.length ? imageSources : imageSources.slice(0, 18), article.articleFile);
+  } else if (settings.type === "video") {
+    await uploadTapTapVideo(page, settings.video, article.articleFile);
+    if (!(await waitForTapTapEditor(page, spec, 10 * 60 * 1000))) {
+      throw new Error("TapTap 视频上传或处理超时，未进入内容编辑步骤");
+    }
+  }
+
+  const titleInput = await waitForVisible(page, spec.title, 10000);
+  const bodyInput = await waitForVisible(page, spec.body, 10000);
+  if (!titleInput || !bodyInput) {
+    throw new Error(`TapTap ${settings.typeLabel}编辑器未完整加载，未找到标题或正文控件`);
+  }
+  await fillLocator(titleInput, article.title);
+  await verifyFilledValue(titleInput, article.title, "标题");
+  await insertTapTapRichContent(page, bodyInput, article, settings, body);
+
+  if (settings.type === "topic" && settings.cover) {
+    await uploadTapTapCover(page, settings.cover, article.articleFile);
+  }
+  await applyTapTapForum(page, settings.forum, promptUser);
+  await applyTapTapSchedule(page, settings.scheduled, promptUser);
+  if (!settings.draft) {
+    await reviewPreparedDraft(page, entry, options);
+  }
+  const confirmation = await submitTapTap(page, settings, options, promptUser);
+  if (options.keepOpen) {
+    await promptUser(
+      `TapTap ${settings.draft ? "草稿保存" : settings.scheduled ? "定时发布" : "发布"}已收到成功回执，浏览器保持打开供检查`
+    );
+  }
+  return {
+    url: page.url(),
+    status: settings.draft ? "draft" : settings.scheduled ? "scheduled" : "published",
+    type: settings.type,
+    ...confirmation
+  };
+}
+
+function bilibiliVideoDescription(article) {
+  const $ = cheerio.load(article.html || "", null, false);
+  $("script,style,noscript,iframe,img,audio,video").remove();
+  $("a").each((_, element) => {
+    const link = $(element);
+    const label = normalizeText(link.text());
+    const href = safeTapTapHref(link.attr("href"));
+    link.replaceWith(href ? (label && label !== href ? `${label}（${href}）` : href) : label);
+  });
+  return plainTextForPlatform({ ...article, html: $.html() }, "bilibili");
+}
+
+async function validateBilibiliFieldLength(locator, value, label) {
+  if (typeof locator.evaluate !== "function") {
+    return;
+  }
+  const limit = await locator
+    .evaluate(element => {
+      const property = Number(element.maxLength);
+      const attribute = Number(element.getAttribute("maxlength"));
+      return property > 0 ? property : attribute > 0 ? attribute : 0;
+    })
+    .catch(() => 0);
+  if (limit > 0 && value.length > limit) {
+    throw new Error(`B站${label}最多 ${limit} 个字符，当前为 ${value.length} 个字符`);
+  }
+}
+
+async function bilibiliEditorIsReady(page, spec, settings) {
+  if (settings.type === "video") {
+    if (await firstExisting(page, spec.videoInputs)) {
+      return true;
+    }
+    return Boolean(await firstVisibleText(page, "上传视频"));
+  }
+  return editorIsReady(page, spec);
+}
+
+async function uploadBilibiliVideo(page, source, articleFile, spec) {
+  if (!source) {
+    throw new Error("B站视频投稿缺少视频；请设置 bilibili_video 为本地视频文件路径");
+  }
+  if (/^(?:https?:)?\/\//i.test(source)) {
+    throw new Error("B站视频上传仅支持本地文件，请把 bilibili_video 设置为本地视频路径");
+  }
+  const videoPath = path.resolve(articleFile ? path.dirname(articleFile) : process.cwd(), source);
+  const stats = await fs.promises.stat(videoPath).catch(error => {
+    throw new Error(`B站视频文件无法读取: ${videoPath} (${error.message})`);
+  });
+  if (!stats.isFile()) {
+    throw new Error(`B站视频路径不是文件: ${videoPath}`);
+  }
+  const supportedExtensions = new Set([".mp4", ".mov", ".mkv", ".flv", ".avi", ".wmv", ".mpeg", ".mpg", ".webm"]);
+  if (!supportedExtensions.has(path.extname(videoPath).toLowerCase())) {
+    throw new Error("B站视频格式无法识别，建议使用 MP4、MOV 或 MKV 文件");
+  }
+  if (stats.size >= 16 * 1024 * 1024 * 1024) {
+    throw new Error(`B站视频必须小于 16GB，当前文件为 ${(stats.size / 1024 / 1024 / 1024).toFixed(2)}GB`);
+  }
+  const input = await firstExisting(page, [...spec.videoInputs, 'input[type="file"]']);
+  if (!input || typeof input.setInputFiles !== "function") {
+    throw new Error("B站视频投稿页中未找到视频上传控件，页面结构可能已更新");
+  }
+  await input.setInputFiles(videoPath);
+  return videoPath;
+}
+
+async function waitForBilibiliVideoForm(page, spec, timeoutMs = 2 * 60 * 60 * 1000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const titleInput = await firstVisible(page, spec.title);
+    const bodyInput = await firstVisible(page, spec.videoBody);
+    if (titleInput && bodyInput) {
+      return { titleInput, bodyInput };
+    }
+    const bodyText = await page.locator("body").innerText().catch(() => "");
+    if (/上传失败|转码失败|文件格式不支持|视频处理失败/i.test(bodyText)) {
+      throw new Error("B站视频上传或处理失败，请检查页面提示和视频文件");
+    }
+    await page.waitForTimeout(1000);
+  } while (Date.now() < deadline);
+  throw new Error("B站视频上传或处理超时，未进入稿件信息填写步骤");
+}
+
+async function applyBilibiliCategory(page, spec, category, optional = false) {
+  if (!category) {
+    return true;
+  }
+  let opener = await waitForVisible(page, spec.category, optional ? 500 : 3000);
+  opener ||= await firstVisibleText(page, "请选择分区");
+  if (!opener) {
+    if (optional) {
+      return false;
+    }
+    throw new Error("B站页面中未找到稿件分区控件");
+  }
+  await opener.click();
+  const parts = category
+    .split(/\s*(?:\/|>|＞)\s*/)
+    .map(item => item.trim())
+    .filter(Boolean);
+  for (const part of parts) {
+    const option = await firstVisibleText(page, part);
+    if (!option) {
+      throw new Error(`B站投稿分区中未找到: ${part}`);
+    }
+    await option.click();
+    await page.waitForTimeout(200);
+  }
+  return true;
+}
+
+async function applyBilibiliTags(page, spec, tags, optional = false) {
+  if (tags.length === 0) {
+    return true;
+  }
+  if (tags.length > 10) {
+    throw new Error(`B站投稿最多配置 10 个标签，当前为 ${tags.length} 个`);
+  }
+  const input = await waitForVisible(page, spec.tags, optional ? 500 : 3000);
+  if (!input) {
+    if (optional) {
+      return false;
+    }
+    throw new Error("B站页面中未找到标签输入框");
+  }
+  for (const tag of tags) {
+    await input.fill(tag);
+    if (typeof input.press === "function") {
+      await input.press("Enter");
+    } else {
+      await page.keyboard.press("Enter");
+    }
+    await page.waitForTimeout(100);
+  }
+  return true;
+}
+
+export async function applyBilibiliTopic(page, spec, topic, optional = false) {
+  if (!topic) {
+    return true;
+  }
+  let input = await waitForVisible(page, spec.topic, optional ? 500 : 3000);
+  if (!input) {
+    const opener =
+      (await firstVisibleText(page, "添加话题")) ||
+      (await firstVisibleText(page, "选择话题"));
+    if (opener) {
+      await opener.click();
+      input = await waitForVisible(page, spec.topic, 3000);
+    }
+  }
+  if (!input) {
+    if (optional) {
+      return false;
+    }
+    throw new Error("B站页面中未找到话题输入框");
+  }
+
+  await input.fill(topic);
+  await page.waitForTimeout(300);
+  const candidates = page.getByText(topic, { exact: true });
+  let option = null;
+  const count = await candidates.count();
+  for (let index = 0; index < count; index += 1) {
+    const candidate = candidates.nth(index);
+    if (await candidate.isVisible().catch(() => false)) {
+      option = candidate;
+      break;
+    }
+  }
+  if (!option) {
+    throw new Error(`B站话题列表中未找到: ${topic}`);
+  }
+  await option.click();
+  await page.waitForTimeout(200);
+  const selected = await firstVisibleText(page, topic);
+  if (!selected) {
+    throw new Error(`B站话题未正确选中: ${topic}`);
+  }
+  return true;
+}
+
+async function uploadBilibiliCover(page, spec, source, articleFile, optional = false) {
+  if (!source) {
+    return true;
+  }
+  const input = await firstExisting(page, spec.coverInputs);
+  if (!input || typeof input.setInputFiles !== "function") {
+    if (optional) {
+      return false;
+    }
+    throw new Error("B站页面中未找到封面上传控件");
+  }
+  await input.setInputFiles([await imageUploadPayload(source, articleFile, 0, "B站")]);
+  await waitForUploadsSettled(page, "B站封面", 120000);
+  return true;
+}
+
+async function applyBilibiliMetadata(page, spec, settings, article, optional = false) {
+  return {
+    category: await applyBilibiliCategory(page, spec, settings.category, optional),
+    tags: await applyBilibiliTags(page, spec, settings.tags, optional),
+    topic: await applyBilibiliTopic(page, spec, settings.topic, optional),
+    cover: await uploadBilibiliCover(page, spec, settings.cover, article.articleFile, optional)
+  };
+}
+
+function bilibiliMutationResponse(response) {
+  const request = response.request();
+  if (!/^(?:POST|PUT|PATCH)$/i.test(request.method())) {
+    return false;
+  }
+  const url = response.url();
+  return (
+    /(?:bilibili\.com|bilibili\.tv)/i.test(url) &&
+    /article|archive|submit|publish|add|edit/i.test(url) &&
+    !/upload|preupload|cover|image|tag|topic|log|track|report|event/i.test(url)
+  );
+}
+
+async function waitForBilibiliSubmission(page, initialUrl, mutationPromise, options) {
+  if (options.skipSubmissionVerification) {
+    return { confirmation: "test" };
+  }
+  const outcomes = [];
+  if (typeof page.waitForURL === "function") {
+    outcomes.push(
+      page
+        .waitForURL(
+          url => {
+            const current = url.toString();
+            return current !== initialUrl && /upload-manager|archive|article\/list|platform\/home/i.test(current);
+          },
+          { timeout: 30000 }
+        )
+        .then(() => ({ confirmation: "navigation" }))
+        .catch(() => null)
+    );
+  }
+  outcomes.push(
+    waitForVisibleTextAcrossFrames(
+      page,
+      /投稿成功|发布成功|提交成功|稿件投递成功|已提交审核/i,
+      30000,
+      false
+    ).then(locator => (locator ? { confirmation: "message" } : null))
+  );
+  outcomes.push(
+    mutationPromise.then(async response => {
+      if (!response) {
+        return null;
+      }
+      const payload = await response.json().catch(() => null);
+      const message = normalizeText(payload?.message || payload?.msg);
+      const successfulStatus = response.status() >= 200 && response.status() < 300;
+      const successfulCode = !payload || payload.code === undefined || [0, 200, "0", "200"].includes(payload.code);
+      if (!successfulStatus || !successfulCode || /失败|错误|fail|error/i.test(message)) {
+        return { error: message || `接口返回 HTTP ${response.status()}` };
+      }
+      return { confirmation: "response", responseUrl: response.url() };
+    })
+  );
+  outcomes.push(page.waitForTimeout(30500).then(() => null));
+
+  const pending = new Set(outcomes);
+  while (pending.size > 0) {
+    const tagged = [...pending].map(promise => promise.then(value => ({ promise, value })));
+    const { promise, value } = await Promise.race(tagged);
+    pending.delete(promise);
+    if (value?.error) {
+      throw new Error(`B站投稿失败: ${value.error}`);
+    }
+    if (value) {
+      return value;
+    }
+  }
+  throw new Error("B站提交后未检测到成功回执，不能判定为发布成功");
+}
+
+async function submitBilibili(page, spec, settings, article, metadataApplied, options, promptUser) {
+  let actionButton = await waitForVisible(page, spec.submitSelectors, 5000);
+  actionButton ||= await waitForVisibleButton(page, [...spec.submit, /^下一步$/], 5000);
+  if (!actionButton) {
+    throw new Error("B站页面中未找到投稿按钮，页面结构可能已更新");
+  }
+  if (typeof actionButton.isDisabled === "function" && (await actionButton.isDisabled().catch(() => false))) {
+    throw new Error("B站投稿按钮不可用，请检查分区、标签、封面和媒体上传状态");
+  }
+
+  const initialUrl = page.url();
+  const mutationPromise =
+    typeof page.waitForResponse === "function"
+      ? page.waitForResponse(bilibiliMutationResponse, { timeout: 30000 }).catch(() => null)
+      : Promise.resolve(null);
+  const actionText =
+    typeof actionButton.innerText === "function" ? normalizeText(await actionButton.innerText().catch(() => "")) : "";
+  await actionButton.click();
+  await page.waitForTimeout(500);
+
+  if (settings.type === "article" && (settings.category || settings.tags.length > 0 || settings.topic || settings.cover)) {
+    await applyBilibiliMetadata(
+      page,
+      spec,
+      {
+        ...settings,
+        category: metadataApplied.category ? "" : settings.category,
+        tags: metadataApplied.tags ? [] : settings.tags,
+        topic: metadataApplied.topic ? "" : settings.topic,
+        cover: metadataApplied.cover ? "" : settings.cover
+      },
+      article
+    );
+  }
+  let confirmationButton = await waitForVisibleButton(page, [/^确认发布$/, /^确认投稿$/, /^确定提交$/], 2000);
+  if (!confirmationButton && /^下一步$/.test(actionText)) {
+    confirmationButton = await waitForVisibleButton(page, [/^发布$/, /^立即发布$/, /^提交文章$/, /^立即投稿$/], 3000);
+  }
+  if (confirmationButton) {
+    if (typeof confirmationButton.isDisabled === "function" && (await confirmationButton.isDisabled().catch(() => false))) {
+      throw new Error("B站最终提交按钮不可用，请检查投稿设置中的必填项");
+    }
+    await confirmationButton.click();
+  }
+
+  try {
+    return await waitForBilibiliSubmission(page, initialUrl, mutationPromise, options);
+  } catch (error) {
+    if (options.keepOpen) {
+      await promptUser(`${error.message}，请在浏览器中检查页面提示`);
+    }
+    throw error;
+  }
+}
+
+async function publishBilibili(page, entry, article, spec, options, promptUser) {
+  const settings = resolveBilibiliPublishingOptions(article);
+  const editorUrl = bilibiliEditorUrl(entry.url, settings.type);
+  await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+  await afterNavigation(page);
+  if (!(await waitForEditorReady(page, () => bilibiliEditorIsReady(page, spec, settings)))) {
+    await ensureBrowserLogin(page, entry, spec, promptUser);
+    await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+    await afterNavigation(page);
+  }
+  if (!(await waitForEditorReady(page, () => bilibiliEditorIsReady(page, spec, settings), 15000))) {
+    throw new Error(`B站登录完成后仍未进入${settings.typeLabel}投稿页，请确认账号拥有投稿权限`);
+  }
+
+  let titleInput;
+  let bodyInput;
+  if (settings.type === "video") {
+    await uploadBilibiliVideo(page, settings.video, article.articleFile, spec);
+    ({ titleInput, bodyInput } = await waitForBilibiliVideoForm(page, spec));
+  } else {
+    titleInput = await waitForVisible(page, spec.title, 10000);
+    bodyInput = await waitForVisible(page, spec.body, 10000);
+  }
+  if (!titleInput || !bodyInput) {
+    throw new Error(`B站${settings.typeLabel}编辑器未完整加载，未找到标题或正文控件`);
+  }
+
+  const body =
+    settings.type === "video"
+      ? bilibiliVideoDescription(article)
+      : buildBilibiliRichContent(article).plainText || plainTextForPlatform(article, "bilibili");
+  await validateBilibiliFieldLength(titleInput, article.title, "标题");
+  await validateBilibiliFieldLength(bodyInput, body, settings.type === "video" ? "简介" : "正文");
+  await fillLocator(titleInput, article.title);
+  await verifyFilledValue(titleInput, article.title, "标题", "B站");
+  if (settings.type === "article") {
+    await insertBilibiliRichContent(page, bodyInput, article, spec, body);
+  } else {
+    await fillLocator(bodyInput, body);
+    await verifyFilledValue(bodyInput, body, "简介", "B站");
+    await applyBilibiliMetadata(page, spec, settings, article);
+  }
+
+  const metadataApplied =
+    settings.type === "article"
+      ? await applyBilibiliMetadata(page, spec, settings, article, true)
+      : { category: true, tags: true, topic: true, cover: true };
+  await reviewPreparedDraft(page, entry, options);
+  const confirmation = await submitBilibili(page, spec, settings, article, metadataApplied, options, promptUser);
+  if (options.keepOpen) {
+    await promptUser(`B站${settings.typeLabel}投稿已收到成功回执，浏览器保持打开供检查`);
+  }
+  return {
+    url: page.url(),
+    status: "published",
+    type: settings.type,
+    ...confirmation
+  };
+}
+
+async function weiboArticleImageButton(page) {
+  const imagePath = page.locator('svg path[d^="M18 4C18.6"]').first();
+  if ((await imagePath.count()) === 0 || !(await imagePath.isVisible().catch(() => false))) {
+    return null;
+  }
+  const button = imagePath.locator("xpath=../..");
+  return (await button.count()) > 0 ? button : null;
+}
+
+async function weiboEditorIsSpinning(page) {
+  if (typeof page.locator !== "function") {
+    return false;
+  }
+  const spinner = page.locator(".n-spin-body.wb-editor-spin").first();
+  return (await spinner.count().catch(() => 0)) > 0 && (await spinner.isVisible().catch(() => false));
+}
+
+async function ensureWeiboArticleDraft(page, articleTitle) {
+  let createClicked = false;
+  let matchingDraftClicked = false;
+  let matchingDraftChecked = false;
+  for (let attempt = 0; attempt < 120; attempt += 1) {
+    const hasDraftId = /#\/draft\/[^/?#]+/.test(page.url());
+    const spinning = await weiboEditorIsSpinning(page);
+    if (hasDraftId && !spinning) {
+      return matchingDraftClicked ? "resumed" : createClicked ? "created" : "existing";
+    }
+    if (!matchingDraftChecked && articleTitle && typeof page.getByText === "function") {
+      matchingDraftChecked = true;
+      const matches = page.getByText(articleTitle, { exact: true });
+      const count = await matches.count().catch(() => 0);
+      for (let index = 0; index < count; index += 1) {
+        const candidate = matches.nth(index);
+        if (!(await candidate.isVisible().catch(() => false))) continue;
+        await candidate.click();
+        matchingDraftClicked = true;
+        break;
+      }
+      if (matchingDraftClicked) {
+        await page.waitForTimeout(500);
+        continue;
+      }
+    }
+    if (!matchingDraftClicked && !createClicked) {
+      const createButton = await firstVisibleButton(page, [/写文章/]);
+      if (createButton) {
+        await createButton.click();
+        createClicked = true;
+      }
+    }
+    await page.waitForTimeout(250);
+  }
+  throw new Error("微博草稿箱为空且未能创建新头条文章草稿");
+}
+
+async function waitForWeiboArticleInlineImage(bodyInput, previousCount, source) {
+  const deadline = Date.now() + 90000;
+  let stableChecks = 0;
+  do {
+    const count = await bodyInput.locator("img:not(.ProseMirror-separator)").count();
+    const failed = await bodyInput
+      .locator('[class*="upload-fail"], [class*="upload-error"], [class*="retry"]')
+      .count();
+    const pending = await pendingUploadCount(bodyInput);
+    if (failed > 0) {
+      throw new Error(`微博文章正文图片上传失败: ${source}`);
+    }
+    if (count > previousCount && pending === 0) {
+      stableChecks += 1;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+    }
+    await new Promise(resolve => setTimeout(resolve, 250));
+  } while (Date.now() < deadline);
+  throw new Error(`微博文章正文图片插入超时: ${source}`);
+}
+
+async function weiboControlDisabled(control) {
+  if (typeof control.isDisabled === "function" && (await control.isDisabled().catch(() => false))) {
+    return true;
+  }
+  if (typeof control.evaluate !== "function") {
+    return false;
+  }
+  return control
+    .evaluate(element =>
+      Boolean(element.disabled) ||
+      element.getAttribute("aria-disabled") === "true" ||
+      element.classList.contains("n-button--disabled") ||
+      element.classList.contains("is-disabled")
+    )
+    .catch(() => false);
+}
+
+async function visibleWeiboCropDialog(page) {
+  if (typeof page.locator !== "function") {
+    return null;
+  }
+  const visibleDialogs = page.locator('[role="dialog"]:visible');
+  if (typeof visibleDialogs.filter === "function") {
+    const matching = visibleDialogs.filter({ hasText: /裁剪图片|图片裁剪|裁剪/ }).last();
+    if ((await matching.count().catch(() => 0)) > 0 && (await matching.isVisible().catch(() => false))) {
+      return matching;
+    }
+  }
+  const dialogs = page.locator('[role="dialog"]');
+  const count = await dialogs.count().catch(() => 0);
+  for (let index = 0; index < count; index += 1) {
+    const dialog = dialogs.nth(index);
+    if (!(await dialog.isVisible().catch(() => false))) {
+      continue;
+    }
+    const text = typeof dialog.innerText === "function" ? await dialog.innerText().catch(() => "") : "";
+    if (/裁剪图片|图片裁剪|裁剪/.test(text)) {
+      return dialog;
+    }
+  }
+  return null;
+}
+
+async function clearExistingWeiboArticleImages(page, scope) {
+  const items = scope.locator(".image-list .image-item");
+  let cleared = 0;
+  while (cleared < 200) {
+    const previousCount = await items.count().catch(() => 0);
+    if (previousCount === 0) {
+      return cleared;
+    }
+    const item = items.first();
+    if (typeof item.hover === "function") {
+      await item.hover().catch(() => {});
+    }
+    const remove = item.locator(".ico_delpic");
+    if ((await remove.count().catch(() => 0)) === 0) {
+      throw new Error("微博头条文章图片库中未找到旧图片删除控件");
+    }
+    await remove.click();
+    const deadline = Date.now() + 10000;
+    let currentCount = previousCount;
+    do {
+      currentCount = await items.count().catch(() => previousCount);
+      if (currentCount < previousCount) {
+        break;
+      }
+      const text = typeof scope.innerText === "function" ? await scope.innerText().catch(() => "") : "";
+      if (/删除失败|操作失败|网络异常/.test(text)) {
+        throw new Error("微博头条文章图片库旧图片删除失败");
+      }
+      await page.waitForTimeout(200);
+    } while (Date.now() < deadline);
+    if (currentCount >= previousCount) {
+      throw new Error("微博头条文章图片库旧图片删除后未消失");
+    }
+    cleared += previousCount - currentCount;
+  }
+  throw new Error("微博头条文章图片库旧图片超过 200 张，已停止清理");
+}
+
+async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, source, options = {}) {
+  options.onProgress?.("正在打开图片库");
+  const imageButton = await weiboArticleImageButton(page);
+  if (!imageButton) {
+    throw new Error("微博头条文章编辑器中未找到图片库按钮");
+  }
+  await imageButton.click();
+  const input = await firstExisting(page, spec.imageInputs);
+  if (!input || typeof input.setInputFiles !== "function") {
+    throw new Error("微博头条文章图片库中未找到上传控件");
+  }
+  const modal = input.locator(
+    '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;
+  if (structuredLibrary && options.clearExistingLibrary) {
+    options.onProgress?.("正在清理图片库旧图");
+    await clearExistingWeiboArticleImages(page, scope);
+  }
+  const previews = structuredLibrary
+    ? scope.locator(".image-list .image-item")
+    : scope.locator('img[src], [style*="background-image"]');
+  const previousPreviews = await previews.count().catch(() => 0);
+  const previousPreviewKeys =
+    typeof previews.evaluateAll === "function"
+      ? await previews
+          .evaluateAll(elements =>
+            elements.map(element => {
+              const image = element.matches("img") ? element : element.querySelector("img");
+              return image?.currentSrc || image?.src || element.style.backgroundImage;
+            })
+          )
+          .catch(() => [])
+      : [];
+  const previousImages = await bodyInput.locator("img:not(.ProseMirror-separator)").count();
+  options.onProgress?.("正在上传正文图片");
+  await input.setInputFiles([payload]);
+
+  const uploadDeadline = Date.now() + 120000;
+  let stablePreviews = 0;
+  do {
+    const modalText = typeof scope.innerText === "function" ? await scope.innerText().catch(() => "") : "";
+    if (/上传失败|图片格式不支持|重新上传/.test(modalText)) {
+      throw new Error(`微博文章图片上传失败: ${source}`);
+    }
+    const previewReady = (await previews.count().catch(() => previousPreviews)) > previousPreviews;
+    const pending = await pendingUploadCount(scope);
+    if (previewReady && pending === 0 && !/上传中|正在上传|处理中/.test(modalText)) {
+      stablePreviews += 1;
+      if (stablePreviews >= 3) {
+        options.onProgress?.("正文图片上传完成，正在插入正文");
+        break;
+      }
+    } else {
+      stablePreviews = 0;
+    }
+    await page.waitForTimeout(250);
+    if (Date.now() >= uploadDeadline) {
+      throw new Error(`微博文章图片上传超时: ${source}`);
+    }
+  } while (true);
+
+  let uploadedPreview = previews.last();
+  if (previousPreviewKeys.length > 0 && typeof previews.evaluateAll === "function") {
+    const previewKeys = await previews
+      .evaluateAll(elements =>
+        elements.map(element => {
+          const image = element.matches("img") ? element : element.querySelector("img");
+          return image?.currentSrc || image?.src || element.style.backgroundImage;
+        })
+      )
+      .catch(() => []);
+    const uploadedIndex = previewKeys.findIndex(key => key && !previousPreviewKeys.includes(key));
+    if (uploadedIndex >= 0) {
+      uploadedPreview = previews.nth(uploadedIndex);
+    }
+  }
+  if ((await uploadedPreview.count()) > 0 && (await uploadedPreview.isVisible().catch(() => false))) {
+    await uploadedPreview.click();
+  } else {
+    throw new Error(`微博文章图片上传完成后未找到可选缩略图: ${source}`);
+  }
+  await page.waitForTimeout(200);
+  if (structuredLibrary && typeof uploadedPreview.evaluate === "function") {
+    let selected = await uploadedPreview
+      .evaluate(element => element.classList.contains("is-selected") || element.getAttribute("aria-selected") === "true")
+      .catch(() => false);
+    if (!selected) {
+      await uploadedPreview.click({ force: true });
+      await page.waitForTimeout(200);
+      selected = await uploadedPreview
+        .evaluate(element => element.classList.contains("is-selected") || element.getAttribute("aria-selected") === "true")
+        .catch(() => false);
+    }
+    if (!selected) {
+      throw new Error(`微博文章图片上传完成后未成功选中缩略图: ${source}`);
+    }
+  }
+
+  let insertButton = null;
+  if (typeof scope.getByRole === "function") {
+    const buttons = scope.getByRole("button", { name: "插入", exact: true });
+    const count = await buttons.count().catch(() => 0);
+    for (let index = count - 1; index >= 0; index -= 1) {
+      const candidate = buttons.nth(index);
+      if (await candidate.isVisible().catch(() => false)) {
+        insertButton = candidate;
+        break;
+      }
+    }
+  }
+  const insertLabel = !insertButton && typeof scope.getByText === "function"
+    ? scope.getByText("插入", { exact: true }).last()
+    : null;
+  if (!insertButton && insertLabel && (await insertLabel.count()) > 0 && (await insertLabel.isVisible().catch(() => false))) {
+    insertButton = insertLabel;
+  }
+  if (!insertButton) {
+    throw new Error("微博头条文章图片库中未找到“插入”按钮");
+  }
+  if (insertButton === insertLabel && typeof insertLabel.locator === "function") {
+    const control = insertLabel.locator('xpath=ancestor-or-self::*[self::button or @role="button"][1]');
+    if ((await control.count().catch(() => 0)) > 0) {
+      insertButton = control;
+    }
+  }
+  for (let attempt = 0; attempt < 12 && (await weiboControlDisabled(insertButton)); attempt += 1) {
+    await page.waitForTimeout(150);
+  }
+  if (await weiboControlDisabled(insertButton)) {
+    throw new Error("微博头条文章图片上传后“插入”按钮仍不可用");
+  }
+  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);
+    }
+  }
+
+  const cropDialog = await visibleWeiboCropDialog(page);
+  if (cropDialog) {
+    let cropInsert = null;
+    if (typeof cropDialog.getByRole === "function") {
+      cropInsert = cropDialog.getByRole("button", { name: /^(?:插入|确定|完成)$/ }).last();
+      if ((await cropInsert.count().catch(() => 0)) === 0 || !(await cropInsert.isVisible().catch(() => false))) {
+        cropInsert = null;
+      }
+    }
+    cropInsert ||= typeof cropDialog.getByText === "function"
+      ? cropDialog.getByText(/^(?:插入|确定|完成)$/).last()
+      : null;
+    if (!cropInsert) {
+      throw new Error("微博图片裁剪页面中未找到默认插入按钮");
+    }
+    if (await weiboControlDisabled(cropInsert)) {
+      throw new Error("微博图片默认裁剪尚未完成，无法插入正文");
+    }
+    let cropClosed = false;
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      options.onProgress?.(`正在等待正文图片裁剪就绪${attempt > 0 ? "（重试）" : ""}`);
+      await waitForWeiboCropReady(page, cropDialog, cropInsert);
+      options.onProgress?.("正在确认正文图片裁剪");
+      await cropInsert.click({ force: true });
+      for (let check = 0; check < 40; check += 1) {
+        if (!(await cropDialog.isVisible().catch(() => false))) {
+          cropClosed = true;
+          break;
+        }
+        await page.waitForTimeout(250);
+      }
+      if (cropClosed) {
+        break;
+      }
+    }
+    if (!cropClosed) {
+      throw new Error("微博正文图片裁剪确认后弹窗未关闭");
+    }
+  }
+  await waitForWeiboArticleInlineImage(bodyInput, previousImages, source);
+  options.onProgress?.("正文图片已插入");
+}
+
+export async function insertWeiboArticleRichContent(page, bodyInput, article, spec, fallbackText, options = {}) {
+  if (typeof bodyInput.evaluate !== "function" || typeof bodyInput.locator !== "function") {
+    await fillLocator(bodyInput, fallbackText);
+    await verifyFilledValue(bodyInput, fallbackText, "正文", "微博文章");
+    return { rich: false, images: 0, links: 0 };
+  }
+
+  const content = buildWeiboRichContent(article);
+  await bodyInput.fill("");
+  const markerPrefix = `QCPLAY_WEIBO_IMAGE_${Date.now()}_`;
+  const imageMarkers = [];
+  const htmlParts = [];
+  const plainParts = [];
+  for (let index = 0; index < content.items.length; index += 1) {
+    const item = content.items[index];
+    if (item.type === "html") {
+      htmlParts.push(item.html);
+      plainParts.push(item.plain);
+      continue;
+    }
+    const marker = `${markerPrefix}${imageMarkers.length}`;
+    htmlParts.push(`<p>${marker}</p>`);
+    plainParts.push(marker);
+    imageMarkers.push({ marker, item, index });
+  }
+  if (htmlParts.length > 0) {
+    await pasteRichHtml(bodyInput, { html: htmlParts.join(""), plain: plainParts.join("\n") });
+    await page.waitForTimeout(100);
+  }
+
+  const payloadCache = new Map();
+  for (let imageIndex = 0; imageIndex < imageMarkers.length; imageIndex += 1) {
+    const { marker, item, index } = imageMarkers[imageIndex];
+    const selected = await bodyInput.evaluate((element, markerValue) => {
+      const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+      let textNode = walker.nextNode();
+      while (textNode) {
+        const start = textNode.data.indexOf(markerValue);
+        if (start >= 0) {
+          const range = document.createRange();
+          range.setStart(textNode, start);
+          range.setEnd(textNode, start + markerValue.length);
+          const selection = window.getSelection();
+          selection.removeAllRanges();
+          selection.addRange(range);
+          document.dispatchEvent(new Event("selectionchange", { bubbles: true }));
+          return true;
+        }
+        textNode = walker.nextNode();
+      }
+      return false;
+    }, marker);
+    if (!selected) {
+      throw new Error(`微博文章正文图片占位位置丢失: ${item.source}`);
+    }
+    await page.keyboard.press("Backspace");
+    let payload = payloadCache.get(item.source);
+    if (!payload) {
+      options.onProgress?.(`正在读取第 ${imageIndex + 1} 张正文图片`);
+      payload = await imageUploadPayload(item.source, article.articleFile, index, "微博文章");
+      payloadCache.set(item.source, payload);
+    }
+    await uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, item.source, {
+      clearExistingLibrary: imageIndex === 0,
+      onProgress: options.onProgress
+    });
+  }
+
+  const state = await bodyInput.evaluate(element => ({
+    text: element.innerText,
+    images: element.querySelectorAll("img:not(.ProseMirror-separator)").length,
+    failedImages: element.querySelectorAll('[class*="upload-fail"], [class*="upload-error"]').length,
+    links: [...element.querySelectorAll("a[href]")].map(link => ({ href: link.href, label: link.innerText }))
+  }));
+  if (state.failedImages > 0 || state.images < content.images.length) {
+    throw new Error(`微博文章正文图片写入不完整，预期 ${content.images.length} 张，实际 ${state.images} 张`);
+  }
+  const actualText = normalizedTapTapText(state.text);
+  if (actualText.includes(markerPrefix)) {
+    throw new Error("微博文章正文图片占位符未正确替换");
+  }
+  for (const item of content.items) {
+    if (item.type === "html" && item.plain && !actualText.includes(normalizedTapTapText(item.plain))) {
+      throw new Error("微博文章正文文字未完整写入编辑器");
+    }
+  }
+  const actualLinks = new Set(state.links.map(link => safeTapTapHref(link.href)));
+  for (const link of content.links) {
+    if (!actualLinks.has(link.href)) {
+      throw new Error(`微博文章正文超链接未正确写入: ${link.href}`);
+    }
+  }
+  return { rich: true, images: content.images.length, links: content.links.length, plainText: content.plainText };
+}
+
+async function waitForWeiboDialog(page, pattern, timeoutMs = 8000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const visibleDialogs = page.locator('[role="dialog"]:visible');
+    if (typeof visibleDialogs.filter === "function") {
+      const matching = visibleDialogs.filter({ hasText: pattern }).last();
+      if ((await matching.count().catch(() => 0)) > 0 && (await matching.isVisible().catch(() => false))) {
+        return matching;
+      }
+    }
+    const dialogs = page.locator('[role="dialog"]');
+    const count = await dialogs.count().catch(() => 0);
+    for (let index = count - 1; index >= 0; index -= 1) {
+      const dialog = dialogs.nth(index);
+      if (!(await dialog.isVisible().catch(() => false))) {
+        continue;
+      }
+      const text = typeof dialog.innerText === "function" ? await dialog.innerText().catch(() => "") : "";
+      if (pattern.test(text)) {
+        return dialog;
+      }
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+function weiboImageSourceKey(value) {
+  return normalizeText(value).replace(/\\/g, "/").replace(/^(?:\.\/)+/, "");
+}
+
+async function waitForWeiboCropReady(page, cropDialog, confirmButton) {
+  let stableChecks = 0;
+  let previousSignature = "";
+  const canInspectCropper = typeof cropDialog.evaluate === "function";
+  for (let attempt = 0; attempt < 120; attempt += 1) {
+    const cropState =
+      canInspectCropper
+        ? await cropDialog
+            .evaluate(element => {
+              const cropImage = element.querySelector("cropper-image");
+              const selection = element.querySelector("cropper-selection");
+              if (!cropImage || !selection) {
+                return { supported: false, ready: false };
+              }
+              const source = cropImage.getAttribute("src") || "";
+              const selectionRect = selection.getBoundingClientRect();
+              const width = Number(selection.getAttribute("width")) || selectionRect.width;
+              const height = Number(selection.getAttribute("height")) || selectionRect.height;
+              const transform = cropImage.style.transform || getComputedStyle(cropImage).transform;
+              const spinning = Boolean(
+                element.querySelector('.n-spin-body, [aria-busy="true"], [class*="loading"], [class*="processing"]')
+              );
+              return {
+                supported: true,
+                ready:
+                  Boolean(source) &&
+                  width > 0 &&
+                  height > 0 &&
+                  Boolean(transform && transform !== "none") &&
+                  !spinning,
+                signature: `${source}|${Math.round(width)}x${Math.round(height)}|${Math.round(selectionRect.x)},${Math.round(selectionRect.y)}|${transform}`
+              };
+            })
+            .catch(() => ({ supported: false, ready: false }))
+        : { supported: false, ready: true };
+    const ready = canInspectCropper
+      ? cropState.supported && cropState.ready
+      : !(await weiboControlDisabled(confirmButton));
+    if (ready && !(await weiboControlDisabled(confirmButton))) {
+      if (!cropState.signature || cropState.signature === previousSignature) {
+        stableChecks += 1;
+      } else {
+        stableChecks = 1;
+      }
+      previousSignature = cropState.signature || previousSignature;
+      if (stableChecks >= 3) {
+        return;
+      }
+    } else {
+      stableChecks = 0;
+      previousSignature = "";
+    }
+    await page.waitForTimeout(250);
+  }
+  throw new Error("微博文章封面裁剪图片未完成加载，无法确认");
+}
+
+async function visibleWeiboCoverProcessingError(page) {
+  if (typeof page.getByText !== "function") {
+    return false;
+  }
+  const message = page.getByText(/图片处理失败|裁剪失败|封面处理失败/).last();
+  return (await message.count().catch(() => 0)) > 0 && (await message.isVisible().catch(() => false));
+}
+
+async function waitForWeiboCoverProcessingErrorToClear(page) {
+  for (let attempt = 0; attempt < 20; attempt += 1) {
+    if (!(await visibleWeiboCoverProcessingError(page))) {
+      return;
+    }
+    await page.waitForTimeout(250);
+  }
+}
+
+async function waitForWeiboCoverApplyOutcome(page, cropDialog, timeoutMs = 20000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    if (await visibleWeiboCoverProcessingError(page)) {
+      return "processing-error";
+    }
+    const cropVisible = await cropDialog.isVisible().catch(() => false);
+    const emptyCover = page.locator(".cover-empty").first();
+    const emptyVisible =
+      (await emptyCover.count().catch(() => 0)) > 0 && (await emptyCover.isVisible().catch(() => false));
+    const dialogVisible = (await page.locator('[role="dialog"]:visible').count().catch(() => 0)) > 0;
+    if (!cropVisible && !dialogVisible && !emptyVisible) {
+      return "applied";
+    }
+    await page.waitForTimeout(250);
+  } while (Date.now() < deadline);
+  return "timeout";
+}
+
+export async function applyWeiboArticleCover(
+  page,
+  article,
+  settings = resolveWeiboPublishingOptions(article),
+  options = {}
+) {
+  const images = buildWeiboRichContent(article).images;
+  if (images.length === 0) {
+    if (settings.cover) {
+      throw new Error("weibo_cover 必须引用一张正文图片");
+    }
+    return { cover: false, coverSource: "" };
+  }
+
+  let coverIndex = 0;
+  if (settings.cover) {
+    const requested = weiboImageSourceKey(settings.cover);
+    coverIndex = images.findIndex(image => weiboImageSourceKey(image.source) === requested);
+    if (coverIndex < 0) {
+      throw new Error("weibo_cover 必须引用正文中已有的图片");
+    }
+  }
+
+  let opener = await firstVisible(page, [".cover-empty"]);
+  if (!opener && typeof page.getByText === "function") {
+    const label = page.getByText("设置封面", { exact: true }).first();
+    if ((await label.count().catch(() => 0)) > 0 && (await label.isVisible().catch(() => false))) {
+      const section = label.locator("xpath=..");
+      const candidate = section.locator('.cover-empty, [class*="cover"]').first();
+      if ((await candidate.count().catch(() => 0)) > 0 && (await candidate.isVisible().catch(() => false))) {
+        opener = candidate;
+      }
+    }
+  }
+  if (!opener) {
+    throw new Error("微博文章发布设置中未找到封面入口");
+  }
+  options.onProgress?.("正在打开封面设置");
+  await opener.click();
+
+  const chooser = await waitForWeiboDialog(page, /正文图片.*图片库|请从正文图片中选择一张作为封面图/s);
+  if (!chooser) {
+    throw new Error("微博文章封面选择弹窗未打开");
+  }
+  const choices = chooser.locator(".image-list .image-item");
+  const choiceDeadline = Date.now() + 10000;
+  while ((await choices.count().catch(() => 0)) <= coverIndex && Date.now() < choiceDeadline) {
+    await page.waitForTimeout(200);
+  }
+  if ((await choices.count().catch(() => 0)) <= coverIndex) {
+    throw new Error(`微博文章封面弹窗中未找到第 ${coverIndex + 1} 张正文图片`);
+  }
+  const choice = choices.nth(coverIndex);
+  options.onProgress?.("正在选择封面图片");
+  await choice.click();
+  await page.waitForTimeout(200);
+  let selected = await choice
+    .evaluate(element => element.classList.contains("is-selected") || element.getAttribute("aria-selected") === "true")
+    .catch(() => false);
+  if (!selected) {
+    await choice.click({ force: true });
+    await page.waitForTimeout(200);
+    selected = await choice
+      .evaluate(element => element.classList.contains("is-selected") || element.getAttribute("aria-selected") === "true")
+      .catch(() => false);
+  }
+  if (!selected) {
+    throw new Error("微博文章封面图片未成功选中");
+  }
+
+  const nextButton = chooser.getByRole("button", { name: "下一步", exact: true }).last();
+  if ((await nextButton.count().catch(() => 0)) === 0 || (await weiboControlDisabled(nextButton))) {
+    throw new Error("微博文章封面选图后“下一步”按钮仍不可用");
+  }
+  await nextButton.click();
+
+  const cropDialog = await waitForWeiboDialog(page, /图片裁剪/);
+  if (!cropDialog) {
+    throw new Error("微博文章封面裁剪页面未打开");
+  }
+  const confirmButton = cropDialog.getByRole("button", { name: "确定", exact: true }).last();
+  if ((await confirmButton.count().catch(() => 0)) === 0 || (await weiboControlDisabled(confirmButton))) {
+    throw new Error("微博文章封面裁剪尚未完成，无法确认");
+  }
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    options.onProgress?.(`正在等待封面裁剪就绪${attempt > 0 ? "（重试）" : ""}`);
+    await waitForWeiboCropReady(page, cropDialog, confirmButton);
+    options.onProgress?.("正在确认封面裁剪");
+    await confirmButton.click({ force: true });
+    const outcome = await waitForWeiboCoverApplyOutcome(page, cropDialog);
+    if (outcome === "applied") {
+      options.onProgress?.("封面已确认，正在等待图片处理完成");
+      await waitForUploadsSettled(page, "微博文章封面", 120000);
+      options.onProgress?.("封面处理完成");
+      return { cover: true, coverSource: images[coverIndex].source, coverIndex };
+    }
+    if (outcome === "processing-error" && attempt === 0) {
+      await waitForWeiboCoverProcessingErrorToClear(page);
+      continue;
+    }
+    if (outcome === "timeout" && attempt === 0 && (await cropDialog.isVisible().catch(() => false))) {
+      continue;
+    }
+    if (outcome === "processing-error") {
+      throw new Error("微博文章封面图片处理失败，自动重试后仍未成功");
+    }
+    throw new Error("微博文章封面确认后未显示在发布设置中");
+  }
+  throw new Error("微博文章封面图片处理失败");
+}
+
+function weiboMutationResponse(response) {
+  const request = response.request();
+  if (!/^POST$/i.test(request.method())) {
+    return false;
+  }
+  const url = response.url();
+  return (
+    /(?:^|\.)weibo\.com/i.test(new URL(url).hostname) &&
+    /publish/i.test(url) &&
+    !/upload|pic|image|log|track|report|event/i.test(url)
+  );
+}
+
+async function waitForWeiboSubmission(page, initialUrl, mutationPromise, options) {
+  if (options.skipSubmissionVerification) {
+    return { confirmation: "test" };
+  }
+  const outcomes = [];
+  if (typeof page.waitForURL === "function") {
+    outcomes.push(
+      page
+        .waitForURL(
+          url => url.toString() !== initialUrl && /article.*(?:history|publish|show)|ttarticle/i.test(url.toString()),
+          { timeout: 30000 }
+        )
+        .then(() => ({ confirmation: "navigation" }))
+        .catch(() => null)
+    );
+  }
+  if (typeof page.getByText === "function") {
+    outcomes.push(
+      page
+        .getByText(/发布成功|提交成功|文章发布成功|已提交审核/i)
+        .first()
+        .waitFor({ state: "visible", timeout: 30000 })
+        .then(() => ({ confirmation: "message" }))
+        .catch(() => null)
+    );
+  }
+  outcomes.push(
+    mutationPromise.then(async response => {
+      if (!response) {
+        return null;
+      }
+      const payload = await response.json().catch(() => null);
+      const message = normalizeText(payload?.message || payload?.msg || payload?.error);
+      const successfulStatus = response.status() >= 200 && response.status() < 300;
+      const failedPayload =
+        payload?.ok === 0 ||
+        payload?.success === false ||
+        (payload?.code !== undefined && ![0, 1, 200, 100000, "0", "1", "200", "100000"].includes(payload.code)) ||
+        /失败|错误|fail|error/i.test(message);
+      if (!successfulStatus || failedPayload) {
+        return { error: message || `接口返回 HTTP ${response.status()}` };
+      }
+      return { confirmation: "response", responseUrl: response.url() };
+    })
+  );
+  outcomes.push(page.waitForTimeout(30500).then(() => null));
+
+  const pending = new Set(outcomes);
+  while (pending.size > 0) {
+    const tagged = [...pending].map(promise => promise.then(value => ({ promise, value })));
+    const { promise, value } = await Promise.race(tagged);
+    pending.delete(promise);
+    if (value?.error) {
+      throw new Error(`微博文章发布失败: ${value.error}`);
+    }
+    if (value) {
+      return value;
+    }
+  }
+  throw new Error("微博文章提交后未检测到成功回执，不能判定为发布成功");
+}
+
+async function fillStableWeiboField(page, selectors, value, label) {
+  const expected = normalizeText(value).replace(/\r\n/g, "\n");
+  let lastActual = "";
+  for (let attempt = 1; attempt <= 6; attempt += 1) {
+    const input = await waitForVisible(page, selectors, 3000);
+    if (!input) {
+      break;
+    }
+    try {
+      await fillLocator(input, value);
+      await page.waitForTimeout(250);
+      const current = await firstVisible(page, selectors);
+      if (!current) {
+        continue;
+      }
+      if (typeof current.inputValue === "function") {
+        lastActual = await current.inputValue().catch(() => "");
+      } else if (typeof current.innerText === "function") {
+        lastActual = await current.innerText().catch(() => "");
+      }
+      if (normalizeText(lastActual).replace(/\r\n/g, "\n") === expected) {
+        return current;
+      }
+    } catch (error) {
+      if (!isNavigationContextError(error)) {
+        throw error;
+      }
+      await afterNavigation(page);
+    }
+  }
+  const actualHint = normalizeText(lastActual) ? `，实际为“${normalizeText(lastActual).slice(0, 40)}”` : "，实际为空";
+  throw new Error(`微博文章 ${label}未正确写入编辑器${actualHint}`);
+}
+
+async function weiboSecurityChallengeVisible(page) {
+  if (/security\.weibo\.com\/captcha|geetest/i.test(page.url())) {
+    return true;
+  }
+  if (typeof page.getByText !== "function") {
+    return false;
+  }
+  const challenge = page.getByText(/请先验证身份|向右拖动滑块填充拼图|安全验证/).first();
+  return (await challenge.count().catch(() => 0)) > 0 && (await challenge.isVisible().catch(() => false));
+}
+
+async function waitForWeiboSecurityVerification(page, progress) {
+  if (!(await weiboSecurityChallengeVisible(page))) {
+    return false;
+  }
+  progress("微博触发身份安全验证，请在浏览器中完成滑块验证");
+  const deadline = Date.now() + 10 * 60 * 1000;
+  do {
+    if (!(await weiboSecurityChallengeVisible(page))) {
+      await afterNavigation(page);
+      progress("微博身份验证已完成，正在继续发布");
+      return true;
+    }
+    await page.waitForTimeout(500);
+  } while (Date.now() < deadline);
+  throw new Error("微博身份安全验证等待超时，请完成滑块验证后重试");
+}
+
+async function publishWeibo(page, entry, article, spec, options, promptUser) {
+  const progress = message => options.onProgress?.(message);
+  const settings = resolveWeiboPublishingOptions(article);
+  const body = buildWeiboText(article);
+  if (!body) {
+    throw new Error("微博文章正文不能为空");
+  }
+  if (article.title.length > 32) {
+    throw new Error(`微博文章标题最多 32 个字符，当前为 ${article.title.length} 个字符`);
+  }
+  if (settings.intro.length > 44) {
+    throw new Error(`微博文章导语最多 44 个字符，当前为 ${settings.intro.length} 个字符`);
+  }
+
+  const editorUrl = weiboArticleEditorUrl(entry.url);
+  await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+  await afterNavigation(page);
+  if (!(await waitForEditorReady(page, () => editorIsReady(page, spec)))) {
+    await ensureBrowserLogin(page, entry, spec, promptUser);
+    await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+    await afterNavigation(page);
+  }
+  if (!(await waitForEditorReady(page, () => editorIsReady(page, spec), 15000))) {
+    throw new Error("微博登录完成后仍未进入头条文章编辑器，请确认账号拥有文章发布权限");
+  }
+
+  const draftMode = await ensureWeiboArticleDraft(page, article.title);
+  progress(
+    draftMode === "resumed"
+      ? "已复用最新同标题微博草稿，正在重写文章内容"
+      : "微博草稿已就绪，正在重写文章内容"
+  );
+  await page.waitForTimeout(1000);
+  const titleInput = await waitForVisible(page, spec.title, 8000);
+  const bodyInput = await waitForVisible(page, spec.body, 8000);
+  if (!titleInput || !bodyInput) {
+    throw new Error("微博头条文章编辑器未完整加载，未找到标题或正文控件");
+  }
+  await fillStableWeiboField(page, spec.title, article.title, "标题");
+  const introInput = await waitForVisible(page, spec.intro, 3000);
+  if (introInput) {
+    // Empty input is intentional: drafts may retain the previous article's intro.
+    await fillStableWeiboField(page, spec.intro, settings.intro, "导语");
+  } else if (settings.intro) {
+    throw new Error("微博头条文章编辑器中未找到导语输入框");
+  }
+  const stableBodyInput = (await waitForVisible(page, spec.body, 3000)) || bodyInput;
+  const richContent = await insertWeiboArticleRichContent(page, stableBodyInput, article, spec, body, {
+    onProgress: progress
+  });
+  progress("正文已写入，正在设置封面");
+  const cover = await applyWeiboArticleCover(page, article, settings, { onProgress: progress });
+
+  const nextButton = await waitForVisibleButton(page, spec.next, 5000);
+  if (!nextButton) {
+    throw new Error("微博头条文章编辑器中未找到“下一步”按钮");
+  }
+  if (typeof nextButton.isDisabled === "function" && (await nextButton.isDisabled().catch(() => false))) {
+    throw new Error("微博文章“下一步”按钮不可用，请检查标题、正文和封面设置");
+  }
+
+  await reviewPreparedDraft(page, entry, options);
+  const initialUrl = page.url();
+  progress("正在进入发布确认页");
+  await nextButton.click();
+  let submitButton = null;
+  let securityDetected = false;
+  const confirmationDeadline = Date.now() + 10000;
+  do {
+    if (await weiboSecurityChallengeVisible(page)) {
+      securityDetected = true;
+      break;
+    }
+    submitButton = await firstVisibleButton(page, spec.submit);
+    if (submitButton) break;
+    await page.waitForTimeout(250);
+  } while (Date.now() < confirmationDeadline);
+  if (securityDetected) {
+    await waitForWeiboSecurityVerification(page, progress);
+    submitButton = await waitForVisibleButton(page, spec.submit, 3000);
+    if (!submitButton) {
+      const resumedNext = await waitForVisibleButton(page, spec.next, 8000);
+      if (!resumedNext) {
+        throw new Error("微博身份验证完成后未返回文章发布页面");
+      }
+      progress("身份验证完成，正在重新进入发布确认页");
+      await resumedNext.click();
+      await page.waitForTimeout(1000);
+      await waitForWeiboSecurityVerification(page, progress);
+      submitButton = await waitForVisibleButton(page, spec.submit, 5000);
+    }
+  }
+  if (submitButton) {
+    if (typeof submitButton.isDisabled === "function" && (await submitButton.isDisabled().catch(() => false))) {
+      throw new Error("微博文章最终发布按钮不可用，请检查发布设置");
+    }
+    const mutationPromise =
+      typeof page.waitForResponse === "function"
+        ? page.waitForResponse(weiboMutationResponse, { timeout: 30000 }).catch(() => null)
+        : Promise.resolve(null);
+    progress("正在提交微博头条文章");
+    await submitButton.click();
+    progress("已提交，正在等待微博成功回执");
+    const confirmation = await waitForWeiboSubmission(page, initialUrl, mutationPromise, options);
+    progress("已收到微博发布成功回执");
+    if (options.keepOpen) {
+      await promptUser("微博头条文章已收到发布成功回执，浏览器保持打开供检查");
+    }
+    return { url: page.url(), status: "published", type: "article", ...richContent, ...cover, ...confirmation };
+  }
+  throw new Error("微博发布确认页中未找到最终发布按钮");
+}
+
+async function launchBrowserContext(entry, browserChannel) {
+  const { chromium } = await import("playwright-core");
+  const profileDir = path.join(os.homedir(), ".qcplay", "browser-profiles", safeProfileName(entry));
+  await fs.promises.mkdir(profileDir, { recursive: true, mode: 0o700 });
+  const channel = browserChannel || process.env.QCPLAY_BROWSER_CHANNEL || (process.platform === "win32" ? "msedge" : "chrome");
+  return chromium.launchPersistentContext(profileDir, {
+    channel,
+    headless: false,
+    slowMo: 50,
+    viewport: null
+  });
+}
+
+function haoyouMutationResponse(response) {
+  const request = response.request();
+  if (!/^POST$/i.test(request.method())) {
+    return false;
+  }
+  try {
+    const url = new URL(response.url());
+    return (
+      /(?:^|\.)bbs\.3839\.com$/i.test(url.hostname) &&
+      url.searchParams.get("m") === "api" &&
+      url.searchParams.get("c") === "thread" &&
+      url.searchParams.get("a") === "setThread"
+    );
+  } catch {
+    return false;
+  }
+}
+
+async function waitForHaoyouSubmission(page, initialUrl, mutationPromise, options) {
+  if (options.skipSubmissionVerification) {
+    return { confirmation: "test" };
+  }
+  const outcomes = [];
+  if (typeof page.waitForURL === "function") {
+    outcomes.push(
+      page
+        .waitForURL(
+          url => {
+            const current = url.toString();
+            return current !== initialUrl && /(?:forum|thread)-\d+\.htm(?:[?#]|$)/i.test(current);
+          },
+          { timeout: 15000 }
+        )
+        .then(() => ({ confirmation: "navigation" }))
+        .catch(() => null)
+    );
+  }
+  outcomes.push(
+    waitForVisibleTextAcrossFrames(page, /发布成功|发帖成功|提交成功/i, 15000, false).then(locator =>
+      locator ? { confirmation: "message" } : null
+    )
+  );
+  outcomes.push(
+    mutationPromise.then(async response => {
+      if (!response) {
+        return null;
+      }
+      const payload = await response.json().catch(() => null);
+      const message = normalizeText(payload?.msg || payload?.message);
+      if (response.status() < 200 || response.status() >= 300) {
+        return { error: message || `接口返回 HTTP ${response.status()}` };
+      }
+      if (!payload || Number(payload.code) !== 100) {
+        return { error: message || `接口返回 code ${payload?.code ?? "未知"}` };
+      }
+      return { confirmation: "response", responseUrl: response.url() };
+    })
+  );
+  outcomes.push(page.waitForTimeout(15500).then(() => null));
+
+  const pending = new Set(outcomes);
+  while (pending.size > 0) {
+    const tagged = [...pending].map(promise => promise.then(value => ({ promise, value })));
+    const { promise, value } = await Promise.race(tagged);
+    pending.delete(promise);
+    if (value?.error) {
+      throw new Error(`好游快爆发布失败: ${value.error}`);
+    }
+    if (value) {
+      return value;
+    }
+  }
+  throw new Error("好游快爆提交后未检测到成功回执，不能判定为发布成功");
+}
+
+export async function publishWithBrowser(entry, article, options = {}) {
+  const spec = BROWSER_PLATFORM_SPECS[entry.platformKey];
+  if (!spec) {
+    throw new Error(`${entry.platform} 尚无可用的 API 或浏览器适配器`);
+  }
+  if (!entry.url) {
+    throw new Error(`${entry.platform} 配置缺少发布页面 URL`);
+  }
+
+  const body =
+    entry.platformKey === "haoyou"
+      ? buildHaoyouRichContent(article).plainText || plainTextForPlatform(article, entry.platformKey)
+      : plainTextForPlatform(article, entry.platformKey);
+  if (entry.platformKey === "x" && body.length > 280) {
+    throw new Error(`X 内容共 ${body.length} 个字符，超过 280 字符限制`);
+  }
+  if (entry.platformKey === "haoyou" && Array.from(article.title).length > 48) {
+    throw new Error(`好游快爆标题最多 48 个字符，当前为 ${Array.from(article.title).length} 个字符`);
+  }
+
+  const ownsContext = !options.context;
+  const context = options.context || (await launchBrowserContext(entry, options.browserChannel));
+  const pages = context.pages();
+  const page = pages[0] || (await context.newPage());
+  const promptUser = options.waitForUser || (message => waitForUser(message, options.streams));
+  let haoyouEditorOpened = false;
+  try {
+    if (entry.platformKey === "taptap") {
+      return await publishTapTap(page, entry, article, spec, options, promptUser);
+    }
+    if (entry.platformKey === "bilibili") {
+      return await publishBilibili(page, entry, article, spec, options, promptUser);
+    }
+    if (entry.platformKey === "weibo") {
+      return await publishWeibo(page, entry, article, spec, options, promptUser);
+    }
+    const editorUrl = entry.platformKey === "haoyou" ? haoyouEditorUrl(entry.url) : entry.url;
+    let editorReady = false;
+    let loginHandled = false;
+    const attempts = entry.platformKey === "haoyou" ? 3 : 2;
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+      await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+      await afterNavigation(page);
+      const readyTimeout = attempt === 0 && spec.loginPage ? 3000 : 15000;
+      if (await waitForEditorReady(page, () => editorIsReady(page, spec), readyTimeout)) {
+        editorReady = true;
+        break;
+      }
+      if (!loginHandled) {
+        await ensureBrowserLogin(page, entry, spec, promptUser);
+        loginHandled = true;
+      } else {
+        await page.waitForTimeout(500);
+      }
+    }
+    if (!editorReady) {
+      const targetHint = entry.platformKey === "haoyou" ? `（目标地址: ${editorUrl}）` : "";
+      throw new Error(`${entry.platform} 登录完成后仍未进入发布编辑器${targetHint}，请确认账号拥有发布权限`);
+    }
+    haoyouEditorOpened = entry.platformKey === "haoyou";
+
+    const titleInput = await waitForVisible(page, spec.title, 5000);
+    if (spec.title && !titleInput) {
+      throw new Error(`${entry.platform} 页面中未找到标题输入框，页面结构可能已更新`);
+    }
+    if (titleInput) {
+      if (entry.platformKey === "haoyou") {
+        await fillStableHaoyouValue(page, titleInput, article.title, "标题");
+      } else {
+        await fillLocator(titleInput, article.title);
+      }
+    }
+
+    const bodyInput = await waitForVisible(page, spec.body, 5000);
+    if (!bodyInput) {
+      throw new Error(`${entry.platform} 页面中未找到正文编辑器，页面结构可能已更新`);
+    }
+    let richContent = null;
+    if (entry.platformKey === "haoyou") {
+      richContent = await insertHaoyouRichContent(page, bodyInput, article, body);
+    } else {
+      await fillLocator(bodyInput, body);
+    }
+
+    let submitButton = await waitForVisible(page, spec.submitSelectors, 5000);
+    submitButton ||= await waitForVisibleButton(page, spec.submit, 5000);
+    if (!submitButton) {
+      if (entry.platformKey === "haoyou" && (await firstVisible(page, [".editSubmit"]))) {
+        throw new Error("好游快爆标题和正文已写入，但发布按钮仍不可用，请检查发布设置");
+      }
+      await promptUser(`${entry.platform} 页面中未找到发布按钮，正文已填入，请检查并手动发布`);
+      return { url: page.url(), manualSubmit: true };
+    }
+    await reviewPreparedDraft(page, entry, options);
+    if (entry.platformKey === "haoyou") {
+      const initialUrl = page.url();
+      const mutationPromise =
+        typeof page.waitForResponse === "function"
+          ? page.waitForResponse(haoyouMutationResponse, { timeout: 15000 }).catch(() => null)
+          : Promise.resolve(null);
+      await submitButton.click();
+      const receipt = await waitForHaoyouSubmission(page, initialUrl, mutationPromise, options);
+      if (options.keepOpen) {
+        await promptUser(`${entry.platform} 已确认发布成功，浏览器保持打开供检查`);
+      }
+      return { url: page.url(), status: "published", ...richContent, ...receipt };
+    }
+    await submitButton.click();
+    await page.waitForTimeout(3000);
+    if (options.keepOpen) {
+      await promptUser(`${entry.platform} 已提交，浏览器保持打开供检查`);
+    }
+    return { url: page.url() };
+  } catch (error) {
+    if (entry.platformKey === "haoyou" && ownsContext && haoyouEditorOpened) {
+      await promptUser(`${error.message}，浏览器将保持打开供检查`).catch(() => {});
+    }
+    throw error;
+  } finally {
+    await context.close().catch(() => {});
+  }
+}
+
+export async function publishPlatformEntry(entry, article, options = {}) {
+  if (entry.publisher === "discord-webhook") {
+    return publishDiscord(entry, article, options);
+  }
+  if (entry.publisher === "browser") {
+    return publishWithBrowser(entry, article, options);
+  }
+  if (entry.publisher === "blocked") {
+    throw new Error("Reddit 配置明确提示非官方工具可能导致封号；未配置 Reddit 官方应用，因此拒绝自动发布");
+  }
+  if (entry.publisher === "unavailable") {
+    throw new Error(`${entry.platform} 缺少可用 API、发布地址或适配器`);
+  }
+  throw new Error(`${entry.platform} 需要由官网发布流程处理`);
+}
+
+export async function runPlatformPublishSequence(entries, publishOne) {
+  const successes = [];
+  const failures = [];
+  let skipped = [];
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    try {
+      const result = await publishOne(entry);
+      successes.push({ entry, result });
+    } catch (error) {
+      failures.push({ entry, error });
+      if (entry.publisher === "browser") {
+        skipped = entries.slice(index + 1);
+        break;
+      }
+    }
+  }
+  return { successes, failures, skipped };
+}