@akairos/pipeline 0.18.1 → 0.19.0

package/src/wechat-preview/index.ts

@@ -25,6 +25,7 @@ import type { WechatThemeOverrides } from "../schema/config";
 import { getWechatPreviewStyleName, getWechatPreviewTheme } from "./themes";
 import { stripLeadingH1 } from "../text";
 import { buildCombinedPresetsCss } from "./browser/studio/syntax-presets";
+import type { ArticleStructure } from "./wechat-renderer";
 
 interface ViteManifestEntry {
   file: string;
@@ -99,6 +100,8 @@ export interface ExportMarkdownToWechatHtmlInput {
   timeoutMs?: number;
   /** Write intermediate artifacts for debugging. */
   debugDir?: string;
+  /** 外部插件提供的已构建入口；浏览器和文件输出继续由宿主管理。 */
+  browserScriptPath?: string;
 }
 
 export interface ExportMarkdownToWechatHtmlResult {
@@ -131,6 +134,10 @@ export function getWechatPreviewBundleSources(): string[] {
     join(WECHAT_PREVIEW_DIR, "browser/studio/studio.css"),
     join(WECHAT_PREVIEW_DIR, "browser/studio/syntax-presets.ts"),
     join(WECHAT_PREVIEW_DIR, "browser/studio/color-palettes.ts"),
+    join(WECHAT_PREVIEW_DIR, "browser/studio/style-packs.ts"),
+    join(WECHAT_PREVIEW_DIR, "browser/studio/milkdown-article-menu.ts"),
+    join(WECHAT_PREVIEW_DIR, "browser/studio/myno-editor.ts"),
+    join(WECHAT_PREVIEW_DIR, "browser/studio/config-manager.ts"),
     join(WECHAT_PREVIEW_DIR, "themes.ts"),
     join(WECHAT_PREVIEW_DIR, "frontmatter-handler.ts"),
     join(PACKAGE_ROOT, "src/text.ts"),
@@ -140,24 +147,27 @@ export function getWechatPreviewBundleSources(): string[] {
   ];
 }
 
-/** Studio 与 CLI 共用模板、账号覆盖和页首素材的解析顺序。 */
+/** 独立配置跨账号复用；目录模板仍沿用账号覆盖顺序。 */
 export function resolveWechatArticleTheme(
   account: string,
   overrides?: Partial<WechatThemeOverrides>,
   articleTheme?: ArticleThemePackage | null,
 ) {
+  const standalone = articleTheme?.manifest.css !== undefined;
+  const accountOverrides = standalone ? undefined : overrides;
   const { headerImage, ...templateStructure } = articleTheme?.manifest.structure ?? {};
-  const theme = getWechatPreviewTheme(account, articleTheme ? {
-    editorVars: { ...articleTheme.manifest.editorVars, ...overrides?.editorVars },
-    exportTheme: { footerText: "", ...articleTheme.manifest.exportTheme, ...overrides?.exportTheme },
-  } : overrides);
-  const structure = articleTheme ? {
+  const theme = getWechatPreviewTheme(standalone ? "default" : account, articleTheme ? {
+    editorVars: { ...articleTheme.manifest.editorVars, ...accountOverrides?.editorVars },
+    exportTheme: { footerText: "", ...articleTheme.manifest.exportTheme, ...accountOverrides?.exportTheme },
+  } : accountOverrides);
+  const structure: ArticleStructure | undefined = articleTheme ? {
     ...templateStructure,
-    ...overrides?.structure,
+    ...accountOverrides?.structure,
     headerImageUrl: headerImage
-      ? `data:image/${headerImage.split(".").pop()!.toLowerCase().replace("jpg", "jpeg")};base64,${Buffer.from(articleTheme.files.get(headerImage)!).toString("base64")}` : null,
-  } : overrides?.structure;
-  return { theme, structure };
+      ? `data:image/${headerImage.split(".").pop()!.toLowerCase().replace("jpg", "jpeg")};base64,${Buffer.from(articleTheme.files.get(headerImage)!).toString("base64")}` : articleTheme.manifest.structure.headerImageUrl ?? null,
+  } : accountOverrides?.structure;
+  const syntaxPresets = accountOverrides?.syntaxPresets ?? articleTheme?.manifest.syntaxPresets;
+  return { theme, structure, syntaxPresets };
 }
 
 export function isWechatPreviewBundleStale(
@@ -264,6 +274,14 @@ export function rewriteRelativeImagePaths(markdown: string, baseDir: string): st
       }
       return `![${alt}](${needsBrackets ? "<" : ""}${resolved}${needsBrackets ? ">" : ""}${titleStr})`;
     })
