multi-publisher 1.0.2 → 1.0.3

package/README.md

@@ -22,23 +22,34 @@
 ## 安装
 
 ```bash
-# 源码安装
-git clone <repo-url>
-cd multi-publisher
-npm install
-npm run build
+# 推荐：一键安装（Node.js ≥ 18）
+npm install -g multi-publisher
 
-# 链接为全局命令
-npm link
-mpub --help
+# 验证安装
+mpub --version
 ```
 
 **Node.js ≥ 18** required.
 
+### 配合 AI 使用
+
+本工具已制作为 Claude Code Skill，可让 AI 直接帮你发布文章：
+
+```bash
+# 在任意 Claude Code 对话中，直接描述你的需求：
+# "帮我把这篇 article.md 发布到微信公众号"
+# "用 cyberpunk 主题渲染预览一下"
+# AI 会调用 mpub 完成操作
+```
+
+查看支持的所有命令：`mpub --help`
+
 ---
 
 ## 快速开始
 
+> **配合 AI 使用**：安装本工具后，在 Claude Code 中直接说"帮我发布文章到微信公众号"，AI 会调用 `mpub` 自动完成。
+
 ### 1. 配置平台登录
 
 **方式一：浏览器自动登录（推荐）**

package/dist/adapters/wechat-publisher.d.ts

