微信公众号推文排版美化工具，将写好的公众号文章自动生成带内联样式的富文本，程序化保证文字零改动。支持导语卡片、列表卡片、重点句标记等多种样式，预览确认后写回剪贴板直接粘贴到公众号编辑器。适合所有需要提升公众号排版效率的个人博主和运营者。

微信公众号推文排版美化助手

【适用场景】

- 已写好公众号文章，需要快速排版成「成熟微信推文」样式 - 希望在公众号编辑器中获得专业级排版效果（导语卡片、列表卡片、重点句标记、图注等） - 需要保证原文文字逐字不改，由程序化校验兜底 - 手动排版费时费力，想要流程化批量处理

【操作步骤】

第一步：获取原文

场景一（默认）：从公众号编辑器复制 1. 在公众号编辑器正文区域，按 `Cmd+A` 全选， `Cmd+C` 复制 2. 执行命令读取剪贴板内容：

```bash bash scripts/read_clipboard_html.sh raw.html ```

场景二：纯文本或文件 直接提供文字内容，保存为 `raw.txt`，后续命令加 `--plain` 参数。

第二步：分析文章结构

```bash python3 scripts/extract_blocks.py raw.html ```

脚本会输出编号块列表（段落含加粗标记、图片含完整地址）。通读全文，理解各段落功能：开篇导语、承上启下句、编号列表、图注、小结句、结尾预告。

第三步：制定排版计划

根据 `references/layout-patterns.md` 中的角色与视觉说明，为每个内容块指定排版角色：

```json { "blocks": [ {"id": "p0", "role": "intro", "text": "开篇导语文本"}, {"id": "p1", "role": "body", "text": "正文段落"}, {"id": "img0", "role": "img-full", "src": "https://..."} ], "accent": "#F37021" } ```

角色说明： - `intro`：开篇导语，用特殊卡片样式 - `body`：正文段落，基础样式 - `list`：编号列表，用列表卡片样式 - `img-full`：横版图片 - `img-phone`：竖屏截图 - `emph`：重点句标记（全文限 3-6 处）

第四步：渲染 + 零改动校验

```bash python3 scripts/render.py raw.html plan.json content.html ```

渲染过程自动校验：块覆盖不重不漏、文字逐字一致。如有差异会报错提示修改计划，不要绕过校验。

第五步：本地预览确认

```bash python3 scripts/make_preview.py content.html preview.html --title "文章标题" python3 -m http.server <端口> --bind 127.0.0.1 ```

用浏览器打开 `http://127.0.0.1:<端口>/preview.html`，视口宽度调至 460 像素（贴近手机阅读宽度），截几张关键位置图片给用户确认。

第六步：写回剪贴板

```bash bash scripts/write_clipboard_html.sh content.html ```

然后指导用户：回到公众号编辑器 → 点进正文 → `Cmd+A` 全选 → `Cmd+V` 粘贴 → 检查 → 手机预览 → 保存。

【代码模板】

排版计划 plan.json 模板

```json { "accent": "#F37021", "accent_deep": "#D85A10", "blocks": [ { "id": "intro0", "role": "intro", "text": "这是开篇导语原文" }, { "id": "body0", "role": "body", "text": "这是正文段落内容" }, { "id": "list0", "role": "list", "text": "列表第一项\n列表第二项\n列表第三项" }, { "id": "emph0", "role": "emph", "text": "要标记的重点句原文" }, { "id": "img0", "role": "img-full", "src": "https://mmbiz.qpic.cn/..." } ] } ```

完整工作流命令序列

```bash

1. 读取剪贴板

bash scripts/read_clipboard_html.sh raw.html

2. 分析结构

python3 scripts/extract_blocks.py raw.html

3. 制定计划（创建 plan.json）

... 编辑 plan.json ...

4. 渲染并校验

python3 scripts/render.py raw.html plan.json content.html

5. 预览

python3 scripts/make_preview.py content.html preview.html --title "文章标题" python3 -m http.server 8765 --bind 127.0.0.1 &

6. 写回剪贴板

bash scripts/write_clipboard_html.sh content.html ```

【复盘要点】

1. 文字零改动原则：排版只改样式不改文字，发现疑似笔误只报告给用户，由用户决定是否修改 2. 强调标记克制：全文加粗/标色/荧光笔控制在 3-6 处，荧光笔最多 1-2 处，避免过度装饰 3. 图片处理：保留微信 CDN 原地址，贴回编辑器后图片正常显示，本地预览占位图是正常现象 4. 剪贴板路径：全程走 HTML flavor（不用纯文本），确保图片地址和格式不丢失 5. 校验链必须全绿：每次渲染后检查 `render.py` 内置校验和 `write_clipboard_html.sh` 回读校验，两道关卡都通过才能交付 6. 浏览器工具缺失时：把预览地址给用户自行确认，不可跳过预览步骤

---

来源：GitHub https://github.com/DragonJames2026/wechat-article-format