wechat-public-cli

wechat-public-cli 是什么

wechat-public-cli 是专为自媒体矩阵运营人员、独立博主及研发运维团队设计的微信公众号开放平台命令行管理与内容自动化发布工具。技能全面封装了微信公众平台官方 RESTful API，突破了传统网页端后台必须人工登录、繁琐排版、手动上传素材的繁重负担。工具提供从本地 Markdown 规范文档解析、代码块语法高亮着色、图床图片自动化转存为微信永久素材、到草稿箱（Draft Box）一键同步与定时群发的全链路自动化能力，使公众号运营能够无缝集成至开发者的 Git 提交流水线或自动化智能体生产体系之中。

核心应用场景

适用于技术博主或团队将 GitHub/博客园/语雀中的 Markdown 技术文章一键无损同步至微信公众号草稿箱；辅助企业自媒体矩阵团队通过自动化脚本定时、批量向多个公众号分发已过审的新闻资讯；为自动化 AI 写作工作流提供最后一公里的内容交付与发布接口，实现‘生成即草稿’；支持在终端命令行中快速查询公众号关注者统计、接口调用配额及粉丝互动数据。

关键功能特性

支持标准 Markdown 语法极速渲染为符合微信排版引擎要求的富文本 HTML，自动处理外链转为文末参考资料标注；自动抓取 Markdown 中的网络图片并静默调用微信素材接口转为微信 CDN 链接，杜绝跨域防盗链红叉图；完备的安全鉴权机制，本地加密保存 AppID 与 AppSecret 并自动维护 AccessToken 的定时刷新与缓存；支持草稿箱增删改查、封面图智能绑定及模板消息自动化推送功能。

标准操作流程

用户在终端或脚本中提供目标 Markdown 文章路径，并配置对应公众号的凭证参数；命令行工具解析文档结构，提取文章标题、摘要、封面图及内联配图；将文档内的第三方外链图片自动上传至微信素材库并替换为微信官方图片链接；将样式内联化处理后调用微信草稿箱 API 创建新的草稿条目；返回已生成的草稿 media_id 与手机端预览链接供用户核验确认。

输入与输出规范

输入参数包括微信公众号 AppID、AppSecret、本地 Markdown 文档路径、可选自定义作者名、摘要及封面图素材 ID；输出内容包括微信公众平台草稿条目唯一标识（Media ID）、生成的临时手机端预览二维码/网页直链以及操作执行状态日志。

环境依赖与权限要求

基于 Python 3.8+ 或 Node.js 运行环境构建，依赖常用网络通信与加解密模块；仅需基础公网出方向网络连接以访问微信官方 api.weixin.qq.com 域名；支持在 Windows、macOS、Linux 服务器及 GitHub Actions 等自动化工作流中直接运行。

边界限制与避坑指南

根据微信公众平台官方安全规范，群发推送与定时群发权限严格受公众号认证类型（订阅号/服务号）及官方 API 配额限制；使用前需在微信公众号后台配置合法的服务器 IP 白名单；本工具仅通过官方合规接口交互，杜绝任何模拟登录或违规抓取操作。

目标适用人群

拥有技术博客的内容创作者、新媒体自媒体矩阵运营工程师、企业市场部自动化工作流设计者，以及致力于搭建 AI 自动化内容生产线的大模型应用开发者。

安装与启用指引

在运行环境中安装 wechat-public-cli 工具包，使用配置文件或环境变量注入微信公众平台接口凭据；在终端中执行命令（如 `wechat-cli publish –file ./article.md –cover ./cover.png`），数秒内即可在手机微信订阅号助手收到草稿就绪通知。

来源背景与开源协议

本技能源自官方认证代码仓库收录，遵循 MIT 开源软件协议，代码逻辑透明开源。在提供高效命令行运维与发布能力的同时严守用户 API 密钥本地隐私安全，商业与个人均可免费使用。

常见问题答疑

1. 使用 wechat-public-cli 发布文章时，如何避免图片因为防盗链而无法显示？

工具在推送前会自动扫描所有本地与外链图片，批量上传至微信官方素材库并自动替换为可用图片。

2. 运行该工具前，在微信公众号官方后台需要开启哪些基础配置？

需在公众号后台‘开发-基本配置’中获取 AppID 与 AppSecret，并将当前运行机器的外网 IP 加入白名单。

3. Markdown 中的代码块（Code Block）同步到微信后排版样式是否美观？

内置主流程序员代码高亮着色器，自动将代码段封装为带滚动条的等宽字体展示框，保持高度专业美观。

4. 该工具上传文章是直接面向全网群发，还是先存放在草稿箱中？

默认采用最安全的草稿箱（Draft）模式，将文章存入草稿供运营人员在手机或后台二次确认后再手动群发。

5. 能否同时在本地配置文件中管理多个不同的微信公众号并自由切换？

支持以 Profile 形式配置多个公众号账号参数，命令行通过指定 `–profile account_b` 即可实现灵活切换。

6. 在 GitHub Actions 或服务器定时任务中能否无人值守全自动调用？

设计完全遵循 POSIX 命令行标准，可顺畅嵌入 CI/CD 脚本流水线中，实现代码或文章提交后全自动同步。

7. 对于 Markdown 中无法直接点击的超链接，系统会如何进行合规转换？

由于微信公众号正文限制外部超链接，工具会自动将文内链接转化为文末‘参考链接列表’进行编号标注。

8. 后续如何获取更多排版主题风格与微信官方新 API 接口的支持？

建议持续关注创作者在 SkillHub 官方发布的最新版本动态，定期拉取升级补丁包以享受最新性能优化与安全特性保障。