@lyhue1991/wxgzh 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,15 @@
 # wxgzh
 
-一个面向微信公众号的 Node.js CLI 工具：把 Markdown 文章处理成适合公众号发布的 HTML，修复图片，并提交到公众号草稿箱。
+一个面向微信公众号的 SKILL，基于 NodeJS CLI.
+
+把 Markdown 文章处理成适合公众号发布的 HTML，上传图片，生成封面，并提交到公众号草稿箱。
+
+<mark>安装此SKILL</mark>
+
+```
+npx skills add lyhue1991/wxgzh
+```
+
 
 ## 一、功能概述
 
@@ -12,31 +21,40 @@
 - 支持主题样式、自定义 CSS、自动摘要、封面图生成。
 - 也支持分步执行，便于你单独检查 HTML、封面或发布结果。
 
-默认一键流程：
+**手动操作方法**
+
+* step1: 一键安装（要求：Node.js >= 18）
 
 ```bash
-wxgzh article.md
+npm install -g @lyhue1991/wxgzh
+```
+安装完成后可直接使用 `wxgzh` 命令。
+
+
+* step2: 一键配置 (提前准备好微信公众号AppID和 AppSecret ， 并配置好IP白名单)
+
+```bash
+wxgzh config --appid 你的AppID --appsecret 你的AppSecret 
+
+```
+
+* step3: 一键投稿 (将本地markdown文章直接投递到公众号草稿箱， 人工确认后即可发布)
+
+```bash
+wxgzh article.md --author 文章作者姓名
 ```
 
 这条命令会自动执行：
 
 1. 读取 `article.md`
 2. 转换成公众号可用 HTML
-3. 上传正文中的本地图片到微信
+3. 上传正文中的本地图片和非微信图床图片到微信公众号图床
 4. 自动生成封面图（如果你没有提供）
 5. 提交到微信公众号草稿箱
 
-## 安装
 
-要求：Node.js >= 18
 
-```bash
-npm install -g @lyhue1991/wxgzh
-```
-
-安装完成后可直接使用 `wxgzh` 命令。
-
-## 二、基本配置
+## 二、配置说明
 
 ### 1. 如何获取公众号 `appid` 和 `appsecret`
 
@@ -99,8 +117,6 @@ wxgzh config --list-themes
 当前内置主题来自 `styles/` 目录，例如：`default`、`blue`、`green`、`red`、`yellow`、`brown`、`black`、`orange`。
 
 
-
-
 ## 三、快速流程
 
 最常见用法：
@@ -374,7 +390,10 @@ enableComment: true
 
 命令行参数优先级高于 Front Matter，Front Matter 又高于默认配置。
 
-## 支持的 Markdown 内容
+
+## 六，备忘清单
+
+### 1. 支持的 Markdown 内容
 
 本项目当前重点支持这些常见内容：
 
@@ -386,9 +405,10 @@ enableComment: true
 - 表格
 - 数学公式（行内与块级）
 
-## 常用命令速查
+### 2. 常用命令速查
 
 ```bash
+wxgzh --help  
 wxgzh article.md
 wxgzh config --list
 wxgzh config --list-themes
@@ -398,34 +418,4 @@ wxgzh cover --title "我的文章" --to .wxgzh/cover.jpg
 wxgzh publish --article .wxgzh/article.html --cover .wxgzh/cover.jpg
 ```
 
-## 开发与构建
-
-开发环境安装依赖：
-
-```bash
-npm install
-```
-
-类型检查：
-
-```bash
-npm run typecheck
-```
-
-构建：
-
-```bash
-npm run build
-```
-
-查看帮助：
-
-```bash
-node dist/cli/index.js --help
-```
-
-## 说明
 
-- 配置文件保存在用户目录下，不会写进项目源码目录。
-- `dist/` 是编译输出目录，日常修改应以 `src/` 为准。
-- 如果一键发布失败，建议改用“分步流程”逐步检查 `HTML`、图片上传和封面图。

package/dist/core/converter.js

