技能介绍

解决什么问题

微信公众号的编辑器对 Markdown 写作者来说是一道明显的壁垒。你在本地用 markdown 写完技术文章，复制粘贴到公众号后台时，代码块的缩进和着色会丢失，图片需要手动一张张上传，整体排版也要逐段调整。这篇文章介绍的 wechat-publisher 技能试图把这件事简化为一条命令：Markdown 文件准备好，剩下的转换、配图、排版、推送草稿箱全部自动完成。

核心能力

这个技能基于 wenyan-cli 封装，核心流程可以拆成三步：

Markdown 解析与转换：读取 .md 文件，将正文、代码块、列表等结构映射为公众号富文本格式，代码块自动加上高亮主题和 Mac 风格装饰。
图片自动上传：支持本地相对路径、绝对路径和网络图片 URL，全部会自动上传到微信图床并替换为微信 CDN 链接，不需要手动处理。
推送草稿箱：转换完成后一键调用公众号 API 写入草稿箱，你只需到后台审核并发布。

主题方面内置了 default、lapis、phycat 等样式，代码高亮支持 github、dracula、monokai、solarized-dark 等常见方案，可以通过 --theme 和 --highlight 参数切换。

注意点与边界

Frontmatter 是硬性要求。 官方文档说正文有图片时可以省略 cover，但实际测试发现 title 和 cover 缺一不可，缺少任何一个都会报「未能找到文章封面」的错误。封面推荐使用 Unsplash 等来源的图片，本地文件用相对路径时从 Markdown 所在目录开始计算。

IP 白名单是最常见的卡点。 上传失败时如果看到 ip not in whitelist，需要先 curl ifconfig.me 拿到公网 IP，再到公众号后台「开发 → 基本配置 → IP 白名单」中添加。

环境变量必须提前配好。 WECHAT_APP_ID 和 WECHAT_APP_SECRET 需要设置在环境变量中，否则会报 WECHAT_APP_ID is required。脚本本身会自动检测并安装 wenyan-cli，但凭证配置这一步没有自动化。

另外，这个技能负责的是「推送到草稿箱」，不包含定时发布或自动审核，最终的发布操作仍需在公众号后台手动完成。