微信公众号发布工具

wechat-publish-pro 技能

微信公众号文章发布工具，完全独立实现，不依赖任何外部 命令行工具 工具。

功能特性 纯 Python 实现: 不依赖 wenyan-命令行工具 或其他外部工具 Markdown 转换: 内置 Markdown → HTML 转换，参考 wenyan-命令行工具 排版风格 多主题支持: 多种精美主题（green、blue、purple、orange、default、simple） 代码高亮: Mac 风格代码块，语法高亮 AI 去痕: 发布前自动 AI 去痕处理，让内容读起来更像真人写的 封面生成: 自动处理封面图，支持本地/网络图片 直接发布: 一键发布到微信公众号草稿箱 触发条件

当用户需要以下操作时自动触发：

将 Markdown 或 HTML 文章发布到微信公众号草稿箱 转换 Markdown 为公众号格式 HTML 使用特定主题发布公众号文章 测试微信连接 安装 # 从 GitHub 安装 pip 安装 git+https://github.com/yuesf/wechat-publish-pro.git

配置 第一步：获取微信公众号凭证 登录 https://developers.weixin.qq.com/ 公众号平台 获取 应用ID 和 应用Secret 第二步：配置凭证 配置文件（多账号支持）

配置文件路径：~/.wechat-publish-pro/config.yaml

accounts: # 账号1（设为默认） default: name: 技术公众号 应用_id: wx89c409208d11dc5b 应用_secret: your_应用_secret_here # 账号2 健康: name: 养生公众号 应用_id: 命令行工具_a95b243c6278dccf 应用_secret: your_应用_secret_here # 可添加更多账号... default_account: default

AI: 提供者: qwen API_key: your_API_key base_url: "" 模型: ""

环境变量（单账号兼容） 导出 WECHAT_应用_ID=your_wechat_应用_id 导出 WECHAT_应用_SECRET=your_wechat_应用_secret

# AI 去痕（可选） 导出 AI_API_KEY=your_API_key 导出 AI_提供者=qwen # openAI, qwen, zhipu, doubao, minimax, moonshot, hunyuan, yi

第三步：设置 IP 白名单

把运行机器的 IP 添加到微信公众号后台白名单：

登录 https://mp.weixin.qq.com/ 设置与开发 → 基本配置 → IP白名单 使用方式 通过 OpenClaw 直接发送

在 OpenClaw 对话中直接说：

"把这篇文章发到公众号" "用蓝色主题发布" "帮我发布到微信，测试一下" "使用 AI 去痕发布" 命令行方式 Markdown 转换 # 基本转换（默认绿色主题） wechat-publish-pro convert article.md

# 指定蓝色主题 wechat-publish-pro convert article.md --theme blue

# 指定输出文件 wechat-publish-pro convert article.md -o 输出.html

发布到微信 # 发布 HTML 文件到草稿箱（使用默认账号） wechat-publish-pro publish article.html

# 指定账号发布 wechat-publish-pro publish article.html --account 健康

# 指定标题和封面 wechat-publish-pro publish article.html --title "文章标题" --cover cover.jpg

# 不使用 AI 去痕 wechat-publish-pro publish article.html --no-humanize

# 调整 AI 去痕强度 wechat-publish-pro publish article.html --intensity heavy

一站式：Markdown → 转换 → 发布 # 转换后直接发布 wechat-publish-pro convert article.md --theme blue -o /tmp/article.html wechat-publish-pro publish /tmp/article.html --title "文章标题"

测试连接 wechat-publish-pro test

上传图片 wechat-publish-pro 上传-image image.jpg

Markdown 格式

文件顶部可以包含 frontmatter：

# 正文开始（frontmatter 有 title 时会自动移除）

你的内容...

可用主题 主题 风格 green 清新自然（绿色，默认） blue 清新专业（蓝色） purple 优雅神秘（紫色） orange 温暖活力（橙色） default 简洁清爽 simple 极简风格 AI 去痕

AI 去痕是可选功能，让文章读起来更自然。支持的 提供者：

提供者 说明 openAI OpenAI GPT 系列 qwen 通义千问（默认） zhipu 智谱 GLM doubao 豆包 minimax MiniMax moonshot Moonshot hunyuan 腾讯混元 yi 零一万物

去痕强度：

light - 轻度：保持原文大部分内容，只做轻微调整 medium - 中度：适度调整，保留核心内容 heavy - 重度：大幅调整，使文章焕然一新 故障排查 错误：45166 (IP地址不在白名单中) 原因：运行机器的 IP 未添加到微信白名单 解决：登录公众号后台添加 IP 到白名单 发布成功但看不到文章？ 原因：文章在草稿箱，需要审核发布 解决：草稿箱 → 选中文章 → 发布 架构说明 wechat-publish-pro/ ├── src/wechat_publisher/ │ ├── 命令行工具.py # 命令行工具 入口 │ ├── config.py # 配置管理 │ ├── 转换器/ # Markdown 转换模块 │ │ ├── wechat_style.py # 微信公众号样式转换器 │ │ ├── themes.py # 主题配置 │ │ └── theme_types.py # 主题数据类型 │ ├── humanizer/ # AI 去痕模块 │ └── 平台s/ # 平台适配器 │ └── wechat.py # 微信公众号 API └── pyproject.toml

设计参考

本项目参考了以下优秀项目的设计思路：

wenyan-命令行工具: Markdown 转微信 HTML 的排版思路 multi-writing-技能s: 转换器和主题系统的实现

但本项目是完全独立实现的，不依赖任何外部代码。

作者

yuesf

许可证

MIT