wechat-article-formatlisted
Install: claude install-skill DragonJames2026/wechat-article-format
# 微信推文排版美化
把用户写好的公众号文章做成「成熟微信推文」的排版:导语卡片、列表卡片、图注、重点句标记、统一的正文字号行距。核心承诺是**文字零改动**——所有环节都有程序化校验兜底。
## 边界
- 只处理**正文**排版。标题栏、封面图、摘要不在正文富文本里,不处理。
- 只改样式,不改文字:不加小标题、不加「END」、不加图注文字、不修笔误。发现疑似笔误(如「如果完成」疑为「如何完成」)**只报告给用户**,由用户决定。
- 强调标记(加粗/标色/荧光笔)算样式不算改字,但要克制:全文 3-6 处,荧光笔至多 1-2 处。
## 关键事实(为什么是这套流程)
- `mp.weixin.qq.com` 通常被 agent 的浏览器工具拦截,**无法直接操作编辑器**。所以原文进出都走剪贴板:用户在编辑器正文 Cmd+A/Cmd+C 拿出来,排版后写回剪贴板 Cmd+A/Cmd+V 贴回去。这也是成熟排版工具(135editor/mdnice)的同款通路,微信编辑器对粘贴的内联样式富文本保留良好。
- 剪贴板纯文本 flavor 直接 `pbpaste` 会乱码,必须走 HTML flavor(脚本已处理);HTML flavor 还带着文章图片的微信 CDN 地址(`data-src`),排版后图片无需重新上传。
- 微信 CDN 图片有防盗链,本地预览会显示「此图片来自微信公众平台 未经允许不可引用」占位图——预览页已加 `no-referrer` 绕过;就算没绕过也**只是预览问题**,贴回编辑器后正常。
- 剪贴板脚本用 `osascript` 读写 HTML flavor,仅支持 macOS。
## 工作流
脚本在本 skill 目录下的 `scripts/`(下称 `$S`)。工作文件一律放临时工作目录,不要污染用户项目。
### 1. 拿到原文
- **编辑器场景(默认)**:请用户在公众号编辑器正文区域 Cmd+A 全选、Cmd+C 复制,然后执行
`bash $S/read_clipboard_html.sh raw.html`
- **纯文本/文件场景**:用户直接给文字或文件时存为 `raw.txt`,后续命令加 `--plain`(此时没有图片块;如有配图请用户说明图放在哪些段落之间)。
### 2. 读懂文章
`python3 $S/extract_blocks.py raw.html` 输出编号块列表(段落含加粗标记、图片含完整地址)。**通读全文**,理解结构:哪些是开篇导语、承上启下句、编号列表、图注、小结句、结尾预告。顺手记下疑似笔误,最后报告。
### 3. 写排版计划 plan.json
角色与视觉说明见 `references/layout-patterns.md`(写 plan 前先读它)��要点:
- 每个原文块**恰好用一次**,render.py 会强制校验,不允许丢段落。
- 角色按段落功能选:不确定就 `body`。图片按长宽比选 `img-full`(横图)或 `img-phone`(竖屏截图)。
- 重点句用 `emph`,子串必须与原文逐字一致。选「读者应该带走的结论」,不要见句就标。
- 主色默认暖橙 `#F37021`;如果用户的公众号有品牌色,在 plan.json 里覆盖 `accent` / `accent_deep`。
### 4. 渲染 + 零改动校验
`python3 $S/render.py raw.html plan.json