@@ -178,6 +178,35 @@ q table:last-child {
   margin-bottom: 0 !important;
 }
 `;
+const WECHAT_LAYOUT_INLINE_CSS = `
+p,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+ul,
+ol,
+dl,
+blockquote,
+q,
+pre,
+hr,
+section.img-wrapper,
+section.tbl-wrapper,
+section.math-block {
+  margin-left: 0 !important;
+  margin-right: 0 !important;
+}
+
+section.img-wrapper,
+section.tbl-wrapper,
+section.math-block {
+  width: 100% !important;
+  box-sizing: border-box !important;
+}
+`;
 const WECHAT_TABLE_INLINE_CSS = `
 section.tbl-wrapper {
   margin: 1.4em 3% !important;
@@ -342,6 +371,9 @@ function escapeHtmlAttribute(value) {
 function isTextNodeEmpty(node) {
     return node.type === 'text' && !node.data.trim();
 }
+function isTagNode(node, tagName) {
+    return node.type === 'tag' && node.tagName.toLowerCase() === tagName;
+}
 function isStandaloneImageParagraph($paragraph) {
     const nodes = $paragraph.contents().toArray().filter((node) => !isTextNodeEmpty(node));
     return nodes.every((node) => node.type === 'tag' && ['img', 'br'].includes(node.tagName.toLowerCase()));
@@ -381,10 +413,33 @@ async function loadCustomCss() {
 function normalizeListItems($) {
     $('li').each((_, element) => {
         const $item = $(element);
-        const childElements = $item
-            .contents()
-            .toArray()
-            .filter((node) => !isTextNodeEmpty(node));
+        const initialChildren = $item.contents().toArray();
+        const hasParagraphChild = initialChildren.some((node) => isTagNode(node, 'p'));
+        if (hasParagraphChild) {
+            const fragments = [];
+            let previousWasParagraph = false;
+            for (const node of initialChildren) {
+                if (isTextNodeEmpty(node)) {
+                    continue;
+                }
+                if (isTagNode(node, 'p')) {
+                    const paragraphHtml = renderSoftBreakFriendlyHtml(node.children ?? []);
+                    if (!paragraphHtml.trim()) {
+                        continue;
+                    }
+                    if (previousWasParagraph) {
+                        fragments.push('<br>');
+                    }
+                    fragments.push(paragraphHtml);
+                    previousWasParagraph = true;
+                    continue;
+                }
+                fragments.push(renderSoftBreakFriendlyNode(node, true));
+                previousWasParagraph = false;
+            }
+            $item.html(fragments.join(''));
+        }
+        const childElements = $item.contents().toArray().filter((node) => !isTextNodeEmpty(node));
         if (childElements.length === 0) {
             return;
         }
@@ -396,7 +451,7 @@ function normalizeListItems($) {
             return ['p', 'ul', 'ol', 'section', 'blockquote', 'pre', 'table'].includes(tagName);
         });
         const firstChild = childElements[0];
-        if (!hasBlockChild && firstChild?.type === 'tag' && firstChild.tagName.toLowerCase() === 'span' && childElements.length === 1) {
+        if (!hasBlockChild && isTagNode(firstChild, 'span') && childElements.length === 1) {
             return;
         }
         if (hasBlockChild) {
@@ -556,12 +611,80 @@ function setInlineStyleProperty(existingStyle, property, value) {
         .map(([name, declarationValue]) => `${name}: ${declarationValue}`)
         .join('; ');
 }
+function removeInlineStyleProperties(existingStyle, properties) {
+    if (!existingStyle) {
+        return undefined;
+    }
+    const propertiesToRemove = new Set(properties.map((property) => property.trim().toLowerCase()).filter(Boolean));
+    const declarations = existingStyle
+        .split(';')
+        .map((declaration) => declaration.trim())
+        .filter(Boolean)
+        .filter((declaration) => {
+        const separatorIndex = declaration.indexOf(':');
+        if (separatorIndex === -1) {
+            return true;
+        }
+        const name = declaration.slice(0, separatorIndex).trim().toLowerCase();
+        return !propertiesToRemove.has(name);
+    });
+    if (declarations.length === 0) {
+        return undefined;
+    }
+    return declarations.join('; ');
+}
+function normalizeInlinedListStyles($) {
+    $('ol').each((_, element) => {
+        const $list = $(element);
+        const depth = $list.parents('ol').length;
+        const cleanedStyle = removeInlineStyleProperties($list.attr('style'), ['list-style', 'list-style-type', 'list-style-position']);
+        const listType = depth === 0 ? '1' : depth === 1 ? 'a' : 'i';
+        if (cleanedStyle) {
+            $list.attr('style', cleanedStyle);
+        }
+        else {
+            $list.removeAttr('style');
+        }
+        $list.attr('type', listType);
+    });
+    $('ul').each((_, element) => {
+        const $list = $(element);
+        const cleanedStyle = removeInlineStyleProperties($list.attr('style'), ['list-style', 'list-style-type', 'list-style-position']);
+        if (cleanedStyle) {
+            $list.attr('style', cleanedStyle);
+            return;
+        }
+        $list.removeAttr('style');
+    });
+    $('ol > li, ul > li').each((_, element) => {
+        const $item = $(element);
+        const cleanedStyle = removeInlineStyleProperties($item.attr('style'), ['list-style', 'list-style-type', 'list-style-position']);
+        if (cleanedStyle) {
+            $item.attr('style', cleanedStyle);
+            return;
+        }
+        $item.removeAttr('style');
+    });
+}
+function removeWechatUnsafeListWhitespace($) {
+    $('ol, ul').each((_, element) => {
+        $(element)
+            .contents()
+            .toArray()
+            .filter((node) => isTextNodeEmpty(node))
+            .forEach((node) => {
+            $(node).remove();
+        });
+    });
+}
 function cleanInlinedHtml(html) {
     const $ = cheerio.load(html);
     $('pre > code').each((_, element) => {
         const $element = $(element);
         $element.html(renderWechatFriendlyCodeHtml($element.contents().toArray()));
     });
+    normalizeInlinedListStyles($);
+    removeWechatUnsafeListWhitespace($);
     const $article = $('body > #write > article').first();
     const $firstChild = $article.children().first();
     if ($firstChild.length > 0) {
@@ -616,7 +739,7 @@ async function renderMarkdownToHtml(body, metadata) {
     const articleHtml = $('article').html() ?? '';
     const baseHtml = createDocumentHtml(articleHtml, metadata);
     const inlinedHtml = (0, css_inline_1.inline)(baseHtml, {
-        extraCss: `${themeCss}\n${HIGHLIGHT_INLINE_CSS}\n${WECHAT_BLOCKQUOTE_INLINE_CSS}\n${WECHAT_TABLE_INLINE_CSS}\n${WECHAT_MATH_INLINE_CSS}\n${customCss}`,
+        extraCss: `${themeCss}\n${HIGHLIGHT_INLINE_CSS}\n${WECHAT_BLOCKQUOTE_INLINE_CSS}\n${WECHAT_TABLE_INLINE_CSS}\n${WECHAT_MATH_INLINE_CSS}\n${WECHAT_LAYOUT_INLINE_CSS}\n${customCss}`,
         keepAtRules: true,
         applyWidthAttributes: false,
         applyHeightAttributes: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyhue1991/wxgzh",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Markdown to WeChat Official Account draft CLI",
   "license": "MIT",
   "main": "dist/cli/index.js",