@qcplay/cli 1.0.10 → 1.0.12

package/README.md

@@ -9,7 +9,7 @@
 - 登录默认打开线上页面：`https://cli.qcg.ink/auth.html`
 - `qcplay-cli install` 初始化完成后会自动打开登录页并等待登录完成
 - 登录凭证保存在当前用户本机的 `~/.qcplay/auth.json`，不同客户端之间不共享账号
-- 状态、权限和发布请求通过 Bearer Token 识别当前账号
+- 状态、权限和文章请求通过 Bearer Token 识别当前账号
 - `qcplay-cli article import <微信文章链接> [文件]` 会提取正文、转存图片并生成未发布的官网文章草稿
 - `qcplay-cli update` 会更新 npm 全局包，并同步 `~/.agents/skills`
 - 本地调试时可直接使用 `--local`
@@ -24,14 +24,34 @@
 qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.md
 ```
 
-转换流程会读取微信文章标题、来源、发布日期和正文，将正文及封面图片逐张上传到官网图片服务，再生成带 Front Matter 的 Markdown 草稿。输出固定为 `status: "0"`，并保留空的 `cate_id` 供发布前确认；任何图片下载或上传失败都会终止转换且不生成文章文件。
+转换流程会读取微信文章标题、来源、发布日期和完整正文，经过安全清理后保留微信原文的 HTML 层级、内联样式、字号、颜色、对齐、间距、媒体链接和表格，并转存正文图片、CSS 背景图及封面图。背景图片仍保留在原容器中，不会额外生成一张普通图片。正文保持微信的 `677px` 阅读宽度并兼容窄屏；独占一行的图片会使用块级布局，纯图片标题容器会转换为普通区块，避免官网 PC 标题样式造成相邻图片重叠。任何正文节点遗漏或图片处理失败都会终止转换，不生成不完整草稿。输出固定为 `status: "0"`，并保留空的 `cate_id` 供发布前确认。
 
-确认草稿内容和业务字段后再发布：
+确认草稿内容和业务字段后保存为未上线文章：
 
 ```bash
 qcplay-cli www-article-list.store article.md
 ```
 
+保存成功后，CLI 会输出文章 ID、`未上线` 状态和可点击的排版预览地址：
+
+```text
+https://snail.qingcigame.com/official/news-details.html?id=<文章ID>
+```
+
+检查 PC 和移动端排版无误后再上线。ID 可以省略，此时只使用当前账号最近一次保存的未上线文章：
+
+```bash
+qcplay-cli article update [id]
+```
+
+删除使用软删除，将同一文章的 `status` 更新为 `2`：
+
+```bash
+qcplay-cli article delete [id]
+```
+
+兼容权限名形式的命令：`www-article-list.update [id]` 和 `www-article-list.delete [id]`。首次保存始终强制使用 `status: "0"`，不会因为 Front Matter 中误填 `1` 而直接上线。
+
 仓库整体需求说明仍在根目录：
 
 - `../docs/requirement.md`

package/bin/qcplay.js

@@ -9,7 +9,12 @@ import path from "path";
 import readline from "readline";
 import { fileURLToPath, pathToFileURL } from "url";
 
-import { buildOfficialArticleMarkdown, importWechatArticle, normalizeArticleColor } from "../lib/wechat-article.js";
+import {
+  buildOfficialArticleMarkdown,
+  importWechatArticle,
+  normalizeArticleColor,
+  sanitizeArticleRichHtml
+} from "../lib/wechat-article.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -94,6 +99,8 @@ const QCPLAY_DIR = path.join(os.homedir(), ".qcplay");
 const AGENTS_DIR = path.join(os.homedir(), ".agents");
 const CONFIG_FILE = path.join(QCPLAY_DIR, "config.json");
 const AUTH_FILE = path.join(QCPLAY_DIR, "auth.json");
+const ARTICLE_STATE_FILE = path.join(QCPLAY_DIR, "article-state.json");
+const ARTICLE_PREVIEW_BASE_URL = "https://snail.qingcigame.com/official/news-details.html";
 const SKILLS_DIR = path.join(AGENTS_DIR, "skills");
 
 function readPackageMetadata() {
@@ -144,7 +151,11 @@ Usage:
   qcplay-cli article init [file]
   qcplay-cli article import <wechat-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 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]
   qcplay-cli features
   qcplay-cli where
 
@@ -170,7 +181,9 @@ function printArticleHelp() {
   qcplay-cli article
   qcplay-cli article init [file]
   qcplay-cli article import <wechat-url> [file]
-  qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]`);
+  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 printFeatures() {
@@ -188,6 +201,8 @@ function printFeatures() {
   console.log(chalk.cyan("3. 发布官网文章"));
   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("   qcplay-cli where");
@@ -492,12 +507,24 @@ function parsePublishOptions(args) {
     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 {
+    articleId: parsed.file,
+    options: parsed.options
+  };
+}
+
 function requestJson(method, baseUrl, pathname, payload, headers = {}) {
   return new Promise((resolve, reject) => {
     const url = new URL(pathname, baseUrl);
@@ -869,6 +896,87 @@ async function authenticatedRequest(method, baseUrl, pathname, payload) {
   });
 }
 
+function normalizeArticleId(value) {
+  const text = normalizeText(value);
+  if (!/^\d+$/.test(text)) {
+    throw new Error("文章 ID 必须是正整数");
+  }
+
+  const articleId = Number(text);
+  if (!Number.isSafeInteger(articleId) || articleId <= 0) {
+    throw new Error("文章 ID 必须是正整数");
+  }
+  return articleId;
+}
+
+function articlePreviewUrl(articleId) {
+  const url = new URL(ARTICLE_PREVIEW_BASE_URL);
+  url.searchParams.set("id", String(articleId));
+  return url.toString();
+}
+
+function backendOriginsMatch(left, right) {
+  try {
+    return new URL(left).origin === new URL(right).origin;
+  } catch {
+    return false;
+  }
+}
+
+async function saveRecentArticleState(articleId, status, backendUrl, previewUrl = "") {
+  const authState = await loadAuthState();
+  await writeJson(ARTICLE_STATE_FILE, {
+    article_id: articleId,
+    status: String(status),
+    preview_url: previewUrl,
+    backend_url: backendUrl,
+    administrator_id: Number(authState.id || 0),
+    account: normalizeText(authState.account),
+    updated_at: Date.now()
+  });
+}
+
+async function trySaveRecentArticleState(articleId, status, backendUrl, previewUrl = "") {
+  try {
+    await saveRecentArticleState(articleId, status, backendUrl, previewUrl);
+    return "";
+  } catch (error) {
+    return normalizeText(error?.message) || String(error);
+  }
+}
+
+async function resolveArticleId(value, backendUrl) {
+  if (normalizeText(value)) {
+    return normalizeArticleId(value);
+  }
+
+  const [recentArticle, authState] = await Promise.all([readJson(ARTICLE_STATE_FILE), loadAuthState()]);
+  if (!recentArticle.article_id) {
+    throw new Error("没有找到最近发布的未上线文章，请手动输入文章 ID");
+  }
+  if (!backendOriginsMatch(recentArticle.backend_url, backendUrl)) {
+    throw new Error("最近文章属于其他后端，请手动输入文章 ID");
+  }
+  if (String(recentArticle.status) !== "0") {
+    throw new Error("最近文章不是未上线状态，请手动输入文章 ID");
+  }
+
+  const recentAdministratorId = Number(recentArticle.administrator_id || 0);
+  const currentAdministratorId = Number(authState.id || 0);
+  if (recentAdministratorId && recentAdministratorId !== currentAdministratorId) {
+    throw new Error("最近文章属于其他登录账号，请手动输入文章 ID");
+  }
+  if (
+    !recentAdministratorId &&
+    normalizeText(recentArticle.account) &&
+    normalizeText(recentArticle.account) !== normalizeText(authState.account)
+  ) {
+    throw new Error("最近文章属于其他登录账号，请手动输入文章 ID");
+  }
+
+  return normalizeArticleId(recentArticle.article_id);
+}
+
 function flattenPermissionTree(items, bucket = []) {
   for (const item of items) {
     bucket.push(item);
@@ -1162,14 +1270,14 @@ function applyInlineMarkdown(text) {
   output = output.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (_, alt, url) => {
     return storeToken(
       `<img src="${escapeHtml(url.trim())}" alt="${escapeHtml(alt.trim())}" ` +
-        'style="display:block;width:auto;max-width:100%;height:auto;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;">${escapeHtml(label.trim())}</a>`
+        `style="color:#576b95;text-decoration:none;overflow-wrap:anywhere;word-break:break-all;">${escapeHtml(label.trim())}</a>`
     );
   });
 
@@ -1188,12 +1296,23 @@ function applyInlineMarkdown(text) {
 }
 
 function markdownToHtml(markdown) {
-  const lines = stripBom(markdown).replace(/\r\n/g, "\n").split("\n");
+  const richHtmlBlocks = [];
+  const normalizedMarkdown = stripBom(markdown)
+    .replace(/\r\n/g, "\n")
+    .replace(
+      /<!--\s*qcplay-rich-html:start\s*-->([\s\S]*?)<!--\s*qcplay-rich-html:end\s*-->/gi,
+      (_, richHtml) => {
+        const index = richHtmlBlocks.push(richHtml) - 1;
+        return `\n@@QCRICHHTML${index}@@\n`;
+      }
+    );
+  const lines = normalizedMarkdown.split("\n");
   const html = [];
   let paragraph = [];
   let quote = [];
   let listType = "";
   let listItems = [];
+  let tableLines = [];
   let inCodeBlock = false;
   let codeLines = [];
 
@@ -1203,7 +1322,7 @@ function markdownToHtml(markdown) {
     }
 
     html.push(
-      `<p style="margin:0 0 20px;font-size:16px;line-height:1.9;color:#3f3f3f;text-align:justify;">` +
+      `<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 = [];
@@ -1251,7 +1370,57 @@ function markdownToHtml(markdown) {
     codeLines = [];
   }
 
+  function parseTableLine(line) {
+    return line
+      .trim()
+      .replace(/^\|/, "")
+      .replace(/\|$/, "")
+      .split(/(?<!\\)\|/)
+      .map(cell => cell.trim().replace(/\\\|/g, "|"));
+  }
+
+  function flushTable() {
+    if (tableLines.length === 0) {
+      return;
+    }
+
+    const rows = tableLines.map(parseTableLine);
+    const separator = rows[1];
+    const isMarkdownTable =
+      rows.length >= 2 && separator.every(cell => /^:?-{3,}:?$/.test(cell.replace(/\s/g, "")));
+    if (!isMarkdownTable) {
+      paragraph.push(...tableLines);
+      tableLines = [];
+      return;
+    }
+
+    const columnCount = Math.max(...rows.map(row => row.length));
+    const normalizeRow = row => [...row, ...Array(columnCount - row.length).fill("")];
+    const header = normalizeRow(rows[0]);
+    const body = rows.slice(2).map(normalizeRow);
+    const cellStyle =
+      "padding:10px 12px;border:1px solid #dfe3e8;text-align:left;vertical-align:top;" +
+      "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>`
+    );
+    tableLines = [];
+  }
+
   function flushAll() {
+    flushTable();
     flushParagraph();
     flushQuote();
     flushList();
@@ -1281,13 +1450,33 @@ function markdownToHtml(markdown) {
       continue;
     }
 
+    const richHtmlMatch = trimmed.match(/^@@QCRICHHTML(\d+)@@$/);
+    if (richHtmlMatch) {
+      flushAll();
+      const sanitizedHtml = sanitizeArticleRichHtml(richHtmlBlocks[Number(richHtmlMatch[1])] || "");
+      if (sanitizedHtml) {
+        html.push(sanitizedHtml);
+      }
+      continue;
+    }
+
+    if (/^\|.*\|$/.test(trimmed)) {
+      flushParagraph();
+      flushQuote();
+      flushList();
+      tableLines.push(trimmed);
+      continue;
+    }
+
+    flushTable();
+
     const headingMatch = trimmed.match(/^(#{1,6})\s+(.+)$/);
     if (headingMatch) {
       flushAll();
       const level = headingMatch[1].length;
       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;">` +
+        `<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}>`
       );
       continue;
@@ -1339,8 +1528,9 @@ function markdownToHtml(markdown) {
   flushCodeBlock();
   flushAll();
   return (
-    '<section style="max-width:677px;margin:0 auto;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,' +
-    'PingFang SC,Hiragino Sans GB,Microsoft YaHei,sans-serif;letter-spacing:0;overflow-wrap:anywhere;">\n' +
+    '<section style="box-sizing:border-box;width:100%;max-width:960px;min-width:0;margin:0 auto;padding:0 16px;' +
+    'font-family:-apple-system,BlinkMacSystemFont,Segoe UI,PingFang SC,Hiragino Sans GB,Microsoft YaHei,' +
+    'sans-serif;letter-spacing:0;overflow-wrap:anywhere;word-break:break-word;">\n' +
     `${html.join("\n")}\n</section>`
   );
 }
@@ -1487,7 +1677,13 @@ async function importWechatArticleCommand(sourceUrl, file = "article.md") {
   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} 个`
+    )
+  );
   console.log("");
   console.log("请补充 cate_id 等业务字段，确认内容后执行:");
   console.log("");
@@ -1547,6 +1743,7 @@ async function publishArticleCommand(file, options) {
   }
 
   const { articleFile, payload } = await parseArticleFile(file);
+  payload.status = "0";
   const config = await loadConfig();
   const backendUrl = resolvePublishBackendUrl(options, config);
 
@@ -1556,15 +1753,66 @@ async function publishArticleCommand(file, options) {
   }
 
   console.log("");
-  console.log(chalk.cyan("正在发布官网文章..."));
+  console.log(chalk.cyan("正在保存官网文章为未上线状态..."));
   console.log(chalk.gray(`文章文件: ${articleFile}`));
   console.log("");
 
   const response = await authenticatedRequest("POST", backendUrl, "/api/articles/publish", payload);
-  console.log(chalk.green(response.message || "发布成功"));
-  const articleId = response.data?.id ?? response.data?.article_id ?? response.data?.articleId;
-  if (articleId !== undefined) {
-    console.log(`文章 ID: ${articleId}`);
+  const rawArticleId = response.data?.id ?? response.data?.article_id ?? response.data?.articleId;
+  const articleId = normalizeArticleId(rawArticleId);
+  const previewUrl = normalizeText(response.data?.preview_url) || articlePreviewUrl(articleId);
+  const stateWarning = await trySaveRecentArticleState(articleId, "0", backendUrl, previewUrl);
+
+  console.log(chalk.green(response.message || "文章已保存为未上线状态"));
+  console.log(`文章 ID: ${articleId}`);
+  console.log("文章状态: 未上线");
+  console.log(`预览地址: ${previewUrl}`);
+  if (stateWarning) {
+    console.log(chalk.yellow(`本地未能记录最近文章 ID，后续操作请手动输入 ${articleId}: ${stateWarning}`));
+  }
+  console.log("");
+  console.log("请打开预览地址检查 PC 和移动端排版。确认无误后执行:");
+  console.log("");
+  console.log(`  qcplay-cli article update ${articleId}`);
+  console.log("");
+}
+
+async function updateArticleStatusCommand(articleIdValue, targetStatus, options) {
+  const config = await loadConfig();
+  const backendUrl = resolvePublishBackendUrl(options, config);
+  const articleId = await resolveArticleId(articleIdValue, backendUrl);
+  const payload = {
+    id: articleId,
+    status: targetStatus
+  };
+
+  if (options.dryRun) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const action = targetStatus === "2" ? "删除" : "上线";
+  console.log("");
+  console.log(chalk.cyan(`正在${action}官网文章...`));
+  console.log(chalk.gray(`文章 ID: ${articleId}`));
+  console.log("");
+
+  const response = await authenticatedRequest("PATCH", backendUrl, "/api/articles/status", payload);
+  const responseStatus = normalizeText(response.data?.status) || targetStatus;
+  const previewUrl =
+    responseStatus === "1"
+      ? normalizeText(response.data?.preview_url) || articlePreviewUrl(articleId)
+      : "";
+  const stateWarning = await trySaveRecentArticleState(articleId, responseStatus, backendUrl, previewUrl);
+
+  console.log(chalk.green(response.message || (responseStatus === "2" ? "文章已删除" : "文章已上线")));
+  console.log(`文章 ID: ${articleId}`);
+  console.log(`文章状态: ${responseStatus === "2" ? "已删除" : "已上线"}`);
+  if (previewUrl) {
+    console.log(`文章地址: ${previewUrl}`);
+  }
+  if (stateWarning) {
+    console.log(chalk.yellow(`本地未能记录文章状态，后续操作请手动输入 ${articleId}: ${stateWarning}`));
   }
 }
 
@@ -1654,6 +1902,16 @@ async function main() {
       return;
     }
 
+    if (subcommand === "update" || subcommand === "delete") {
+      const parsed = parseArticleMutationOptions(rest);
+      const targetStatus = subcommand === "delete" ? "2" : "1";
+      const errorTitle = subcommand === "delete" ? "删除失败" : "上线失败";
+      await runWithErrorBanner(errorTitle, () =>
+        updateArticleStatusCommand(parsed.articleId, targetStatus, parsed.options)
+      );
+      return;
+    }
+
     printArticleHelp();
     process.exit(1);
   }
@@ -1664,6 +1922,16 @@ async function main() {
     return;
   }
 
+  if (command === "www-article-list.update" || command === "www-article-list.delete") {
+    const parsed = parseArticleMutationOptions([subcommand, ...rest].filter(Boolean));
+    const targetStatus = command === "www-article-list.delete" ? "2" : "1";
+    const errorTitle = targetStatus === "2" ? "删除失败" : "上线失败";
+    await runWithErrorBanner(errorTitle, () =>
+      updateArticleStatusCommand(parsed.articleId, targetStatus, parsed.options)
+    );
+    return;
+  }
+
   if (command === "features") {
     printFeatures();
     return;