@qcplay/cli 1.0.19 → 1.0.21

package/bin/qcplay.js

@@ -39,6 +39,7 @@ import {
 import {
   availableProjects,
   bilibiliPublishingPlan,
+  editPreparedPlatformPage,
   entriesForProject,
   loadPlatformEntries,
   openPublishPage,
@@ -49,6 +50,9 @@ import {
   runPlatformPublishSequence,
   selectRequestedEntries,
   tapTapPublishingPlan,
+  deleteDiscordMessages,
+  findDiscordMessageRecord,
+  removeDiscordMessageRecord,
   weiboPublishingPlan,
   writePlatformPublishUrls
 } from "../lib/platform-publish.js";
@@ -184,6 +188,7 @@ const ARTICLE_STATE_FILE = path.join(QCPLAY_DIR, "article-state.json");
 const CONTENT_RULES_FILE = DEFAULT_CONTENT_RULES_FILE;
 const ARTICLE_PREVIEW_BASE_URL = "https://snail.qingcigame.com/official/news-details.html";
 const SKILLS_DIR = path.join(AGENTS_DIR, "skills");
+const LARK_SKILL_NAMES = ["lark-shared", "lark-sheets", "lark-doc", "lark-wiki"];
 const WEST_ARTICLE_LANGUAGES = new Set(["portuguese", "german", "spanish", "italian", "french", "america_en"]);
 const ARTICLE_PREVIEW_URLS = {
   "33": "https://tideng.qingcigame.com/official/news.html",
@@ -247,6 +252,8 @@ Usage:
   qcplay-cli wechat article --game-id <id> [--game-id <id> ...] (--month <YYYY-MM> | --begin-date <YYYY-MM-DD> --end-date <YYYY-MM-DD>) [--output <file>] [--format markdown|json] [--local] [--backend <url>]
   qcplay-cli publish [file] [--title <标题>] [--cover <图片>] [--weibo-column <专栏>] [--project <项目>] [--region <区域>] [--platform <平台>]
   qcplay-cli publish --project <项目> --list-platforms
+  qcplay-cli edit-page --project <项目> --region <区域> --platform <平台> --target <title|body> --find <原文> --replace <新文>
+  qcplay-cli discord delete <文章文件> --project <项目> --region <区域>
   qcplay-cli rules [init|validate|list] [--rules-file <json>]
   qcplay-cli www-article-list.store <file> [--title <标题>] [--cover <图片>] [--project <项目>] [--region <区域>] [--rules-file <json>] [--dry-run]
   qcplay-cli www-article-list.update [id] [--local] [--backend <url>] [--dry-run]
@@ -268,6 +275,14 @@ function printUpdateHelp() {
   console.log("  qcplay-cli update");
 }
 
+function printEditPageHelp() {
+  console.log(`Usage:
+  qcplay-cli edit-page --project <项目> --region <区域> --platform <平台> --target <title|body> --find <原文> --replace <新文>
+
+Edits one exact text occurrence in a platform editor page that is already prepared and still open.
+This command never saves a draft or publishes.`);
+}
+
 function printAuthHelp() {
   console.log("Usage:");
   console.log("  qcplay-cli auth [login|status|logout] [--local] [--backend <url>] [--auth-page <url>]");
@@ -743,6 +758,25 @@ async function installSkills() {
   };
 }
 
+async function detectLarkSkills() {
+  const installed = [];
+  const missing = [];
+  for (const name of LARK_SKILL_NAMES) {
+    const skillFile = path.join(SKILLS_DIR, name, "SKILL.md");
+    (await pathExists(skillFile) ? installed : missing).push(name);
+  }
+  return { installed, missing };
+}
+
+function printLarkSkillStatus(status) {
+  if (status.missing.length === 0) {
+    console.log(chalk.green("Feishu Skills detected: lark-shared, lark-sheets, lark-doc, lark-wiki"));
+    return;
+  }
+  console.log(chalk.yellow(`Feishu Skills incomplete; missing: ${status.missing.join(", ")}`));
+  console.log(chalk.gray("Install command: npx skills add larksuite/cli -g -y"));
+}
+
 async function saveConfig(authBackendUrl, publishBackendUrl, authPageUrl, localMode = false) {
   await writeJson(CONFIG_FILE, {
     cli: "qcplay-cli",
@@ -1079,6 +1113,139 @@ function parseDistributionOptions(args) {
   return { file: positional[0], options };
 }
 
+function parseEditPageOptions(args) {
+  const options = {
+    project: "",
+    region: "",
+    platform: "",
+    target: "body",
+    find: "",
+    replacement: "",
+    configFile: "",
+    browserChannel: ""
+  };
+  const valueFlags = new Map([
+    ["--project", "project"],
+    ["--region", "region"],
+    ["--platform", "platform"],
+    ["--target", "target"],
+    ["--find", "find"],
+    ["--replace", "replacement"],
+    ["--config-file", "configFile"],
+    ["--browser-channel", "browserChannel"]
+  ]);
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    const key = valueFlags.get(current);
+    if (!key) throw new Error(`未知参数: ${current}`);
+    const value = args[index + 1];
+    if (!value || value.startsWith("--")) throw new Error(`${current} 缺少参数值`);
+    options[key] = value;
+    index += 1;
+  }
+  for (const key of ["project", "region", "platform", "find", "replacement"]) {
+    if (!String(options[key]).trim()) throw new Error(`edit-page 缺少 --${key === "replacement" ? "replace" : key}`);
+  }
+  if (!new Set(["title", "body"]).has(String(options.target).trim().toLowerCase())) {
+    throw new Error("--target 只能是 title 或 body");
+  }
+  return options;
+}
+
+/*
+function parseDiscordDeleteOptions(args) {
+  const positional = [];
+  const options = { project: "", region: "", platform: "Discord" };
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    if (current === "--project" || current === "--region" || current === "--platform") {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) throw new Error(`${current} 缂哄皯鍙傛暟鍊糮);
+      options[current.slice(2)] = next;
+      index += 1;
+      continue;
+    }
+    if (current.startsWith("--")) throw new Error(`鏈煡鍙傛暟: ${current}`);
+    positional.push(current);
+  }
+  if (positional.length !== 1) throw new Error("discord delete 闇€瑕佹寚瀹氫竴涓枃绔犳枃浠?");
+  if (!options.project || !options.region) throw new Error("discord delete 闇€瑕佹寚瀹氭爣椤圭洰鍜屽尯鍩?");
+  return { file: positional[0], options };
+}
+
+async function deleteDiscordCommand(file, options) {
+  const parsedArticle = await parseArticleFile(file);
+  const allEntries = await loadPlatformEntries({});
+  const candidates = entriesForProject(allEntries, options.project, options.region);
+  const selectedEntries = selectRequestedEntries(candidates, [options.platform]);
+  const entry = selectedEntries.find(candidate => candidate.platformKey === "discord");
+  if (!entry || entry.publisher !== "discord-webhook") {
+    throw new Error(`${options.project} / ${options.region} 娌℃湁鍙敤鐨?Discord Webhook 閰嶇疆`);
+  }
+  const article = {
+    title: parsedArticle.payload.article_title,
+    markdown: parsedArticle.markdown,
+    html: parsedArticle.payload.article_content,
+    payload: parsedArticle.payload,
+    meta: parsedArticle.meta
+  };
+  const record = await findDiscordMessageRecord(article, entry);
+  if (!record) {
+    throw new Error("娌℃湁鎵惧埌杩欑瘒鏂囩珷鐨?Discord 鍙戝竷璁板綍锛涚幇鏈夊彂甯冩棤娉曠敤 CLI 鑷姩瀹氫綅");
+  }
+  const result = await deleteDiscordMessages(entry, record.messageIds);
+  await removeDiscordMessageRecord(article, entry);
+  console.log(chalk.green(`Discord 消息已删除: ${result.deleted} 条`));
+}
+
+}
+*/
+
+function parseDiscordDeleteOptions(args) {
+  const positional = [];
+  const options = { project: "", region: "", platform: "Discord" };
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    if (current === "--project" || current === "--region" || current === "--platform") {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) throw new Error(`${current} requires a value`);
+      options[current.slice(2)] = next;
+      index += 1;
+      continue;
+    }
+    if (current.startsWith("--")) throw new Error(`Unknown option: ${current}`);
+    positional.push(current);
+  }
+  if (positional.length !== 1) throw new Error("discord delete requires exactly one article file");
+  if (!options.project || !options.region) throw new Error("discord delete requires --project and --region");
+  return { file: positional[0], options };
+}
+
+async function deleteDiscordCommand(file, options) {
+  const parsedArticle = await parseArticleFile(file);
+  const allEntries = await loadPlatformEntries({});
+  const candidates = entriesForProject(allEntries, options.project, options.region);
+  const selectedEntries = selectRequestedEntries(candidates, [options.platform]);
+  const entry = selectedEntries.find(candidate => candidate.platformKey === "discord");
+  if (!entry || entry.publisher !== "discord-webhook") {
+    throw new Error(`${options.project} / ${options.region} has no usable Discord Webhook configuration`);
+  }
+  const article = {
+    title: parsedArticle.payload.article_title,
+    markdown: parsedArticle.markdown,
+    html: parsedArticle.payload.article_content,
+    payload: parsedArticle.payload,
+    meta: parsedArticle.meta
+  };
+  const record = await findDiscordMessageRecord(article, entry);
+  if (!record) {
+    throw new Error("No Discord publish record found for this article; older messages cannot be located automatically");
+  }
+  const result = await deleteDiscordMessages(entry, record.messageIds);
+  await removeDiscordMessageRecord(article, entry);
+  console.log(chalk.green(`Discord messages deleted: ${result.deleted}`));
+}
+
 function applyPublishOverrides(parsedArticle, options) {
   const title = normalizeText(options.title);
   const cover = normalizeText(options.cover);
@@ -1206,6 +1373,10 @@ function getNpmCommand() {
   return process.platform === "win32" ? "npm.cmd" : "npm";
 }
 
+function getNpxCommand() {
+  return process.platform === "win32" ? "npx.cmd" : "npx";
+}
+
 function runCommand(command, args) {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, {
@@ -1224,6 +1395,11 @@ function runCommand(command, args) {
   });
 }
 
+async function installLarkCli() {
+  console.log(chalk.cyan("Installing/updating Feishu CLI and skills..."));
+  await runCommand(getNpxCommand(), ["@larksuite/cli@latest", "install"]);
+}
+
 function delay(ms) {
   return new Promise(resolve => {
     setTimeout(resolve, ms);
@@ -1676,6 +1852,7 @@ async function installCommand(options) {
   console.log(`内容规则: ${chalk.gray(CONTENT_RULES_FILE)}`);
 
   const skillsInstalled = await installSkills();
+  await installLarkCli();
   if (skillsInstalled.available) {
     console.log(chalk.green("✔ Skills 已安装"));
     console.log(`Skills 目录: ${chalk.gray(SKILLS_DIR)}`);
@@ -1683,6 +1860,7 @@ async function installCommand(options) {
     console.log(chalk.yellow("! 未找到 Skills 模板，已跳过"));
   }
 
+  printLarkSkillStatus(await detectLarkSkills());
   await saveConfig(authBackendUrl, publishBackendUrl, authPageUrl, localMode);
   console.log(chalk.green("✔ 配置文件已生成"));
   console.log(chalk.gray(`认证后端: ${authBackendUrl}`));
@@ -1732,6 +1910,7 @@ async function updateCommand() {
   const latestPackage = readPackageMetadata();
   await updateStoredConfigVersion(latestPackage.version);
   const skillsInstalled = await installSkills();
+  await installLarkCli();
 
   console.log("");
   console.log(chalk.green("CLI 更新完成"));
@@ -1741,6 +1920,7 @@ async function updateCommand() {
     console.log(chalk.gray(`版本: ${latestPackage.version}`));
   }
   printSkillsSyncResult(skillsInstalled);
+  printLarkSkillStatus(await detectLarkSkills());
   console.log(chalk.green(rulesCreated ? "✔ 用户内容规则已创建" : "✔ 用户内容规则未覆盖"));
   console.log(`内容规则: ${chalk.gray(CONTENT_RULES_FILE)}`);
   console.log("");
@@ -2253,7 +2433,10 @@ async function parseArticleFile(file) {
   }
 
   const raw = await fs.promises.readFile(articleFile, "utf8");
-  if (path.extname(articleFile).toLowerCase() === ".html") {
+  const looksLikeQcplayHtml =
+    /^(?:\uFEFF)?\s*(?:<!doctype\s+html\b|<html\b)/i.test(raw) &&
+    /(?:id=["']qcplay-article-meta["']|data-qcplay-article-content=["']1["'])/i.test(raw);
+  if (path.extname(articleFile).toLowerCase() === ".html" || looksLikeQcplayHtml) {
     const { meta, richHtml } = parseRichArticleUploadFile(raw);
     return {
       articleFile,
@@ -2525,9 +2708,12 @@ async function publishPlatformsCommand(file, options) {
     parsedArticle = await parseArticleFile(file);
     parsedArticle = applyPublishOverrides(parsedArticle, options);
   }
-  const allEntries = await loadPlatformEntries({ configFile: options.configFile });
-
   const project = inferDistributionProject(parsedArticle?.payload, options.project, parsedArticle?.meta);
+  const allEntries = await loadPlatformEntries({
+    configFile: options.configFile,
+    project,
+    region: options.region
+  });
   if (!project) {
     if (options.listPlatforms) {
       printPlatformEntries(allEntries);
@@ -2753,6 +2939,29 @@ async function publishPlatformsCommand(file, options) {
   }
 }
 
+async function editPreparedPageCommand(options) {
+  const allEntries = await loadPlatformEntries({ configFile: options.configFile });
+  const candidates = entriesForProject(allEntries, options.project, options.region);
+  const selected = selectRequestedEntries(candidates, [options.platform]);
+  if (selected.length !== 1 || selected[0].publisher !== "browser") {
+    throw new Error(`${options.platform} 没有可编辑的浏览器发布页面配置`);
+  }
+  const entry = selected[0];
+  const result = await editPreparedPlatformPage(
+    entry,
+    { target: options.target, find: options.find, replacement: options.replacement },
+    { browserChannel: options.browserChannel, onProgress: message => console.log(chalk.gray(`  ${message}`)) }
+  );
+  console.log(
+    JSON.stringify({
+      event: "qcplay.page-edit-complete",
+      platform: entry.platform,
+      target: result.target,
+      url: result.url
+    })
+  );
+}
+
 async function publishArticleCommand(file, options, platformEntry = null, expectedTarget = "") {
   if (!file) {
     throw new Error("缺少文章文件，例如：qcplay-cli www-article-list.store article.md");
@@ -2959,6 +3168,32 @@ async function main() {
     return;
   }
 
+  if (command === "edit-page") {
+    if (subcommand === "-h" || subcommand === "--help") {
+      printEditPageHelp();
+      return;
+    }
+    const options = parseEditPageOptions([subcommand, ...rest].filter(Boolean));
+    await runWithErrorBanner("编辑已准备页面失败", () => editPreparedPageCommand(options));
+    return;
+  }
+
+  if (command === "discord") {
+    if (subcommand === "-h" || subcommand === "--help") {
+      console.log("Usage:\n  qcplay-cli discord delete <文章文件> --project <项目> --region <区域>");
+      return;
+    }
+    if (subcommand !== "delete") {
+      await runWithErrorBanner("Discord 操作失败", async () => {
+        throw new Error(`未知 discord 命令: ${subcommand || ""}`);
+      });
+      return;
+    }
+    const parsed = parseDiscordDeleteOptions(rest);
+    await runWithErrorBanner("Discord 删除失败", () => deleteDiscordCommand(parsed.file, parsed.options));
+    return;
+  }
+
   if (command === "rules") {
     if (!subcommand || subcommand === "-h" || subcommand === "--help") {
       printRulesHelp();

package/lib/platform-publish.js

@@ -12,7 +12,60 @@ import { applyContentRules } from "./content-rules.js";
 import { stripWechatGuidanceHtml } from "./wechat-article.js";
 
 const PLATFORM_CONFIG_URL = "https://t4blw8ys5w.feishu.cn/wiki/OqH7wkx9PiBaTYkKeWNc35SonGf";
+const DOMESTIC_REGION = "国内";
+const DOMESTIC_PLATFORM_ROWS = [
+  {
+    项目: "最强蜗牛",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=187376&group_id=227162&show_activity=1"
+  },
+  {
+    项目: "提灯与地下城",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=149961&group_id=177149&show_activity=1"
+  },
+  {
+    项目: "阿瑞斯病毒2",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=topic&app_id=387841&group_id=663910&show_activity=1"
+  },
+  {
+    项目: "迷途之光",
+    区域: DOMESTIC_REGION,
+    平台: "TapTap",
+    页面URL链接: "https://www.taptap.cn/creator/edit?type=moment&app_id=600170&show_activity=1"
+  },
+  {
+    项目: "最强蜗牛",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=12201&type=1"
+  },
+  {
+    项目: "新仙剑",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=24008&type=1"
+  },
+  {
+    项目: "阿瑞斯病毒2",
+    区域: DOMESTIC_REGION,
+    平台: "好游快爆",
+    页面URL链接: "https://bbs.3839.com/index.php?m=api&c=thread&a=sendThreadShow&fid=20313&type=1"
+  }
+];
+const DOMESTIC_STANDARD_PLATFORM_ROWS = ["最强蜗牛", "提灯与地下城", "阿瑞斯病毒2", "新仙剑", "迷途之光", "魔卡少女樱"].flatMap(
+  项目 => [
+    { 项目, 区域: DOMESTIC_REGION, 平台: "B站", 页面URL链接: "https://member.bilibili.com/platform/upload/text/new-edit" },
+    { 项目, 区域: DOMESTIC_REGION, 平台: "微博", 页面URL链接: "https://card.weibo.com/article/v5/editor" },
+    { 项目, 区域: DOMESTIC_REGION, 平台: "小红书", 页面URL链接: "https://creator.xiaohongshu.com/publish/publish?from=menu&target=image" }
+  ]
+);
 const DISCORD_MESSAGE_LIMIT = 2000;
+const DISCORD_MESSAGE_STATE_FILE = path.join(os.homedir(), ".qcplay", "discord-messages.json");
 const BROWSER_SUBMISSION_COOLDOWN_MS = 60_000;
 const BROWSER_SUBMISSION_STATE_FILE = path.join(os.homedir(), ".qcplay", "browser-submissions.json");
 const ARES_PROJECT = "阿瑞斯病毒2";
@@ -458,6 +511,10 @@ function runJson(command, args) {
   });
 }
 
+function domesticPlatformRows() {
+  return normalizePlatformRows([...DOMESTIC_PLATFORM_ROWS, ...DOMESTIC_STANDARD_PLATFORM_ROWS]);
+}
+
 export async function loadPlatformEntries(options = {}) {
   if (options.configFile) {
     const configFile = path.resolve(process.cwd(), options.configFile);
@@ -472,6 +529,13 @@ export async function loadPlatformEntries(options = {}) {
     return normalizePlatformRows(rows);
   }
 
+  const domesticEntries = domesticPlatformRows();
+  const requestedRegion = normalizeKey(options.region || "");
+  const requestedProject = normalizeProjectKey(options.project || "");
+  if ((!requestedRegion || requestedRegion === normalizeKey(DOMESTIC_REGION)) && (!requestedProject || entriesForProject(domesticEntries, options.project).length > 0)) {
+    return domesticEntries;
+  }
+
   const workbook = await runJson("lark-cli", [
     "sheets",
     "+workbook-info",
@@ -663,7 +727,11 @@ function postJson(urlValue, payload) {
             reject(new Error(`Discord webhook 返回 ${response.statusCode}: ${responseBody.slice(0, 160)}`));
             return;
           }
-          resolve();
+          try {
+            resolve(responseBody ? JSON.parse(responseBody) : {});
+          } catch {
+            resolve({});
+          }
         });
       }
     );
@@ -672,6 +740,110 @@ function postJson(urlValue, payload) {
   });
 }
 
+function deleteJson(urlValue) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(urlValue);
+    const request = https.request(
+      url,
+      {
+        method: "DELETE",
+        headers: {
+          Accept: "application/json",
+          "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();
+  });
+}
+
+function discordMessageStateKey(entry, article) {
+  const sourceUrl = normalizeText(article.meta?.source_url || article.payload?.source_url);
+  return [entry.project, entry.region, entry.platformKey || "discord", sourceUrl || article.title].map(normalizeText).join("\u0000");
+}
+
+async function readDiscordMessageState() {
+  try {
+    const value = JSON.parse(await fs.promises.readFile(DISCORD_MESSAGE_STATE_FILE, "utf8"));
+    return Array.isArray(value?.records) ? value.records : [];
+  } catch {
+    return [];
+  }
+}
+
+async function writeDiscordMessageState(records) {
+  await fs.promises.mkdir(path.dirname(DISCORD_MESSAGE_STATE_FILE), { recursive: true, mode: 0o700 });
+  await fs.promises.writeFile(
+    DISCORD_MESSAGE_STATE_FILE,
+    `${JSON.stringify({ version: 1, records }, null, 2)}\n`,
+    { encoding: "utf8", mode: 0o600 }
+  );
+  await fs.promises.chmod(DISCORD_MESSAGE_STATE_FILE, 0o600).catch(() => {});
+}
+
+async function recordDiscordMessages(entry, article, messageIds) {
+  if (!messageIds.length) return;
+  const record = {
+    key: discordMessageStateKey(entry, article),
+    project: normalizeText(entry.project),
+    region: normalizeText(entry.region),
+    platform: normalizeText(entry.platform),
+    platformKey: entry.platformKey || "discord",
+    title: normalizeText(article.title),
+    sourceUrl: normalizeText(article.meta?.source_url || article.payload?.source_url),
+    messageIds,
+    createdAt: new Date().toISOString()
+  };
+  const records = (await readDiscordMessageState()).filter(item => item?.key !== record.key);
+  records.unshift(record);
+  await writeDiscordMessageState(records.slice(0, 100));
+}
+
+export async function deleteDiscordMessages(entry, messageIds, options = {}) {
+  const webhook = discordWebhookFromEntry(entry);
+  if (!webhook) {
+    throw new Error("Discord 配置缺少 webhook，无法删除消息");
+  }
+  const ids = [...new Set(messageIds.map(value => normalizeText(value)).filter(Boolean))];
+  if (!ids.length) {
+    throw new Error("没有可删除的 Discord 消息 ID");
+  }
+  const remove = options.deleteJson || (messageId => {
+    const url = new URL(webhook);
+    url.pathname = `${url.pathname.replace(/\/+$/, "")}/messages/${encodeURIComponent(messageId)}`;
+    return deleteJson(url.toString());
+  });
+  for (const messageId of ids) {
+    await remove(messageId);
+  }
+  return { deleted: ids.length };
+}
+
+export async function findDiscordMessageRecord(article, entry) {
+  const key = discordMessageStateKey(entry, article);
+  const records = await readDiscordMessageState();
+  return records.find(item => item?.key === key) || null;
+}
+
+export async function removeDiscordMessageRecord(article, entry) {
+  const key = discordMessageStateKey(entry, article);
+  const records = (await readDiscordMessageState()).filter(item => item?.key !== key);
+  await writeDiscordMessageState(records);
+}
+
 export async function publishDiscord(entry, article, options = {}) {
   const webhook = discordWebhookFromEntry(entry);
   if (!webhook) {
@@ -683,21 +855,56 @@ export async function publishDiscord(entry, article, options = {}) {
     : preparedArticle.markdown;
   const chunks = splitDiscordContent(preparedArticle.title, markdown);
   const send = options.postJson || postJson;
+  const messageIds = [];
   for (const chunk of chunks) {
-    await send(webhook, { content: chunk, allowed_mentions: { parse: [] } });
+    const response = await send(`${webhook}${webhook.includes("?") ? "&" : "?"}wait=true`, {
+      content: chunk,
+      allowed_mentions: { parse: [] }
+    });
+    const messageId = normalizeText(response?.id);
+    if (messageId) messageIds.push(messageId);
+  }
+  let messageRecordSaved = false;
+  if (messageIds.length === chunks.length) {
+    try {
+      await recordDiscordMessages(entry, preparedArticle, messageIds);
+      messageRecordSaved = true;
+    } catch {
+      // A successful Discord post must not be reported as failed when local
+      // bookkeeping is unavailable; deletion can still be done manually.
+    }
   }
-  return { messages: chunks.length };
+  return { messages: chunks.length, messageIds, messageRecordSaved };
 }
 
 function plainTextForPlatform(article, platformKey) {
   const $ = cheerio.load(stripWechatPlatformGuidance(article), null, false);
+  // WeChat exports decorative empty spans containing <br> for layout. They
+  // must not become real line breaks in native editors; preserve only breaks
+  // that sit inside a node with actual text or media content.
+  $("br").each((_, element) => {
+    const parent = $(element).parent();
+    const hasMeaningfulSibling = parent
+      .contents()
+      .toArray()
+      .some(node => {
+        if (node === element) return false;
+        if (node.type === "text") return normalizeText(node.data).trim().length > 0;
+        if (node.type !== "tag") return false;
+        return $(node).is("img") || normalizeText($(node).text()).trim().length > 0;
+      });
+    if (!hasMeaningfulSibling) {
+      $(element).remove();
+    }
+  });
   $("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 source = image.attr("src") || image.attr("data-qcplay-src") || image.attr("data-src") || image.attr("data-original");
+    image.replaceWith(source ? `\n${source}\n` : "");
   });
   const markdown = normalizeText($.root().text() || article.markdown)
     .replace(/[ \t]+\n/g, "\n")
@@ -1619,6 +1826,8 @@ export function resolveWeiboSuperTopic(article, entry = {}) {
 }
 
 export function resolveWeiboShareCopy(article, entry = {}) {
+  const configured = weiboMeta(article, "weibo_share_copy", "weibo_share_text");
+  if (configured) return configured;
   const title = resolveWeiboArticleTitle(article);
   const project = normalizeText(entry.project);
   if (project === "最强蜗牛") {
@@ -1913,8 +2122,13 @@ export function browserPlatformPageUrl(entry, type = "topic") {
 
 function imageSourcesFromArticle(article) {
   const $ = cheerio.load(stripWechatPlatformGuidance(article), null, false);
-  return $("img[src]")
-    .map((_, element) => normalizeText($(element).attr("src")))
+  return $("img")
+    .map((_, element) => {
+      const image = $(element);
+      return normalizeText(
+        image.attr("src") || image.attr("data-qcplay-src") || image.attr("data-src") || image.attr("data-original")
+      );
+    })
     .get()
     .filter(Boolean);
 }
@@ -2377,7 +2591,12 @@ function buildPlatformRichContent(article, options = {}) {
       });
     }
     for (const element of tableImages) {
-      const source = normalizeText($(element).attr("src") || $(element).attr("data-src"));
+      const source = normalizeText(
+        $(element).attr("src") ||
+          $(element).attr("data-qcplay-src") ||
+          $(element).attr("data-src") ||
+          $(element).attr("data-original")
+      );
       if (!source) continue;
       const caption = normalizeText($(element).closest("figure").find("figcaption").first().text()) ||
         normalizeText($(element).attr("alt") || $(element).attr("title")).slice(0, 50);
@@ -2407,7 +2626,12 @@ function buildPlatformRichContent(article, options = {}) {
     }
     if (tag === "img") {
       flushHtml();
-      const source = normalizeText(element.attr("src") || element.attr("data-src"));
+      const source = normalizeText(
+        element.attr("src") ||
+          element.attr("data-qcplay-src") ||
+          element.attr("data-src") ||
+          element.attr("data-original")
+      );
       if (source) {
         const caption = normalizeText(element.closest("figure").find("figcaption").first().text()) ||
           normalizeText(element.attr("alt") || element.attr("title")).slice(0, 50);
@@ -2599,11 +2823,74 @@ function normalizeNumberedSectionHeadings(items) {
 }
 
 export function buildBilibiliRichContent(article) {
-  return buildPlatformRichContent(article, {
+  const content = buildPlatformRichContent(article, {
     preserveBackground: true,
     preserveBlockStyles: true,
     structuredTables: true
   });
+  // Bilibili can drop the first paragraph's CSS alignment when it follows an
+  // inline image node. Keep an explicit align attribute on that first text
+  // block so the source formatting survives the editor's initial normalization.
+  const firstTextIndex = content.items.findIndex(item => item.type === "html" && item.plain);
+  if (firstTextIndex < 0) return content;
+  const firstText = content.items[firstTextIndex];
+  const alignment = normalizeText(firstText.align).toLowerCase();
+  if (!alignment) return content;
+  const $ = cheerio.load(firstText.html, null, false);
+  const root = $.root().children().first();
+  if (!root.length) return content;
+  root.attr("align", alignment);
+  return {
+    ...content,
+    items: content.items.map((item, index) => (index === firstTextIndex ? { ...item, html: $.html(root) } : item))
+  };
+}
+
+async function enforceBilibiliFirstTextAlignment(bodyInput, content) {
+  const firstText = content.items.find(item => item.type === "html" && item.plain);
+  const alignment = normalizeText(firstText?.align).toLowerCase();
+  const expectedText = normalizeText(firstText?.plain);
+  if (!alignment || !expectedText || typeof bodyInput.evaluate !== "function") return false;
+  return bodyInput
+    .evaluate(
+      (element, payload) => {
+        const normalize = value => String(value || "").replace(/\s+/g, " ").trim();
+        const blocks = [...element.querySelectorAll("p,h1,h2,h3,h4,h5,h6,div")].filter(block => {
+          const text = normalize(block.textContent);
+          return text === payload.text || text.includes(payload.text) || payload.text.includes(text);
+        });
+        // Prefer the smallest matching block. The outer editor container often
+        // contains the same text, but formatting it does not update the actual
+        // paragraph node stored by Bilibili's rich-text model.
+        blocks.sort((left, right) => normalize(left.textContent).length - normalize(right.textContent).length);
+        const target = blocks[0];
+        if (!target) return false;
+        const range = document.createRange();
+        range.selectNodeContents(target);
+        const selection = window.getSelection();
+        selection.removeAllRanges();
+        selection.addRange(range);
+        try {
+          document.execCommand("justifyCenter", false, null);
+        } catch {
+          // Some Chromium builds disable execCommand; the explicit style below
+          // still provides a deterministic fallback for the editor DOM.
+        }
+        target.style.textAlign = payload.alignment;
+        target.setAttribute("align", payload.alignment);
+        target.setAttribute("data-align", payload.alignment);
+        target.dispatchEvent(
+          new InputEvent("input", {
+            bubbles: true,
+            inputType: "formatBlock",
+            data: null
+          })
+        );
+        return getComputedStyle(target).textAlign === payload.alignment;
+      },
+      { text: expectedText, alignment }
+    )
+    .catch(() => false);
 }
 
 export function buildHaoyouRichContent(article) {
@@ -3135,7 +3422,7 @@ async function removeBilibiliFailedImage(bodyInput) {
   });
 }
 
-async function waitForBilibiliInlineImage(page, bodyInput, previousCount, source, options = {}) {
+export async function waitForBilibiliInlineImage(page, bodyInput, previousCount, source, options = {}) {
   const deadline = Date.now() + 120000;
   const startedAt = Date.now();
   let stableChecks = 0;
@@ -3144,7 +3431,6 @@ async function waitForBilibiliInlineImage(page, bodyInput, previousCount, source
     const failed = await bodyInput
       .locator('.upload-fail, .image-upload-error, [class*="upload-error"], [class*="retry"]')
       .count();
-    const pending = await pendingUploadCount(bodyInput);
     if (failed > 0) {
       const failureText = await bodyInput.evaluate(element => {
         const nodes = [...element.querySelectorAll(
@@ -3162,7 +3448,10 @@ async function waitForBilibiliInlineImage(page, bodyInput, previousCount, source
       }
       throw new Error(`B站正文图片上传失败: ${source}`);
     }
-    if (count > previousCount && pending === 0 && Date.now() - startedAt >= 1200) {
+    // The B站 editor may keep a visible toolbar spinner after the image node
+    // is inserted. Treat the new, stable image node as the upload receipt;
+    // failure selectors above still catch explicit upload errors.
+    if (count > previousCount && Date.now() - startedAt >= 1200) {
       stableChecks += 1;
       if (stableChecks >= 3) {
         return;
@@ -3208,6 +3497,7 @@ export async function insertBilibiliRichContent(page, bodyInput, article, spec,
       plain: plainParts.join("\n")
     });
     await page.waitForTimeout(100);
+    await enforceBilibiliFirstTextAlignment(bodyInput, content);
     options.onProgress?.("B站 文字正文已写入，正在回读校验");
     options.onProgress?.(`B站 已写入 ${content.items.length} 个正文区块，准备处理 ${imageMarkers.length} 张正文图片`);
   }
@@ -3271,6 +3561,9 @@ export async function insertBilibiliRichContent(page, bodyInput, article, spec,
     }
   }
 
+  // Media insertion may rerender the first paragraph and drop its alignment.
+  // Reapply it after all images are settled, immediately before final reading.
+  await enforceBilibiliFirstTextAlignment(bodyInput, content);
   options.onProgress?.("B站 正文媒体已处理，正在最终回读校验");
   let state = null;
   let previousTextLength = -1;
@@ -3844,6 +4137,85 @@ async function fillLocator(locator, value) {
   await locator.fill(value);
 }
 
+export function replaceFirstTextValue(value, find, replacement) {
+  const source = String(value ?? "");
+  const needle = String(find ?? "");
+  const next = String(replacement ?? "");
+  if (!needle) {
+    throw new Error("待替换的原文不能为空");
+  }
+  const index = source.indexOf(needle);
+  if (index < 0) {
+    throw new Error("当前编辑页中未找到指定原文");
+  }
+  return `${source.slice(0, index)}${next}${source.slice(index + needle.length)}`;
+}
+
+async function replaceTextInEditable(locator, find, replacement) {
+  const before = String(
+    typeof locator.inputValue === "function"
+      ? await locator.inputValue().catch(() => "")
+      : await locator.innerText().catch(() => "")
+  );
+  replaceFirstTextValue(before, find, replacement);
+  const result = await locator.evaluate(
+    (element, values) => {
+      const source = "value" in element ? String(element.value ?? "") : String(element.innerText ?? element.textContent ?? "");
+      const index = source.indexOf(values.find);
+      if (index < 0) return { changed: false, reason: "not-found" };
+
+      if ("value" in element) {
+        const prototype = element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+        const setter = Object.getOwnPropertyDescriptor(prototype, "value")?.set;
+        const next = `${source.slice(0, index)}${values.replacement}${source.slice(index + values.find.length)}`;
+        if (setter) {
+          setter.call(element, next);
+        } else {
+          element.value = next;
+        }
+        element.dispatchEvent(new Event("input", { bubbles: true }));
+        element.dispatchEvent(new Event("change", { bubbles: true }));
+        return { changed: true, value: next };
+      }
+
+      const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+      let node;
+      while ((node = walker.nextNode())) {
+        const nodeIndex = node.data.indexOf(values.find);
+        if (nodeIndex < 0) continue;
+        const range = document.createRange();
+        range.setStart(node, nodeIndex);
+        range.setEnd(node, nodeIndex + values.find.length);
+        range.deleteContents();
+        const fragment = document.createDocumentFragment();
+        const lines = values.replacement.replace(/\r\n?/g, "\n").split("\n");
+        lines.forEach((line, lineIndex) => {
+          if (lineIndex > 0) fragment.append(document.createElement("br"));
+          if (line) fragment.append(document.createTextNode(line));
+        });
+        range.insertNode(fragment);
+        element.dispatchEvent(new Event("input", { bubbles: true }));
+        return { changed: true, value: String(element.innerText ?? element.textContent ?? "") };
+      }
+      return { changed: false, reason: "cross-node" };
+    },
+    { find, replacement }
+  );
+  if (!result?.changed) {
+    const detail = result?.reason === "cross-node" ? "原文跨越多个富文本节点，无法在不破坏排版的情况下替换" : "当前编辑页中未找到指定原文";
+    throw new Error(detail);
+  }
+  const actual = String(
+    typeof locator.inputValue === "function"
+      ? await locator.inputValue().catch(() => "")
+      : await locator.innerText().catch(() => "")
+  );
+  if (!actual.includes(replacement)) {
+    throw new Error("编辑器未回读到修改后的文本");
+  }
+  return actual;
+}
+
 async function verifyFilledValue(locator, expected, label, platform = "TapTap") {
   let actual = "";
   if (typeof locator.inputValue === "function") {
@@ -4052,6 +4424,60 @@ async function editorIsReady(page, spec) {
   return Boolean(await firstVisible(page, spec.body));
 }
 
+async function findPreparedEditorPage(context, spec) {
+  const deadline = Date.now() + 10000;
+  do {
+    const pages = context.pages().filter(page => !(typeof page.isClosed === "function" && page.isClosed()));
+    for (const page of [...pages].reverse()) {
+      if (await editorIsReady(page, spec)) return page;
+    }
+    const page = pages.at(-1);
+    if (page && typeof page.waitForTimeout === "function") {
+      await page.waitForTimeout(200);
+    } else {
+      await new Promise(resolve => setTimeout(resolve, 200));
+    }
+  } while (Date.now() < deadline);
+  return null;
+}
+
+export async function editPreparedPlatformPage(entry, revision, options = {}) {
+  const spec = BROWSER_PLATFORM_SPECS[entry.platformKey];
+  if (!spec || entry.publisher !== "browser") {
+    throw new Error(`${entry.platform} 不支持编辑已准备页面`);
+  }
+  const target = normalizeKey(revision?.target || "body");
+  if (!new Set(["title", "body"]).has(target)) {
+    throw new Error("编辑位置只能是 title 或 body");
+  }
+  const find = String(revision?.find ?? "");
+  const replacement = String(revision?.replacement ?? "");
+  if (!find || !replacement) {
+    throw new Error("编辑需要同时提供原文和新文");
+  }
+
+  const { chromium } = await import("playwright-core");
+  const context = await reconnectDetachedBrowserContext(browserProfileDir(entry), chromium);
+  if (!context) {
+    throw new Error(`${entry.platform} 没有可继续编辑的已准备页面，请先重新准备该平台的发布页`);
+  }
+  try {
+    const page = await findPreparedEditorPage(context, spec);
+    if (!page) {
+      throw new Error(`${entry.platform} 已准备页面中未找到标题和正文编辑器`);
+    }
+    const field = await waitForVisible(page, target === "title" ? spec.title : spec.body, 3000);
+    if (!field) {
+      throw new Error(`${entry.platform} 页面中未找到${target === "title" ? "标题" : "正文"}编辑器`);
+    }
+    const value = await replaceTextInEditable(field, find, replacement);
+    options.onProgress?.(`${entry.platform}${target === "title" ? "标题" : "正文"}已修改并回读确认`);
+    return { url: page.url(), target, value };
+  } finally {
+    await closeBrowserContext(context);
+  }
+}
+
 async function openPlatformLogin(page, entry, spec) {
   if (spec.loginPage) {
     await page.goto(spec.loginPage, { waitUntil: "domcontentloaded", timeout: 60000 });
@@ -4084,6 +4510,24 @@ async function openPlatformLogin(page, entry, spec) {
   return false;
 }
 
+export function browserSessionLoginPrompt(platform) {
+  return `${platform} 尚未登录。请仅在 CLI 刚打开的自动化浏览器窗口中完成登录（扫码或账号密码均可），不要改用其他浏览器；完成后保持该窗口打开并回复“已登录”。`;
+}
+
+async function waitForExisting(page, selectors, timeoutMs = 15000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const locator = await firstExisting(page, selectors);
+    if (locator) return locator;
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return null;
+}
+
+function browserSessionLoginFailure(platform) {
+  return `${platform} 登录完成后仍未进入发布编辑器。请确认登录发生在 CLI 刚打开的自动化浏览器窗口中，并检查账号是否拥有发布权限`;
+}
+
 async function ensureBrowserLogin(page, entry, spec, promptUser) {
   const alreadyLoggedIn = await openPlatformLogin(page, entry, spec);
   if (alreadyLoggedIn) {
@@ -4091,7 +4535,7 @@ async function ensureBrowserLogin(page, entry, spec, promptUser) {
   }
 
   if (spec.manualLogin) {
-    await promptUser(`${entry.platform} 尚未登录，请在浏览器中手动完成登录（可自行填写账号密码或扫码）`);
+    await promptUser(browserSessionLoginPrompt(entry.platform));
     return true;
   }
 
@@ -4705,7 +5149,7 @@ async function publishTapTap(page, entry, article, spec, options, promptUser) {
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => tapTapCreatorReady(page, spec), 15000))) {
-    throw new Error("TapTap 登录完成后仍未进入创作者发布页，请确认账号拥有发布权限");
+    throw new Error(browserSessionLoginFailure("TapTap"));
   }
   const resumedDraft = await resumeMatchingTapTapDraft(page, spec, preparedArticle.title, editorUrl);
   if (options.publishDraft) {
@@ -5212,7 +5656,7 @@ async function publishBilibili(page, entry, article, spec, options, promptUser)
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => bilibiliEditorIsReady(page, spec, settings), 15000))) {
-    throw new Error(`B站登录完成后仍未进入${settings.typeLabel}投稿页，请确认账号拥有投稿权限`);
+    throw new Error(browserSessionLoginFailure("B站"));
   }
 
   let titleInput;
@@ -5356,7 +5800,10 @@ async function waitForWeiboArticleInlineImage(bodyInput, previousCount, source)
     if (failed > 0) {
       throw new Error(`微博文章正文图片上传失败: ${source}`);
     }
-    if (count > previousCount && pending === 0) {
+    if (count > previousCount + 1) {
+      throw new Error(`微博正文图片疑似重复插入: ${source}`);
+    }
+    if (count === previousCount + 1 && pending === 0) {
       stableChecks += 1;
       if (stableChecks >= 3) {
         return;
@@ -5473,10 +5920,24 @@ async function visibleWeiboCropDialog(page) {
 
 async function clearExistingWeiboArticleImages(page, scope) {
   const items = scope.locator(".image-list .image-item");
+  // The gallery list is populated asynchronously after the dialog opens. Give
+  // existing items a short window to appear before treating the library as empty.
+  let previousCount = await items.count().catch(() => 0);
+  if (previousCount === 0) {
+    const deadline = Date.now() + 5000;
+    do {
+      await page.waitForTimeout(200);
+      previousCount = await items.count().catch(() => 0);
+      if (previousCount > 0) break;
+    } while (Date.now() < deadline);
+  }
+  if (previousCount === 0) {
+    return 0;
+  }
   let cleared = 0;
   while (cleared < 200) {
-    const previousCount = await items.count().catch(() => 0);
-    if (previousCount === 0) {
+    const currentCount = await items.count().catch(() => 0);
+    if (currentCount === 0) {
       return cleared;
     }
     const item = items.first();
@@ -5489,10 +5950,10 @@ async function clearExistingWeiboArticleImages(page, scope) {
     }
     await remove.click();
     const deadline = Date.now() + 10000;
-    let currentCount = previousCount;
+    let afterDeleteCount = currentCount;
     do {
-      currentCount = await items.count().catch(() => previousCount);
-      if (currentCount < previousCount) {
+      afterDeleteCount = await items.count().catch(() => currentCount);
+      if (afterDeleteCount < currentCount) {
         break;
       }
       const text = typeof scope.innerText === "function" ? await scope.innerText().catch(() => "") : "";
@@ -5501,14 +5962,26 @@ async function clearExistingWeiboArticleImages(page, scope) {
       }
       await page.waitForTimeout(200);
     } while (Date.now() < deadline);
-    if (currentCount >= previousCount) {
+    if (afterDeleteCount >= currentCount) {
       throw new Error("微博头条文章图片库旧图片删除后未消失");
     }
-    cleared += previousCount - currentCount;
+    cleared += currentCount - afterDeleteCount;
   }
   throw new Error("微博头条文章图片库旧图片超过 200 张，已停止清理");
 }
 
+async function waitForWeiboArticleImageList(page, scope, timeoutMs = 10000) {
+  const list = scope.locator(".image-list");
+  const deadline = Date.now() + timeoutMs;
+  do {
+    if ((await list.count().catch(() => 0)) > 0) {
+      return true;
+    }
+    await page.waitForTimeout(200);
+  } while (Date.now() < deadline);
+  return false;
+}
+
 async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, source, options = {}) {
   options.onProgress?.("正在打开图片库");
   const imageButton = await weiboArticleImageButton(page);
@@ -5516,7 +5989,7 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
     throw new Error("微博头条文章编辑器中未找到图片库按钮");
   }
   await imageButton.click();
-  const input = await firstExisting(page, spec.imageInputs);
+  const input = await waitForExisting(page, spec.imageInputs, 15000);
   if (!input || typeof input.setInputFiles !== "function") {
     throw new Error("微博头条文章图片库中未找到上传控件");
   }
@@ -5524,7 +5997,7 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
     'xpath=ancestor::*[.//*[normalize-space(text())="图片库"] and .//*[normalize-space(text())="插入"]][1]'
   );
   const scope = (await modal.count().catch(() => 0)) > 0 ? modal : page;
-  const structuredLibrary = (await scope.locator(".image-list").count().catch(() => 0)) > 0;
+  const structuredLibrary = await waitForWeiboArticleImageList(page, scope, 10000);
   if (structuredLibrary && options.clearExistingLibrary) {
     options.onProgress?.("正在清理图片库旧图");
     await clearExistingWeiboArticleImages(page, scope);
@@ -5545,6 +6018,9 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
           .catch(() => [])
       : [];
   const previousImages = await bodyInput.locator("img:not(.ProseMirror-separator)").count();
+  if (options.clearExistingLibrary && (await previews.count().catch(() => 0)) !== 0) {
+    throw new Error(`微博图片库旧图未清空，已停止上传: ${source}`);
+  }
   options.onProgress?.("正在上传正文图片");
   await input.setInputFiles([payload]);
 
@@ -5591,10 +6067,12 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
   if (candidateIndexes.length === 0 && previewCount > previousPreviews) {
     candidateIndexes = Array.from({ length: previewCount - previousPreviews }, (_, offset) => previousPreviews + offset);
   }
-  if (candidateIndexes.length === 0 && previewCount > 0) {
-    candidateIndexes = [previewCount - 1];
+  if (candidateIndexes.length === 0) {
+    throw new Error(`微博文章图片上传后未识别到本次上传的缩略图: ${source}`);
   }
-  if (structuredLibrary && candidateIndexes.length > 0) {
+  if (options.clearExistingLibrary && previewCount === 1) {
+    uploadedPreview = previews.first();
+  } else if (structuredLibrary && candidateIndexes.length > 0) {
     // Let the common click-and-verify path below perform the selection once.
     uploadedPreview = previews.nth(candidateIndexes[0]);
   }
@@ -5656,12 +6134,19 @@ async function uploadWeiboArticleInlineImage(page, bodyInput, spec, payload, sou
   await insertButton.click();
   await page.waitForTimeout(300);
   if (scope !== page && typeof scope.isVisible === "function" && (await scope.isVisible().catch(() => false))) {
-    const retryInsert = typeof scope.getByRole === "function"
-      ? scope.getByRole("button", { name: "插入", exact: true }).last()
-      : insertButton;
-    if ((await retryInsert.count().catch(() => 0)) > 0 && !(await weiboControlDisabled(retryInsert))) {
-      await retryInsert.click({ force: true });
-      await page.waitForTimeout(300);
+    // A successful click normally closes the library or opens the crop dialog.
+    // Only retry when neither happened and the editor image count is unchanged;
+    // an unconditional second click can insert the same image twice.
+    const cropStarted = await visibleWeiboCropDialog(page);
+    const currentImages = await bodyInput.locator("img:not(.ProseMirror-separator)").count().catch(() => previousImages);
+    if (!cropStarted && currentImages === previousImages) {
+      const retryInsert = typeof scope.getByRole === "function"
+        ? scope.getByRole("button", { name: "插入", exact: true }).last()
+        : insertButton;
+      if ((await retryInsert.count().catch(() => 0)) > 0 && !(await weiboControlDisabled(retryInsert))) {
+        await retryInsert.click({ force: true });
+        await page.waitForTimeout(300);
+      }
     }
   }
 
@@ -5717,10 +6202,15 @@ async function clearWeiboArticleBody(page, bodyInput) {
     await page.waitForTimeout(100);
   }
 
-  let remaining = await bodyInput
-    .evaluate(element => String(element.innerText || element.textContent || "").trim())
-    .catch(() => "");
-  if (typeof remaining === "string" && remaining) {
+  const readBodyState = async () =>
+    bodyInput
+      .evaluate(element => ({
+        text: String(element.innerText || element.textContent || "").trim(),
+        images: element.querySelectorAll("img:not(.ProseMirror-separator)").length
+      }))
+      .catch(() => ({ text: "", images: 0 }));
+  let remaining = await readBodyState();
+  if (remaining.text || remaining.images > 0) {
     await bodyInput.evaluate(element => {
       element.replaceChildren(document.createElement("p"));
       element.dispatchEvent(
@@ -5732,11 +6222,9 @@ async function clearWeiboArticleBody(page, bodyInput) {
       );
     });
     await page.waitForTimeout(100);
-    remaining = await bodyInput
-      .evaluate(element => String(element.innerText || element.textContent || "").trim())
-      .catch(() => "");
+    remaining = await readBodyState();
   }
-  if (typeof remaining === "string" && remaining) {
+  if (remaining.text || remaining.images > 0) {
     throw new Error("微博文章正文未能清空，已停止发布以避免复用旧草稿内容");
   }
 }
@@ -5954,7 +6442,7 @@ export async function insertWeiboArticleRichContent(page, bodyInput, article, sp
       payloadCache.set(item.source, payload);
     }
     await uploadWeiboArticleInlineImage(page, activeBodyInput, spec, payload, item.source, {
-      clearExistingLibrary: imageIndex === 0,
+      clearExistingLibrary: true,
       onProgress: options.onProgress
     });
   }
@@ -6492,6 +6980,43 @@ async function findWeiboShareSubmitButton(page, dialog) {
   return findIn(page);
 }
 
+async function preparedWeiboArticleState(page, spec, article, title) {
+  if (!(await waitForEditorReady(page, () => editorIsReady(page, spec), 5000))) return null;
+  const titleInput = await waitForVisible(page, spec.title, 3000);
+  const bodyInput = await waitForVisible(page, spec.body, 3000);
+  if (!titleInput || !bodyInput) return null;
+  if (normalizeText(await readFilledValue(titleInput)) !== normalizeText(title)) return null;
+
+  const expected = buildWeiboRichContent(article);
+  const state =
+    typeof bodyInput.evaluate === "function"
+      ? await bodyInput
+          .evaluate(element => ({
+            text: element.innerText || element.textContent || "",
+            images: element.querySelectorAll("img:not(.ProseMirror-separator)").length,
+            links: element.querySelectorAll("a[href]").length,
+            failedImages: element.querySelectorAll('[class*="upload-fail"], [class*="upload-error"]').length
+          }))
+          .catch(() => null)
+      : null;
+  const actualText = normalizedPresenceText(state?.text || normalizeText(await readFilledValue(bodyInput)));
+  if (!actualText || state?.failedImages > 0) return null;
+  if (state && state.images < expected.images.length) return null;
+  const expectedFragments = expected.items
+    .filter(item => item.type === "html" && item.plain)
+    .map(item => normalizedPresenceText(item.plain))
+    .filter(Boolean);
+  if (expectedFragments.length > 0 && !hasOrderedTextFragments(actualText, expectedFragments)) return null;
+  return {
+    richContent: {
+      rich: true,
+      images: state?.images ?? expected.images.length,
+      links: state?.links ?? expected.links.length,
+      plainText: expected.plainText
+    }
+  };
+}
+
 async function publishWeibo(page, entry, article, spec, options, promptUser) {
   const progress = message => options.onProgress?.(message);
   const preparedArticle = prepareWeiboArticleForProject(article, entry);
@@ -6506,6 +7031,24 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
   }
 
   const editorUrl = weiboArticleEditorUrl(entry.url);
+  if (options.directPublish) {
+    const context = typeof page.context === "function" ? page.context() : null;
+    const preparedPage = context ? await findPreparedEditorPage(context, spec) : null;
+    if (preparedPage) page = preparedPage;
+  }
+  const directPrepared = options.directPublish
+    ? await preparedWeiboArticleState(page, spec, preparedArticle, title)
+    : null;
+  if (options.directPublish && !directPrepared) {
+    throw new Error("微博待发布编辑页未找到与当前文章一致的已准备内容；请重新准备后再授权发布");
+  }
+  let richContent = directPrepared?.richContent || null;
+  let cover = {};
+  let column = "";
+  if (options.directPublish) {
+    progress("已复用当前微博待发内容，正在提交，不重复上传正文图片或封面");
+  }
+  if (!options.directPublish) {
   await page.goto(editorUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
   await afterNavigation(page);
   if (!(await waitForEditorReady(page, () => editorIsReady(page, spec)))) {
@@ -6514,7 +7057,7 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
     await afterNavigation(page);
   }
   if (!(await waitForEditorReady(page, () => editorIsReady(page, spec), 120000))) {
-    throw new Error("微博登录完成后仍未进入头条文章编辑器，请确认账号拥有文章发布权限");
+    throw new Error(browserSessionLoginFailure("微博"));
   }
 
   const draftMode = await ensureWeiboArticleDraft(page, title);
@@ -6531,12 +7074,13 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
   }
   await fillStableWeiboField(page, spec.title, title, "标题");
   const stableBodyInput = (await waitForVisible(page, spec.body, 3000)) || bodyInput;
-  const richContent = await insertWeiboArticleRichContent(page, stableBodyInput, preparedArticle, spec, body, {
+  richContent = await insertWeiboArticleRichContent(page, stableBodyInput, preparedArticle, spec, body, {
     onProgress: progress
   });
   progress("正文已写入，正在设置封面");
-  const cover = await applyWeiboArticleCover(page, preparedArticle, settings, { onProgress: progress });
-  const column = await applyWeiboArticleColumn(page, settings.column, { onProgress: progress });
+  cover = await applyWeiboArticleCover(page, preparedArticle, settings, { onProgress: progress });
+  column = await applyWeiboArticleColumn(page, settings.column, { onProgress: progress });
+  }
 
   const nextButton = await waitForVisibleButton(page, spec.next, 5000);
   if (!nextButton) {
@@ -6633,7 +7177,26 @@ async function publishWeibo(page, entry, article, spec, options, promptUser) {
       }
       const shareSubmit = await findWeiboShareSubmitButton(page, shareComposer.dialog);
       if (!shareSubmit) {
-        throw new Error("微博分享发布弹窗中未找到“发布”按钮");
+        // The article submit can navigate to publish history while the share
+        // composer is still being torn down. Treat that navigation as a
+        // successful article submission instead of reporting a false failure.
+        const historyDeadline = Date.now() + 3000;
+        while (!/\/history\//i.test(page.url()) && Date.now() < historyDeadline) {
+          await page.waitForTimeout(200);
+        }
+        if (/\/history\//i.test(page.url())) {
+          progress("微博文章已提交，分享弹窗已自动关闭");
+          confirmation = { confirmation: "navigation" };
+        } else {
+          throw new Error("微博分享发布弹窗中未找到“发布”按钮");
+        }
+      }
+      if (confirmation) {
+        progress("已收到微博发布成功回执");
+        if (options.keepOpen) {
+          await promptUser("微博头条文章已收到发布成功回执，浏览器保持打开供检查");
+        }
+        return { url: page.url(), status: "published", type: "article", title, ...richContent, ...cover, column, ...confirmation };
       }
       if (typeof shareSubmit.isDisabled === "function" && (await shareSubmit.isDisabled().catch(() => false))) {
         throw new Error("微博分享发布弹窗中的“发布”按钮不可用");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "QCPlay CLI",
   "type": "module",
   "bin": {

package/templates/skills/qcplay-publish-article/SKILL.md

@@ -60,6 +60,18 @@ qcplay publish --project 最强蜗牛 --list-platforms
 
 默认 `qcplay publish` 不得进入正式发布或填入文章；它会先打开每个浏览器平台的真实编辑器页面，再返回 `qcplay.publish-action-required` 事件。Agent 收到该事件后，必须立即在当前 AI 对话提供“发布”“保存草稿箱”“取消发布”三个选项，不能用终端提问。用户明确选择发布后才添加 `--direct`；选择保存草稿箱后才添加 `--draft-only`。用户说“保存到草稿箱”“发布到草稿箱”时，直接使用 `--draft-only`，不得调用默认发布命令。`--draft-only` 填完内容后只保存原生草稿或停留在编辑页，且草稿页面保持打开。草稿成功后，CLI 会立即返回 `qcplay.draft-approval-required` 事件；Agent 必须立刻在 AI 对话提供“发布”“取消”两个选项，不能等待用户在网页中操作，也不能等待终端输入。用户明确要求先查看官网外平台的待发布稿时，增加 `--review-draft`（或 `--review`）：CLI 填完标题、富文本、图片、封面和发布设置后，在最终提交前保持浏览器打开；必须回到当前 AI 对话询问用户“发布”“保存草稿”或“取消”，并等待明确回复，禁止要求用户在 CMD/终端输入确认或按 Enter。用户明确授权跳过二次确认时使用 `--direct`（或 `--no-review`），该参数仅跳过发布前预览确认，不跳过登录、验证码或安全验证。该参数不改变官网流程。TapTap 已保存草稿且用户明确要求发布时，使用 `--publish-draft`，只恢复标题匹配的已有草稿并提交，禁止再次覆盖正文、图片或封面。好游快爆没有原生草稿箱，只能保持已填好的编辑页供用户预览。
 
+## 已准备页面的对话修改
+
+当浏览器平台已经返回 `qcplay.publish-action-required`，且编辑页仍保持打开时，用户可在当前 AI 对话中明确说明平台、标题或正文位置、待替换原文及新文。此类单次修改不写入 `rule.docx` 或 `platform-rules.json`，也不改变本地 `article.md`。
+
+AI 应将用户已明确的修改转换为一次受限页面编辑：
+
+```bash
+qcplay-cli edit-page --project <项目> --region <区域> --platform <平台> --target <title|body> --find "原文" --replace "新文"
+```
+
+该命令只连接已打开的待确认编辑页、替换第一处完全匹配的文本并回读验证；新文中的真实换行会保留为富文本换行。不保存草稿、不点击发布，也不会重新打开或覆盖编辑页。原文跨越多个富文本节点、未找到原文、页面已关闭或已发布时必须停止并反馈失败。用户未同时给出原文和新文，或未说明目标位置时，AI 应在当前对话中请求补充，不得猜测或修改规则文件。
+
 ## AI 对话授权与反馈
 
 发布或保存草稿前，只要流程需要用户确认，必须在当前 AI 对话中询问并等待明确回复，不得唤起终端或要求用户在 CMD/终端输入“发布”“可以发布”或按 Enter。询问时说明目标平台、文章标题或文章 ID（不得包含 token），并提供以下动作：