md2wx-cli 0.2.0__py3-none-any.whl

md2wx/gallery.py

@@ -0,0 +1,199 @@
+"""Theme Gallery generator for md2wx — Shadcn-styled interactive theme explorer."""
+
+import json
+import tempfile
+import webbrowser
+from pathlib import Path
+from typing import Optional
+
+from .converter import WeChatConverter
+from .theme import list_themes, load_theme
+
+
+def generate_gallery_html(markdown_text: str, title: str = "Theme Gallery", base_dir: Optional[Path] = None) -> str:
+    """Compile Markdown across all themes and wrap in a clean Shadcn-styled single-file explorer."""
+    themes = list_themes()
+    theme_data = {}
+
+    for tname in themes:
+        try:
+            th = load_theme(tname)
+            conv = WeChatConverter(theme=th)
+            res = conv.convert(markdown_text, base_dir=base_dir)
+            theme_data[tname] = {
+                "name": tname,
+                "description": getattr(th, "description", ""),
+                "primary": th.colors.get("primary", "#2563eb"),
+                "html": res.html,
+            }
+        except Exception:
+            continue
+
+    themes_json = json.dumps(theme_data, ensure_ascii=False).replace("</script>", "<\\/script>")
+    default_theme = "default" if "default" in theme_data else list(theme_data.keys())[0]
+
+    return f"""<!DOCTYPE html>
+<html lang="zh-CN" class="dark">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{title} — md2wx Theme Gallery</title>
+    <style>
+        :root {{
+            --bg: #09090b; --card-bg: #18181b; --border: #27272a;
+            --text-primary: #fafafa; --text-muted: #a1a1aa; --accent: #2563eb;
+        }}
+        * {{ margin: 0; padding: 0; box-sizing: border-box; }}
+        body {{
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "PingFang SC", sans-serif;
+            background-color: var(--bg); color: var(--text-primary); min-height: 100vh; display: flex; flex-direction: column;
+        }}
+        header {{
+            position: sticky; top: 0; z-index: 50; background: rgba(9, 9, 11, 0.85); backdrop-filter: blur(12px);
+            border-bottom: 1px solid var(--border); padding: 12px 24px; display: flex; align-items: center; justify-content: space-between; gap: 16px;
+        }}
+        .brand {{ display: flex; align-items: center; gap: 10px; font-weight: 700; font-size: 15px; }}
+        .brand-badge {{ font-size: 11px; padding: 2px 7px; background: #27272a; border: 1px solid #3f3f46; border-radius: 9999px; color: #d4d4d8; }}
+        .controls {{ display: flex; align-items: center; gap: 10px; }}
+        .btn {{
+            display: inline-flex; align-items: center; gap: 6px; padding: 6px 14px; font-size: 13px; font-weight: 500;
+            border-radius: 6px; cursor: pointer; transition: all 0.15s ease; border: 1px solid var(--border);
+            background: var(--card-bg); color: var(--text-primary); outline: none;
+        }}
+        .btn-primary {{ background: var(--accent); border-color: var(--accent); color: white; }}
+        .btn-primary:hover {{ background: #1d4ed8; }}
+        .layout {{ display: flex; flex: 1; overflow: hidden; }}
+        aside {{
+            width: 280px; flex-shrink: 0; background: var(--card-bg); border-right: 1px solid var(--border);
+            padding: 16px; display: flex; flex-direction: column; gap: 6px; overflow-y: auto;
+        }}
+        .theme-item {{
+            display: flex; flex-direction: column; padding: 10px 12px; border-radius: 6px;
+            cursor: pointer; transition: all 0.15s ease; border: 1px solid transparent; text-align: left; background: transparent; color: inherit;
+        }}
+        .theme-item:hover {{ background: rgba(255, 255, 255, 0.04); }}
+        .theme-item.active {{ background: rgba(37, 99, 235, 0.12); border-color: rgba(37, 99, 235, 0.35); }}
+        .theme-title {{ font-size: 13px; font-weight: 600; margin-bottom: 2px; }}
+        .theme-desc {{ font-size: 11px; color: var(--text-muted); line-height: 1.4; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }}
+        main {{ flex: 1; display: flex; justify-content: center; align-items: flex-start; padding: 32px 24px; overflow-y: auto; background: #0c0d12; }}
+        .canvas {{
+            width: 100%; max-width: 640px; background: #ffffff; color: #1e293b; border-radius: 12px;
+            box-shadow: 0 10px 30px rgba(0, 0, 0, 0.4); padding: 36px 24px; min-height: 80vh; transition: all 0.2s ease;
+        }}
+        .toast {{
+            position: fixed; bottom: 24px; right: 24px; background: #10b981; color: white; padding: 10px 18px;
+            border-radius: 6px; font-size: 13px; font-weight: 500; opacity: 0; transform: translateY(10px);
+            transition: all 0.2s ease; pointer-events: none; z-index: 100;
+        }}
+        .toast.show {{ opacity: 1; transform: translateY(0); }}
+    </style>
+</head>
+<body>
+    <header>
+        <div class="brand">
+            <span>md2wx</span>
+            <span class="brand-badge">Theme Gallery</span>
+        </div>
+        <div class="controls">
+            <button id="copy-btn" class="btn btn-primary" onclick="copyCurrentHtml()">📋 复制当前主题富文本</button>
+        </div>
+    </header>
+    <div class="layout">
+        <aside id="theme-list"></aside>
+        <main>
+            <div class="canvas" id="preview-canvas"></div>
+        </main>
+    </div>
+    <div class="toast" id="toast">已成功复制微信排版富文本！</div>
+    <script id="themes-data" type="application/json">
+        {themes_json}
+    </script>
+    <script>
+        const themesData = JSON.parse(document.getElementById('themes-data').textContent);
+        let currentTheme = '{default_theme}';
+
+        function renderSidebar() {{
+            const listEl = document.getElementById('theme-list');
+            listEl.innerHTML = '';
+            Object.keys(themesData).forEach(key => {{
+                const item = themesData[key];
+                const btn = document.createElement('button');
+                btn.className = `theme-item ${{key === currentTheme ? 'active' : ''}}`;
+                btn.onclick = () => selectTheme(key);
+                btn.innerHTML = `
+                    <div class="theme-title" style="color: ${{key === currentTheme ? 'var(--accent)' : 'var(--text-primary)'}}">${{item.name}}</div>
+                    <div class="theme-desc">${{item.description}}</div>
+                `;
+                listEl.appendChild(btn);
+            }});
+        }}
+
+        function selectTheme(name) {{
+            currentTheme = name;
+            renderSidebar();
+            const canvas = document.getElementById('preview-canvas');
+            canvas.innerHTML = themesData[name].html;
+        }}
+
+        async function copyCurrentHtml() {{
+            const htmlContent = themesData[currentTheme].html;
+            try {{
+                const blobHtml = new Blob([htmlContent], {{ type: 'text/html' }});
+                const blobText = new Blob([document.getElementById('preview-canvas').innerText], {{ type: 'text/plain' }});
+                await navigator.clipboard.write([
+                    new ClipboardItem({{ 'text/html': blobHtml, 'text/plain': blobText }})
+                ]);
+                showToast('已成功复制微信排版富文本！');
+            }} catch (err) {{
+                showToast('复制失败，请手动全选预览区域复制');
+            }}
+        }}
+
+        function showToast(msg) {{
+            const toast = document.getElementById('toast');
+            toast.textContent = msg;
+            toast.classList.add('show');
+            setTimeout(() => toast.classList.remove('show'), 2000);
+        }}
+
+        selectTheme(currentTheme);
+    </script>
+</body>
+</html>"""
+
+
+def open_in_browser(html_content: str) -> None:
+    """Save gallery HTML to a temp file and open in default browser."""
+    with tempfile.NamedTemporaryFile("w", suffix=".html", delete=False, encoding="utf-8") as f:
+        f.write(html_content)
+        temp_path = f.name
+    webbrowser.open(f"file://{temp_path}")
+
+
+def launch_gallery(
+    input_source: object,
+    title: str = "Theme Gallery",
+    output_html: Optional[Path] = None,
+    open_browser: bool = True,
+) -> Path:
+    """Compile gallery across themes, save to file and open in browser."""
+    if isinstance(input_source, Path) and input_source.exists():
+        markdown_text = input_source.read_text(encoding="utf-8-sig")
+        base_dir = input_source.parent
+    else:
+        markdown_text = str(input_source)
+        base_dir = None
+
+    html = generate_gallery_html(markdown_text, title=title, base_dir=base_dir)
+    if output_html is None:
+        with tempfile.NamedTemporaryFile("w", suffix=".html", delete=False, encoding="utf-8") as f:
+            f.write(html)
+            target = Path(f.name)
+    else:
+        output_html.parent.mkdir(parents=True, exist_ok=True)
+        output_html.write_text(html, encoding="utf-8")
+        target = output_html
+
+    if open_browser:
+        webbrowser.open(f"file://{target.resolve()}")
+    return target

