wechat-mp-publish — Markdown 进，草稿箱出

一句话总纲：AI 负责写和排，人负责两件事——审稿，以及点发布。

要解决的真问题

公众号发布卡人的地方不是排版，是图片。

Markdown 里写 ![封面](images/cover.png)，粘进公众号编辑器，图全丢，只剩一个裂开的图标或链接。原因有三层，缺一层都不行：

所以 .html 文件传不上去、图片粘过去消失，都不是操作问题，是链路问题。这个 Skill 把链路补全：每张图先走 media/uploadimg 换成微信地址，再写进正文。

四步流程，两个人工闸门

AI 写稿(md) ──► [人审稿] ──► AI 排版+传图 ──► [人发布]
                  闸门1                        闸门2

闸门一：审稿。 内容没定就别排版。排完再改稿，图片要重传一遍。

闸门二：发布。 工具只把文章送进草稿箱，永远不替你点发布。这条是硬规则，不是能力限制。

命令

只依赖 Python 3.8+ 标准库，不用 pip install。

# 1) 看排版效果，不联网、不需要凭据
python scripts/wmp.py convert article.md -o 公众号版.html --theme qing
python scripts/wmp.py check 公众号版.html

# 2) 只搬图片：把 md / html / 目录里的图全换到微信图床
python scripts/wmp.py upload article.md --rewrite

# 3) 先干跑一遍，确认图片和字段都没问题
python scripts/wmp.py push article.md --cover cover.png --author Yardon --dry-run

# 4) 真推草稿箱（需要 .env 里的 AppID / AppSecret）
python scripts/wmp.py push article.md --cover cover.png --author Yardon --digest "摘要"

# 5) 凭据和连通性自检
python scripts/wmp.py doctor

convert 产出的是可粘贴 HTML，图片保留原地址；push 才会上传图片换成微信地址。

怎么保证图片一定在图床

三处卡口，任何一处不过就不算完成：

只想要图在床、不想发文章，就用 upload：它可以在 md、html、图片目录上跑，输出一份「原地址 → mmbiz 地址」的清单，加 --rewrite 还会把地址替换好写进副本。

upload 的输出长这样：

目标：article.md（Markdown，3 张）
  images/cover.png   93 KB
  images/filter-diagram.png   161 KB
  ✓ images/cover.png
    → http://mmbiz.qpic.cn/mmbiz_png/xxxx/0
已生成替换版：article.wechat.md
原文件没动，核对无误后再拿它去发布。
RESULT: PASS

两条出口怎么选

convert 出来的 HTML 粘贴时图片会跟着走（浏览器会把图像数据放进剪贴板），但样式可能被微信改写一两处；push 没有这个问题，因为 HTML 是直接从服务端写进草稿的。

主题

assets/themes.json 里三个：qing（青竹，深青）、ink（墨黑）、blue（经典蓝）。

改这个 JSON 就能加新主题，不用动代码。换主题只影响配色和字号，不影响结构。

微信的字段上限

写稿阶段就要守住，别等接口拒绝：

脚本会在推送前替你卡这几项。

排错

关于发布接口

freepublish/submit 是真正把文章发出去的接口。2025 年 7 月起，个人主体和未认证企业号的发布权限已被回收，只有认证的服务号/订阅号能调用。

所以本 Skill 的定位是明确的：机器负责生产与入库，人负责放行。这不是妥协，草稿箱本身就是个安全缓冲区——进去了还能改、能预览、能挑时间。

不做的事

• 不代替用户点发布，也不做定时群发
• 不做小红书、知乎等平台的排版（各家过滤规则不同，混做会两头不讨好）
• 不替你写稿。写稿交给写作类 Skill，这里只管把稿子送到位
• 不在没有审稿的情况下推送。push 之前人必须看过 convert 的产物