npm - @qcplay/cli - Versions diffs - 1.0.17 → 1.0.19 - Mend

@qcplay/cli 1.0.17 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +58 -329
package/bin/qcplay.js +416 -54
package/lib/platform-publish.js +1173 -177
package/lib/rich-article-upload.js +116 -0
package/lib/wechat-article.js +126 -29
package/lib/wechat-data.js +155 -0
package/package.json +2 -1
package/templates/skills/qcplay-publish-article/SKILL.md +46 -18
package/templates/skills/qcplay-wechat-data/SKILL.md +101 -0

package/lib/rich-article-upload.js ADDED Viewed

@@ -0,0 +1,116 @@
+import * as cheerio from "cheerio";
+import { sanitizeArticleRichHtml } from "./wechat-article.js";
+function escapeHtmlTitle(value) {
+  return String(value || "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+export function buildRichArticleUploadFile(article, metadata = {}) {
+  const normalizedMetadata = {
+    article_title: String(metadata.article_title ?? article.title ?? ""),
+    thumbnail: String(metadata.thumbnail ?? article.thumbnail ?? ""),
+    move_thumbnail: String(metadata.move_thumbnail ?? metadata.thumbnail ?? article.thumbnail ?? ""),
+    article_excerpt: String(metadata.article_excerpt ?? article.excerpt ?? ""),
+    article_url: String(metadata.article_url ?? ""),
+    origin: String(metadata.origin ?? article.author ?? "微信公众号"),
+    status: String(metadata.status ?? "0"),
+    cate_id: String(metadata.cate_id ?? ""),
+    video_link: String(metadata.video_link ?? ""),
+    is_hot: String(metadata.is_hot ?? "0"),
+    is_index: String(metadata.is_index ?? "0"),
+    release_time: String(metadata.release_time ?? article.releaseDate ?? ""),
+    area: String(metadata.area ?? "1"),
+    sort: String(metadata.sort ?? "100"),
+    game_id: String(metadata.game_id ?? "39"),
+    index_pc_img: String(metadata.index_pc_img ?? ""),
+    index_move_img: String(metadata.index_move_img ?? ""),
+    source_url: String(metadata.source_url ?? article.sourceUrl ?? ""),
+    distribution_project: String(metadata.distribution_project ?? "")
+  };
+  const richHtml = sanitizeArticleRichHtml(article.richHtml || "");
+  if (!richHtml) {
+    throw new Error("文章没有可保存的富文本正文");
+  }
+  const metadataJson = JSON.stringify(normalizedMetadata).replace(/</g, "\\u003c");
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtmlTitle(normalizedMetadata.article_title)}</title>
+  <script id="qcplay-article-meta" type="application/json">${metadataJson}</script>
+</head>
+<body>
+  <main data-qcplay-article-content="1">
+${richHtml}
+  </main>
+</body>
+</html>
+`;
+}
+export function parseRichArticleUploadFile(raw) {
+  const $ = cheerio.load(String(raw || ""));
+  const metadataText = $("#qcplay-article-meta[type='application/json']").first().text().trim();
+  const content = $("[data-qcplay-article-content='1']").first().html();
+  if (!metadataText || content === null) {
+    throw new Error("HTML 文章文件不是 QCPlay 富文本导入格式，请使用 article import --format html 生成");
+  }
+  let meta;
+  try {
+    meta = JSON.parse(metadataText);
+  } catch {
+    throw new Error("HTML 文章文件中的 QCPlay 元数据格式无效");
+  }
+  if (!meta || typeof meta !== "object" || Array.isArray(meta)) {
+    throw new Error("HTML 文章文件中的 QCPlay 元数据格式无效");
+  }
+  const richHtml = sanitizeArticleRichHtml(content);
+  if (!richHtml) {
+    throw new Error("HTML 文章文件中的富文本正文不能为空");
+  }
+  return { meta, richHtml };
+}
+export function buildRichArticleUploadPayload(meta, richHtml, helpers) {
+  const { normalizeText, normalizeMappedValue, normalizeGameAndCategory, normalizeBoolLike, statusMap, areaMap, westLanguages } =
+    helpers;
+  const { gameId, category } = normalizeGameAndCategory(meta);
+  const payload = {
+    article_title: normalizeText(meta.article_title),
+    thumbnail: normalizeText(meta.thumbnail),
+    move_thumbnail: normalizeText(meta.move_thumbnail),
+    article_content: richHtml,
+    article_excerpt: normalizeText(meta.article_excerpt),
+    article_url: normalizeText(meta.article_url),
+    origin: normalizeText(meta.origin),
+    status: normalizeMappedValue(meta.status, statusMap) || "0",
+    cate_id: category,
+    video_link: normalizeText(meta.video_link),
+    is_hot: normalizeBoolLike(meta.is_hot, "0"),
+    is_index: normalizeBoolLike(meta.is_index, "0"),
+    release_time: normalizeText(meta.release_time),
+    area: normalizeMappedValue(meta.area, areaMap) || "1",
+    sort: normalizeText(meta.sort) || "1",
+    game_id: gameId,
+    is_index2: "0",
+    index_pc_img: normalizeText(meta.index_pc_img),
+    index_move_img: normalizeText(meta.index_move_img),
+    type: "1"
+  };
+  if (gameId === "64") {
+    payload.language = normalizeText(meta.language).toLowerCase();
+    if (!westLanguages.has(payload.language)) {
+      throw new Error("欧美蜗牛文章的 language 必须是 portuguese、german、spanish、italian、french 或 america_en");
+    }
+  }
+  if (!payload.article_title) throw new Error("article_title 不能为空");
+  if (!payload.thumbnail) throw new Error("thumbnail 不能为空");
+  if (!payload.article_content) throw new Error("文章正文不能为空");
+  return payload;
+}

package/lib/wechat-article.js CHANGED Viewed

@@ -2,17 +2,20 @@ import { createHash, randomBytes } from "crypto";
 import http from "http";
 import https from "https";
 import path from "path";
-import zlib from "zlib";
 import * as cheerio from "cheerio";
 import { applyContentRules, matchingContentRules, matchingDownloadedImageRules } from "./content-rules.js";
+import { buildRichArticleUploadFile } from "./rich-article-upload.js";
 const WECHAT_HOST = "mp.weixin.qq.com";
-const MEDIA_UPLOAD_URL = "https://api.qingcigame.com/novel/time/literature/avatar";
 const MAX_REDIRECTS = 5;
 const MAX_HTML_BYTES = 8 * 1024 * 1024;
 const MAX_IMAGE_BYTES = 25 * 1024 * 1024;
 const MAX_VIDEO_BYTES = 512 * 1024 * 1024;
+const MAX_IMAGES_PER_ARTICLE = 80;
+const MAX_VIDEOS_PER_ARTICLE = 3;
+const MAX_MEDIA_BYTES_PER_ARTICLE = 768 * 1024 * 1024;
+const MAX_REQUEST_RETRIES = 2;
 const RICH_HTML_START = "<!-- qcplay-rich-html:start -->";
 const RICH_HTML_END = "<!-- qcplay-rich-html:end -->";
 const ARES_IGNORED_GIF_SHA256 = "138ed7ebf49170605efd81c99f516d648b43c22a972743680f6d974129e54da8";
@@ -201,7 +204,15 @@ const SAFE_STYLE_PROPERTIES = new Set([
   "-webkit-text-stroke-width"
 ]);
-function requestBuffer(target, options = {}, redirectCount = 0) {
+function retryDelayMs(response, retryCount) {
+  const retryAfterSeconds = Number.parseFloat(String(response?.headers?.["retry-after"] || ""));
+  if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds >= 0) {
+    return Math.min(Math.round(retryAfterSeconds * 1000), 10_000);
+  }
+  return 500 * 2 ** retryCount;
+}
+function requestBuffer(target, options = {}, redirectCount = 0, retryCount = 0) {
   const url = target instanceof URL ? target : new URL(target);
   const client = url.protocol === "https:" ? https : url.protocol === "http:" ? http : null;
   if (!client) {
@@ -216,7 +227,9 @@ function requestBuffer(target, options = {}, redirectCount = 0) {
         method: options.method || "GET",
         headers: {
           Accept: "text/html,application/xhtml+xml,image/avif,image/webp,image/*,*/*;q=0.8",
-          "Accept-Encoding": "gzip, deflate, br",
+          // Media is kept uncompressed so a small compressed response cannot expand
+          // into an unbounded in-memory buffer before the size check runs.
+          "Accept-Encoding": "identity",
           "User-Agent":
             "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/138 Safari/537.36",
           ...options.headers
@@ -238,7 +251,17 @@ function requestBuffer(target, options = {}, redirectCount = 0) {
             reject(error);
             return;
           }
-          requestBuffer(redirectUrl, options, redirectCount + 1).then(resolve, reject);
+          requestBuffer(redirectUrl, options, redirectCount + 1, retryCount).then(resolve, reject);
+          return;
+        }
+        const method = String(options.method || "GET").toUpperCase();
+        const retryableStatus = statusCode === 429 || statusCode >= 500;
+        if (retryableStatus && method === "GET" && retryCount < MAX_REQUEST_RETRIES) {
+          res.resume();
+          setTimeout(() => {
+            requestBuffer(url, options, redirectCount, retryCount + 1).then(resolve, reject);
+          }, retryDelayMs(res, retryCount));
           return;
         }
@@ -248,6 +271,13 @@ function requestBuffer(target, options = {}, redirectCount = 0) {
           return;
         }
+        const contentEncoding = String(res.headers["content-encoding"] || "identity").toLowerCase();
+        if (contentEncoding !== "identity") {
+          res.resume();
+          reject(new Error(`不支持压缩响应: ${contentEncoding} (${url})`));
+          return;
+        }
         const chunks = [];
         let receivedBytes = 0;
         res.on("data", chunk => {
@@ -260,20 +290,7 @@ function requestBuffer(target, options = {}, redirectCount = 0) {
         });
         res.on("end", () => {
           try {
-            let body = Buffer.concat(chunks);
-            const encoding = String(res.headers["content-encoding"] || "").toLowerCase();
-            if (encoding === "gzip") {
-              body = zlib.gunzipSync(body);
-            } else if (encoding === "deflate") {
-              body = zlib.inflateSync(body);
-            } else if (encoding === "br") {
-              body = zlib.brotliDecompressSync(body);
-            }
-            if (body.length > maxBytes) {
-              reject(new Error(`解压后的响应内容超过 ${Math.floor(maxBytes / 1024 / 1024)} MB 限制: ${url}`));
-              return;
-            }
-            resolve({ body, headers: res.headers, url });
+            resolve({ body: Buffer.concat(chunks), headers: res.headers, url });
           } catch (error) {
             reject(new Error(`读取响应失败 ${url}: ${error.message}`));
           }
@@ -426,8 +443,13 @@ export async function downloadWechatVideo(sourceUrl) {
   };
 }
-async function uploadOfficialMedia(media, kind, uploadUrl = MEDIA_UPLOAD_URL) {
-  const target = new URL(uploadUrl);
+async function uploadOfficialMedia(media, kind, uploadUrl, extraHeaders = {}) {
+  const configuredUploadUrl = String(uploadUrl || "").trim();
+  if (!configuredUploadUrl) {
+    throw new Error("未配置媒体上传地址，请通过后端媒体上传代理调用");
+  }
+  const target = new URL(configuredUploadUrl);
   const extension = kind === "video"
     ? extensionForVideo(media.contentType, media.sourceUrl)
     : extensionForImage(media.contentType, media.sourceUrl);
@@ -447,7 +469,8 @@ async function uploadOfficialMedia(media, kind, uploadUrl = MEDIA_UPLOAD_URL) {
       Accept: "application/json",
       "Accept-Encoding": "identity",
       "Content-Type": `multipart/form-data; boundary=${boundary}`,
-      "Content-Length": String(body.length)
+      "Content-Length": String(body.length),
+      ...extraHeaders
     }
   });
@@ -473,14 +496,25 @@ async function uploadOfficialMedia(media, kind, uploadUrl = MEDIA_UPLOAD_URL) {
   return uploadedUrl.toString();
 }
-export function uploadOfficialImage(image, uploadUrl = MEDIA_UPLOAD_URL) {
+export function uploadOfficialImage(image, uploadUrl) {
   return uploadOfficialMedia(image, "image", uploadUrl);
 }
-export function uploadOfficialVideo(video, uploadUrl = MEDIA_UPLOAD_URL) {
+export function uploadOfficialVideo(video, uploadUrl) {
   return uploadOfficialMedia(video, "video", uploadUrl);
 }
+export function uploadMediaToBackend(media, kind, backendUrl, accessToken) {
+  const target = new URL("/api/media/upload", backendUrl).toString();
+  const token = String(accessToken || "").trim();
+  if (!token) {
+    throw new Error("媒体上传需要有效的登录凭证");
+  }
+  return uploadOfficialMedia(media, kind, target, {
+    Authorization: `Bearer ${token}`
+  });
+}
 function normalizeTextContent(value) {
   return String(value || "")
     .replace(/\u00a0/g, " ")
@@ -747,7 +781,7 @@ function backgroundImageSources(element) {
 function safeHttpUrl(value) {
   try {
     const url = new URL(String(value || ""));
-    return url.protocol === "http:" || url.protocol === "https:" ? url.toString() : "";
+    return url.protocol === "https:" ? url.toString() : "";
   } catch {
     return "";
   }
@@ -954,7 +988,7 @@ export function sanitizeArticleRichHtml(value, options = {}) {
         element.replaceWith(alt ? $("<span></span>").text(alt) : "");
         continue;
       }
-      element.attr("src", src).attr("alt", alt);
+      element.attr("src", src).attr("alt", alt).attr("referrerpolicy", "no-referrer");
       if (/^\d+(?:\.\d+)?$/.test(originalAttributes.width || "")) {
         element.attr("width", originalAttributes.width);
       }
@@ -983,7 +1017,7 @@ export function sanitizeArticleRichHtml(value, options = {}) {
     if (tag === "a") {
       const href = safeHttpUrl(originalAttributes.href || originalAttributes["data-link"] || originalAttributes["data-url"]);
       if (href) {
-        element.attr({ href, target: "_blank", rel: "noreferrer" });
+        element.attr({ href, target: "_blank", rel: "noopener noreferrer nofollow" });
       } else {
         element.replaceWith(element.contents());
       }
@@ -1038,6 +1072,44 @@ export function sanitizeArticleRichHtml(value, options = {}) {
   );
 }
+export function analyzeArticleContentSafety(article = {}) {
+  const sourceUrl = String(article.sourceUrl || article.meta?.source_url || article.payload?.source_url || "").trim();
+  const richHtml = String(article.richHtml || article.html || "");
+  const $ = cheerio.load(richHtml, null, false);
+  const text = $.root().text().replace(/\s+/g, " ").trim();
+  const externalHosts = new Set();
+  $("a[href], img[src]").each((_, node) => {
+    const rawUrl = $(node).attr("href") || $(node).attr("src") || "";
+    try {
+      const url = new URL(rawUrl);
+      if (!/(?:^|\.)weixin\.qq\.com$|(?:^|\.)qpic\.cn$|(?:^|\.)qingcigame\.com$|(?:^|\.)qingcijoy\.com$/i.test(url.hostname)) {
+        externalHosts.add(url.hostname.toLowerCase());
+      }
+    } catch {
+      // Sanitized content only keeps absolute HTTPS URLs; malformed values are ignored here.
+    }
+  });
+  const phoneMatches = text.match(/(?<!\d)(?:1\d{10}|(?:\+?86[-\s]?)?\d{3,4}[-\s]?\d{7,8})(?!\d)/g) || [];
+  const idMatches = text.match(/(?<![\dA-Za-z])\d{17}[\dXx](?![\dA-Za-z])/g) || [];
+  const warnings = [];
+  if (externalHosts.size > 0) {
+    warnings.push(`正文包含 ${externalHosts.size} 个非受管外链域名: ${[...externalHosts].slice(0, 3).join("、")}`);
+  }
+  if (phoneMatches.length > 0) {
+    warnings.push(`正文疑似包含 ${phoneMatches.length} 个电话号码，请确认已获得公开与分发授权`);
+  }
+  if (idMatches.length > 0) {
+    warnings.push(`正文疑似包含 ${idMatches.length} 个身份证号码，请在发布前人工处理`);
+  }
+  return {
+    sourceUrl,
+    externalHosts: [...externalHosts],
+    phoneCount: phoneMatches.length,
+    identityNumberCount: idMatches.length,
+    warnings
+  };
+}
 function collectMeaningfulTextNodes(node, bucket = []) {
   if (node.type === "text") {
     if (normalizeTextContent(node.data).trim()) {
@@ -1337,7 +1409,11 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
   const downloadVideo = options.downloadVideo || downloadWechatVideo;
   const uploadVideo = options.uploadVideo || uploadOfficialVideo;
   const uniqueSourceCount = new Set(allSources.map(rawSource => assertWechatImageUrl(rawSource, sourceUrl).toString())).size;
+  if (uniqueSourceCount > MAX_IMAGES_PER_ARTICLE) {
+    throw new Error(`微信文章图片数量超过 ${MAX_IMAGES_PER_ARTICLE} 张限制`);
+  }
   let processedSourceCount = 0;
+  let mediaBytes = 0;
   for (const rawSource of allSources) {
     const imageUrl = assertWechatImageUrl(rawSource, sourceUrl);
@@ -1349,6 +1425,10 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
     options.onProgress?.({ mediaType: "image", current, total: uniqueSourceCount, sourceUrl: key });
     try {
       const image = await downloadImage(imageUrl);
+      mediaBytes += Number(image.buffer?.length || 0);
+      if (mediaBytes > MAX_MEDIA_BYTES_PER_ARTICLE) {
+        throw new Error(`微信文章媒体总大小超过 ${Math.floor(MAX_MEDIA_BYTES_PER_ARTICLE / 1024 / 1024)} MB 限制`);
+      }
       const matchedImageRules = options.contentRules
         ? matchingDownloadedImageRules(image, ruleArticle, ruleEntry, options.contentRules, { phase: "import" })
         : [];
@@ -1400,11 +1480,18 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
   const uploadedVideos = new Map();
   const uniqueVideoSources = [...new Set(videoSources.filter(Boolean))];
+  if (uniqueVideoSources.length > MAX_VIDEOS_PER_ARTICLE) {
+    throw new Error(`微信文章视频数量超过 ${MAX_VIDEOS_PER_ARTICLE} 个限制`);
+  }
   for (const rawSource of uniqueVideoSources) {
     const current = uploadedVideos.size + 1;
     options.onProgress?.({ mediaType: "video", current, total: uniqueVideoSources.length, sourceUrl: rawSource });
     try {
       const video = await downloadVideo(rawSource);
+      mediaBytes += Number(video.buffer?.length || 0);
+      if (mediaBytes > MAX_MEDIA_BYTES_PER_ARTICLE) {
+        throw new Error(`微信文章媒体总大小超过 ${Math.floor(MAX_MEDIA_BYTES_PER_ARTICLE / 1024 / 1024)} MB 限制`);
+      }
       uploadedVideos.set(rawSource, await uploadVideo(video));
     } catch (error) {
       throw new Error(`第 ${current} 个视频处理失败: ${error.message}`);
@@ -1470,7 +1557,7 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
     throw new Error(`微信文章有 ${missingTextNodes.length} 处正文未被完整转换: ${preview}`);
   }
-  return {
+  const article = {
     title,
     author,
     releaseDate: releaseDateFromWechatPage($, html),
@@ -1485,6 +1572,7 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
     colorCount: markdownContext.colorCount,
     colors: [...markdownContext.colors],
     mediaCount: markdownContext.mediaCount,
+    mediaBytes,
     specialElementCount: markdownContext.specialElementCount,
     tableCount: markdownContext.tableCount,
     textSegmentCount: sourceTextNodes.length,
@@ -1492,6 +1580,7 @@ export async function convertWechatHtml(html, pageUrl, options = {}) {
     matchedContentRules,
     appliedContentRules: [...appliedContentRules]
   };
+  return { ...article, contentSafety: analyzeArticleContentSafety(article) };
 }
 function yamlString(value) {
@@ -1521,7 +1610,7 @@ article_excerpt: ${yamlString(article.excerpt)}
 article_url: ""
 origin: ${yamlString(article.author || "微信公众号")}
 status: "0"
-cate_id: ""
+cate_id: ${yamlString(article.categoryId || "")}
 video_link: ""
 is_hot: "0"
 is_index: "0"
@@ -1539,6 +1628,14 @@ ${articleBody}
 `;
 }