md2wx/publisher.py

@@ -0,0 +1,136 @@
+"""微信公众号草稿直传与发布模块 —— 原生微信 Open Platform API 接入。"""
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import List, Optional, Tuple
+
+from .wechat_api import (
+    _http_post_json,
+    get_access_token,
+    upload_article_image,
+    upload_cover_material,
+)
+
+
+@dataclass
+class DraftResult:
+    media_id: str
+
+
+def create_draft(
+    access_token: str,
+    title: str,
+    html: str,
+    digest: str,
+    thumb_media_id: str,
+    author: Optional[str] = None,
+    show_cover_pic: int = 0,
+) -> DraftResult:
+    """调用微信官方 API 创建图文草稿。
+    
+    接口: POST https://api.weixin.qq.com/cgi-bin/draft/add
+    """
+    if not thumb_media_id:
+        raise ValueError("创建微信公众号图文草稿必须提供封面素材 thumb_media_id")
+
+    article = {
+        "title": title,
+        "author": author or "",
+        "digest": digest,
+        "content": html,
+        "thumb_media_id": thumb_media_id,
+        "show_cover_pic": show_cover_pic,
+        "need_open_comment": 1,
+        "only_fans_can_comment": 0,
+    }
+
+    data = _http_post_json(
+        "https://api.weixin.qq.com/cgi-bin/draft/add",
+        params={"access_token": access_token},
+        json_data={"articles": [article]},
+    )
+
+    errcode = data.get("errcode", 0)
+    if errcode != 0:
+        errmsg = data.get("errmsg", "unknown error")
+        raise ValueError(f"创建微信草稿失败: errcode={errcode}, errmsg={errmsg}")
+
+    media_id = data.get("media_id")
+    if not media_id:
+        raise ValueError(f"创建草稿异常，未返回 media_id: {data}")
+
+    return DraftResult(media_id=media_id)
+
+
+def publish_to_wechat(
+    html: str,
+    title: str,
+    digest: str,
+    images: List[str],
+    appid: str,
+    secret: str,
+    cover: Optional[str] = None,
+    author: Optional[str] = None,
+    base_dir: Optional[Path] = None,
+) -> str:
+    """一站式将排版好的富文本文章上传并发布至微信公众号草稿箱。
+    
+    1. 获取官方 Access Token；
+    2. 自动上传文中相对/绝对本地图片到微信 CDN 并替换 HTML 中的 src；
+    3. 上传指定封面（或首图）作为永久封面素材；
+    4. 提交草稿箱，返回 media_id。
+    """
+    token = get_access_token(appid, secret)
+    processed_html = html
+
+    # 1. 上传文中本地图片至微信 CDN 图床
+    uploaded_count = 0
+    for img_src in images:
+        if img_src.startswith(("http://", "https://", "data:")):
+            continue
+
+        img_path = Path(img_src)
+        if not img_path.is_absolute() and base_dir:
+            img_path = (base_dir / img_src).resolve()
+
+        if img_path.exists():
+            wechat_cdn_url = upload_article_image(token, str(img_path))
+            processed_html = processed_html.replace(img_src, wechat_cdn_url)
+            uploaded_count += 1
+
+    # 2. 准备图文封面素材 thumb_media_id
+    cover_path: Optional[Path] = None
+    if cover:
+        p = Path(cover)
+        if not p.is_absolute() and base_dir:
+            p = (base_dir / cover).resolve()
+        if p.exists():
+            cover_path = p
+        else:
+            raise FileNotFoundError(f"未找到指定的封面图片文件: {cover}")
+    elif images:
+        # 回退：使用文中第一张本地图片作为封面
+        for img_src in images:
+            if not img_src.startswith(("http://", "https://", "data:")):
+                p = Path(img_src)
+                if not p.is_absolute() and base_dir:
+                    p = (base_dir / img_src).resolve()
+                if p.exists():
+                    cover_path = p
+                    break
+
+    if not cover_path:
+        raise ValueError("微信公众号官方要求每篇草稿必须有封面图，请使用 --cover 指定封面图片路径。")
+
+    thumb_media_id = upload_cover_material(token, str(cover_path))
+
+    # 3. 创建图文草稿
+    draft = create_draft(
+        access_token=token,
+        title=title,
+        html=processed_html,
+        digest=digest,
+        thumb_media_id=thumb_media_id,
+        author=author,
+    )
+    return draft.media_id

