核心用法
wechat-publisher 是一款面向微信公众号内容创作者的自动化发布工具，本质上是知名开源项目 wenyan-cli 的 OpenClaw 封装层。用户只需准备符合规范的 Markdown 文件，即可一键将文章推送至微信公众号草稿箱，无需手动处理繁琐的排版与图片上传。
使用流程分为三步：首先全局安装 wenyan-cli 工具并配置微信公众号 API 凭证（WECHAT_APP_ID 与 WECHAT_APP_SECRET）；其次编写包含完整 frontmatter（title 与 cover 为必填项）的 Markdown 文件；最后通过 publish.sh 脚本或直接调用 wenyan-cli 执行发布。工具会自动完成 Markdown 到公众号格式的转换、本地/网络图片上传至微信图床、以及最终推送到草稿箱的全流程。
显著优点
该工具的最大价值在于彻底解放了公众号运营者的排版生产力。传统公众号编辑体验割裂，Markdown 写作者往往需要借助第三方编辑器或手动调整格式。wechat-publisher 实现了真正的"所写即所得"——支持 lapis、phycat 等多款精美主题，内置 solarized-light、dracula 等十余种代码高亮方案，Mac 风格代码块一键生成，专业感远超原生编辑器。
图片处理是另一大亮点。无论使用本地相对路径、绝对路径还是网络 URL，所有图片都会自动上传至微信官方图床并替换链接，彻底解决了外链失效风险。对于技术博主、知识付费创作者等高频发文群体，这一功能可节省大量手动操作时间。
潜在缺点与局限性
工具存在明确的使用门槛。首先必须拥有微信公众号开发者权限，且需完成 IP 白名单配置，这对普通订阅号运营者形成一定技术壁垒。其次 frontmatter 的强制性要求（title 与 cover 缺一不可）与官方文档存在出入，新手容易因格式问题遭遇"未能找到文章封面"等报错。
主题生态虽丰富但深度有限，高度定制化的排版需求仍需手动干预 CSS。此外，工具仅支持推送至草稿箱而非直接发布，最终审核环节无法绕过，完整工作流仍需人工介入。
适合的目标群体
核心用户为技术博主、知识付费创作者、企业公众号运营者三类人群。技术写作者受益于代码高亮与 Markdown 原生支持；高频发文者看重批量处理能力；团队协作场景下，Markdown 版本控制与自动化发布可显著提升内容生产管线效率。对个人偶尔发文的 casual 用户而言，配置成本可能高于收益。
使用风险
主要风险集中于配置环节：API 凭证泄露可能导致公众号被盗用，需严格避免将 WECHAT_APP_SECRET 提交至公共仓库；IP 白名单机制意味着动态 IP 用户需频繁更新配置；全局依赖 wenyan-cli 存在版本漂移风险，建议锁定具体版本号。性能方面，大体积图片批量上传可能触发微信 API 频率限制，超长篇文档渲染耗时需预留等待时间。