@qcplay/cli 1.0.19 → 1.0.20

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("");
@@ -2753,6 +2933,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 +3162,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

@@ -13,6 +13,7 @@ import { stripWechatGuidanceHtml } from "./wechat-article.js";
 
 const PLATFORM_CONFIG_URL = "https://t4blw8ys5w.feishu.cn/wiki/OqH7wkx9PiBaTYkKeWNc35SonGf";
 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";
@@ -663,7 +664,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 +677,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 +792,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);
   }
-  return { messages: chunks.length };
+  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, 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")
@@ -1913,8 +2057,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 +2526,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 +2561,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);
@@ -3135,7 +3294,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 +3303,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 +3320,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;
@@ -3844,6 +4005,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 +4292,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 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "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），并提供以下动作：