@qcplay/cli 1.0.18 → 1.0.20

package/bin/qcplay.js

@@ -10,12 +10,15 @@ import readline from "readline";
 import { fileURLToPath, pathToFileURL } from "url";
 
 import {
+  analyzeArticleContentSafety,
+  buildImportedArticleHtml,
   buildOfficialArticleMarkdown,
   importWechatArticle,
   normalizeArticleColor,
   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,
@@ -24,9 +27,19 @@ 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,
+  editPreparedPlatformPage,
   entriesForProject,
   loadPlatformEntries,
   openPublishPage,
@@ -37,7 +50,11 @@ import {
   runPlatformPublishSequence,
   selectRequestedEntries,
   tapTapPublishingPlan,
-  weiboPublishingPlan
+  deleteDiscordMessages,
+  findDiscordMessageRecord,
+  removeDiscordMessageRecord,
+  weiboPublishingPlan,
+  writePlatformPublishUrls
 } from "../lib/platform-publish.js";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -171,8 +188,10 @@ 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",
   "50": "https://mtzg.qingcijoy.com/news-details.html",
   "69": "https://hjwq.qingcijoy.com/news-details.html",
   "74": "https://sakura.qingcijoy.com/news-details.html",
@@ -226,12 +245,15 @@ 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 <平台>] [--backend <url>] [--local]
+  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 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]
@@ -253,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>]");
@@ -264,22 +294,105 @@ 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 <项目>] [--backend <url>] [--local]
+  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: "", backend: undefined, local: false };
+  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" || current === "--backend") {
+    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} 缺少参数值`);
-      const key = current === "--rules-file" ? "rulesFile" : current === "--project" ? "project" : current === "--platform" ? "platform" : "backend";
-      options[key] = 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;
     }
@@ -291,7 +404,14 @@ function parseArticleImportOptions(args) {
     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() {
@@ -311,8 +431,10 @@ Options:
   --config-file <json>      使用本地平台配置（主要用于测试）
   --rules-file <json>       使用指定内容规则；默认 ~/.qcplay/platform-rules.json
   --browser-channel <name>  Playwright 浏览器通道，Windows 默认 msedge
-  --review-draft, --review  官网外平台先准备草稿，预览后在 CMD 确认发布
-  --direct, --no-review     用户已确认内容时跳过发布前二次预览确认
+  --review-draft, --review  官网外平台先准备草稿，预览后由当前 AI 对话确认发布
+  --direct, --no-review     需配合 AI 对话确认标记后才可跳过发布前预览
+  --publish-draft           仅 TapTap：发布标题匹配的已有草稿，不重新写入内容
+  --draft-only, --draft     仅保存或停留在官网外平台草稿，不执行正式发布
   --open-page               只打开真实浏览器发布页，供登录和页面流程测试，不读取或提交文章
   --switch-account          先打开发布页切换账号，确认后继续当前发布流程
   --keep-open               浏览器提交后等待用户确认再关闭
@@ -378,6 +500,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);
@@ -430,7 +602,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]");
@@ -442,6 +614,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() {
@@ -583,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",
@@ -814,6 +1008,9 @@ function parseDistributionOptions(args) {
     browserChannel: "",
     reviewDraft: false,
     directPublish: false,
+    confirmed: false,
+    draftOnly: false,
+    publishDraft: false,
     keepOpen: false,
     openPage: false,
     switchAccount: false,
@@ -857,6 +1054,18 @@ function parseDistributionOptions(args) {
       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"],
@@ -904,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);
@@ -921,11 +1263,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 } : {})
   };
@@ -1003,7 +1345,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];
@@ -1029,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, {
@@ -1047,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);
@@ -1344,7 +1697,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,
@@ -1354,13 +1707,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);
@@ -1497,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)}`);
@@ -1504,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}`));
@@ -1553,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 更新完成"));
@@ -1562,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("");
@@ -1701,14 +2060,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>`
     );
   });
 
@@ -1754,7 +2113,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 = [];
   }
@@ -1766,9 +2125,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 = [];
   }
@@ -1782,7 +2141,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 = [];
@@ -1795,7 +2154,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 = [];
@@ -1834,18 +2193,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 = [];
   }
@@ -1908,7 +2267,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;
     }
@@ -2074,6 +2433,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,
@@ -2106,7 +2482,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 文档链接");
   }
@@ -2151,14 +2527,22 @@ async function importArticleCommand(sourceUrl, file = "article.md", options = {}
       }
     });
   }
-  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("已保留标题、列表、引用、颜色、高亮、对齐、列宽及合并单元格"));
@@ -2188,7 +2572,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("");
@@ -2251,9 +2641,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("项目默认分类：")}
 
@@ -2277,6 +2667,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("可用发布平台:"));
@@ -2324,9 +2729,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 指定浏览器平台");
@@ -2376,8 +2797,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) } : {})
     };
@@ -2396,7 +2820,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;
@@ -2405,13 +2839,34 @@ async function publishPlatformsCommand(file, options) {
     } else {
       result = await publishPlatformEntry(entry, article, {
         browserChannel: options.browserChannel,
-        reviewDraft: options.reviewDraft,
-        directPublish: options.directPublish,
+        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") {
@@ -2425,6 +2880,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("已停止后续平台发布，请先处理当前浏览器平台的登录或页面问题。"));
   }
@@ -2442,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");
@@ -2561,11 +3075,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}`);
@@ -2639,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();
@@ -2654,6 +3203,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) {
@@ -2677,6 +3246,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)