@qcplay/cli 1.0.17 → 1.0.19

package/bin/qcplay.js

@@ -10,11 +10,15 @@ import readline from "readline";
 import { fileURLToPath, pathToFileURL } from "url";
 
 import {
+  analyzeArticleContentSafety,
+  buildImportedArticleHtml,
   buildOfficialArticleMarkdown,
   importWechatArticle,
   normalizeArticleColor,
-  sanitizeArticleRichHtml
+  sanitizeArticleRichHtml,
+  uploadMediaToBackend
 } from "../lib/wechat-article.js";
+import { buildRichArticleUploadPayload, parseRichArticleUploadFile } from "../lib/rich-article-upload.js";
 import { importLarkArticle, parseLarkDocumentUrl } from "../lib/lark-article.js";
 import {
   CONTENT_RULES_TEMPLATE,
@@ -23,6 +27,15 @@ import {
   loadContentRules,
   matchingContentRules
 } from "../lib/content-rules.js";
+import {
+  WECHAT_GAME_CATALOG,
+  buildWechatArticleJson,
+  normalizeWechatGameId,
+  monthDateRange,
+  renderWechatArticleMarkdown,
+  splitWechatDateRange,
+  todayInShanghai
+} from "../lib/wechat-data.js";
 import {
   availableProjects,
   bilibiliPublishingPlan,
@@ -36,7 +49,8 @@ import {
   runPlatformPublishSequence,
   selectRequestedEntries,
   tapTapPublishingPlan,
-  weiboPublishingPlan
+  weiboPublishingPlan,
+  writePlatformPublishUrls
 } from "../lib/platform-publish.js";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -172,6 +186,7 @@ const ARTICLE_PREVIEW_BASE_URL = "https://snail.qingcigame.com/official/news-det
 const SKILLS_DIR = path.join(AGENTS_DIR, "skills");
 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",
   "50": "https://mtzg.qingcijoy.com/news-details.html",
   "69": "https://hjwq.qingcijoy.com/news-details.html",
   "74": "https://sakura.qingcijoy.com/news-details.html",
@@ -225,10 +240,11 @@ Usage:
   qcplay-cli article
   qcplay-cli article init [file]
   qcplay-cli article west-init [file]
-  qcplay-cli article import <wechat-or-feishu-url> [file] [--rules-file <json|txt|docx>] [--project <项目>] [--platform <平台>]
+  qcplay-cli article import <wechat-or-feishu-url> [file] [--format html|markdown] [--rules-file <json|txt|docx>] [--project <项目>] [--platform <平台>] [--backend <url>] [--local]
   qcplay-cli article publish <file> [--title <标题>] [--cover <图片>] [--project <项目>] [--region <区域>] [--rules-file <json>] [--dry-run]
   qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]
+  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 rules [init|validate|list] [--rules-file <json>]
@@ -263,29 +279,124 @@ function printArticleHelp() {
   qcplay-cli article
   qcplay-cli article init [file]
   qcplay-cli article west-init [file]
-  qcplay-cli article import <wechat-or-feishu-url> [file] [--rules-file <json>] [--project <项目>]
+  qcplay-cli article import <wechat-or-feishu-url> [file] [--format html|markdown] [--rules-file <json>] [--project <项目>] [--backend <url>] [--local]
   qcplay-cli article publish <file> [--title <标题>] [--cover <图片>] [--project <项目>] [--region <区域>] [--rules-file <json>] [--dry-run]
   qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]`);
 }
 
+function printWechatHelp() {
+  console.log(`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>]
+
+只读取微信公众号接口返回的 day_total，并按游戏和月份生成表格。
+支持的 game_id: ${Object.entries(WECHAT_GAME_CATALOG).map(([id, name]) => `${id}（${name}）`).join("、")}
+当前日期作为结束日期时，必须填写到昨天；超过 30 天的范围会按月份和 30 天窗口自动拆分请求。`);
+}
+
+function parseWechatArticleOptions(args) {
+  const options = {
+    gameIds: [],
+    beginDate: "",
+    endDate: "",
+    month: "",
+    output: "",
+    format: "markdown",
+    backend: undefined,
+    local: false
+  };
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    if (["--game-id", "--game", "--begin-date", "--start", "--end-date", "--end", "--month", "--output", "--format", "--backend"].includes(current)) {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) throw new Error(`${current} 缺少参数值`);
+      if (current === "--game-id" || current === "--game") {
+        options.gameIds.push(...next.split(",").map(normalizeWechatGameId));
+      } else if (current === "--begin-date" || current === "--start") {
+        options.beginDate = next;
+      } else if (current === "--end-date" || current === "--end") {
+        options.endDate = next;
+      } else if (current === "--month") {
+        options.month = next;
+      } else if (current === "--output") {
+        options.output = next;
+      } else if (current === "--format") {
+        options.format = next.toLowerCase();
+      } else {
+        options.backend = next;
+      }
+      index += 1;
+      continue;
+    }
+    if (current === "--local") {
+      options.local = true;
+      continue;
+    }
+    if (current === "--all-games") {
+      options.gameIds = Object.keys(WECHAT_GAME_CATALOG);
+      continue;
+    }
+    throw new Error(`未知参数: ${current}`);
+  }
+  options.gameIds = [...new Set(options.gameIds)];
+  if (options.gameIds.length === 0) throw new Error("请至少指定一个 --game-id");
+  if (options.month && (options.beginDate || options.endDate)) throw new Error("--month 不能与 --begin-date/--end-date 同时使用");
+  if (options.month) {
+    const range = monthDateRange(options.month, todayInShanghai());
+    options.beginDate = range.begin.toISOString().slice(0, 10);
+    options.endDate = range.end.toISOString().slice(0, 10);
+  }
+  if (!options.beginDate || !options.endDate) throw new Error("请指定 --month，或同时指定 --begin-date 和 --end-date");
+  if (!new Set(["markdown", "json"]).has(options.format)) throw new Error("--format 只能是 markdown 或 json");
+  return options;
+}
+
 function parseArticleImportOptions(args) {
   const positional = [];
-  const options = { rulesFile: "", project: "", platform: "" };
+  const options = { rulesFile: "", project: "", platform: "", format: "html", backend: undefined, local: false };
   for (let index = 0; index < args.length; index += 1) {
     const current = args[index];
-    if (current === "--rules-file" || current === "--project" || current === "--platform") {
+    if (
+      current === "--rules-file" ||
+      current === "--project" ||
+      current === "--platform" ||
+      current === "--format" ||
+      current === "--backend"
+    ) {
       const next = args[index + 1];
       if (!next || next.startsWith("--")) throw new Error(`${current} 缺少参数值`);
-      options[current === "--rules-file" ? "rulesFile" : current === "--project" ? "project" : "platform"] = next;
+      if (current === "--format") {
+        options.format = next.toLowerCase();
+      } else {
+        const key =
+          current === "--rules-file"
+            ? "rulesFile"
+            : current === "--project"
+              ? "project"
+              : current === "--platform"
+                ? "platform"
+                : "backend";
+        options[key] = next;
+      }
       index += 1;
       continue;
     }
+    if (current === "--local") {
+      options.local = true;
+      continue;
+    }
     if (current.startsWith("--")) throw new Error(`未知参数: ${current}`);
     positional.push(current);
   }
   if (positional.length > 2) throw new Error(`未知参数: ${positional.slice(2).join(" ")}`);
-  return { sourceUrl: positional[0], file: positional[1] || "article.md", options };
+  if (!new Set(["markdown", "html"]).has(options.format)) {
+    throw new Error("--format 只能是 markdown 或 html");
+  }
+  return {
+    sourceUrl: positional[0],
+    file: positional[1] || (options.format === "markdown" ? "article.md" : "article.html"),
+    options
+  };
 }
 
 function printPublishHelp() {
@@ -305,7 +416,10 @@ Options:
   --config-file <json>      使用本地平台配置（主要用于测试）
   --rules-file <json>       使用指定内容规则；默认 ~/.qcplay/platform-rules.json
   --browser-channel <name>  Playwright 浏览器通道，Windows 默认 msedge
-  --review-draft, --review  官网外平台先准备草稿，预览后在 CMD 确认发布
+  --review-draft, --review  官网外平台先准备草稿，预览后由当前 AI 对话确认发布
+  --direct, --no-review     需配合 AI 对话确认标记后才可跳过发布前预览
+  --publish-draft           仅 TapTap：发布标题匹配的已有草稿，不重新写入内容
+  --draft-only, --draft     仅保存或停留在官网外平台草稿，不执行正式发布
   --open-page               只打开真实浏览器发布页，供登录和页面流程测试，不读取或提交文章
   --switch-account          先打开发布页切换账号，确认后继续当前发布流程
   --keep-open               浏览器提交后等待用户确认再关闭
@@ -371,6 +485,56 @@ function parseRulesOptions(args) {
   return options;
 }
 
+async function importWechatDataCommand(options) {
+  const config = await loadConfig();
+  const backendUrl = resolveAuthBackendUrl(options, config);
+  const reports = [];
+  for (const gameId of options.gameIds) {
+    const ranges = splitWechatDateRange(options.beginDate, options.endDate, todayInShanghai());
+    const dayTotal = new Map();
+    for (const range of ranges) {
+      const query = new URLSearchParams({
+        game_id: gameId,
+        begin_date: range.beginDate,
+        end_date: range.endDate
+      });
+      console.log(chalk.gray(`正在拉取${WECHAT_GAME_CATALOG[gameId]} ${range.beginDate} 至 ${range.endDate}`));
+      const response = await authenticatedRequest("GET", backendUrl, `/api/wechat/article?${query}`);
+      if (Number(response.code) !== 200) {
+        throw new Error(`${WECHAT_GAME_CATALOG[gameId]} ${range.beginDate} 至 ${range.endDate}：${response.message || `接口返回 code=${response.code ?? "未知"}`}`);
+      }
+      const items = Array.isArray(response.data?.day_total) ? response.data.day_total : [];
+      for (const item of items) {
+        const key = `${item.ref_date || ""}\u0000${item.msgid || ""}`;
+        dayTotal.set(key, item);
+      }
+    }
+    reports.push({
+      gameId,
+      gameName: WECHAT_GAME_CATALOG[gameId],
+      beginDate: options.beginDate,
+      endDate: options.endDate,
+      ranges,
+      dayTotal: [...dayTotal.values()].sort((left, right) => {
+        const byDate = String(left.ref_date || "").localeCompare(String(right.ref_date || ""));
+        return byDate || String(left.msgid || "").localeCompare(String(right.msgid || ""));
+      })
+    });
+  }
+
+  const output = options.format === "json" ? buildWechatArticleJson(reports) : renderWechatArticleMarkdown(reports);
+  if (options.output) {
+    const target = path.resolve(options.output);
+    if (await pathExists(target)) throw new Error(`输出文件已存在: ${target}`);
+    await ensureDir(path.dirname(target));
+    await fs.promises.writeFile(target, output, { encoding: "utf8", mode: 0o600 });
+    console.log(chalk.green(`微信公众号数据已生成: ${target}`));
+    console.log(`文章数据: ${reports.reduce((sum, report) => sum + report.dayTotal.length, 0)} 篇`);
+    return;
+  }
+  process.stdout.write(output);
+}
+
 async function contentRulesCommand(action, args = []) {
   const options = parseRulesOptions(args);
   const file = path.resolve(options.rulesFile || CONTENT_RULES_FILE);
@@ -423,7 +587,7 @@ function printFeatures() {
   console.log("   qcplay-cli auth permissions --key www-article-list.store");
   console.log("");
   console.log(chalk.cyan("3. 发布官网文章"));
-  console.log("   qcplay-cli article import <微信文章或飞书文档链接> article.md");
+  console.log("   qcplay-cli article import <微信文章或飞书文档链接> article.html");
   console.log("   qcplay-cli www-article-list.store article.md");
   console.log("   qcplay-cli article update [id]");
   console.log("   qcplay-cli article delete [id]");
@@ -435,6 +599,9 @@ function printFeatures() {
   console.log(chalk.cyan("5. 查看本地目录"));
   console.log("   qcplay-cli where");
   console.log("");
+  console.log(chalk.cyan("6. 拉取微信公众号数据"));
+  console.log("   qcplay-cli wechat article --game-id 39 --month 2026-08 --output wechat-2026-08.md");
+  console.log("");
 }
 
 function printWhere() {
@@ -806,6 +973,10 @@ function parseDistributionOptions(args) {
     weiboColumn: "",
     browserChannel: "",
     reviewDraft: false,
+    directPublish: false,
+    confirmed: false,
+    draftOnly: false,
+    publishDraft: false,
     keepOpen: false,
     openPage: false,
     switchAccount: false,
@@ -845,6 +1016,22 @@ function parseDistributionOptions(args) {
       options.reviewDraft = true;
       continue;
     }
+    if (current === "--direct" || current === "--no-review") {
+      options.directPublish = true;
+      continue;
+    }
+    if (current === "--confirmed") {
+      options.confirmed = true;
+      continue;
+    }
+    if (current === "--draft-only" || current === "--draft") {
+      options.draftOnly = true;
+      continue;
+    }
+    if (current === "--publish-draft") {
+      options.publishDraft = true;
+      continue;
+    }
 
     const valueFlags = new Map([
       ["--backend", "backend"],
@@ -909,11 +1096,11 @@ function applyPublishOverrides(parsedArticle, options) {
     ...parsedArticle.meta,
     ...(cover
       ? {
-          weibo_cover: cover,
-          taptap_cover: cover,
-          bilibili_cover: cover,
-          xiaohongshu_images: cover
-        }
+        weibo_cover: cover,
+        taptap_cover: cover,
+        bilibili_cover: cover,
+        xiaohongshu_images: cover
+      }
       : {}),
     ...(weiboColumn ? { weibo_column: weiboColumn } : {})
   };
@@ -991,7 +1178,9 @@ function openBrowser(targetUrl) {
 
     if (process.platform === "win32") {
       command = "cmd";
-      args = ["/c", "start", "", targetUrl];
+      // 关键修复：将 URL 中的 & 替换为 ^&
+      const safeUrl = targetUrl.replace(/&/g, '^&'); 
+      args = ["/c", "start", "", safeUrl];
     } else if (process.platform === "darwin") {
       command = "open";
       args = [targetUrl];
@@ -1332,7 +1521,7 @@ function backendOriginsMatch(left, right) {
   }
 }
 
-async function saveRecentArticleState(articleId, status, backendUrl, previewUrl = "", target = "domestic") {
+async function saveRecentArticleState(articleId, status, backendUrl, previewUrl = "", target = "domestic", metadata = {}) {
   const authState = await loadAuthState();
   await writeJson(ARTICLE_STATE_FILE, {
     article_id: articleId,
@@ -1342,13 +1531,15 @@ async function saveRecentArticleState(articleId, status, backendUrl, previewUrl
     backend_url: backendUrl,
     administrator_id: Number(authState.id || 0),
     account: normalizeText(authState.account),
+    game_id: normalizeText(metadata.game_id),
+    cate_id: normalizeText(metadata.cate_id),
     updated_at: Date.now()
   });
 }
 
-async function trySaveRecentArticleState(articleId, status, backendUrl, previewUrl = "", target = "domestic") {
+async function trySaveRecentArticleState(articleId, status, backendUrl, previewUrl = "", target = "domestic", metadata = {}) {
   try {
-    await saveRecentArticleState(articleId, status, backendUrl, previewUrl, target);
+    await saveRecentArticleState(articleId, status, backendUrl, previewUrl, target, metadata);
     return "";
   } catch (error) {
     return normalizeText(error?.message) || String(error);
@@ -1689,14 +1880,14 @@ function applyInlineMarkdown(text) {
   output = output.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (_, alt, url) => {
     return storeToken(
       `<img src="${escapeHtml(url.trim())}" alt="${escapeHtml(alt.trim())}" ` +
-        'style="display:block;box-sizing:border-box;width:auto;max-width:100%;height:auto;object-fit:contain;margin:24px auto;" />'
+      'style="display:block;box-sizing:border-box;width:auto;max-width:100%;height:auto;object-fit:contain;margin:24px auto;" />'
     );
   });
 
   output = output.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, label, url) => {
     return storeToken(
       `<a href="${escapeHtml(url.trim())}" target="_blank" rel="noreferrer" ` +
-        `style="color:#576b95;text-decoration:none;overflow-wrap:anywhere;word-break:break-all;">${escapeHtml(label.trim())}</a>`
+      `style="color:#576b95;text-decoration:none;overflow-wrap:anywhere;word-break:break-all;">${escapeHtml(label.trim())}</a>`
     );
   });
 
@@ -1742,7 +1933,7 @@ function markdownToHtml(markdown) {
 
     html.push(
       `<p style="margin:0 0 20px;font-size:16px;line-height:1.9;color:#3f3f3f;text-align:justify;overflow-wrap:anywhere;word-break:break-word;">` +
-        `${paragraph.map(line => applyInlineMarkdown(line)).join("<br />")}</p>`
+      `${paragraph.map(line => applyInlineMarkdown(line)).join("<br />")}</p>`
     );
     paragraph = [];
   }
@@ -1754,9 +1945,9 @@ function markdownToHtml(markdown) {
 
     html.push(
       '<blockquote style="margin:24px 0;padding:14px 18px;border-left:4px solid #17b9c2;background:#f5f7f8;color:#57606a;">' +
-        `<p style="margin:0;font-size:15px;line-height:1.8;">${quote
-          .map(line => applyInlineMarkdown(line))
-          .join("<br />")}</p></blockquote>`
+      `<p style="margin:0;font-size:15px;line-height:1.8;">${quote
+        .map(line => applyInlineMarkdown(line))
+        .join("<br />")}</p></blockquote>`
     );
     quote = [];
   }
@@ -1770,7 +1961,7 @@ function markdownToHtml(markdown) {
 
     html.push(
       `<${listType} style="margin:0 0 20px;padding-left:1.6em;font-size:16px;line-height:1.9;color:#3f3f3f;">` +
-        `${listItems.map(item => `<li style="margin:6px 0;">${applyInlineMarkdown(item)}</li>`).join("")}</${listType}>`
+      `${listItems.map(item => `<li style="margin:6px 0;">${applyInlineMarkdown(item)}</li>`).join("")}</${listType}>`
     );
     listType = "";
     listItems = [];
@@ -1783,7 +1974,7 @@ function markdownToHtml(markdown) {
 
     html.push(
       '<pre style="margin:24px 0;padding:16px;overflow:auto;border-radius:4px;background:#f5f7f8;">' +
-        `<code>${escapeHtml(codeLines.join("\n"))}</code></pre>`
+      `<code>${escapeHtml(codeLines.join("\n"))}</code></pre>`
     );
     inCodeBlock = false;
     codeLines = [];
@@ -1822,18 +2013,18 @@ function markdownToHtml(markdown) {
       "font-size:15px;line-height:1.7;overflow-wrap:anywhere;word-break:break-word;";
     html.push(
       '<div style="width:100%;margin:24px 0;overflow-x:auto;-webkit-overflow-scrolling:touch;">' +
-        '<table style="width:100%;min-width:560px;border-collapse:collapse;table-layout:auto;color:#3f3f3f;">' +
-        `<thead><tr>${header
-          .map(cell => `<th style="${cellStyle}background:#f5f7f8;font-weight:600;">${applyInlineMarkdown(cell)}</th>`)
-          .join("")}</tr></thead>` +
-        `<tbody>${body
-          .map(
-            row =>
-              `<tr>${row
-                .map(cell => `<td style="${cellStyle}">${applyInlineMarkdown(cell)}</td>`)
-                .join("")}</tr>`
-          )
-          .join("")}</tbody></table></div>`
+      '<table style="width:100%;min-width:560px;border-collapse:collapse;table-layout:auto;color:#3f3f3f;">' +
+      `<thead><tr>${header
+        .map(cell => `<th style="${cellStyle}background:#f5f7f8;font-weight:600;">${applyInlineMarkdown(cell)}</th>`)
+        .join("")}</tr></thead>` +
+      `<tbody>${body
+        .map(
+          row =>
+            `<tr>${row
+              .map(cell => `<td style="${cellStyle}">${applyInlineMarkdown(cell)}</td>`)
+              .join("")}</tr>`
+        )
+        .join("")}</tbody></table></div>`
     );
     tableLines = [];
   }
@@ -1896,7 +2087,7 @@ function markdownToHtml(markdown) {
       const headingSize = level === 1 ? 24 : level === 2 ? 20 : 18;
       html.push(
         `<h${level} style="margin:32px 0 16px;font-size:${headingSize}px;line-height:1.5;font-weight:700;color:#24292f;overflow-wrap:anywhere;word-break:break-word;">` +
-          `${applyInlineMarkdown(headingMatch[2].trim())}</h${level}>`
+        `${applyInlineMarkdown(headingMatch[2].trim())}</h${level}>`
       );
       continue;
     }
@@ -2062,6 +2253,23 @@ async function parseArticleFile(file) {
   }
 
   const raw = await fs.promises.readFile(articleFile, "utf8");
+  if (path.extname(articleFile).toLowerCase() === ".html") {
+    const { meta, richHtml } = parseRichArticleUploadFile(raw);
+    return {
+      articleFile,
+      payload: buildRichArticleUploadPayload(meta, richHtml, {
+        normalizeText,
+        normalizeMappedValue,
+        normalizeGameAndCategory,
+        normalizeBoolLike,
+        statusMap: STATUS_MAP,
+        areaMap: AREA_MAP,
+        westLanguages: WEST_ARTICLE_LANGUAGES
+      }),
+      meta,
+      markdown: ""
+    };
+  }
   const parsed = parseFrontMatter(raw);
   return {
     articleFile,
@@ -2094,7 +2302,7 @@ async function initArticleTemplate(file = "article.md", template = "article.md")
   console.log("");
 }
 
-async function importArticleCommand(sourceUrl, file = "article.md", options = {}) {
+async function importArticleCommand(sourceUrl, file = "article.html", options = {}) {
   if (!sourceUrl) {
     throw new Error("缺少文章来源链接，请提供微信公众号文章或飞书 Docx/Wiki 文档链接");
   }
@@ -2124,24 +2332,37 @@ async function importArticleCommand(sourceUrl, file = "article.md", options = {}
     if (options.rulesFile) {
       console.log(chalk.gray(`已加载内容规则: ${contentRules.file}（${contentRules.rules.length} 条）`));
     }
+    const config = await loadConfig();
+    const backendUrl = resolveAuthBackendUrl(options, config);
+    const authState = await requireAuthState(backendUrl);
     article = await importWechatArticle(sourceUrl, {
       contentRules,
       project: options.project,
       platform: options.platform,
+      uploadImage: image => uploadMediaToBackend(image, "image", backendUrl, authState.access_token),
+      uploadVideo: video => uploadMediaToBackend(video, "video", backendUrl, authState.access_token),
       onProgress: ({ mediaType = "image", current, total }) => {
         const label = mediaType === "video" ? "正文视频" : "正文图片";
         console.log(chalk.gray(`正在转存${label} ${current}/${total}`));
       }
     });
   }
-  const output = buildOfficialArticleMarkdown(article);
+  const projectMetadata = importProjectMetadata(options.project);
+  if (projectMetadata) {
+    article = { ...article, ...projectMetadata };
+  }
+  const output = options.format === "html" ? buildImportedArticleHtml(article) : buildOfficialArticleMarkdown(article);
   await ensureDir(path.dirname(targetFile));
   await fs.promises.writeFile(targetFile, output, { encoding: "utf8", flag: "wx" });
 
   console.log("");
-  console.log(chalk.green(`${sourceLabel}已转换为官网文章草稿:`));
+  console.log(chalk.green(`${sourceLabel}已转换为${options.format === "html" ? "HTML 富文本文章" : "官网文章草稿"}:`));
   console.log(targetFile);
   console.log(chalk.gray(`标题: ${article.title}`));
+  const contentSafety = article.contentSafety || analyzeArticleContentSafety(article);
+  for (const warning of contentSafety.warnings) {
+    console.log(chalk.yellow(`内容安全提示: ${warning}`));
+  }
   if (sourceLabel === "飞书文档") {
     console.log(chalk.gray(`已保留图片: ${article.imageCount} 张，表格: ${article.tableCount} 个`));
     console.log(chalk.gray("已保留标题、列表、引用、颜色、高亮、对齐、列宽及合并单元格"));
@@ -2171,7 +2392,13 @@ async function importArticleCommand(sourceUrl, file = "article.md", options = {}
     );
   }
   console.log("");
-  console.log(sourceLabel === "飞书文档" ? "请补充 thumbnail、cate_id 等业务字段，确认内容后执行:" : "请补充 cate_id 等业务字段，确认内容后执行:");
+  console.log(
+    options.format === "html"
+      ? "可直接用于官网或各分发平台，平台规则会在发布时按原有流程处理："
+      : sourceLabel === "飞书文档"
+        ? "请补充 thumbnail、cate_id 等业务字段，确认内容后执行:"
+        : "请补充 cate_id 等业务字段，确认内容后执行:"
+  );
   console.log("");
   console.log(`  qcplay-cli www-article-list.store ${file}`);
   console.log("");
@@ -2234,9 +2461,9 @@ ${chalk.cyan("发布命令：")}
 
   qcplay-cli www-article-list.store article.md
 
-${chalk.cyan("从微信推文生成官网草稿：")}
+${chalk.cyan("从微信推文拉取 HTML 富文本：")}
 
-  qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.md
+  qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.html
 
 ${chalk.cyan("项目默认分类：")}
 
@@ -2260,6 +2487,21 @@ function inferDistributionProject(payload, explicitProject, meta = {}) {
   return "";
 }
 
+function importProjectMetadata(project) {
+  const normalizedProject = normalizeText(project);
+  if (!normalizedProject) return null;
+  const gameId = normalizeMappedValue(normalizedProject, GAME_MAP);
+  const game = gameCatalogEntry(gameId);
+  if (!game) {
+    throw new Error(`未知项目: ${normalizedProject}`);
+  }
+  return {
+    gameId,
+    categoryId: game.defaultCategory,
+    distributionProject: normalizedProject
+  };
+}
+
 function printPlatformEntries(entries) {
   console.log("");
   console.log(chalk.cyan("可用发布平台:"));
@@ -2307,9 +2549,25 @@ async function publishPlatformsCommand(file, options) {
     throw new Error("缺少文章文件，例如：qcplay-cli publish article.md --platform TapTap");
   }
 
-  const selectedEntries = options.platforms.length
+  let selectedEntries = options.platforms.length
     ? selectRequestedEntries(candidates, options.platforms)
     : await promptForPlatformEntries(candidates);
+  if (options.draftOnly) {
+    selectedEntries = selectedEntries.filter(entry => entry.platformKey !== "website");
+    if (selectedEntries.length === 0) {
+      throw new Error("--draft-only 仅适用于官网之外的游戏平台");
+    }
+  }
+  if (options.draftOnly && options.publishDraft) {
+    throw new Error("--draft-only 与 --publish-draft 不能同时使用");
+  }
+  const needsActionSelection =
+    !options.dryRun &&
+    !options.openPage &&
+    !options.switchAccount &&
+    !options.draftOnly &&
+    !(options.publishDraft && options.confirmed) &&
+    !(options.directPublish && options.confirmed);
   if (options.openPage) {
     if (selectedEntries.some(entry => entry.publisher !== "browser")) {
       throw new Error("--open-page 仅支持有真实浏览器发布页的平台，请使用 --platform 指定浏览器平台");
@@ -2359,8 +2617,11 @@ async function publishPlatformsCommand(file, options) {
     const matchedRules = matchingContentRules(contentRules, planningArticle, entry).map(rule => rule.name);
     return {
       ...publicEntrySummary(entry),
+      ...(options.draftOnly ? { mode: "draft-only" } : {}),
       ...(matchedRules.length > 0 ? { contentRules: matchedRules } : {}),
-      ...(entry.platformKey === "taptap" ? { taptap: tapTapPublishingPlan(planningArticle, entry) } : {}),
+      ...(entry.platformKey === "taptap"
+        ? { taptap: { ...tapTapPublishingPlan(planningArticle, entry), ...(options.draftOnly ? { draft: true } : {}) } }
+        : {}),
       ...(entry.platformKey === "bilibili" ? { bilibili: bilibiliPublishingPlan(planningArticle, entry) } : {}),
       ...(entry.platformKey === "weibo" ? { weibo: weiboPublishingPlan(planningArticle, entry) } : {})
     };
@@ -2379,7 +2640,17 @@ async function publishPlatformsCommand(file, options) {
     meta: parsedArticle.meta,
     platformInputs
   };
-  const { successes, failures, skipped } = await runPlatformPublishSequence(selected, async entry => {
+  const contentSafety = analyzeArticleContentSafety(article);
+  for (const warning of contentSafety.warnings) {
+    console.log(chalk.yellow(`内容安全提示: ${warning}`));
+  }
+  const browserEntries = selected.filter(entry => entry.publisher === "browser");
+  // Each browser platform needs its own explicit AI-conversation authorisation.
+  // Preparing every selected editor before asking keeps the user waiting behind
+  // long image uploads on later platforms and leaves no safe action boundary.
+  const executionEntries = needsActionSelection ? browserEntries.slice(0, 1) : selected;
+  const pendingApprovalEntries = needsActionSelection ? browserEntries.slice(1) : [];
+  const { successes, failures, skipped } = await runPlatformPublishSequence(executionEntries, async entry => {
     console.log("");
     console.log(chalk.cyan(`正在发布到 ${entry.platform}（${entry.region}）...`));
     let result;
@@ -2388,12 +2659,34 @@ async function publishPlatformsCommand(file, options) {
     } else {
       result = await publishPlatformEntry(entry, article, {
         browserChannel: options.browserChannel,
-        reviewDraft: options.reviewDraft,
+        reviewDraft: needsActionSelection || options.reviewDraft,
+        // A review is always approved in the current AI conversation. Never
+        // fall back to the legacy terminal confirmation path.
+        awaitAIAction: needsActionSelection || options.reviewDraft,
+        // The initial AI-authorisation preview prepares the complete native
+        // editor draft, including body media. It still never clicks save or
+        // publish; only the later explicit action may submit it. A platform
+        // must not reach the action selection while any image is still
+        // uploading, including editors that expose their fields after upload.
+        previewTextOnly: false,
+        directPublish: options.directPublish && options.confirmed,
+        draftOnly: options.draftOnly,
+        publishDraft: options.publishDraft,
         keepOpen: options.keepOpen,
         onProgress: message => console.log(chalk.gray(`  ${message}`))
       });
-      if (entry.platformKey === "taptap" && result?.status === "draft") {
-        console.log(chalk.green("TapTap 草稿已保存"));
+      if (result?.status === "draft") {
+        console.log(chalk.green(`${entry.platform} 草稿已保存，浏览器保持打开`));
+        if (result.approvalRequired) {
+          console.log(
+            JSON.stringify({
+              event: "qcplay.draft-approval-required",
+              platform: entry.platform,
+              title: article.title,
+              actions: result.approvalActions || ["publish", "cancel"]
+            })
+          );
+        }
         return result;
       }
       if (entry.platformKey === "taptap" && result?.status === "scheduled") {
@@ -2407,6 +2700,42 @@ async function publishPlatformsCommand(file, options) {
   failures.forEach(({ entry, error }) => {
     console.error(chalk.red(`${entry.platform} 发布失败: ${error.message || error}`));
   });
+
+  if (needsActionSelection) {
+    if (failures.length > 0) {
+      throw new Error("待授权预览准备失败，请根据上面的错误处理后重试失败平台");
+    }
+    const pages = successes
+      .map(({ entry, result }) => ({ platform: entry.platform, url: result?.url || "" }))
+      .filter(item => item.url);
+    const previewResults = successes.map(({ result }) => result || {});
+    const imagesPending = previewResults.reduce((sum, result) => sum + Number(result.imagesPending || 0), 0);
+    const requiresMediaBeforeText = previewResults.some(result => result.requiresMediaBeforeText);
+    const contentPrepared = previewResults.every(result => result.contentPrepared !== false) && imagesPending === 0;
+    if (!contentPrepared || requiresMediaBeforeText) {
+      throw new Error("编辑器尚未完成正文或图片回读校验，暂不提供发布授权选项");
+    }
+    console.log(
+      JSON.stringify({
+        event: "qcplay.publish-action-required",
+        title: previewResults.find(result => normalizeText(result.title))?.title || article.title,
+        platforms: executionEntries.map(entry => entry.platform),
+        ...(pendingApprovalEntries.length > 0
+          ? { pendingPlatforms: pendingApprovalEntries.map(entry => entry.platform) }
+          : {}),
+        pages,
+        contentPrepared,
+        imagesPending,
+        actions: ["publish", "save_draft", "cancel"]
+      })
+    );
+    return;
+  }
+
+  const urlsFile = await writePlatformPublishUrls(file, successes);
+  if (urlsFile) {
+    console.log(chalk.green(`平台地址已写入: ${urlsFile}`));
+  }
   if (skipped.length > 0) {
     console.error(chalk.yellow("已停止后续平台发布，请先处理当前浏览器平台的登录或页面问题。"));
   }
@@ -2543,11 +2872,20 @@ async function updateArticleStatusCommand(articleIdValue, targetStatus, options,
 
   const response = await authenticatedRequest("PATCH", backendUrl, articleApiPath(target, "status"), payload);
   const responseStatus = normalizeText(response.data?.status) || targetStatus;
+  const recentState = await readJson(ARTICLE_STATE_FILE);
+  const recentStateMatches =
+    String(recentState.article_id || "") === String(articleId) &&
+    (recentState.target || "domestic") === target;
+  const previewPayload = recentStateMatches
+    ? { game_id: recentState.game_id, cate_id: recentState.cate_id }
+    : {};
   const previewUrl =
     responseStatus === "1"
-      ? normalizeText(response.data?.preview_url) || (target === "domestic" ? articlePreviewUrl(articleId) : "")
+      ? normalizeText(response.data?.preview_url) ||
+      (recentStateMatches ? normalizeText(recentState.preview_url) : "") ||
+      (target === "domestic" ? articlePreviewUrl(articleId, previewPayload) : "")
       : "";
-  const stateWarning = await trySaveRecentArticleState(articleId, responseStatus, backendUrl, previewUrl, target);
+  const stateWarning = await trySaveRecentArticleState(articleId, responseStatus, backendUrl, previewUrl, target, previewPayload);
 
   console.log(chalk.green(response.message || (responseStatus === "2" ? "文章已删除" : "文章已上线")));
   console.log(`文章 ID: ${articleId}`);
@@ -2636,6 +2974,26 @@ async function main() {
     return;
   }
 
+  if (command === "wechat") {
+    if (!subcommand || subcommand === "-h" || subcommand === "--help") {
+      printWechatHelp();
+      return;
+    }
+    if (subcommand !== "article") {
+      await runWithErrorBanner("微信公众号数据失败", async () => {
+        throw new Error(`未知 wechat 命令: ${subcommand}`);
+      });
+      return;
+    }
+    if (rest.includes("-h") || rest.includes("--help")) {
+      printWechatHelp();
+      return;
+    }
+    const parsed = parseWechatArticleOptions(rest);
+    await runWithErrorBanner("微信公众号数据失败", () => importWechatDataCommand(parsed));
+    return;
+  }
+
   if (command === "article") {
     if (!subcommand || subcommand === "-h" || subcommand === "--help") {
       if (!subcommand) {
@@ -2659,6 +3017,10 @@ async function main() {
     }
 
     if (subcommand === "import") {
+      if (rest.length === 1 && ["--help", "-h"].includes(rest[0])) {
+        printArticleHelp();
+        return;
+      }
       const parsed = parseArticleImportOptions(rest);
       await runWithErrorBanner("转换失败", () =>
         importArticleCommand(parsed.sourceUrl, parsed.file, parsed.options)