@qcplay/cli 1.0.12 → 1.0.14

package/README.md

@@ -11,6 +11,7 @@
 - 登录凭证保存在当前用户本机的 `~/.qcplay/auth.json`，不同客户端之间不共享账号
 - 状态、权限和文章请求通过 Bearer Token 识别当前账号
 - `qcplay-cli article import <微信文章链接> [文件]` 会提取正文、转存图片并生成未发布的官网文章草稿
+- `qcplay-cli publish <文件>` 会按项目、区域和平台把文章分发到多个渠道
 - `qcplay-cli update` 会更新 npm 全局包，并同步 `~/.agents/skills`
 - 本地调试时可直接使用 `--local`
 - `--local` 默认指向 `http://127.0.0.1:8787`
@@ -18,7 +19,113 @@
 - 如果本地域名不是 `127.0.0.1:8787`，可设置 `QCPLAY_LOCAL_BASE_URL=http://cli.local.test`
 - 安装说明：仓库根目录的 `cli-installation-guide.md`
 
-## 微信文章转官网草稿
+## 多平台分发
+
+平台配置默认从飞书 Wiki“内容一键分发信息表”实时读取，账号、密码和 webhook 不会写入项目文件，也不会出现在 dry-run 或平台列表中。首次使用需要当前用户已通过 `lark-cli` 授予 `wiki:node:retrieve` 和 `sheets:spreadsheet:read` 只读权限。
+
+查看某个项目可用的平台：
+
+```bash
+qcplay-cli publish --project 最强蜗牛 --list-platforms
+```
+
+指定一个或多个平台：
+
+```bash
+qcplay-cli publish article.md --project 最强蜗牛 --region 国内 --platform TapTap --platform B站
+qcplay-cli publish article.md --project 最强蜗牛 --region 欧美 --platform Discord
+```
+
+不传 `--platform` 时，交互终端会列出匹配的平台供选择；CI 等非交互环境会报错并提示可用平台。`game_id: "39"` 可自动推断项目为“最强蜗牛”。发布前可检查脱敏计划：
+
+```bash
+qcplay-cli publish article.md --project 最强蜗牛 --region 国内 --platform TapTap --dry-run
+```
+
+官网外的浏览器平台可在最终提交前暂停，先在浏览器中预览已填好的内容：
+
+```bash
+qcplay-cli publish article.md --project 最强蜗牛 --region 国内 --platform TapTap --review-draft
+```
+
+默认仍按原流程直接发布。使用 `--review-draft`（简写 `--review`）时，CLI 会完成标题、富文本、图片、封面和发布设置后保持浏览器打开；确认无误后在 CMD 输入“可以发布”“发布”或直接按 Enter，输入“取消”则停止且不点击最终发布。官网发布流程不受该参数影响。好游快爆没有可复用的原生草稿箱，因此会保持当前编辑页供预览。
+
+发布方式：
+
+- 官网继续使用现有 QCPlay API，并保持“先保存未上线草稿、用户预览后再上线”的原逻辑。
+- 配置了 webhook 的 Discord 使用 API 分发，长内容自动拆分且禁用 `@everyone` 等自动提及。
+- TapTap、好游快爆、B站、微博、X、Facebook/Instagram 使用可见的本机 Edge/Chrome 和独立持久登录态。TapTap、好游快爆、B站和微博的账号密码配置会在加载后丢弃；未登录时由用户在浏览器中自行填写登录信息或扫码，CLI 不会向登录页写入账号密码，也不会点击登录提交。验证码、二次验证和页面反爬验证同样由用户完成，不绕过平台验证。
+- 已存在有效登录态时，CLI 会等待发布编辑器加载完成并直接填充内容，不再重复提示登录；只有明确进入登录页或检测不到有效会话时才进入登录流程。
+- 多个浏览器平台按顺序处理：当前平台需要扫码或验证时会停留等待，当前浏览器平台失败时停止后续平台，避免跳过登录继续发布。
+- 图片和视频必须确认上传或处理完成后才能提交；上传失败或超过有限等待时间会停止当前平台，避免发布按钮卡死或提交不完整内容。
+- 好游快爆只使用飞书配置中当前游戏对应的 `bbs.3839.com` 发布链接，并保留有效 `fid`；例如最强蜗牛使用 `fid=12201`，缺失或为 `0` 会直接停止。未登录时先进入官网首页并点击头像登录，在官方 iframe 中完成登录；登录成功后最多重试 3 次返回原游戏发布页，不会改用其他游戏或通用链接。
+- 好游快爆新版发帖页使用 `#threadTitle` 可编辑标题、Quill `.ql-editor` 正文和 `.editSubmit.active` 发布控件。CLI 会忽略 Quill 对空白和换行的重排，连续回读确认内容稳定；标题超过 48 字、正文仍为空或发布控件不可用时停止。点击发布后只有 `setThread` 接口返回 `code: 100`、出现成功提示或跳转到论坛/帖子页才判定成功；没有成功回执时会报错，并保留浏览器窗口供检查后再关闭。
+- Reddit 配置明确提示非官方工具存在封号风险；未配置官方 Reddit 应用时，CLI 会拒绝自动发布。
+- 配置缺少发布 URL、webhook 或适配器的平台会明确报错，不伪造成功结果。
+
+### TapTap 发布设置
+
+TapTap 文章默认按“长帖”发布。需要图文、视频、论坛、定时或草稿时，在文章 Front Matter 中增加对应字段；发布命令仍然只传文章文件：
+
+```yaml
+taptap_type: long-post       # long-post、image-text、video
+taptap_forum: ""             # 留空默认使用项目同名论坛；填 0 不添加论坛
+taptap_scheduled: "1"       # 勾选定时发布，具体时间可在打开的页面确认
+taptap_draft: "0"           # 1 保存草稿，0 正式提交
+taptap_images: image-1.png,image-2.png
+taptap_video: ./video.mp4
+taptap_cover: ./cover.png
+```
+
+- 图文至少需要 1 张图片、最多 18 张；未设置 `taptap_images` 时会依次使用正文图片，正文无图片时使用 `thumbnail`。
+- 视频必须使用 `taptap_video` 指向本地文件，远程 `video_link` 不能直接交给 TapTap 的文件上传控件。
+- `taptap_scheduled` 与 `taptap_draft` 不能同时启用。
+- 添加论坛时会依次点击搜索建议和精确同名论坛结果行，再执行“返回 → 完成”；“完成”仍为 CSS 禁用状态、弹窗未关闭或主页面未回读到论坛时都不会继续发布。已选中同名论坛时不会重复点击反选。
+- 长帖标题最多 30 个字符；图文标题最多 20 个字符、正文最多 5000 个字符。超过限制会停止并提示修改，不会静默截断。
+- 长帖正文按原文顺序写入：普通文字和 `http/https` 超链接使用 TapTap 富文本粘贴，图片会先下载，再通过 TapTap 官方正文图片控件上传。不会再把图片降级为 URL 文本，链接会保留为可点击跳转。
+- Markdown 会先转换为富文本；TapTap 支持的标题强调、段落间距、有序/无序列表、引用、粗体、斜体、下划线和删除线会保留。原内容中的对齐和颜色也会传入，但最终效果以 TapTap 编辑器支持范围为准。
+- 图文模式的正文图片仍按 TapTap 规则进入顶部图片区；正文中的超链接保留为可点击链接。视频模式同样保留正文超链接。
+- CLI 会在填写后回读标题和正文，精确点击编辑器页脚的发布/草稿按钮，并等待成功提示、页面跳转或发布接口成功响应。未检测到回执时按失败处理，不会输出成功。
+- TapTap 编辑器的自动保存请求不会被拦截，但正式发布时不会把自动草稿创建/更新误判为成功；CLI 会继续等待正式发布接口成功后才关闭浏览器。显式设置 `taptap_draft: "1"` 时才以草稿保存回执结束流程。
+- 自动化测试使用模拟浏览器；真实编辑器的格式探测必须在断网后进行，禁止保存或发布测试图片草稿。
+
+### 微博发布设置
+
+微博使用头条文章编辑器发布富文本文章，而不是首页的短微博发送框：
+
+```yaml
+weibo_intro: ""               # 可选；留空使用 article_excerpt，最多 44 字
+weibo_cover: ""               # 可选；必须引用正文图片，留空默认使用正文第 1 张图
+```
+
+- 文章标题独立写入头条文章标题框，最多 32 个字符；正文写入 Tiptap/ProseMirror 富文本编辑器。
+- 草稿箱为空时，CLI 会先点击“写文章”，等待新草稿 ID 生成且编辑器遮罩消失，再重写标题、导语和正文；导语为空时也会主动清除旧值。
+- 正文标题、段落、列表、引用、粗体、斜体、下划线、删除线和 `http/https` 超链接会在编辑器支持范围内保留。
+- 正文图片按原文位置和顺序执行“图片库 → 上传完成 → 选中 `.image-list .image-item` 缩略图 → 等待 `is-selected` → 插入”。首次打开图片库时，CLI 会通过 `.ico_delpic` 逐张删除既有图片并等待缩略图消失，再上传本次文章图片；后续打开不再清理，因此发布结束时图片库只保留本次文章使用的图片。同一图片地址重复出现时只保留首次出现的一张。出现裁剪对话框时会等待裁剪区域连续稳定，再确认并验证弹窗关闭。
+- 正文含图片时，CLI 会在发布设置中进入“正文图片”，选择 `weibo_cover` 指定的正文图；未指定时选择第 1 张，并完成“下一步 → 图片裁剪 → 确定”。选图和裁剪弹窗按当前可见文本动态定位，避免前一个弹窗关闭后 DOM 下标变化导致等待失效；若首次确认无响应或微博提示“图片处理失败”，会自动重试一次。封面没有回显时不会继续发布。
+- 封面确认并回显后，CLI 立即按“下一步 → 发布”完成投稿。只有检测到发布接口、成功提示或发布历史页面跳转的成功回执时才报告成功。
+
+### B站投稿设置
+
+B站默认按专栏图文发布；视频投稿通过 Front Matter 切换到官方视频投稿页：
+
+```yaml
+bilibili_type: article       # article（专栏图文）或 video（视频投稿）
+bilibili_video: ./video.mp4  # 视频投稿必须是本地文件
+bilibili_cover: ./cover.png
+bilibili_category: 游戏/手机游戏
+bilibili_tags: 最强蜗牛,攻略
+bilibili_topic: 最强蜗牛攻略
+```
+
+- 专栏正文会转换成富文本，在编辑器支持范围内保留标题、段落、列表、引用、粗体、斜体、下划线、删除线、颜色和对齐。
+- 正文图片按原文位置通过 B站官方图片控件上传；`http/https` 链接保留为可点击超链接。图片、文字或链接回读不完整时会停止投稿。
+- 视频必须使用 `bilibili_video` 指向本地文件，文件需小于 16GB；建议使用 MP4、MOV 或 MKV。CLI 会先上传视频，等待稿件表单出现后再填写标题和简介。
+- 视频简介不提供专栏富文本能力；带文字的超链接会转换为“文字（URL）”，使目标地址不丢失。
+- `bilibili_category` 可用 `/` 表示多级分区，`bilibili_tags` 最多 10 个。填写 `bilibili_topic` 后会搜索并选择精确同名话题；找不到时停止投稿，不会引用相似话题。
+- 只有检测到 B站成功提示、投稿后页面跳转或成功接口回执时才报告成功；仅点击投稿按钮不算成功。
+
+## 微信或飞书文章转官网草稿
 
 ```bash
 qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.md
@@ -26,19 +133,27 @@ qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.md
 
 转换流程会读取微信文章标题、来源、发布日期和完整正文，经过安全清理后保留微信原文的 HTML 层级、内联样式、字号、颜色、对齐、间距、媒体链接和表格，并转存正文图片、CSS 背景图及封面图。背景图片仍保留在原容器中，不会额外生成一张普通图片。正文保持微信的 `677px` 阅读宽度并兼容窄屏；独占一行的图片会使用块级布局，纯图片标题容器会转换为普通区块，避免官网 PC 标题样式造成相邻图片重叠。任何正文节点遗漏或图片处理失败都会终止转换，不生成不完整草稿。输出固定为 `status: "0"`，并保留空的 `cate_id` 供发布前确认。
 
+飞书 Docx/Wiki 文档使用同一命令：
+
+```bash
+qcplay-cli article import "https://tenant.feishu.cn/wiki/..." article.md
+```
+
+飞书来源会读取完整 XML 块结构，而不是有损的 Markdown 导出；标题层级、粗体/斜体、文字颜色、背景高亮、段落对齐、引用、编号列表、链接、表格列宽和合并单元格会转换为安全富文本。宽表格保持原列宽并在窄屏横向滚动。导入仍固定生成未上线草稿，缩略图和业务字段需在发布前确认。
+
 确认草稿内容和业务字段后保存为未上线文章：
 
 ```bash
 qcplay-cli www-article-list.store article.md
 ```
 
-保存成功后，CLI 会输出文章 ID、`未上线` 状态和可点击的排版预览地址：
+保存成功后，CLI 会输出文章 ID、`未上线` 状态和可点击的排版预览地址，并自动在浏览器中打开该页面：
 
 ```text
 https://snail.qingcigame.com/official/news-details.html?id=<文章ID>
 ```
 
-检查 PC 和移动端排版无误后再上线。ID 可以省略，此时只使用当前账号最近一次保存的未上线文章：
+文章内容和排版只由用户在打开的预览页面中检查，CLI 或 AI 不自动抓取、分析或判断预览内容。用户明确确认无误后再上线。ID 可以省略，此时只使用当前账号最近一次保存的未上线文章：
 
 ```bash
 qcplay-cli article update [id]