+export function buildImportedArticleHtml(article) {
+  return buildRichArticleUploadFile(article, {
+    game_id: article.gameId || gameIdForWechatArticle(article),
+    cate_id: article.categoryId || "",
+    distribution_project: article.distributionProject || distributionProjectForWechatArticle(article)
+  });
+}
 export async function importWechatArticle(value, options = {}) {
   const pageUrl = parseWechatUrl(value);
   const response = await requestBuffer(pageUrl, {

package/lib/wechat-data.js ADDED Viewed

@@ -0,0 +1,155 @@
+const SHANGHAI_TIME_ZONE = "Asia/Shanghai";
+export const WECHAT_GAME_CATALOG = {
+  "25": "使魔计划",
+  "39": "最强蜗牛",
+  "33": "提灯与地下城",
+  "69": "新仙剑奇侠传之挥剑问情",
+  "35": "时光旅行社",
+  "74": "魔卡少女樱回忆钥匙",
+  "50": "迷途之光手游",
+  "47": "骑士冲呀",
+  "41": "阿瑞斯病毒"
+};
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const MONTH_PATTERN = /^\d{4}-\d{2}$/;
+export function normalizeWechatGameId(value) {
+  const text = String(value ?? "").trim();
+  if (!WECHAT_GAME_CATALOG[text]) {
+    throw new Error(`不支持的微信公众号 game_id: ${text || "空"}`);
+  }
+  return text;
+}
+export function todayInShanghai(now = new Date()) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: SHANGHAI_TIME_ZONE,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).formatToParts(now);
+  const values = Object.fromEntries(parts.filter(part => part.type !== "literal").map(part => [part.type, part.value]));
+  return `${values.year}-${values.month}-${values.day}`;
+}
+function parseDate(value, label) {
+  const text = String(value ?? "").trim();
+  if (!DATE_PATTERN.test(text)) {
+    throw new Error(`${label} 格式必须是 YYYY-MM-DD`);
+  }
+  const [year, month, day] = text.split("-").map(Number);
+  const date = new Date(Date.UTC(year, month - 1, day));
+  if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
+    throw new Error(`${label} 不是有效日期`);
+  }
+  return date;
+}
+function formatDate(date) {
+  return date.toISOString().slice(0, 10);
+}
+function addDays(date, amount) {
+  const next = new Date(date);
+  next.setUTCDate(next.getUTCDate() + amount);
+  return next;
+}
+function compareDates(left, right) {
+  return left.getTime() - right.getTime();
+}
+export function validateWechatDateRange(beginDate, endDate, today = todayInShanghai()) {
+  const begin = parseDate(beginDate, "begin_date");
+  const end = parseDate(endDate, "end_date");
+  const todayDate = parseDate(today, "今天");
+  if (compareDates(end, begin) < 0) {
+    throw new Error("结束日期不能小于开始日期");
+  }
+  if (compareDates(end, todayDate) >= 0) {
+    throw new Error("结束日期不能大于或等于今天");
+  }
+  return { begin, end };
+}
+export function monthDateRange(month, today = todayInShanghai()) {
+  const value = String(month ?? "").trim();
+  if (!MONTH_PATTERN.test(value)) throw new Error("--month 格式必须是 YYYY-MM");
+  const [year, monthNumber] = value.split("-").map(Number);
+  if (monthNumber < 1 || monthNumber > 12) throw new Error("--month 不是有效月份");
+  const begin = `${value}-01`;
+  const lastDay = new Date(Date.UTC(year, monthNumber, 0));
+  let end = formatDate(lastDay);
+  const todayDate = parseDate(today, "今天");
+  if (lastDay.getTime() >= todayDate.getTime()) end = formatDate(addDays(todayDate, -1));
+  return validateWechatDateRange(begin, end, today);
+}
+export function splitWechatDateRange(beginDate, endDate, today = todayInShanghai()) {
+  const { begin, end } = validateWechatDateRange(beginDate, endDate, today);
+  const ranges = [];
+  let cursor = begin;
+  while (compareDates(cursor, end) <= 0) {
+    const monthEnd = new Date(Date.UTC(cursor.getUTCFullYear(), cursor.getUTCMonth() + 1, 0));
+    let chunkEnd = compareDates(monthEnd, end) < 0 ? monthEnd : end;
+    // The upstream API accepts at most 30 calendar dates. Keep 31-day months
+    // as two requests even though their date difference can be exactly 30.
+    const maxChunkEnd = addDays(cursor, 29);
+    if (compareDates(chunkEnd, maxChunkEnd) > 0) {
+      chunkEnd = maxChunkEnd;
+    }
+    ranges.push({ beginDate: formatDate(cursor), endDate: formatDate(chunkEnd) });
+    cursor = addDays(chunkEnd, 1);
+  }
+  return ranges;
+}
+function cleanCell(value) {
+  return String(value ?? "").replace(/[\r\n]+/g, " ").replaceAll("|", "\\|").trim();
+}
+function detailRows(article) {
+  const details = Array.isArray(article?.detail_list) ? article.detail_list : [];
+  if (details.length === 0) return [{ article, detail: {} }];
+  return details.map(detail => ({ article, detail: detail || {} }));
+}
+function metric(detail, key) {
+  return detail?.[key] ?? "";
+}
+export function renderWechatArticleMarkdown(reports) {
+  const lines = ["# 微信公众号文章数据", ""];
+  for (const report of reports) {
+    lines.push(`## ${cleanCell(report.gameName)}（game_id: ${report.gameId}）`, "");
+    lines.push(`查询范围：${report.beginDate} 至 ${report.endDate}`, "");
+    const months = new Map();
+    for (const article of report.dayTotal) {
+      const month = cleanCell(article.ref_date).slice(0, 7) || "未分组";
+      if (!months.has(month)) months.set(month, []);
+      months.get(month).push(article);
+    }
+    if (months.size === 0) {
+      lines.push("暂无文章数据", "");
+      continue;
+    }
+    for (const [month, articles] of months) {
+      lines.push(`### ${month}`, "");
+      lines.push("| 发表日期 | 消息 ID | 标题 | 统计日期 | 阅读人数 | 分享人数 | 在看 | 点赞 | 留言 | 收藏 | 阅读后关注 | 赞赏(分) | 原文链接 |");
+      lines.push("| --- | --- | --- | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | --- |");
+      for (const article of articles) {
+        for (const { detail } of detailRows(article)) {
+          lines.push(`| ${cleanCell(article.ref_date)} | ${cleanCell(article.msgid)} | ${cleanCell(article.title)} | ${cleanCell(detail.stat_date)} | ${cleanCell(metric(detail, "read_user"))} | ${cleanCell(metric(detail, "share_user"))} | ${cleanCell(metric(detail, "zaikan_user"))} | ${cleanCell(metric(detail, "like_user"))} | ${cleanCell(metric(detail, "comment_count"))} | ${cleanCell(metric(detail, "collection_user"))} | ${cleanCell(metric(detail, "read_subscribe_user"))} | ${cleanCell(metric(detail, "praise_money"))} | ${cleanCell(article.content_url)} |`);
+        }
+      }
+      lines.push("");
+    }
+  }
+  return `${lines.join("\n").trim()}\n`;
+}
+export function buildWechatArticleJson(reports) {
+  return JSON.stringify(reports, null, 2) + "\n";
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "QCPlay CLI",
   "type": "module",
   "bin": {
@@ -27,6 +27,7 @@
     "test:auth": "node bin/qcplay.js auth",
     "test:publish": "node bin/qcplay.js www-article-list.store ../article.md",
     "test:wechat": "node test/wechat-article.test.js",
+    "test:wechat-data": "node test/wechat-data.test.js",
     "test:lark": "node test/lark-article.test.js",
     "test:platforms": "node test/platform-publish.test.js",
     "test:rules": "node test/content-rules.test.js",