+    .replace(/^([ \t]*\[[^\]]+\]:\s*)(\S+)(.*)$/gm, (match, prefix, rawUrl, suffix) => {
+      if (isExternalUrl(rawUrl)) return match;
+      const cleanUrl = rawUrl.replace(/^<([^>]+)>$/, "$1");
+      const hadAngle = rawUrl.startsWith("<") && rawUrl.endsWith(">");
+      const resolved = resolveMarkdownAsset(cleanUrl, baseDir);
+      const needsBrackets = resolved ? resolved.includes(" ") : hadAngle;
+      return `${prefix}${needsBrackets ? "<" : ""}${resolved}${needsBrackets ? ">" : ""}${suffix}`;
+    })
     .replace(/(<img\b[^>]*\bsrc=["'])([^"']+)(["'][^>]*>)/gi, (_match, prefix, src, suffix) => {
       const resolved = resolveMarkdownAsset(String(src ?? ""), baseDir);
       return `${prefix}${resolved}${suffix}`;
@@ -389,7 +407,9 @@ export async function exportMarkdownToWechatHtml(
 
     let bundle: BundleAssets;
     try {
-      bundle = ensureBundle();
+      bundle = input.browserScriptPath
+        ? { scriptPath: input.browserScriptPath, rebuilt: false, stale: false }
+        : ensureBundle();
       bundleRebuilt = bundle.rebuilt;
       bundleStale = bundle.stale;
     } catch (error) {
@@ -404,9 +424,9 @@ export async function exportMarkdownToWechatHtml(
     const bodyMarkdown = stripLeadingH1(stripped).trimStart();
     const markdown = bodyMarkdown;
     const articleTheme = input.articleThemePath ? await readArticleTheme(input.articleThemePath) : null;
-    const { theme, structure } = resolveWechatArticleTheme(input.account, input.themeOverrides, articleTheme);
-    const presetsCss = input.themeOverrides?.syntaxPresets
-      ? buildCombinedPresetsCss(input.themeOverrides.syntaxPresets)
+    const { theme, structure, syntaxPresets } = resolveWechatArticleTheme(input.account, input.themeOverrides, articleTheme);
+    const presetsCss = syntaxPresets
+      ? buildCombinedPresetsCss(syntaxPresets)
       : "";
     const customCss = [presetsCss, articleTheme?.css, input.customCss ? await readFile(input.customCss, "utf-8") : ""].filter(Boolean).join("\n\n");
     const shell = readUtf8(TEMPLATE_PATH);
@@ -416,6 +436,7 @@ export async function exportMarkdownToWechatHtml(
         assetBaseUrl: pathToFileURL(`${dirname(resolve(input.markdownPath))}/`).href,
         editorVars: theme.editorVars,
         exportTheme: theme.exportTheme,
+        syntaxPresets,
         customCss,
         structure,
       }),

package/src/wechat-preview/server/http.ts

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
+import { realpath, stat } from "fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "path";
 import { z } from "zod";
 import {
   previewBaseUrl,
@@ -26,12 +27,14 @@ import {
   rewriteHtmlLocalAssets,
 } from "./local-file";
 import { renderDashboardHtml, renderFailedEntryHtml } from "./ui";
-import { buildWechatPreviewShell, resolveWechatArticleTheme } from "../index";
+import { buildWechatPreviewShell, resolveWechatArticleTheme, rewriteRelativeImagePaths } from "../index";
 import { getPluginDocs } from "@akairos/milkdown-article-plugins";
 import { readArticleTheme } from "../../article-theme";
 import { PipelineConfigSchema, WechatExportThemeOverridesSchema, WechatStructureOverridesSchema } from "../../schema/config";
 import { loadConfig, saveConfig, getPipelineConfigPath, resolveConfigRelativePath } from "../../config";
 import { DIST_DIR, WECHAT_PREVIEW_DIR } from "../../runtime-paths";
+import { resolveMarkdownRenderer } from "../../adapter-loader";
+import type { MarkdownStudioAssets } from "../../adapter-types";
 import type { PreviewRegisterInput } from "./types";
 
 /** 保存入口先校验完整请求，避免写入 CLI 无法加载的配置。 */
@@ -105,6 +108,32 @@ export async function startPreviewServer(
     clearServerLock();
   }
 
+  // 工作台与导出使用同一个插件；没有工作台能力时给出明确提示。
+  const pluginConfig = loadConfig();
+  const externalMarkdown = Boolean(pluginConfig.plugins.markdownRenderer);
+  let studioAssets: Promise<MarkdownStudioAssets | undefined> | undefined;
+  /** 按需加载工作台，故障插件不影响预览登记和历史页面。 */
+  function getStudio() {
+    return studioAssets ??= resolveMarkdownRenderer(pluginConfig).then(async renderer => {
+      const studio = await renderer.studio?.();
+      return studio ? { ...studio, root: await realpath(studio.root) } : undefined;
+    });
+  }
+
+  /** 插件静态资源独立挂载，真实路径也必须留在插件资源目录内。 */
+  async function studioFile(name: string): Promise<string | null> {
+    try {
+      if (!externalMarkdown) return null;
+      const studioRoot = (await getStudio())?.root;
+      if (!studioRoot) return null;
+      const target = await realpath(resolve(studioRoot, name));
+      const rel = relative(studioRoot, target);
+      return rel && !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`) && (await stat(target)).isFile() ? target : null;
+    } catch {
+      return null;
+    }
+  }
+
   let server: ReturnType<typeof Bun.serve>;
   server = Bun.serve({
     hostname: host,
@@ -210,8 +239,10 @@ export async function startPreviewServer(
         const accountsData: Record<string, unknown> = {};
 
         for (const [key, account] of Object.entries(config.wx.accounts)) {
+          const articleThemePath = resolveConfigRelativePath(account.articleTheme, configPath);
+          const articleTheme = articleThemePath ? await readArticleTheme(articleThemePath) : null;
           let customCssContent = "";
-          if (account.customCss) {
+          if (account.customCss && articleTheme?.manifest.css === undefined) {
             const resolved = resolveConfigRelativePath(account.customCss, configPath);
             if (resolved) {
               try {
@@ -222,9 +253,7 @@ export async function startPreviewServer(
             }
           }
 
-          const articleThemePath = resolveConfigRelativePath(account.articleTheme, configPath);
-          const articleTheme = articleThemePath ? await readArticleTheme(articleThemePath) : null;
-          const { theme, structure } = resolveWechatArticleTheme(key, account.theme, articleTheme);
+          const { theme, structure, syntaxPresets } = resolveWechatArticleTheme(key, account.theme, articleTheme);
 
           accountsData[key] = {
             name: account.name || key,
@@ -233,11 +262,12 @@ export async function startPreviewServer(
             theme: {
               editorVars: theme.editorVars,
               exportTheme: theme.exportTheme,
-              syntaxPresets: account.theme?.syntaxPresets || {},
+              syntaxPresets: syntaxPresets || {},
               structure: structure || {},
             },
             articleThemeCss: articleTheme?.css || "",
             articleTheme: account.articleTheme ?? null,
+            articleThemeStandalone: articleTheme?.manifest.css !== undefined,
           };
         }
 
@@ -245,7 +275,7 @@ export async function startPreviewServer(
         const fixturePath = join(WECHAT_PREVIEW_DIR, "fixtures/all-nodes.md");
         if (existsSync(fixturePath)) {
           try {
-            sampleMarkdown = readFileSync(fixturePath, "utf-8");
+            sampleMarkdown = rewriteRelativeImagePaths(readFileSync(fixturePath, "utf-8"), dirname(fixturePath));
           } catch {
             // ignore
           }
@@ -316,6 +346,21 @@ export async function startPreviewServer(
       }
 
       if (pathname === "/studio" || pathname === "/studio/" || pathname === "/studio/index.html") {
+        if (externalMarkdown) {
+          let studio: MarkdownStudioAssets | undefined;
+          try { studio = await getStudio(); }
+          catch (error) { return json({ error: error instanceof Error ? error.message : String(error) }, 500); }
+          if (!studio) return html("<h1>当前 Markdown 渲染插件未提供 Studio 工作台。</h1>", 404);
+          const entry = await studioFile(studio.entry);
+          if (!entry) return html("<h1>插件 Studio 入口不存在或超出资源目录。</h1>", 500);
+          // 相对资源按插件入口解析，统一放入命名空间且保留页面导航链接。
+          return html(readFileSync(entry, "utf8").replace(/<(?:script|link)\b[^>]*>/g,
+            tag => tag.replace(/\b(src|href)=(["'])([^"']+)\2/g, (attribute, name, quote, value: string) => {
+              if (/^(?:[a-z][a-z0-9+.-]*:|\/\/|#)/i.test(value)) return attribute;
+              const asset = new URL(value, `http://studio/${studio.entry}`);
+              return `${name}=${quote}/studio-assets${asset.pathname}${asset.search}${quote}`;
+            })));
+        }
         const studioHtmlPath = join(DIST_DIR, "src/wechat-preview/browser/studio/studio.html");
         const fallbackPath = join(DIST_DIR, "studio.html");
         const targetHtmlPath = existsSync(studioHtmlPath) ? studioHtmlPath : fallbackPath;
@@ -325,6 +370,17 @@ export async function startPreviewServer(
         return html("<h1>Studio not built. Run bun run build:wechat-preview first.</h1>", 500);
       }
 
+      if (pathname.startsWith("/studio-assets/")) {
+        let name: string;
+        try { name = decodeURIComponent(pathname.slice("/studio-assets/".length)); }
+        catch { return json({ error: "invalid asset path" }, 400); }
+        const target = await studioFile(name);
+        if (!target) return json({ error: "Studio asset not found" }, 404);
+        return new Response(new Uint8Array(readFileSync(target)), {
+          headers: { "content-type": guessContentType(target), "cache-control": "no-cache" },
+        });
+      }
+
       if (pathname === "/studio.js" || pathname === "/editor-export.js") {
         const filePath = join(DIST_DIR, pathname.slice(1));
         if (existsSync(filePath)) {

package/src/wechat-preview/server/studio.test.ts

@@ -2,7 +2,7 @@ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 
 import { tmpdir } from "os";
 import { join } from "path";
-import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync } from "fs";
 import { startPreviewServer, type StartPreviewServerResult } from "./http";
 import { loadConfig, saveConfig } from "../../config";
 
@@ -160,11 +160,70 @@ describe("wechat-preview studio server APIs", () => {
     }
   });
 
+  test("loads standalone defaults without depending on account CSS or styles", async () => {
+    const path = join(testDir, "config", "studio-style.json");
+    writeFileSync(path, JSON.stringify({ schemaVersion: 1, engineVersion: 1, id: "style", name: "Style", version: "1.0.0",
+      css: "p { color: #123456; }", exportTheme: { bodyFontSize: "18px" }, syntaxPresets: { h2: "contrast-green" } }));
+    const config = loadConfig();
+    const original = { ...config.wx.accounts.default };
+    config.wx.accounts.default.articleTheme = "studio-style.json";
+    config.wx.accounts.default.customCss = "missing.css";
+    saveConfig(config);
+    try {
+      const response = await fetch(`${server.url}/api/studio/config`);
+      expect(response.status).toBe(200);
+      const data = await response.json() as any;
+      expect(data.accounts.default.theme.exportTheme.bodyFontSize).toBe("18px");
+      expect(data.accounts.default.theme.syntaxPresets.h2).toBe("contrast-green");
+      expect(data.accounts.default.articleThemeCss).toContain("#123456");
+      expect(data.accounts.default.customCssContent).toBe("");
+      expect(data.accounts.default.articleThemeStandalone).toBe(true);
+    } finally {
+      config.wx.accounts.default = original;
+      saveConfig(config);
+    }
+  });
+
   test("GET /studio serves the Studio HTML dashboard", async () => {
     const res = await fetch(`${server.url}/studio`);
     expect(res.status).toBe(200);
     const html = await res.text();
     expect(html).toContain("WeChat Visual Studio");
     expect(html).toContain("studio.js");
+    expect(html).toContain('id="btn-export-config"');
+  });
+
+  test("external Studio serves plugin resources without exposing files outside its root", async () => {
+    const root = join(testDir, "plugin-assets");
+    mkdirSync(root);
+    writeFileSync(join(root, "studio.html"), '<script src="/studio.js"></script><link href="/style.css"><a href="/">History</a>');
+    writeFileSync(join(root, "studio.js"), "/* plugin studio */");
+    writeFileSync(join(testDir, "private.txt"), "private");
+    symlinkSync(join(testDir, "private.txt"), join(root, "outside.txt"));
+    const pluginPath = join(testDir, "studio-plugin.mjs");
+    writeFileSync(pluginPath, `export default {name:'studio-test',render(){},studio(){return {root:${JSON.stringify(root)},entry:'studio.html'}}}`);
+    const config = loadConfig();
+    const original = config.plugins.markdownRenderer;
+    config.plugins.markdownRenderer = pluginPath;
+    saveConfig(config);
+    let external: StartPreviewServerResult | undefined;
+    const originalServerDir = process.env.ZZHUB_WECHAT_PREVIEW_DIR;
+    process.env.ZZHUB_WECHAT_PREVIEW_DIR = join(testDir, "external-server");
+    try {
+      external = await startPreviewServer({ host: "127.0.0.1", port: 0, reuseExisting: false });
+      const page = await (await fetch(`${external.url}/studio`)).text();
+      expect(page).toContain('src="/studio-assets/studio.js"');
+      expect(page).toContain('href="/studio-assets/style.css"');
+      expect(page).toContain('<a href="/">History</a>');
+      expect(await (await fetch(`${external.url}/studio-assets/studio.js`)).text()).toBe("/* plugin studio */");
+      expect((await fetch(`${external.url}/studio-assets/outside.txt`)).status).toBe(404);
+      expect((await fetch(`${external.url}/studio-assets/..%2fprivate.txt`)).status).toBe(404);
+      expect((await fetch(`${external.url}/api/studio/config`)).status).toBe(200);
+    } finally {
+      external?.stop?.();
+      process.env.ZZHUB_WECHAT_PREVIEW_DIR = originalServerDir;
+      config.plugins.markdownRenderer = original;
+      saveConfig(config);
+    }
   });
 });

