技能介绍

问题从哪来

把 Markdown 发到微信公众号草稿箱，看起来只是「转 HTML + 调 API」，实际踩坑很集中：默认样式会把标题、列表洗成公众号后台那套丑排版；Python requests.post(json=…) 常把中文转成 \uXXXX，再叠加标题 UTF-8 字节超限，容易撞上 errcode 45003；正文里 gradient / rgba / h1–h6 / flex 等在手机端要么不渲染要么布局塌陷，推送成功预览却像「坏页」。

核心机制

技能把链路拆成三块，对应仓库里的脚本：

scripts/push.js：Markdown → 微信可接受的全内联 HTML。--style 在 warmGold、blueMagazine、minimalBlack 三套主题间切换；引用块、⚠️ / 💡 / 📌 等 emoji 前缀会落成金句、警告、提示、信息等卡片；推送前做 12 项兼容性自检（如用 section/span 替代标题标签、实色 hex 替代半透明、避免 flex/position/SVG 等），违规不交付。
scripts/upload_images.py：批量把正文配图上传到微信 CDN，并处理 access_token 获取与缓存。
scripts/setup.py：首次写入 AppID、AppSecret、作者与品牌名等配置。

Agent 侧典型流程：准备带 # 标题 的 Markdown →（可选）上传配图 → 调用 push 指定 --brand、--author、--digest、--thumb 等 → 返回 media_id，到后台草稿箱预览。

边界与注意

必须在公众号后台配置 IP 白名单，否则 40164: invalid ip。
封面需已有永久素材的 thumb（media_id）；摘要默认可从正文前 120 字截取。
PC 端草稿预览可能异常，手机扫码预览更可靠。
本技能面向自有公众号 API 凭证的排版与草稿推送，不是替代后台人工审校或群发策略。

截图预览

使用场景

在本地或 AI 对话里写好 Markdown 长文，需要按品牌名、作者、摘要一键推送到公众号草稿箱并返回 media_id 供后台预览。
科技或商业类稿件已定栏目风格，需通过 `--style` 在 warmGold、blueMagazine、minimalBlack 间切换，且引用块与 emoji 前缀自动渲染成微信卡片。
正文含多张配图，需先用 upload 脚本批量上传到微信 CDN，再在 push 时传入配图 URL，避免手工传图。
从 Typora/Obsidian 导出带表格与代码块的 MD，要求推送前完成 12 项兼容性自检，避免 rgba、flex、h 标签导致手机端预览塌陷。

适合人员

负责企业服务号、团队在 Notion/Git 里协作写 Markdown，要把成稿稳定送进草稿箱且避免 45003 中文编码问题的内容运营。
独立技术或财经博主，每周从 Markdown 工具出稿，不愿在公众号后台逐段调样式，需要三套主题与智能卡片开箱即用。
搭建「AI 写稿 → 排版推送」自动化链路的工程师，需要 push.js、upload_images.py、setup.py 可被 Agent 按步骤调用的脚本化接口。
同一公众号下分科技、商业、极简文艺栏目，希望按稿件类型切换主题配色并在推送前拦截微信不支持的 HTML 结构的编辑负责人。