md2wx-cli 0.2.0__tar.gz → 0.2.1__tar.gz

md2wx_cli-0.2.1/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: md2wx-cli
+Version: 0.2.1
+Summary: 轻量级 Markdown 转微信公众号 HTML CLI 工具（支持剪贴板直达、主题提取、WeChatSync 联动）
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown>=3.10
+Requires-Dist: beautifulsoup4>=4.14
+Requires-Dist: cssutils>=2.11
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: Pygments>=2.17
+Dynamic: license-file
+
+# md2wx-cli
+
+[![PyPI](https://img.shields.io/pypi/v/md2wx-cli)](https://pypi.org/project/md2wx-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/md2wx-cli)](https://pypi.org/project/md2wx-cli/)
+[![License](https://img.shields.io/pypi/l/md2wx-cli)](LICENSE)
+
+> 轻量、确定性、高保真的 Markdown 转微信公众号排版 CLI。
+
+从写作到发布全链路命令行闭环：内联 CSS 排版、5 套精选主题、多主题画廊对比、推文抓取逆向、主题智能提取、官方 API 直传草稿箱、排版合规体检。不依赖任何网页编辑器，改一个错别字只需重跑一条命令。
+
+## 安装
+
+要求 Python ≥ 3.11。
+
+```bash
+pip install md2wx-cli
+```
+
+或免安装直接运行：
+
+```bash
+uvx md2wx-cli article.md -c
+```
+
+> 命令入口名为 `md2wx`。PyPI 包名 `md2wx-cli` 与 import 名 `md2wx` 分离（`md2wx` 在 PyPI 上已被其他项目占用）。
+
+## 快速开始
+
+```bash
+# 转换并写入系统剪贴板，公众号编辑器 Ctrl+V 直接粘贴
+md2wx article.md -c
+
+# 输出 HTML 文件
+md2wx article.md -o output.html
+
+# 切换主题
+md2wx article.md -t github-tech -c
+
+# 生成完整 <html> 独立页面，双击即可预览
+md2wx article.md -o preview.html --full-page
+
+# 支持标准输入管道
+cat article.md | md2wx -c
+```
+
+转换器处理的不只是 Markdown 渲染：中英文之间自动加空格、代码块语法高亮（Pygments）、外链自动转为文末脚注（微信正文不允许外链可点击）、全内联 CSS 与暗黑模式适配——这些全是微信编辑器的兼容性硬需求。
+
+## 主题系统
+
+内置 5 套主题，`-t` 一键切换：
+
+| 主题 | 风格 | 适合内容 |
+| :--- | :--- | :--- |
+| `default` | 现代极简杂志编辑风 | 通用，默认选项 |
+| `github-tech` | GitHub 开发者文档风（OneDark 代码高亮） | 教程、源码解析 |
+| `bauhaus` | 包豪斯几何设计风 | 设计类、观点文 |
+| `bold-green` | 清新高对比科技绿 | 环保、健康主题 |
+| `bold-navy` | 深邃藏青商务编辑风 | 深度长文、行业分析 |
+
+不确定选哪套？生成全主题交互画廊，浏览器里秒级切换对比，选中即一键复制：
+
+```bash
+md2wx gallery article.md -o gallery.html
+```
+
+主题是 YAML 文件（字体栈、配色、标题层级、代码块样式全部可调），也支持从外部逆向提取：
+
+```bash
+# 从一篇排版不错的微信推文学一套主题
+md2wx learn-theme --url "https://mp.weixin.qq.com/s/xxxxxx" -n brand-editorial
+
+# 或从本地设计稿目录提取
+md2wx learn-theme --dir ./design_folder -n brand-editorial
+
+# 直接套用
+md2wx article.md -t brand-editorial -c
+```
+
+## 发布到公众号草稿箱
+
+前置条件：公众号 AppID / AppSecret（微信公众平台「设置与开发 → 基本配置」获取），且将本机出口 IP 加入后台 **IP 白名单**（否则报 `errcode=40164`）。
+
+首次配置凭据，永久保存至 `~/.md2wx/config.yaml`：
+
+```bash
+md2wx config set wechat.appid "wx1234567890abcdef"
+md2wx config set wechat.secret "你的AppSecret"
+```
+
+一键直传（自动上传本地配图到微信永久图床并替换链接、上传封面、创建草稿）：
+
+```bash
+md2wx article.md -p --title "文章标题" --author "作者" --cover images/cover.png
+```
+
+命令返回 `media_id`，登录 mp.weixin.qq.com 在草稿箱中确认后手动群发。**直传只写草稿箱，不会自动群发。**
+
+凭据读取优先级：命令行参数（`--appid` / `--secret`）> 环境变量 > `~/.md2wx/config.yaml`，方便在 CI 中注入。
+
+> 注意：`--cover` 路径相对于输入 Markdown 文件所在目录解析，建议传绝对路径或相对 md 文件的路径。
+
+## 发布前体检
+
+```bash
+md2wx check article.md
+```
+
+内置 16+ 条微信平台硬规则检测：失效的本地图片引用、未转脚注的裸外链、编辑器不支持的非法 CSS（`position: fixed`、`display: grid`、`animation` 等）、代码块格式保护。体检通过再直传，基本不会翻车。
+
+## 抓取推文逆向
+
+```bash
+md2wx fetch "https://mp.weixin.qq.com/s/xxxxxx" -o draft.md
+```
+
+配图自动下载至 `draft-assets/`，居中高亮、白底卡片、实心横幅被识别还原为对应的容器语法。学习他人排版或做二次加工，从这一步开始。
+
+## 容器排版语法
+
+标准 Markdown 之外，原生支持几种扩展容器（渲染为微信兼容的内联样式组件）：
+
+```markdown
+::: banner 导语标题
+正文内容，支持 **加粗** 与 `代码`
+:::
+
+::: card 白底描边卡片，适合承载补充说明或外链
+https://github.com/example/repo
+:::
+
+> [!WARNING]
+> GitHub 风格告示块同样支持，自动渲染为主题色提示卡。
+```
+
+## 配置文件
+
+`~/.md2wx/config.yaml`：
+
+```yaml
+wechat:
+  appid: "wx1234567890abcdef"
+  secret: "你的AppSecret"
+  author: "你的笔名"
+```
+
+## 开发
+
+```bash
+git clone <repo-url> && cd md2wx-cli
+pip install -e .
+python -m pytest tests/
+```
+
+## License
+
+MIT

md2wx_cli-0.2.1/README.md

@@ -0,0 +1,156 @@
+# md2wx-cli
+
+[![PyPI](https://img.shields.io/pypi/v/md2wx-cli)](https://pypi.org/project/md2wx-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/md2wx-cli)](https://pypi.org/project/md2wx-cli/)
+[![License](https://img.shields.io/pypi/l/md2wx-cli)](LICENSE)
+
+> 轻量、确定性、高保真的 Markdown 转微信公众号排版 CLI。
+
+从写作到发布全链路命令行闭环：内联 CSS 排版、5 套精选主题、多主题画廊对比、推文抓取逆向、主题智能提取、官方 API 直传草稿箱、排版合规体检。不依赖任何网页编辑器，改一个错别字只需重跑一条命令。
+
+## 安装
+
+要求 Python ≥ 3.11。
+
+```bash
+pip install md2wx-cli
+```
+
+或免安装直接运行：
+
+```bash
+uvx md2wx-cli article.md -c
+```
+
+> 命令入口名为 `md2wx`。PyPI 包名 `md2wx-cli` 与 import 名 `md2wx` 分离（`md2wx` 在 PyPI 上已被其他项目占用）。
+
+## 快速开始
+
+```bash
+# 转换并写入系统剪贴板，公众号编辑器 Ctrl+V 直接粘贴
+md2wx article.md -c
+
+# 输出 HTML 文件
+md2wx article.md -o output.html
+
+# 切换主题
+md2wx article.md -t github-tech -c
+
+# 生成完整 <html> 独立页面，双击即可预览
+md2wx article.md -o preview.html --full-page
+
+# 支持标准输入管道
+cat article.md | md2wx -c
+```
+
+转换器处理的不只是 Markdown 渲染：中英文之间自动加空格、代码块语法高亮（Pygments）、外链自动转为文末脚注（微信正文不允许外链可点击）、全内联 CSS 与暗黑模式适配——这些全是微信编辑器的兼容性硬需求。
+
+## 主题系统
+
+内置 5 套主题，`-t` 一键切换：
+
+| 主题 | 风格 | 适合内容 |
+| :--- | :--- | :--- |
+| `default` | 现代极简杂志编辑风 | 通用，默认选项 |
+| `github-tech` | GitHub 开发者文档风（OneDark 代码高亮） | 教程、源码解析 |
+| `bauhaus` | 包豪斯几何设计风 | 设计类、观点文 |
+| `bold-green` | 清新高对比科技绿 | 环保、健康主题 |
+| `bold-navy` | 深邃藏青商务编辑风 | 深度长文、行业分析 |
+
+不确定选哪套？生成全主题交互画廊，浏览器里秒级切换对比，选中即一键复制：
+
+```bash
+md2wx gallery article.md -o gallery.html
+```
+
+主题是 YAML 文件（字体栈、配色、标题层级、代码块样式全部可调），也支持从外部逆向提取：
+
+```bash
+# 从一篇排版不错的微信推文学一套主题
+md2wx learn-theme --url "https://mp.weixin.qq.com/s/xxxxxx" -n brand-editorial
+
+# 或从本地设计稿目录提取
+md2wx learn-theme --dir ./design_folder -n brand-editorial
+
+# 直接套用
+md2wx article.md -t brand-editorial -c
+```
+
+## 发布到公众号草稿箱
+
+前置条件：公众号 AppID / AppSecret（微信公众平台「设置与开发 → 基本配置」获取），且将本机出口 IP 加入后台 **IP 白名单**（否则报 `errcode=40164`）。
+
+首次配置凭据，永久保存至 `~/.md2wx/config.yaml`：
+
+```bash
+md2wx config set wechat.appid "wx1234567890abcdef"
+md2wx config set wechat.secret "你的AppSecret"
+```
+
+一键直传（自动上传本地配图到微信永久图床并替换链接、上传封面、创建草稿）：
+
+```bash
+md2wx article.md -p --title "文章标题" --author "作者" --cover images/cover.png
+```
+
+命令返回 `media_id`，登录 mp.weixin.qq.com 在草稿箱中确认后手动群发。**直传只写草稿箱，不会自动群发。**
+
+凭据读取优先级：命令行参数（`--appid` / `--secret`）> 环境变量 > `~/.md2wx/config.yaml`，方便在 CI 中注入。
+
+> 注意：`--cover` 路径相对于输入 Markdown 文件所在目录解析，建议传绝对路径或相对 md 文件的路径。
+
+## 发布前体检
+
+```bash
+md2wx check article.md
+```
+
+内置 16+ 条微信平台硬规则检测：失效的本地图片引用、未转脚注的裸外链、编辑器不支持的非法 CSS（`position: fixed`、`display: grid`、`animation` 等）、代码块格式保护。体检通过再直传，基本不会翻车。
+
+## 抓取推文逆向
+
+```bash
+md2wx fetch "https://mp.weixin.qq.com/s/xxxxxx" -o draft.md
+```
+
+配图自动下载至 `draft-assets/`，居中高亮、白底卡片、实心横幅被识别还原为对应的容器语法。学习他人排版或做二次加工，从这一步开始。
+
+## 容器排版语法
+
+标准 Markdown 之外，原生支持几种扩展容器（渲染为微信兼容的内联样式组件）：
+
+```markdown
+::: banner 导语标题
+正文内容，支持 **加粗** 与 `代码`
+:::
+
+::: card 白底描边卡片，适合承载补充说明或外链
+https://github.com/example/repo
+:::
+
+> [!WARNING]
+> GitHub 风格告示块同样支持，自动渲染为主题色提示卡。
+```
+
+## 配置文件
+
+`~/.md2wx/config.yaml`：
+
+```yaml
+wechat:
+  appid: "wx1234567890abcdef"
+  secret: "你的AppSecret"
+  author: "你的笔名"
+```
+
+## 开发
+
+```bash
+git clone <repo-url> && cd md2wx-cli
+pip install -e .
+python -m pytest tests/
+```
+
+## License
+
+MIT

{md2wx_cli-0.2.0 → md2wx_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "md2wx-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "轻量级 Markdown 转微信公众号 HTML CLI 工具（支持剪贴板直达、主题提取、WeChatSync 联动）"
 readme = "README.md"
 requires-python = ">=3.11"

{md2wx_cli-0.2.0 → md2wx_cli-0.2.1}/src/md2wx/__init__.py

@@ -1,3 +1,3 @@
 """md2wx — Markdown to WeChat HTML CLI tool."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{md2wx_cli-0.2.0 → md2wx_cli-0.2.1}/src/md2wx/converter.py

@@ -36,6 +36,7 @@ class WeChatConverter:
     def __init__(self, theme: Optional[Theme] = None, theme_name: str = "default"):
         self._theme = theme if theme is not None else load_theme(theme_name)
         self._css_rules = get_inline_css_rules(self._theme)
+        self._pygments_style = self._resolve_pygments_style()
 
     def convert(self, markdown_text: str, base_dir: Optional[Path] = None) -> ConvertResult:
         title = self._extract_title(markdown_text)
@@ -48,8 +49,8 @@ class WeChatConverter:
         markdown_text = process_containers(markdown_text, accent)
         markdown_text = self._fix_cjk_spacing(markdown_text)
 
-        # 2. 基础 Markdown → HTML 解析
-        raw_html = self._markdown_to_html(markdown_text)
+        # 2. 基础 Markdown → HTML 解析（解包 codehilite 外层 div）
+        raw_html = self._unwrap_codehilite_div(self._markdown_to_html(markdown_text))
         soup = BeautifulSoup(raw_html, "html.parser")
 
         # 3. 本地图片路径转换与外框样式
@@ -132,9 +133,41 @@ class WeChatConverter:
             "markdown.extensions.sane_lists",
             "markdown.extensions.codehilite",
         ]
-        configs = {"codehilite": {"linenums": False, "guess_lang": True, "noclasses": True}}
+        # 注意：extension_configs 的键必须与扩展注册路径完全一致，
+        # 使用短名 "codehilite" 在 Markdown 3.x 下会静默失效（noclasses/pygments_style 均不生效）
+        configs = {
+            "markdown.extensions.codehilite": {
+                "linenums": False,
+                "guess_lang": True,
+                "noclasses": True,
+                "pygments_style": self._pygments_style,
+            }
+        }
         return markdown.Markdown(extensions=exts, extension_configs=configs).convert(text)
 
+    def _resolve_pygments_style(self) -> str:
+        """解析代码高亮风格：主题显式声明优先，否则按 code_bg 亮度自动选择。"""
+        style = str(self._theme._raw_data.get("code_highlight_style", "")).strip()
+        if style:
+            return style
+        code_bg = str(self._theme.colors.get("code_bg", "#f8f8f8"))
+        m = re.search(r"^#?([0-9a-fA-F]{6})$", code_bg)
+        if m:
+            r, g, b = (int(m.group(1)[i : i + 2], 16) for i in (0, 2, 4))
+            # 相对亮度粗估：暗底用暗色系高亮风格，浅底用浅色系
+            if 0.299 * r + 0.587 * g + 0.114 * b < 128:
+                return "one-dark"
+        return "friendly"
+
+    def _unwrap_codehilite_div(self, raw_html: str) -> str:
+        """解包 codehilite/highlight 包装 div，避免其内联背景色在微信端形成色差外框。"""
+        return re.sub(
+            r'<div class="(?:codehilite|highlight)"[^>]*>\s*(<pre.*?</pre>)\s*</div>',
+            r"\1",
+            raw_html,
+            flags=re.DOTALL,
+        )
+
     def _process_images(self, soup: BeautifulSoup, base_dir: Optional[Path]) -> list[str]:
         images = []
         for img in soup.find_all("img"):

{md2wx_cli-0.2.0 → md2wx_cli-0.2.1}/src/md2wx/styler.py

@@ -107,7 +107,15 @@ def apply_inline_styles(soup: BeautifulSoup, theme: Theme, css_rules: dict) -> N
             if extra:
                 img["style"] = f"{est}; {'; '.join(extra)}" if est else "; ".join(extra)
 
-    # 7. 代码块横向滚动保障
+    # 7. 代码块横向滚动保障；pre 显式声明文字色（内层 code 为 color: inherit，
+    #    若 pre 缺省 color 会继承正文灰，在深色代码底上完全不可读）
+    def _is_dark_bg(bg: str) -> bool:
+        m = re.search(r"([0-9a-fA-F]{6})", bg or "")
+        if not m:
+            return False
+        r, g, b = (int(m.group(1)[i : i + 2], 16) for i in (0, 2, 4))
+        return 0.299 * r + 0.587 * g + 0.114 * b < 128
+
     for pre in soup.find_all("pre"):
         for code in pre.find_all("code"):
             code["style"] = (
@@ -117,6 +125,16 @@ def apply_inline_styles(soup: BeautifulSoup, theme: Theme, css_rules: dict) -> N
                 "color: inherit !important; padding: 0 !important; border: none !important; "
                 "font-size: inherit; font-family: inherit; line-height: inherit"
             )
+        # 解析 pre 现有内联样式（注意 "background-color" 含 "color" 子串，须按键精确判断）
+        pre_items = [item.split(":", 1) for item in pre.get("style", "").split(";") if ":" in item]
+        sdict = {k.strip(): v.strip() for k, v in pre_items}
+        if "color" not in sdict:
+            bg = sdict.get("background") or sdict.get("background-color") or str(colors.get("code_bg", ""))
+            if _is_dark_bg(bg):
+                fallback = str(colors.get("code_color", "#e2e8f0"))
+            else:
+                fallback = str(colors.get("text", "#333333"))
+            pre["style"] = f"color: {fallback}; {pre.get('style', '')}" if pre.get("style") else f"color: {fallback}"
 
 
 def preserve_code_block_newlines(soup: BeautifulSoup) -> None: