multi-publisher 1.1.2 → 1.1.3

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

@@ -15,6 +15,10 @@ export declare class WechatPublisher {
      * 下载图片并以指定文件名上传到微信 CDN
      */
     uploadImageFromUrl(imageUrl: string): Promise<string>;
+    /**
+     * 上传图片到微信 CDN（图文消息专用接口，返回可直接访问的 URL）
+     */
+    uploadImageForArticle(filePath: string): Promise<string>;
     /**
      * 上传本地图片到微信 CDN（临时素材，用于正文嵌入）
      */
@@ -35,11 +39,12 @@ export declare class WechatPublisher {
     uploadPermanentImageFromUrl(imageUrl: string): Promise<string>;
     /**
      * 处理 HTML 中的图片：本地图片上传到微信 CDN，外部图片保留原 URL
-     * 返回处理后的 HTML 和第一张可用的 media_id（用作封面）
+     * 返回处理后的 HTML、第一张 media_id（临时）和第一张本地路径（用于封面永久上传）
      */
     processImages(html: string): Promise<{
         html: string;
         firstMediaId?: string;
+        firstLocalPath?: string;
     }>;
     /**
      * 发布到微信公众号草稿箱

package/dist/adapters/wechat-publisher.js

@@ -10,7 +10,14 @@ function extFromUrl(url) {
     return ext || '.jpg';
 }
 function nameFromUrl(url) {
-    return path.basename(new URL(url).pathname) || `image${extFromUrl(url)}`;
+    const ext = extFromUrl(url);
+    const pathname = new URL(url).pathname;
+    const basename = path.basename(pathname);
+    // If basename has no extension (or is just numbers like "720"), generate a proper name
+    if (!path.extname(basename) || /^\d+$/.test(basename)) {
+        return `cover${ext}`;
+    }
+    return basename;
 }
 export class WechatPublisher {
     runtime;
@@ -65,6 +72,21 @@ export class WechatPublisher {
         this.uploadCache[imageUrl] = mediaId;
         return mediaId;
     }
+    /**
+     * 上传图片到微信 CDN（图文消息专用接口，返回可直接访问的 URL）
+     */
+    async uploadImageForArticle(filePath) {
+        const token = await this.getAccessToken();
+        const name = path.basename(filePath);
+        const form = new FormData();
+        form.append('media', readFileSync(filePath), { filename: name, contentType: 'image/png' });
+        const res = await axios.post(`https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=${token}`, form, { headers: form.getHeaders(), maxBodyLength: Infinity, maxContentLength: Infinity });
+        const data = res.data;
+        if (!data.url) {
+            throw new Error(`图片上传失败: ${data.errmsg || JSON.stringify(data)}`);
+        }
+        return data.url;
+    }
     /**
      * 上传本地图片到微信 CDN（临时素材，用于正文嵌入）
      */
@@ -142,11 +164,12 @@ export class WechatPublisher {
     }
     /**
      * 处理 HTML 中的图片：本地图片上传到微信 CDN，外部图片保留原 URL
-     * 返回处理后的 HTML 和第一张可用的 media_id（用作封面）
+     * 返回处理后的 HTML、第一张 media_id（临时）和第一张本地路径（用于封面永久上传）
      */
     async processImages(html) {
         const imgPattern = /<img\s+[^>]*src=["']([^"']+)["'][^>]*>/gi;
         let firstMediaId;
+        let firstLocalPath;
         let replaced = html;
         for (const match of [...html.matchAll(imgPattern)]) {
             const original = match[0];
@@ -160,24 +183,35 @@ export class WechatPublisher {
                 continue;
             }
             try {
-                const mediaId = await this.uploadImageFromUrl(src);
-                if (!firstMediaId)
-                    firstMediaId = mediaId;
-                const cdnUrl = `https://mmbiz.qpic.cn/mmbiz_png/${mediaId}/0`;
-                replaced = replaced.replace(original, original.replace(src, cdnUrl));
+                const isLocalPath = !src.startsWith('http://') && !src.startsWith('https://');
+                if (isLocalPath) {
+                    // 本地文件用 uploadimg 接口，返回直接可访问的 URL
+                    const url = await this.uploadImageForArticle(src);
+                    if (!firstLocalPath)
+                        firstLocalPath = src;
+                    replaced = replaced.replace(original, original.replace(src, url));
+                }
+                else {
+                    // 外部 URL 下载后上传
+                    const mediaId = await this.uploadImageFromUrl(src);
+                    if (!firstMediaId)
+                        firstMediaId = mediaId;
+                    const cdnUrl = `https://mmbiz.qpic.cn/mmbiz_png/${mediaId}/0`;
+                    replaced = replaced.replace(original, original.replace(src, cdnUrl));
+                }
             }
             catch (err) {
                 console.warn(`[WechatPublisher] 上传图片失败 ${src}: ${err.message}，保留原 URL`);
             }
         }
-        return { html: replaced, firstMediaId };
+        return { html: replaced, firstMediaId, firstLocalPath };
     }
     /**
      * 发布到微信公众号草稿箱
      */
     async publishToDraft(options) {
         const token = await this.getAccessToken();
-        const { html: processedHtml, firstMediaId } = await this.processImages(options.content);
+        const { html: processedHtml, firstMediaId, firstLocalPath } = await this.processImages(options.content);
         // 上传封面图：优先用 front-matter 指定的封面图，其次用正文第一张图片的 media_id
         let thumbMediaId;
         try {
@@ -185,10 +219,15 @@ export class WechatPublisher {
         }
         catch (err) {
             console.warn(`[WechatPublisher] 封面上传失败: ${err.message}`);
-            // 用 processImages 返回的第一张图片 media_id 作为封面
-            if (firstMediaId) {
+            // 用 processImages 返回的第一张图片（本地路径需要用永久素材接口）
+            if (firstLocalPath) {
+                thumbMediaId = await this.uploadPermanentImageFromPath(firstLocalPath);
+                console.log('[WechatPublisher] 使用正文第一张图片作为封面（永久素材）');
+            }
+            else if (firstMediaId) {
+                // 外部 URL 图片用临时素材
                 thumbMediaId = firstMediaId;
-                console.log('[WechatPublisher] 使用正文第一张图片作为封面');
+                console.log('[WechatPublisher] 使用正文第一张图片作为封面（临时素材）');
             }
             else {
                 // fallback：直接从 processedHtml 中查找 img 标签
@@ -197,12 +236,14 @@ export class WechatPublisher {
                     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;
+                    if (src.startsWith('http')) {
+                        try {
+                            thumbMediaId = await this.uploadPermanentImageFromUrl(src);
+                            console.log(`[WechatPublisher] 用正文图片作封面: ${src}`);
+                            break;
+                        }
+                        catch { /* continue */ }
                     }
-                    catch { /* continue */ }
                 }
             }
         }

package/dist/adapters/weixin.d.ts

@@ -8,7 +8,12 @@ export declare class WeixinAdapter implements IPlatformAdapter {
     readonly meta: PlatformMeta;
     private runtime;
     private publisher;
+    private getPublisher;
     init(runtime: RuntimeInterface): Promise<void>;
     checkAuth(): Promise<AuthResult>;
+    processMermaid(html: string): Promise<{
+        html: string;
+        tempFiles: string[];
+    }>;
     publish(article: Article): Promise<SyncResult>;
 }

package/dist/adapters/weixin.js

@@ -1,4 +1,6 @@
 import { WechatPublisher } from './wechat-publisher.js';
+import os from 'os';
+import fs from 'node:fs/promises';
 export class WeixinAdapter {
     meta = {
         id: 'weixin',
@@ -9,13 +11,18 @@ export class WeixinAdapter {
     };
     runtime;
     publisher;
+    getPublisher() {
+        if (!this.publisher) {
+            this.publisher = new WechatPublisher(this.runtime);
+        }
+        return this.publisher;
+    }
     async init(runtime) {
         this.runtime = runtime;
-        this.publisher = new WechatPublisher(runtime);
     }
     async checkAuth() {
         try {
-            const token = await this.publisher.getAccessToken();
+            const token = this.getPublisher().getAccessToken();
             return {
                 isAuthenticated: !!token,
                 userId: 'authenticated',
@@ -26,20 +33,49 @@ export class WeixinAdapter {
             return { isAuthenticated: false, error: msg };
         }
     }
+    async processMermaid(html) {
+        const { processMermaid: convert } = await import('../core/renderer.js');
+        const { html: processed, tempFiles } = await convert(html, os.tmpdir());
+        // 上传图片到微信 CDN 并替换 URL
+        const imgPattern = /<img\s+[^>]*src=["']([^"']+)["'][^>]*>/gi;
+        let result = processed;
+        for (const match of [...processed.matchAll(imgPattern)]) {
+            const original = match[0];
+            const src = match[1];
+            if (!src.startsWith('http://') && !src.startsWith('https://')) {
+                try {
+                    const url = await this.getPublisher().uploadImageForArticle(src);
+                    result = result.replace(original, original.replace(src, url));
+                }
+                catch (err) {
+                    console.warn(`[weixin] mermaid 图片上传失败 ${src}: ${err.message}`);
+                }
+            }
+        }
+        return { html: result, tempFiles };
+    }
     async publish(article) {
         const start = Date.now();
         try {
             if (!article.html) {
                 throw new Error('article.html is required for WeChat publishing');
             }
-            const result = await this.publisher.publishToDraft({
+            // 处理 Mermaid 代码块（转换为图片并上传 CDN）
+            let processedHtml = article.html;
+            if (this.processMermaid) {
+                const { html: mermaidHtml, tempFiles } = await this.processMermaid(article.html);
+                processedHtml = mermaidHtml;
+                // 清理临时文件
+                await Promise.all(tempFiles.map(f => fs.unlink(f).catch(() => { })));
+            }
+            const result = await this.getPublisher().publishToDraft({
                 title: article.title,
-                content: article.html,
+                content: processedHtml,
                 cover: article.cover ?? '',
                 author: article.author ?? '',
                 source_url: article.source_url ?? '',
             });
-            const token = await this.publisher.getAccessToken();
+            const token = await this.getPublisher().getAccessToken();
             const draftUrl = `https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit&action=edit&type=77&appmsgid=${result.media_id}&token=${token}&lang=zh_CN`;
             return {
                 platform: this.meta.id,

package/dist/cli/index.js

@@ -24,6 +24,7 @@ export function createProgram() {
         .requiredOption('-f, --file <path>', 'Markdown 文件路径（支持本地文件和 URL）')
         .option('-p, --platform <platform>', '目标平台 (weixin|zhihu|juejin|csdn)', 'weixin')
         .option('-t, --theme <theme-id>', '主题 ID', 'default')
+        .option('-m, --cover-mode <mode>', '封面模式 (sharp|network|auto)', 'auto')
         .option('--app-id <appId>', '微信公众号 AppID（可省略，从配置文件读取）')
         .option('--no-mac-style', '禁用 Mac 风格代码块')
         .option('--auto-cover', '当文章无封面图时，根据标题自动从网络获取封面')

package/dist/cli/login.js

@@ -95,6 +95,9 @@ async function saveCookies(platformId, cookies) {
         case 'cto51':
             await ConfigStore.setCto51Cookies(cookies);
             break;
+        case 'qq':
+            await ConfigStore.setQQCookies(cookies);
+            break;
         default:
             console.warn(`⚠️  尚未为 ${platformId} 实现 Cookie 保存，请手动保存`);
     }

package/dist/cli/platforms.js

@@ -19,9 +19,10 @@ const PLATFORM_LIST = [
     { id: 'sohu', name: '搜狐号', auth: 'Cookie', capabilities: ['article', 'draft'], note: 'Cookie 登录支持', status: '🔄 待测试' },
     { id: 'eastmoney', name: '东方财富', auth: 'Cookie', capabilities: ['article', 'draft'], note: 'Cookie 登录支持', status: '🔄 待测试' },
     { id: 'cto51', name: '51CTO', auth: 'Cookie', capabilities: ['article', 'draft'], note: 'Cookie 登录支持', status: '🔄 待测试' },
+    { id: 'qq', name: '企鹅号', auth: 'Cookie', capabilities: ['article', 'draft', 'image_upload'], note: '企鹅号平台', status: '🔄 待测试' },
 ];
 export async function runPlatforms() {
-    console.log('\n🖥️  支持的平台（共 20 个）：\n');
+    console.log('\n🖥️  支持的平台（共 21 个）：\n');
     console.log('状态说明：');
     console.log('  ✅ 已验证 - 登录和发布功能已测试通过');
     console.log('  🔄 待测试 - Cookie 登录支持，但发布功能尚未测试\n');

package/dist/cli/publish-all.js

@@ -55,7 +55,7 @@ export async function runPublishAll(options) {
             cover = coverMatch[1].trim();
         markdownContent = markdownContent.slice(frontmatterMatch[0].length);
     }
-    // 渲染 HTML
+    // 渲染 HTML（不处理 mermaid，由各平台适配器自行处理）
     const renderResult = await renderMarkdown(markdownContent, {
         theme,
         highlight,

package/dist/cli/publish.d.ts

@@ -5,4 +5,5 @@ export declare function runPublish(options: {
     appId?: string;
     macStyle?: boolean;
     autoCover?: boolean;
+    coverMode?: 'sharp' | 'network' | 'auto';
 }, input?: string): Promise<void>;

package/dist/cli/publish.js

@@ -27,14 +27,30 @@ export async function runPublish(options, input) {
         else {
             throw new Error('请提供 -f 选项指定 Markdown 文件');
         }
-        // 2. 渲染
+        // 平台未显式指定主题时，按平台绑定合适的默认主题
+        const platformId = options.platform || 'weixin';
+        const PLATFORM_DEFAULT_THEME = {
+            weixin: 'wechat',
+            zhihu: 'modern',
+            toutiao: 'minimal',
+            // 其余平台回退到 default
+        };
+        const theme = options.theme || PLATFORM_DEFAULT_THEME[platformId] || 'default';
+        // 2. 渲染（不处理 mermaid，由各平台适配器自行处理）
         const result = await renderMarkdown(content, {
-            theme: options.theme || 'default',
+            theme,
             macStyle: options.macStyle !== false,
             autoCover: options.autoCover || false,
+            coverMode: options.coverMode || 'auto',
         });
         // 3. 选择适配器
-        const platformId = options.platform || 'weixin';
+        // 校验 title
+        if (!result.title || result.title === '无标题') {
+            console.warn(`[publish] ⚠️ 警告：文章标题为空！`);
+        }
+        else {
+            console.log(`[publish] ✅ 文章标题: "${result.title}"`);
+        }
         // 初始化适配器注册表
         const runtime = createNodeRuntime();
         await initAdapterRegistry(runtime);
@@ -50,8 +66,16 @@ export async function runPublish(options, input) {
         if (options.appId) {
             process.env.WECHAT_APP_ID = options.appId;
         }
-        // 使用自动获取的封面图（如果文章没有指定封面）
-        const coverImage = result.cover || result.autoCoverPath;
+        // 使用封面图：
+        // - coverMode=sharp/network: 强制用 autoCoverPath，忽略 front-matter 封面
+        // - coverMode=auto: 优先用 front-matter 封面，其次 autoCoverPath
+        let coverImage;
+        if (options.coverMode === 'sharp' || options.coverMode === 'network') {
+            coverImage = result.autoCoverPath;
+        }
+        else {
+            coverImage = result.cover || result.autoCoverPath;
+        }
         const syncResult = await adapter.publish({
             title: result.title,
             markdown: content,

package/dist/config.d.ts

@@ -61,6 +61,9 @@ export interface SohuConfig {
 export interface EastmoneyConfig {
     cookies?: Record<string, string>;
 }
+export interface QQConfig {
+    cookies?: Record<string, string>;
+}
 export interface GlobalConfig {
     version: number;
     weixin?: WeixinConfig;
@@ -83,6 +86,7 @@ export interface GlobalConfig {
     douban?: DoubanConfig;
     sohu?: SohuConfig;
     eastmoney?: EastmoneyConfig;
+    qq?: QQConfig;
 }
 /** 读取配置（带缓存） */
 export declare function loadConfig(): Promise<GlobalConfig>;
@@ -172,6 +176,10 @@ export declare class ConfigStore {
     static getEastmoneyCookies(): Promise<Record<string, string> | null>;
     /** 设置东方财富 Cookie */
     static setEastmoneyCookies(cookies: Record<string, string>): Promise<void>;
+    /** 获取企鹅号 Cookie */
+    static getQQCookies(): Promise<Record<string, string> | null>;
+    /** 设置企鹅号 Cookie */
+    static setQQCookies(cookies: Record<string, string>): Promise<void>;
     /** 获取配置目录路径 */
     static getDir(): string;
 }

package/dist/config.js

@@ -326,6 +326,17 @@ export class ConfigStore {
             c.eastmoney = { ...c.eastmoney, cookies };
         });
     }
+    /** 获取企鹅号 Cookie */
+    static async getQQCookies() {
+        const config = await loadConfig();
+        return config.qq?.cookies || null;
+    }
+    /** 设置企鹅号 Cookie */
+    static async setQQCookies(cookies) {
+        await updateConfig((c) => {
+            c.qq = { ...c.qq, cookies };
+        });
+    }
     /** 获取配置目录路径 */
     static getDir() {
         return getConfigDir();

package/dist/core/parser.js

@@ -27,9 +27,17 @@ const markedInstance = createMarked();
 export function parseMarkdown(content) {
     const parsed = fm(content);
     const html = markedInstance.parse(parsed.body);
+    // Fallback title extraction: try to get first # heading if front-matter title is missing
+    let title = parsed.attributes.title;
+    if (!title) {
+        const headingMatch = parsed.body.match(/^#\s+(.+)/m);
+        if (headingMatch) {
+            title = headingMatch[1].trim();
+        }
+    }
     return {
         meta: {
-            title: parsed.attributes.title || '无标题',
+            title: title || '无标题',
             author: parsed.attributes.author,
             cover: parsed.attributes.cover,
             source_url: parsed.attributes.source_url,

package/dist/core/renderer.d.ts

@@ -1,3 +1,4 @@
+export type CoverMode = 'sharp' | 'network' | 'auto';
 export interface RenderOptions {
     theme?: string;
     customCss?: string;
@@ -6,6 +7,8 @@ export interface RenderOptions {
     footnote?: boolean;
     /** 是否在无封面时自动根据标题获取封面图 */
     autoCover?: boolean;
+    /** 封面模式: sharp(SVG生成)|network(网络抓取)|auto(自动选择) */
+    coverMode?: CoverMode;
 }
 export interface RenderResult {
     title: string;
@@ -17,6 +20,11 @@ export interface RenderResult {
     autoCoverPath?: string;
 }
 /**
- * 渲染 Markdown 文件为平台 HTML
+ * 处理 Mermaid 代码块，将它们转换为图片
+ * 各平台适配器可调用此函数
  */
+export declare function processMermaid(html: string, outputDir: string): Promise<{
+    html: string;
+    tempFiles: string[];
+}>;
 export declare function renderMarkdown(content: string, options?: RenderOptions): Promise<RenderResult>;

package/dist/core/renderer.js

@@ -6,32 +6,107 @@ import { processMath } from './mathjax.js';
 import { inlineStyles } from './styler.js';
 import { loadThemeCss, DEFAULT_CSS } from './theme.js';
 import { generateCover } from '../tools/cover-generator.js';
+import { fetchCoverByTitle } from '../tools/cover-fetcher.js';
+import { execSync } from 'child_process';
+import path from 'path';
+import fs from 'fs/promises';
+import os from 'os';
 /**
- * 渲染 Markdown 文件为平台 HTML
+ * 处理 Mermaid 代码块，将它们转换为图片
+ * 各平台适配器可调用此函数
  */
+export async function processMermaid(html, outputDir) {
+    const mermaidBlockRegex = /<pre[^>]*><code[^>]*class="hljs language-mermaid"[^>]*>([\s\S]*?)<\/code><\/pre>/gi;
+    const matches = [...html.matchAll(mermaidBlockRegex)];
+    const tempFiles = [];
+    if (matches.length === 0)
+        return { html, tempFiles };
+    console.log(`[renderer] 发现 ${matches.length} 个 mermaid 代码块，开始转换为图片...`);
+    for (const match of matches) {
+        let mermaidCode = match[1].trim();
+        // 解码 HTML 实体
+        mermaidCode = mermaidCode
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&amp;/g, '&')
+            .replace(/&quot;/g, '"');
+        const tmpMmd = path.join(os.tmpdir(), `mermaid-${Date.now()}-${Math.random()}.mmd`);
+        const outputPng = path.join(outputDir, `mermaid-${Date.now()}-${Math.random()}.png`);
+        try {
+            // 写入临时 mmd 文件
+            await fs.writeFile(tmpMmd, mermaidCode, 'utf8');
+            tempFiles.push(tmpMmd);
+            // 调用 mmdc 渲染
+            execSync(`mmdc -i "${tmpMmd}" -o "${outputPng}" -b white`, {
+                stdio: 'pipe',
+                timeout: 60000
+            });
+            // 验证图片生成
+            await fs.access(outputPng);
+            tempFiles.push(outputPng);
+            // 替换 mermaid 代码块为图片
+            const imageTag = `<img src="${outputPng.replace(/\\/g, '/')}" />`;
+            html = html.replace(match[0], imageTag);
+            console.log(`[renderer] Mermaid 图片生成成功: ${outputPng}`);
+        }
+        catch (err) {
+            console.warn(`[renderer] Mermaid 渲染失败: ${err.message}，保留原代码块`);
+            await fs.unlink(tmpMmd).catch(() => { });
+        }
+    }
+    return { html, tempFiles };
+}
 export async function renderMarkdown(content, options = {}) {
-    const { theme = 'default', customCss, macStyle = true, autoCover = false, } = options;
+    const { theme = 'default', customCss, macStyle = true, autoCover = false, coverMode = 'auto', } = options;
     // 1. 解析 front-matter + Markdown → HTML
     const parsed = parseMarkdown(content);
     // 2. 处理 LaTeX 公式（$...$ 和 $$...$$）
     let html = processMath(parsed.html);
+    // 注意：Mermaid 处理移到各平台适配器的 processMermaid 钩子
+    // 各 adapter 自己决定是否转换 mermaid 代码块
     // 3. 加载主题 CSS
     const themeCss = customCss ?? (await loadThemeCss(theme)) ?? DEFAULT_CSS;
     // 4. CSS 内联
     html = inlineStyles(html, themeCss);
     // 5. 包裹 section 标签（微信公众号要求）
     html = `<section style="margin-left:6px;margin-right:6px;line-height:1.75em">${html}</section>`;
+    // 5.5 校验 title
+    if (!parsed.meta.title || parsed.meta.title === '无标题') {
+        console.warn(`[renderer] ⚠️ 标题为空或为默认值，将尝试从正文提取。原始 content 前200字符: ${content.substring(0, 200)}`);
+    }
+    else {
+        console.log(`[renderer] ✅ 标题: "${parsed.meta.title}"`);
+    }
     let autoCoverPath;
-    // 6. 自动生成封面图（当未指定封面图时）
-    if (autoCover && !parsed.meta.cover && parsed.meta.title) {
-        console.log(`[renderer] 未指定封面图，正在根据标题生成封面...`);
-        const result = await generateCover(parsed.meta.title, parsed.meta.description || '');
-        if (result.success && result.localPath) {
-            autoCoverPath = result.localPath;
-            console.log(`[renderer] 自动封面图生成成功: ${result.localPath}`);
+    // 6. 自动生成封面图
+    // 条件：有 --auto-cover 且（front-matter 无封面 或 coverMode=sharp/network 强制覆盖）
+    const shouldGenerateCover = autoCover && (!parsed.meta.cover ||
+        coverMode === 'sharp' ||
+        coverMode === 'network');
+    if (shouldGenerateCover && parsed.meta.title) {
+        if (coverMode === 'sharp') {
+            // sharp 模式：强制用 SVG 生成封面
+            console.log(`[renderer] cover-mode=sharp，强制用 SVG 生成封面...`);
+            const result = await generateCover(parsed.meta.title, parsed.meta.description || '');
+            if (result.success && result.localPath) {
+                autoCoverPath = result.localPath;
+                console.log(`[renderer] SVG 封面生成成功: ${result.localPath}`);
+            }
+            else {
+                console.warn(`[renderer] SVG 封面生成失败: ${result.error}`);
+            }
         }
-        else {
-            console.warn(`[renderer] 自动封面图生成失败: ${result.error}`);
+        else if (coverMode === 'network' || (coverMode === 'auto' && !parsed.meta.cover)) {
+            // network 模式 或 auto 模式（无 front-matter 封面）：从网络抓取
+            console.log(`[renderer] cover-mode=${coverMode}，从网络抓取封面...`);
+            const result = await fetchCoverByTitle(parsed.meta.title);
+            if (result.success && result.localPath) {
+                autoCoverPath = result.localPath;
+                console.log(`[renderer] 网络封面获取成功: ${result.localPath}`);
+            }
+            else {
+                console.warn(`[renderer] 网络封面获取失败: ${result.error}`);
+            }
         }
     }
     return {

package/dist/core/theme.d.ts

@@ -4,6 +4,6 @@ export interface ThemeInfo {
     description?: string;
     isBuiltin: boolean;
 }
-export declare const DEFAULT_CSS = "\np {\n  color: rgb(51, 51, 51);\n  font-size: 15px;\n  line-height: 1.75em;\n  margin: 0 0 1em 0;\n  word-wrap: break-word;\n}\nh1, h2, h3, h4, h5, h6 {\n  font-weight: bold;\n  margin: 1em 0 0.5em 0;\n}\nh1 { font-size: 1.25em; line-height: 1.4em; }\nh2 { font-size: 1.125em; }\nh3 { font-size: 1.05em; }\nh4, h5, h6 { font-size: 1em; }\nli p { margin: 0; }\nul, ol { margin: 0; padding-left: 2em; }\nli { margin: 0; padding: 0; line-height: normal; }\nli + li { margin-top: 0.3em; }\npre {\n  background-color: #f6f8fa;\n  border-radius: 6px;\n  padding: 16px;\n  overflow-x: auto;\n  font-size: 14px;\n  line-height: 1.6;\n  margin: 1em 0;\n}\ncode {\n  background-color: rgba(175, 184, 193, 0.2);\n  border-radius: 3px;\n  padding: 0.2em 0.4em;\n  font-size: 0.9em;\n  font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;\n}\npre code { background: none; padding: 0; font-size: 14px; }\nblockquote { border-left: 4px solid #ddd; padding-left: 1em; margin: 1em 0; color: #666; }\nhr { border: none; border-top: 1px solid #ddd; margin: 1.5em 0; }\ni, cite, em, var, address { font-style: italic; }\nb, strong { font-weight: bolder; }\nimg { max-width: 100%; height: auto; display: block; margin: 1em auto; }\ntable { border-collapse: collapse; width: 100%; margin: 1em 0; }\ntable th, table td { border: 1px solid #ddd; padding: 8px 12px; }\ntable th { background-color: #f6f8fa; font-weight: bold; }\na { color: #0579b7; text-decoration: none; }\n";
+export declare const DEFAULT_CSS = "\np {\n  color: rgb(51, 51, 51);\n  font-size: 15px;\n  line-height: 1.75em;\n  margin: 0 0 1em 0;\n  word-wrap: break-word;\n  letter-spacing: 0.5px;\n}\nh1, h2, h3, h4, h5, h6 {\n  font-weight: bold;\n  color: #2c3e50;\n  margin: 1.2em 0 0.6em 0;\n}\nh1 { font-size: 1.4em; line-height: 1.4em; border-bottom: 1px solid #e8e8e8; padding-bottom: 0.3em; }\nh2 { font-size: 1.2em; border-left: 4px solid #07a35a; padding-left: 0.5em; }\nh3 { font-size: 1.05em; }\nh4, h5, h6 { font-size: 1em; }\nul, ol { margin: 0 0 1em 0; padding-left: 1.8em; }\nli { margin: 0.3em 0; line-height: 1.7em; }\nli p { margin: 0; }\npre {\n  background-color: #f6f8fa;\n  border: 1px solid #eaecef;\n  border-radius: 6px;\n  padding: 14px 16px;\n  overflow-x: auto;\n  font-size: 13.5px;\n  line-height: 1.6;\n  margin: 1em 0;\n  color: #24292e;\n}\ncode {\n  background-color: rgba(175, 184, 193, 0.2);\n  border-radius: 3px;\n  padding: 0.2em 0.4em;\n  font-size: 0.9em;\n  font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;\n}\npre code { background: none; padding: 0; border: none; font-size: 13.5px; }\nblockquote {\n  border-left: 4px solid #07a35a;\n  background-color: #f6fbf8;\n  padding: 0.8em 1em;\n  margin: 1em 0;\n  color: #555;\n  border-radius: 0 4px 4px 0;\n}\nhr { border: none; border-top: 1px solid #e8e8e8; margin: 1.5em 0; }\ni, cite, em, var, address { font-style: italic; }\nb, strong { font-weight: bold; color: #1a1a1a; }\nimg { max-width: 100%; height: auto; display: block; margin: 1em auto; border-radius: 4px; }\ntable { border-collapse: collapse; width: 100%; margin: 1em 0; font-size: 14px; }\ntable th, table td { border: 1px solid #e8e8e8; padding: 8px 12px; }\ntable th { background-color: #f6f8fa; font-weight: bold; color: #2c3e50; }\ntable tr:nth-child(even) { background-color: #fafafa; }\na { color: #576b95; text-decoration: none; border-bottom: 1px solid rgba(87, 107, 149, 0.3); }\n";
 export declare function listThemes(): Promise<ThemeInfo[]>;
 export declare function loadThemeCss(themeId: string): Promise<string | null>;