package/src/wechat-preview/wechat-export.integration.test.ts

@@ -44,10 +44,27 @@ describe("semantic WeChat HTML export", () => {
     expect(html).toContain("Chapter</span>");
     expect(html).toContain("01</span>");
     expect(html).toContain("Citation</p>");
+    // 公众号编辑器解析不了 currentcolor/多值 border 简写，导出必须展开为可见边单值属性
+    expect(html).not.toContain("currentcolor");
+    // 引用导出为 section（规避微信编辑器对原生 blockquote 的强制灰色左边框），样式全靠内联
+    expect(html).not.toContain("<blockquote");
+    expect(html).toContain("border-left: 3px solid");
     expect(html).toContain("Advice</strong>");
     expect(html).toMatch(/background-color: (?:#1f7a4d|rgb\(31, 122, 77\))/);
   }, 30_000);
 
+  test("h2 pillar preset exports border-left on the heading section", async () => {
+    tempDir = await mkdtemp(join(tmpdir(), "zzhub-wechat-pillar-"));
+    const markdownPath = join(tempDir, "post.md");
+    await writeFile(markdownPath, "## 竖条标题\n\nBody.");
+    const { html } = await exportMarkdownToWechatHtml({
+      markdownPath, outPath: join(tempDir, "post.html"), account: "default",
+      themeOverrides: { syntaxPresets: { h2: "pillar" } },
+    });
+    const h2Tag = html.match(/<section[^>]*>(?:<span[^>]*>[^<]*<\/span>)*竖条标题/)?.[0] ?? "";
+    expect(h2Tag).toContain("border-left: 4px solid");
+  }, 30_000);
+
   test.skipIf(findChrome() === null)("Studio saves and resets the same style and ignores stale renders", async () => {
     const studio = await readFile(join(DIST_DIR, "src/wechat-preview/browser/studio/studio.html"), "utf8");
     const theme = getWechatPreviewTheme("default");
@@ -60,14 +77,20 @@ window.fetch = async (url, options) => {
   }
   return new Response(JSON.stringify(${JSON.stringify({ defaultAccount: "default", accounts: { default: { name: "default", theme, customCssContent: "" } }, plugins: [], sampleMarkdown: "# Title\n\nInitial body." })}));
 };
+const originalCreateObjectURL = URL.createObjectURL;
+URL.createObjectURL = blob => { window.exportedBlob = blob; return originalCreateObjectURL.call(URL, blob); };
+HTMLAnchorElement.prototype.click = function() { window.downloadName = this.download; };
 window.__zzhubRenderReady = (async () => {
   const waitFor = async predicate => { while (!predicate()) await new Promise(resolve => setTimeout(resolve, 20)); };
   const edit = (id, value) => { const input = document.getElementById(id); input.value = value; input.dispatchEvent(new Event('input')); };
   const source = () => document.getElementById('html-source-code')?.value || '';
   await waitFor(() => source().includes('Initial body.'));
   edit('input-font-size', '18'); edit('input-para-spacing', '1.44');
-  edit('input-heading-label', 'Chapter'); edit('input-custom-css', 'p { color: #123456; }');
+  edit('input-heading-label', 'Chapter'); edit('input-custom-css', '.milkdown .editor p { color: #123456; }');
   await waitFor(() => source().includes('font-size: 18px') && source().includes('margin-bottom: 1.44em'));
+  document.getElementById('btn-export-config').click();
+  const exported = JSON.parse(await window.exportedBlob.text());
+  const exportDidNotSave = !window.saved;
   document.getElementById('btn-save').click();
   await waitFor(() => window.saved);
   await new Promise(resolve => setTimeout(resolve, 20));
@@ -79,10 +102,10 @@ window.__zzhubRenderReady = (async () => {
   Image.prototype.decode = async function() { await new Promise(resolve => setTimeout(resolve, 250)); return originalDecode.call(this); };
   edit('editor-markdown', '![0.50](data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7)');
   await new Promise(resolve => setTimeout(resolve, 100));
-  edit('editor-markdown', 'Latest body.');
-  await waitFor(() => source().includes('Latest body.'));
+  edit('editor-markdown', 'Latest body.\\n\\n![1.00](data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7 "Crepe 图注")');
+  await waitFor(() => source().includes('Latest body.') && source().includes('Crepe 图注</p>'));
   const result = document.createElement('script'); result.id = 'zzhub-wechat-export-result'; result.type = 'application/json';
-  result.textContent = JSON.stringify({status:'success',html:JSON.stringify({saved:window.saved,resetOk,html:source()})});
+  result.textContent = JSON.stringify({status:'success',html:JSON.stringify({saved:window.saved,exported,exportDidNotSave,downloadName:window.downloadName,resetOk,html:source()})});
   document.body.appendChild(result);
 })();
 </script>`);
@@ -90,12 +113,30 @@ window.__zzhubRenderReady = (async () => {
     expect(result.status).toBe("success");
     if (!("html" in result)) throw new Error("Studio did not produce HTML");
     const checked = JSON.parse(result.html);
+    expect(checked.exported.account).toBeUndefined();
+    expect(checked.exported.exportTheme.bodyFontSize).toBe("18px");
+    expect(checked.exported.structure.headingLabel).toBe("Chapter");
+    expect(checked.exported.css).toContain("#123456");
+    expect(checked.exportDidNotSave).toBe(true);
+    expect(checked.downloadName).toBe("wechat-style.json");
+    tempDir = await mkdtemp(join(tmpdir(), "zzhub-standalone-export-"));
+    const profilePath = join(tempDir, "wechat-style.json");
+    const markdownPath = join(tempDir, "post.md");
+    await writeFile(profilePath, JSON.stringify(checked.exported));
+    await writeFile(markdownPath, "## Section\n\nPortable body.");
+    const portable = await exportMarkdownToWechatHtml({
+      markdownPath, outPath: join(tempDir, "post.html"), account: "ancientone", articleThemePath: profilePath,
+      themeOverrides: { exportTheme: { bodyFontSize: "14px" } },
+    });
+    expect(portable.html).toMatch(/<p[^>]+font-size: 18px[^>]*>Portable body\.<\/p>/);
+    expect(portable.html).toContain("Chapter</span>");
+    expect(portable.html).toMatch(/color: (?:#123456|rgb\(18, 52, 86\))/);
     expect(checked.saved.exportTheme.bodyFontSize).toBe("18px");
     expect(checked.saved.exportTheme.bodyParagraphSpacing).toBe("1.44em");
     expect(checked.saved.structure.headingLabel).toBe("Chapter");
     expect(checked.resetOk).toBe(true);
     expect(checked.html).toContain("Latest body.");
-    expect(checked.html).not.toContain("<img");
+    expect(checked.html).toContain("Crepe 图注</p>");
   }, 20_000);
 
   test.skipIf(findChrome() === null)("renders all nodes, cascades CSS, and emits a safe exact preview", async () => {
@@ -123,8 +164,8 @@ window.__zzhubRenderReady = (async () => {
 
     expect(result.html).toBe(html);
     expect(html.length).toBeLessThan(65_400);
-    expect(html).toContain("一级标题：克制的中文编辑部");
-    expect(html).toContain("<blockquote");
+    expect(html).toContain("二级标题：清晰但不过度装饰");
+    expect(html).not.toContain("<blockquote");
     expect(html).toContain("重点结论</span>");
     expect(html).not.toContain("==重点结论==");
     expect(html).toContain("==不高亮==");
@@ -170,7 +211,7 @@ window.__zzhubRenderReady = (async () => {
 
     const tagNames = Array.from(html.matchAll(/<\/?([a-z][a-z0-9-]*)\b/gi), (match) => match[1]?.toLowerCase());
     const allowedTags = new Set([
-      "section", "p", "blockquote", "ul", "ol", "li", "pre", "code",
+      "section", "p", "ul", "ol", "li", "pre", "code",
       "span", "strong", "em", "b", "i", "u", "s", "del", "a", "img",
       "br", "hr", "table", "thead", "tbody", "tr", "th", "td",
     ]);