@@ -15,9 +15,6 @@ export declare class WechatPublisher {
      * 下载图片并以指定文件名上传到微信 CDN
      */
     uploadImageFromUrl(imageUrl: string): Promise<string>;
-    /**
-     * 上传本地图片到微信 CDN
-     */
     /**
      * 上传本地图片到微信 CDN（临时素材，用于正文嵌入）
      */
@@ -27,6 +24,11 @@ export declare class WechatPublisher {
      * 使用 material/add_material 接口
      */
     uploadPermanentImageFromPath(filePath: string, filename?: string): Promise<string>;
+    /**
+     * 生成占位封面图（当文章无图片时使用）
+     * 从占位图服务下载图片并上传为永久素材
+     */
+    uploadPlaceholderCover(): Promise<string>;
     /**
      * 从 URL 下载图片并上传为永久素材（用于封面）
      */

package/dist/adapters/wechat-publisher.js

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import { createReadStream } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import FormData from 'form-data';
 import path from 'node:path';
 import os from 'node:os';
@@ -65,9 +65,6 @@ export class WechatPublisher {
         this.uploadCache[imageUrl] = mediaId;
         return mediaId;
     }
-    /**
-     * 上传本地图片到微信 CDN
-     */
     /**
      * 上传本地图片到微信 CDN（临时素材，用于正文嵌入）
      */
@@ -75,7 +72,7 @@ export class WechatPublisher {
         const token = await this.getAccessToken();
         const name = filename ?? path.basename(filePath);
         const form = new FormData();
-        form.append('media', createReadStream(filePath), name);
+        form.append('media', readFileSync(filePath), { filename: name, contentType: 'image/png' });
         const res = await axios.post(`https://api.weixin.qq.com/cgi-bin/media/upload?access_token=${token}&type=image`, form, { headers: form.getHeaders(), maxBodyLength: Infinity, maxContentLength: Infinity });
         const data = res.data;
         if (!data.media_id) {
@@ -91,7 +88,7 @@ export class WechatPublisher {
         const token = await this.getAccessToken();
         const name = filename ?? path.basename(filePath);
         const form = new FormData();
-        form.append('media', createReadStream(filePath), name);
+        form.append('media', readFileSync(filePath), { filename: name, contentType: 'image/png' });
         form.append('type', 'image');
         const res = await axios.post(`https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=${token}&type=image`, form, { headers: form.getHeaders(), maxBodyLength: Infinity, maxContentLength: Infinity });
         const data = res.data;
@@ -100,6 +97,27 @@ export class WechatPublisher {
         }
         return data.media_id;
     }
+    /**
+     * 生成占位封面图（当文章无图片时使用）
+     * 从占位图服务下载图片并上传为永久素材
+     */
+    async uploadPlaceholderCover() {
+        const token = await this.getAccessToken();
+        // 从 httpbin 下载标准测试图（8090 bytes 有效 PNG）
+        const res = await this.runtime.fetch('https://httpbin.org/image/png');
+        if (!res.ok)
+            throw new Error(`占位图下载失败: ${res.status}`);
+        const buf = await res.arrayBuffer();
+        const png = Buffer.from(buf);
+        const form = new FormData();
+        form.append('media', png, { filename: 'cover.png', contentType: 'image/png' });
+        form.append('type', 'image');
+        const uploadRes = await axios.post(`https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=${token}&type=image`, form, { headers: form.getHeaders(), maxBodyLength: Infinity, maxContentLength: Infinity });
+        const data = uploadRes.data;
+        if (!data.media_id)
+            throw new Error(`占位图上传失败: ${data.errmsg || JSON.stringify(data)}`);
+        return data.media_id;
+    }
     /**
      * 从 URL 下载图片并上传为永久素材（用于封面）
      */
@@ -160,28 +178,42 @@ export class WechatPublisher {
     async publishToDraft(options) {
         const token = await this.getAccessToken();
         const { html: processedHtml, firstMediaId } = await this.processImages(options.content);
-        // 上传封面图
+        // 上传封面图：优先用 front-matter 指定的封面图，其次用正文第一张图片的 media_id
         let thumbMediaId;
         try {
             thumbMediaId = await this.uploadCover(options.cover);
         }
         catch (err) {
-            console.warn(`[WechatPublisher] 封面上传失败，遍历正文图片: ${err.message}`);
-            const imgMatches = [...options.content.matchAll(/<img\s+[^>]*src=["']([^"']+)["'][^>]*>/gi)];
-            for (const m of imgMatches) {
-                const src = m[1];
-                if (src.includes('mmbiz.qpic.cn') || src.includes('mmbiz.qlogo.cn'))
-                    continue;
-                try {
-                    thumbMediaId = await this.uploadImageFromUrl(src);
-                    console.log(`[WechatPublisher] 用正文图片作封面: ${src}`);
-                    break;
+            console.warn(`[WechatPublisher] 封面上传失败: ${err.message}`);
+            // 用 processImages 返回的第一张图片 media_id 作为封面
+            if (firstMediaId) {
+                thumbMediaId = firstMediaId;
+                console.log('[WechatPublisher] 使用正文第一张图片作为封面');
+            }
+            else {
+                // fallback：直接从 processedHtml 中查找 img 标签
+                const imgMatches = [...processedHtml.matchAll(/<img\s+[^>]*src=["']([^"']+)["'][^>]*>/gi)];
+                for (const m of imgMatches) {
+                    const src = m[1];
+                    if (src.includes('mmbiz.qpic.cn') || src.includes('mmbiz.qlogo.cn'))
+                        continue;
+                    try {
+                        thumbMediaId = await this.uploadImageFromUrl(src);
+                        console.log(`[WechatPublisher] 用正文图片作封面: ${src}`);
+                        break;
+                    }
+                    catch { /* continue */ }
                 }
-                catch { /* continue */ }
             }
         }
         if (!thumbMediaId) {
-            console.warn('[WechatPublisher] 没有可用封面，将使用微信默认封面');
+            try {
+                thumbMediaId = await this.uploadPlaceholderCover();
+                console.log('[WechatPublisher] 使用占位图作为封面');
+            }
+            catch (err) {
+                console.warn('[WechatPublisher] 占位图上传失败，不传 thumb_media_id:', err.message);
+            }
         }
         const article = {
             title: options.title,
@@ -190,8 +222,10 @@ export class WechatPublisher {
             digest: options.title,
             content_source_url: options.source_url,
         };
-        if (thumbMediaId)
+        // 只在有有效 thumbMediaId 时才传 thumb_media_id
+        if (thumbMediaId && thumbMediaId.trim() !== '') {
             article.thumb_media_id = thumbMediaId;
+        }
         const payload = { articles: [article] };
         const res = await axios.post(`https://api.weixin.qq.com/cgi-bin/draft/add?access_token=${token}`, payload, { headers: { 'Content-Type': 'application/json' }, responseType: 'json' });
         const data = res.data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-publisher",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Markdown → 微信公众号 / 知乎 / 掘金等多平台 CLI 发布工具",
   "type": "module",
   "repository": {