package/bin/qcplay.js

@@ -15,6 +15,20 @@ import {
   normalizeArticleColor,
   sanitizeArticleRichHtml
 } from "../lib/wechat-article.js";
+import { importLarkArticle, parseLarkDocumentUrl } from "../lib/lark-article.js";
+import {
+  availableProjects,
+  bilibiliPublishingPlan,
+  entriesForProject,
+  loadPlatformEntries,
+  promptForPlatformEntries,
+  publicEntrySummary,
+  publishPlatformEntry,
+  runPlatformPublishSequence,
+  selectRequestedEntries,
+  tapTapPublishingPlan,
+  weiboPublishingPlan
+} from "../lib/platform-publish.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -149,10 +163,12 @@ Usage:
   qcplay-cli auth permissions [--local] [--key <key>] [--json]
   qcplay-cli article
   qcplay-cli article init [file]
-  qcplay-cli article import <wechat-url> [file]
+  qcplay-cli article import <wechat-or-feishu-url> [file]
   qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]
   qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]
+  qcplay-cli publish [file] [--project <项目>] [--region <区域>] [--platform <平台>]
+  qcplay-cli publish --project <项目> --list-platforms
   qcplay-cli www-article-list.store <file> [--local] [--backend <url>] [--dry-run]
   qcplay-cli www-article-list.update [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli www-article-list.delete [id] [--local] [--backend <url>] [--dry-run]
@@ -180,12 +196,51 @@ function printArticleHelp() {
   console.log(`Usage:
   qcplay-cli article
   qcplay-cli article init [file]
-  qcplay-cli article import <wechat-url> [file]
+  qcplay-cli article import <wechat-or-feishu-url> [file]
   qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]
   qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]`);
 }
 
+function printPublishHelp() {
+  console.log(`Usage:
+  qcplay-cli publish <file> --project <项目> [--region <区域>] [--platform <平台> ...]
+  qcplay-cli publish --project <项目> [--region <区域>] --list-platforms
+
+Options:
+  --project <项目>          项目名称；game_id=39 时默认使用“最强蜗牛”
+  --region <区域>           国内、日本、欧美等区域
+  -p, --platform <平台>     发布平台，可重复使用或用逗号分隔
+  --list-platforms          列出匹配的平台，不发布
+  --config-file <json>      使用本地平台配置（主要用于测试）
+  --browser-channel <name>  Playwright 浏览器通道，Windows 默认 msedge
+  --review-draft, --review  官网外平台先准备草稿，预览后在 CMD 确认发布
+  --keep-open               浏览器提交后等待用户确认再关闭
+  --dry-run                 只展示发布计划，不登录或发布
+  --local                   官网发布使用本地后端
+  --backend <url>           官网发布后端地址
+
+TapTap Front Matter:
+  taptap_type               long-post（默认）、image-text 或 video
+  taptap_forum              默认使用当前项目同名论坛；填 0 时不添加论坛
+  taptap_scheduled          填 1 时勾选定时发布
+  taptap_draft              填 1 时保存草稿而非发布
+  taptap_images             图文图片路径或 URL，多个用逗号分隔
+  taptap_video              视频模式使用的本地视频路径
+  taptap_cover              长帖封面路径或 URL
+
+B站 Front Matter:
+  bilibili_type             article（默认）或 video
+  bilibili_video            视频投稿使用的本地视频路径
+  bilibili_cover            投稿封面本地路径或 URL
+  bilibili_category         投稿分区，可用“一级/二级”表示层级
+  bilibili_tags             投稿标签，多个用逗号分隔
+  bilibili_topic            投稿话题；填写后搜索并选择精确同名话题
+
+微博 Front Matter:
+  weibo_intro               头条文章导语，最多 44 个字符；默认使用 article_excerpt`);
+}
+
 function printFeatures() {
   console.log("");
   console.log(chalk.green("你现在可以使用以下功能:"));
@@ -199,12 +254,16 @@ 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.md");
   console.log("   qcplay-cli www-article-list.store article.md");
   console.log("   qcplay-cli article update [id]");
   console.log("   qcplay-cli article delete [id]");
   console.log("");
-  console.log(chalk.cyan("4. 查看本地目录"));
+  console.log(chalk.cyan("4. 多平台分发"));
+  console.log("   qcplay-cli publish article.md --project 最强蜗牛");
+  console.log("   qcplay-cli publish --project 最强蜗牛 --list-platforms");
+  console.log("");
+  console.log(chalk.cyan("5. 查看本地目录"));
   console.log("   qcplay-cli where");
   console.log("");
 }
@@ -517,6 +576,84 @@ function parsePublishOptions(args) {
   };
 }
 