md2wx/styler.py

@@ -0,0 +1,288 @@
+"""WeChat inline style engine, DOM mutator, and platform sanitizer."""
+
+import re
+from typing import Optional
+from bs4 import BeautifulSoup
+
+from .theme import Theme
+
+
+def apply_inline_styles(soup: BeautifulSoup, theme: Theme, css_rules: dict) -> None:
+    """Inject computed inline CSS and enhance theme-specific components."""
+    typo = getattr(theme, "typography", {}) or {}
+    comp = getattr(theme, "components", {}) or {}
+    colors = getattr(theme, "colors", {}) or {}
+
+    font_heading = typo.get("font_heading", "")
+
+    # 1. 应用基础 CSS 选择器规则
+    for selector, styles in css_rules.items():
+        sel = selector.strip()
+        if sel == "body":
+            continue
+        try:
+            elements = soup.select(sel)
+        except Exception:
+            continue
+        for elem in elements:
+            if sel == "code" and elem.find_parent("pre"):
+                continue
+            existing = elem.get("style", "")
+            sdict = {}
+            if existing:
+                for item in existing.split(";"):
+                    if ":" in item:
+                        k, v = item.split(":", 1)
+                        sdict[k.strip()] = v.strip()
+            for prop, val in styles.items():
+                if prop not in sdict:
+                    sdict[prop] = val
+            elem["style"] = "; ".join(f"{k}: {v}" for k, v in sdict.items())
+
+    # 2. 标题独立字体栈与装饰模式增强
+    h2_comp = comp.get("h2", {}) or comp.get("heading_h2", {})
+    h2_style = h2_comp.get("style", "")
+    h2_divider = h2_comp.get("section_divider", False)
+
+    for tag in ["h1", "h2", "h3"]:
+        for el in soup.find_all(tag):
+            est = el.get("style", "")
+            if font_heading and "font-family" not in est:
+                el["style"] = f"font-family: {font_heading}; {est}" if est else f"font-family: {font_heading}"
+
+            if tag == "h2":
+                if h2_style == "none":
+                    st = el.get("style", "")
+                    st = re.sub(r"border-left:[^;]+;?", "", st)
+                    st = re.sub(r"padding-left:[^;]+;?", "", st)
+                    el["style"] = f"{st}; border: none !important; padding: 0 !important"
+                elif h2_style == "border-bottom":
+                    pcolor = h2_comp.get("color", colors.get("primary", "#2563eb"))
+                    el["style"] = f"{el.get('style', '')}; border-bottom: 2px solid {pcolor}; padding-bottom: 8px;"
+
+                if h2_divider:
+                    prev = el.find_previous_sibling()
+                    if prev and prev.name not in ("h1", "hr"):
+                        hr = soup.new_tag("section", style="border-top: 1px solid #e2e8f0; height: 0; margin: 32px 0 16px 0; padding: 0;")
+                        el.insert_before(hr)
+
+    # 3. strong 加粗字体独立对比色注入
+    strong_comp = comp.get("strong", {})
+    strong_color = strong_comp.get("color", "")
+    strong_weight = strong_comp.get("font_weight", 600)
+    if strong_color:
+        for s_tag in soup.find_all("strong"):
+            est = s_tag.get("style", "")
+            s_tag["style"] = f"color: {strong_color} !important; font-weight: {strong_weight}; {est}" if est else f"color: {strong_color} !important; font-weight: {strong_weight}"
+
+    # 4. 高亮卡片/引用块 (callout) 居中卡片样式
+    callout_comp = comp.get("callout", {})
+    if callout_comp.get("style") == "center-card":
+        c_bg = callout_comp.get("background", "#eff6ff")
+        c_color = callout_comp.get("color", "#2563eb")
+        c_rad = callout_comp.get("border_radius", "8px")
+        for bq in soup.find_all("blockquote"):
+            bq["style"] = f"background: {c_bg} !important; color: {c_color} !important; border-radius: {c_rad} !important; border: none !important; padding: 16px 20px !important; margin: 20px 0 !important; text-align: center !important;"
+            for p_child in bq.find_all("p"):
+                p_child["style"] = f"color: {c_color} !important; margin: 0 !important; text-align: center !important; font-weight: 600 !important;"
+
+    # 5. 居中装帧分隔符 (✦ / ✧ / * * *)
+    for p in soup.find_all("p"):
+        txt = p.get_text(strip=True)
+        if txt in ("✦", "✧", "◆", "◇", "* * *"):
+            p["style"] = "text-align: center !important; font-size: 13px !important; color: #cbd5e1 !important; margin: 32px 0 24px 0 !important; letter-spacing: 4px;"
+
+    # 6. 插图外层弥散阴影与圆角
+    img_comp = comp.get("image", {})
+    img_shadow = img_comp.get("box_shadow", "")
+    img_rad = img_comp.get("border_radius", "")
+    if img_shadow or img_rad:
+        for img in soup.find_all("img"):
+            est = img.get("style", "")
+            extra = []
+            if img_shadow and "box-shadow" not in est:
+                extra.append(f"box-shadow: {img_shadow}")
+            if img_rad and "border-radius" not in est:
+                extra.append(f"border-radius: {img_rad}")
+            if extra:
+                img["style"] = f"{est}; {'; '.join(extra)}" if est else "; ".join(extra)
+
+    # 7. 代码块横向滚动保障
+    for pre in soup.find_all("pre"):
+        for code in pre.find_all("code"):
+            code["style"] = (
+                "display: block !important; width: max-content !important; min-width: 100% !important; "
+                "max-width: none !important; white-space: pre !important; word-wrap: normal !important; "
+                "word-break: normal !important; text-align: left !important; background: transparent !important; "
+                "color: inherit !important; padding: 0 !important; border: none !important; "
+                "font-size: inherit; font-family: inherit; line-height: inherit"
+            )
+
+
+def preserve_code_block_newlines(soup: BeautifulSoup) -> None:
+    """为 <pre> 代码块内的换行符补充 <br/>，防止微信入库和回显时塌缩为单行。"""
+    for pre in soup.find_all("pre"):
+        for text_node in list(pre.find_all(string=True)):
+            if "\n" in text_node:
+                parts = text_node.split("\n")
+                curr = text_node
+                for idx, part in enumerate(parts):
+                    if part:
+                        s_node = soup.new_string(part)
+                        curr.insert_after(s_node)
+                        curr = s_node
+                    if idx < len(parts) - 1:
+                        br_node = soup.new_tag("br")
+                        curr.insert_after(br_node)
+                        curr = br_node
+                text_node.extract()
+
+
+def apply_wechat_fixes(soup: BeautifulSoup, text_color: str = "#333333") -> None:
+    """修复微信端特定标签与段落样式。"""
+    for p in soup.find_all("p"):
+        style = p.get("style", "")
+        if "color" not in style:
+            p["style"] = f"{style}; color: {text_color}" if style else f"color: {text_color}"
+
+    for pre in soup.find_all("pre"):
+        style = pre.get("style", "")
+        sdict = {}
+        if style:
+            for item in style.split(";"):
+                if ":" in item:
+                    k, v = item.split(":", 1)
+                    sdict[k.strip()] = v.strip()
+        sdict["overflow-x"] = "auto !important"
+        sdict["overflow-y"] = "hidden"
+        sdict["white-space"] = "pre !important"
+        sdict["word-wrap"] = "normal !important"
+        sdict["word-break"] = "normal !important"
+        sdict["text-align"] = "left !important"
+        sdict["-webkit-overflow-scrolling"] = "touch"
+        sdict["box-sizing"] = "border-box"
+        pre["style"] = "; ".join(f"{k}: {v}" for k, v in sdict.items())
+
+        for span in pre.find_all("span"):
+            est = span.get("style", "")
+            if "text-align" not in est:
+                span["style"] = f"{est}; text-align: left !important; white-space: pre !important; word-wrap: normal !important" if est else "text-align: left !important; white-space: pre !important; word-wrap: normal !important"
+
+
+def convert_lists_to_sections(soup: BeautifulSoup, text_color: str, primary: str) -> None:
+    """将无序与有序列表转为稳定的 Section Flex 容器。"""
+    for ul in soup.find_all("ul"):
+        sec = soup.new_tag("section")
+        for li in ul.find_all("li", recursive=False):
+            item = soup.new_tag("section", style=f"display: flex; align-items: flex-start; margin-bottom: 8px; color: {text_color}")
+            bullet = soup.new_tag("span", style=f"color: {primary}; margin-right: 8px; flex-shrink: 0; font-size: 18px; line-height: 1.6")
+            bullet.string = "•"
+            content = soup.new_tag("span", style="flex: 1")
+            for c in list(li.children):
+                content.append(c.extract() if hasattr(c, "extract") else c)
+            item.append(bullet)
+            item.append(content)
+            sec.append(item)
+        ul.replace_with(sec)
+
+    for ol in soup.find_all("ol"):
+        sec = soup.new_tag("section")
+        for num, li in enumerate(ol.find_all("li", recursive=False), 1):
+            item = soup.new_tag("section", style=f"display: flex; align-items: flex-start; margin-bottom: 8px; color: {text_color}")
+            number = soup.new_tag("span", style=f"color: {primary}; margin-right: 8px; flex-shrink: 0; font-weight: 700; line-height: 1.8")
+            number.string = f"{num}."
+            content = soup.new_tag("span", style="flex: 1")
+            for c in list(li.children):
+                content.append(c.extract() if hasattr(c, "extract") else c)
+            item.append(number)
+            item.append(content)
+            sec.append(item)
+        ol.replace_with(sec)
+
+
+def convert_links_to_footnotes(soup: BeautifulSoup, primary: str) -> None:
+    """将文本中的外部超链接提取为文末上标脚注。"""
+    footnotes = []
+    counter = 0
+
+    for a in soup.find_all("a"):
+        href = a.get("href", "")
+        if not href or href.startswith("#"):
+            continue
+        counter += 1
+        text = a.get_text()
+        footnotes.append((counter, text, href))
+        sup = soup.new_tag("sup")
+        sup_link = soup.new_tag("span", style=f"color: {primary}; font-size: 12px")
+        sup_link.string = f"[{counter}]"
+        sup.append(sup_link)
+        a.replace_with(text, sup)
+
+    if footnotes:
+        hr = soup.new_tag("hr", style="border: none; border-top: 1px solid #e5e5e5; margin: 32px 0 16px")
+        soup.append(hr)
+        ref_title = soup.new_tag("p", style="font-size: 13px; color: #999999; margin-bottom: 8px; font-weight: 700")
+        ref_title.string = "参考链接"
+        soup.append(ref_title)
+        for num, text, href in footnotes:
+            ref = soup.new_tag("p", style="font-size: 12px; color: #999999; margin: 2px 0; word-break: break-all")
+            ref.string = f"[{num}] {text}: {href}"
+            soup.append(ref)
+
+
+def inject_darkmode(soup: BeautifulSoup, darkmode_config: dict) -> None:
+    """注入微信专用暗黑模式数据属性。"""
+    if not darkmode_config:
+        return
+    for tag in ("p", "span", "section"):
+        for el in soup.find_all(tag):
+            if "color" in el.get("style", ""):
+                el["data-darkmode-color"] = darkmode_config.get("text", "#c8c8c8")
+                el["data-darkmode-bgcolor"] = "transparent"
+    for tag in ("h1", "h2", "h3", "h4"):
+        for el in soup.find_all(tag):
+            el["data-darkmode-color"] = darkmode_config.get("text", "#e0e0e0")
+            el["data-darkmode-bgcolor"] = "transparent"
+    for pre in soup.find_all("pre"):
+        pre["data-darkmode-bgcolor"] = darkmode_config.get("code_bg", "#2d2d2d")
+        pre["data-darkmode-color"] = darkmode_config.get("code_color", "#d4d4d4")
+    for code in soup.find_all("code"):
+        code["data-darkmode-color"] = darkmode_config.get("code_color", "#d4d4d4")
+    for bq in soup.find_all("blockquote"):
+        bq["data-darkmode-bgcolor"] = darkmode_config.get("quote_bg", "#2a2a2a")
+        bq["data-darkmode-color"] = darkmode_config.get("text", "#c8c8c8")
+
+
+def sanitize_for_wechat(soup: BeautifulSoup) -> None:
+    """清洗不合规标签、class 与 id 属性。"""
+    for div in soup.find_all("div"):
+        div.name = "section"
+    for el in soup.find_all(attrs={"class": True}):
+        del el["class"]
+    for el in soup.find_all(attrs={"id": True}):
+        del el["id"]
+
+
+def make_paste_safe(html: str) -> str:
+    """给所有非代码文本节点包裹 span[leaf]，为空装饰元素补充占位。"""
+    soup = BeautifulSoup(html, "html.parser")
+    for node in list(soup.find_all(string=True)):
+        if not str(node).strip() or node.find_parent(["pre", "code"]) is not None:
+            continue
+        parent = node.parent
+        if parent and parent.name == "span" and parent.has_attr("leaf"):
+            continue
+        wrap = soup.new_tag("span")
+        wrap["leaf"] = ""
+        node.wrap(wrap)
+
+    for el in soup.find_all(["section", "span"]):
+        if el.find_parent(["pre", "code"]) is not None or el.name in ["pre", "code"]:
+            continue
+        if not el.get_text(strip=True) and not el.find(["img", "br"]) and not (el.name == "span" and el.has_attr("leaf")):
+            ph = soup.new_tag("span")
+            ph["leaf"] = ""
+            ph.append(soup.new_tag("br"))
+            el.append(ph)
+
+    return str(soup)