Wechat Publisher

核心功能

wechat-publisher 是基于 wenyan-cli 封装的自动化工具，核心解决 Markdown 写作与微信公众号排版之间的鸿沟问题。

核心用法

用户只需准备符合规范的 Markdown 文件（必须包含 title 和 cover 的 frontmatter），通过一条命令即可将文章推送到微信公众号草稿箱。支持三种调用方式：本地 publish.sh 脚本、直接使用 wenyan-cli 命令、或在 OpenClaw 框架内自然语言触发。

显著优点

• 零配置体验：自动检测并安装依赖，内置多主题（lapis、phycat 等）和代码高亮方案
• 图片自动化：本地图片、网络图片自动上传至微信图床，无需手动处理
• 格式保真：Mac 风格代码块、链接脚注转换等公众号友好格式
• 自定义扩展：支持自定义 CSS 主题，满足品牌化需求

局限性与风险

• API 凭证依赖：必须配置 WECHAT_APP_ID 和 WECHAT_APP_SECRET，且 IP 需加入公众号白名单
• 强制字段要求：title 和 cover 缺一不可（实测与官方文档存在出入）
• 网络环境敏感：IP 白名单机制导致频繁更换网络环境时需反复配置
• 发布范围受限：仅能推送到「草稿箱」，最终发布仍需人工登录后台确认

适合人群

技术内容创作者、独立博主、企业运营人员——尤其是习惯 Markdown 写作、需要频繁向公众号迁移内容的用户。

常规风险

凭证泄露风险（需妥善保管 AppSecret）、IP 白名单配置遗漏导致发布失败、frontmatter 格式错误引发的发布中断。建议生产环境使用专用公众号测试号，避免主账号权限暴露。

核心用法

wechat-publisher 是一款 OpenClaw Skill，用于将 Markdown 文章一键发布到微信公众号草稿箱。它封装了 wenyan-cli 工具链，提供零配置的自动化发布体验。

主要功能流程：
1. 准备带 frontmatter 的 Markdown 文件（必须包含 title 和 cover）
2. 配置微信 API 凭证（WECHAT_APP_ID 和 WECHAT_APP_SECRET）
3. 执行发布命令，自动完成格式转换、图片上传、推送到草稿箱

关键使用要求：

• Markdown 文件顶部必须包含 YAML frontmatter，且 title 和 cover 为强制字段（实测发现文档描述与实际行为存在差异，cover 不可省略）
• 公众号后台需添加当前 IP 至白名单
• 支持本地/网络图片，自动转存至微信图床

主题系统：
内置 lapis、phycat 等多种主题，支持 solarized-light、github、dracula 等代码高亮方案，可自定义 CSS 主题。

显著优点

• 全流程自动化：从 Markdown 到公众号草稿箱一键完成，无需手动排版
• 图片处理省心：本地/网络图片自动上传微信图床，解决外链失效问题
• 专业排版效果：Mac 风格代码块、多种代码高亮主题，提升技术文章阅读体验
• 无侵入式依赖：仅包装 wenyan-cli，无额外第三方依赖，依赖关系清晰

潜在缺点/局限性

• 强制 frontmatter 要求：title 和 cover 缺一不可，灵活性受限
• IP 白名单依赖：每次更换网络环境需更新公众号后台白名单
• T3 来源可信度：个人开发者维护，无 GitHub 仓库信息，代码审查依赖用户自行完成
• 无预览机制：缺少 --dry-run 选项，无法先预览效果再发布
• 版本控制缺失：自动安装 wenyan-cli 不锁定版本，存在兼容性风险

适合人群

• 技术博主、开发者运营者，需要频繁将技术文档发布至微信公众号
• 习惯 Markdown 写作，厌倦公众号后台排版的用户
• 有基本 Shell/命令行使用经验，能配置环境变量的用户

常规风险

• 凭证管理风险：API 凭证存储于本地 TOOLS.md，需确保文件权限安全
• 网络环境变更：IP 变动导致发布失败，需频繁更新白名单
• 第三方工具依赖：wenyan-cli 的更新可能引入 breaking changes