+function parseDistributionOptions(args) {
+  const options = {
+    backend: undefined,
+    local: false,
+    dryRun: false,
+    project: "",
+    region: "",
+    platforms: [],
+    listPlatforms: false,
+    configFile: "",
+    browserChannel: "",
+    reviewDraft: false,
+    keepOpen: false
+  };
+  const positional = [];
+
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    if (current === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+    if (current === "--local") {
+      options.local = true;
+      continue;
+    }
+    if (current === "--list-platforms") {
+      options.listPlatforms = true;
+      continue;
+    }
+    if (current === "--keep-open") {
+      options.keepOpen = true;
+      continue;
+    }
+    if (current === "--review-draft" || current === "--review") {
+      options.reviewDraft = true;
+      continue;
+    }
+
+    const valueFlags = new Map([
+      ["--backend", "backend"],
+      ["--project", "project"],
+      ["--region", "region"],
+      ["--config-file", "configFile"],
+      ["--browser-channel", "browserChannel"]
+    ]);
+    if (valueFlags.has(current)) {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) {
+        throw new Error(`${current} 缺少参数值`);
+      }
+      options[valueFlags.get(current)] = next;
+      index += 1;
+      continue;
+    }
+
+    if (current === "--platform" || current === "-p") {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) {
+        throw new Error(`${current} 缺少参数值`);
+      }
+      options.platforms.push(...next.split(/[,，]/).map(value => value.trim()).filter(Boolean));
+      index += 1;
+      continue;
+    }
+
+    if (current.startsWith("--")) {
+      throw new Error(`未知参数: ${current}`);
+    }
+    positional.push(current);
+  }
+
+  if (positional.length > 1) {
+    throw new Error(`未知参数: ${positional.slice(1).join(" ")}`);
+  }
+  return { file: positional[0], options };
+}
+
 function parseArticleMutationOptions(args) {
   const parsed = parsePublishOptions(args);
   return {
@@ -602,9 +739,11 @@ function openBrowser(targetUrl) {
       stdio: "ignore"
     });
 
-    child.on("error", reject);
-    child.unref();
-    resolve();
+    child.once("error", reject);
+    child.once("spawn", () => {
+      child.unref();
+      resolve();
+    });
   });
 }
 
@@ -1624,7 +1763,9 @@ async function parseArticleFile(file) {
   const parsed = parseFrontMatter(raw);
   return {
     articleFile,
-    payload: normalizeArticlePayload(parsed.meta, parsed.content)
+    payload: normalizeArticlePayload(parsed.meta, parsed.content),
+    meta: parsed.meta,
+    markdown: parsed.content
   };
 }
 
@@ -1651,9 +1792,9 @@ async function initArticleTemplate(file = "article.md") {
   console.log("");
 }
 
-async function importWechatArticleCommand(sourceUrl, file = "article.md") {
+async function importArticleCommand(sourceUrl, file = "article.md") {
   if (!sourceUrl) {
-    throw new Error("缺少微信文章链接，例如：qcplay-cli article import https://mp.weixin.qq.com/s/... article.md");
+    throw new Error("缺少文章来源链接，请提供微信公众号文章或飞书 Docx/Wiki 文档链接");
   }
 
   const targetFile = path.resolve(process.cwd(), file);
@@ -1662,30 +1803,48 @@ async function importWechatArticleCommand(sourceUrl, file = "article.md") {
   }
 
   console.log("");
-  console.log(chalk.cyan("正在获取微信文章..."));
-  const article = await importWechatArticle(sourceUrl, {
-    onProgress: ({ current, total }) => {
-      console.log(chalk.gray(`正在转存正文图片 ${current}/${total}`));
+  let article;
+  let sourceLabel;
+  try {
+    parseLarkDocumentUrl(sourceUrl);
+    sourceLabel = "飞书文档";
+    console.log(chalk.cyan("正在获取飞书文档完整格式..."));
+    article = await importLarkArticle(sourceUrl);
+  } catch (larkError) {
+    if (!/飞书文档链接无效|仅支持飞书 Docx 或 Wiki 文档链接/.test(larkError.message)) {
+      throw larkError;
     }
-  });
+    sourceLabel = "微信文章";
+    console.log(chalk.cyan("正在获取微信文章..."));
+    article = await importWechatArticle(sourceUrl, {
+      onProgress: ({ current, total }) => {
+        console.log(chalk.gray(`正在转存正文图片 ${current}/${total}`));
+      }
+    });
+  }
   const output = buildOfficialArticleMarkdown(article);
   await ensureDir(path.dirname(targetFile));
   await fs.promises.writeFile(targetFile, output, { encoding: "utf8", flag: "wx" });
 
   console.log("");
-  console.log(chalk.green("微信文章已转换为官网文章草稿:"));
+  console.log(chalk.green(`${sourceLabel}已转换为官网文章草稿:`));
   console.log(targetFile);
   console.log(chalk.gray(`标题: ${article.title}`));
-  console.log(chalk.gray(`已转存图片: ${article.imageCount} 张`));
-  console.log(chalk.gray(`已提取正文: ${article.textSegmentCount} 段`));
-  console.log(chalk.gray(`已保留文字颜色: ${article.colorCount} 处`));
-  console.log(
-    chalk.gray(
-      `特殊内容: ${article.specialElementCount} 处，媒体: ${article.mediaCount} 处，表格: ${article.tableCount} 个`
-    )
-  );
+  if (sourceLabel === "飞书文档") {
+    console.log(chalk.gray(`已保留图片: ${article.imageCount} 张，表格: ${article.tableCount} 个`));
+    console.log(chalk.gray("已保留标题、列表、引用、颜色、高亮、对齐、列宽及合并单元格"));
+  } else {
+    console.log(chalk.gray(`已转存图片: ${article.imageCount} 张`));
+    console.log(chalk.gray(`已提取正文: ${article.textSegmentCount} 段`));
+    console.log(chalk.gray(`已保留文字颜色: ${article.colorCount} 处`));
+    console.log(
+      chalk.gray(
+        `特殊内容: ${article.specialElementCount} 处，媒体: ${article.mediaCount} 处，表格: ${article.tableCount} 个`
+      )
+    );
+  }
   console.log("");
-  console.log("请补充 cate_id 等业务字段，确认内容后执行:");
+  console.log(sourceLabel === "飞书文档" ? "请补充 thumbnail、cate_id 等业务字段，确认内容后执行:" : "请补充 cate_id 等业务字段，确认内容后执行:");
   console.log("");
   console.log(`  qcplay-cli www-article-list.store ${file}`);
   console.log("");
@@ -1720,6 +1879,20 @@ sort: 100
 game_id: 最强蜗牛
 index_pc_img: ""
 index_move_img: ""
+taptap_type: long-post
+taptap_forum: ""
+taptap_scheduled: "0"
+taptap_draft: "0"
+taptap_images: ""
+taptap_video: ""
+taptap_cover: ""
+bilibili_type: article
+bilibili_video: ""
+bilibili_cover: ""
+bilibili_category: ""
+bilibili_tags: ""
+bilibili_topic: ""
+weibo_intro: ""
 ---
 
 # 文章标题
@@ -1737,6 +1910,128 @@ ${chalk.cyan("从微信推文生成官网草稿：")}
 `);
 }
 
+function inferDistributionProject(payload, explicitProject) {
+  if (normalizeText(explicitProject)) {
+    return normalizeText(explicitProject);
+  }
+  if (payload?.game_id === "39") {
+    return "最强蜗牛";
+  }
+  return "";
+}
+
+function printPlatformEntries(entries) {
+  console.log("");
+  console.log(chalk.cyan("可用发布平台:"));
+  console.log("");
+  entries.forEach(entry => {
+    const status = entry.publisher === "blocked" || entry.publisher === "unavailable" ? "不可自动发布" : entry.publisher;
+    console.log(`  ${entry.project} / ${entry.region} / ${entry.platform}  [${status}; ${entry.authMode}]`);
+  });
+  console.log("");
+}
+
+async function publishPlatformsCommand(file, options) {
+  let parsedArticle;
+  if (file) {
+    parsedArticle = await parseArticleFile(file);
+  }
+  const allEntries = await loadPlatformEntries({ configFile: options.configFile });
+
+  const project = inferDistributionProject(parsedArticle?.payload, options.project);
+  if (!project) {
+    if (options.listPlatforms) {
+      printPlatformEntries(allEntries);
+      return;
+    }
+    throw new Error(`缺少项目名称。可用项目: ${availableProjects(allEntries).join("、")}。请使用 --project <项目>`);
+  }
+
+  const candidates = entriesForProject(allEntries, project, options.region);
+  if (candidates.length === 0) {
+    const regionHint = options.region ? ` / ${options.region}` : "";
+    throw new Error(`平台配置中没有找到项目 ${project}${regionHint}`);
+  }
+  if (options.listPlatforms) {
+    printPlatformEntries(candidates);
+    return;
+  }
+  if (!parsedArticle) {
+    throw new Error("缺少文章文件，例如：qcplay-cli publish article.md --platform TapTap");
+  }
+
+  const selected = options.platforms.length
+    ? selectRequestedEntries(candidates, options.platforms)
+    : await promptForPlatformEntries(candidates);
+  const planningArticle = {
+    ...parsedArticle,
+    title: parsedArticle.payload.article_title,
+    html: parsedArticle.payload.article_content
+  };
+  const plan = selected.map(entry => ({
+    ...publicEntrySummary(entry),
+    ...(entry.platformKey === "taptap" ? { taptap: tapTapPublishingPlan(planningArticle, entry) } : {}),
+    ...(entry.platformKey === "bilibili" ? { bilibili: bilibiliPublishingPlan(planningArticle) } : {}),
+    ...(entry.platformKey === "weibo" ? { weibo: weiboPublishingPlan(planningArticle) } : {})
+  }));
+  if (options.dryRun) {
+    console.log(JSON.stringify({ article: parsedArticle.articleFile, project, platforms: plan }, null, 2));
+    return;
+  }
+
+  const article = {
+    articleFile: parsedArticle.articleFile,
+    title: parsedArticle.payload.article_title,
+    markdown: parsedArticle.markdown,
+    html: parsedArticle.payload.article_content,
+    payload: parsedArticle.payload,
+    meta: parsedArticle.meta
+  };
+  const { successes, failures, skipped } = await runPlatformPublishSequence(selected, async entry => {
+    console.log("");
+    console.log(chalk.cyan(`正在发布到 ${entry.platform}（${entry.region}）...`));
+    let result;
+    if (entry.publisher === "official-api") {
+      await publishArticleCommand(file, options);
+    } else {
+      result = await publishPlatformEntry(entry, article, {
+        browserChannel: options.browserChannel,
+        reviewDraft: options.reviewDraft,
+        keepOpen: options.keepOpen,
+        onProgress: message => console.log(chalk.gray(`  ${message}`))
+      });
+      if (entry.platformKey === "taptap" && result?.status === "draft") {
+        console.log(chalk.green("TapTap 草稿已保存"));
+        return result;
+      }
+      if (entry.platformKey === "taptap" && result?.status === "scheduled") {
+        console.log(chalk.green("TapTap 定时发布已提交"));
+        return result;
+      }
+    }
+    console.log(chalk.green(`${entry.platform} 发布流程完成`));
+    return result;
+  });
+  failures.forEach(({ entry, error }) => {
+    console.error(chalk.red(`${entry.platform} 发布失败: ${error.message || error}`));
+  });
+  if (skipped.length > 0) {
+    console.error(chalk.yellow("已停止后续平台发布，请先处理当前浏览器平台的登录或页面问题。"));
+  }
+
+  console.log("");
+  console.log(`发布完成: ${successes.length} 个成功，${failures.length} 个失败，${skipped.length} 个未执行`);
+  failures.forEach(({ entry, error }) => {
+    console.log(`  - ${entry.platform}（${entry.region}）: ${error.message || error}`);
+  });
+  skipped.forEach(entry => {
+    console.log(`  - ${entry.platform}（${entry.region}）: 未执行`);
+  });
+  if (failures.length > 0) {
+    throw new Error("部分平台发布失败，请根据上面的错误处理后重试失败平台");
+  }
+}
+
 async function publishArticleCommand(file, options) {
   if (!file) {
     throw new Error("缺少文章文件，例如：qcplay-cli www-article-list.store article.md");
@@ -1771,7 +2066,13 @@ async function publishArticleCommand(file, options) {
     console.log(chalk.yellow(`本地未能记录最近文章 ID，后续操作请手动输入 ${articleId}: ${stateWarning}`));
   }
   console.log("");
-  console.log("请打开预览地址检查 PC 和移动端排版。确认无误后执行:");
+  try {
+    await openBrowser(previewUrl);
+    console.log(chalk.cyan("已打开文章预览页面，请由用户检查文章内容和排版。"));
+  } catch {
+    console.log(chalk.yellow("自动打开预览页面失败，请手动打开上面的预览地址。"));
+  }
+  console.log("用户确认无误后再执行:");
   console.log("");
   console.log(`  qcplay-cli article update ${articleId}`);
   console.log("");
@@ -1867,6 +2168,16 @@ async function main() {
     return;
   }
 
+  if (command === "publish") {
+    if (subcommand === "-h" || subcommand === "--help") {
+      printPublishHelp();
+      return;
+    }
+    const parsed = parseDistributionOptions([subcommand, ...rest].filter(Boolean));
+    await runWithErrorBanner("多平台发布失败", () => publishPlatformsCommand(parsed.file, parsed.options));
+    return;
+  }
+
   if (command === "article") {
     if (!subcommand || subcommand === "-h" || subcommand === "--help") {
       if (!subcommand) {
@@ -1892,7 +2203,7 @@ async function main() {
         });
         return;
       }
-      await runWithErrorBanner("转换失败", () => importWechatArticleCommand(sourceUrl, file));
+      await runWithErrorBanner("转换失败", () => importArticleCommand(sourceUrl, file));
       return;
     }