微信公众号发布工具

wechat-publish-pro Skill

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

功能特性

纯 Python 实现: 不依赖 wenyan-cli 或其他外部工具

Markdown 转换: 内置 Markdown → HTML 转换，参考 wenyan-cli 排版风格

多主题支持: 多种精美主题（green、blue、purple、orange、default、simple）

代码高亮: Mac 风格代码块，语法高亮

AI 去痕: 发布前自动 AI 去痕处理，让内容读起来更像真人写的

封面生成: 自动处理封面图，支持本地/网络图片

直接发布: 一键发布到微信公众号草稿箱

触发条件

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

将 Markdown 或 HTML 文章发布到微信公众号草稿箱

转换 Markdown 为公众号格式 HTML

使用特定主题发布公众号文章

测试微信连接

安装

# 从 GitHub 安装
pip install git+https://github.com/yuesf/wechat-publish-pro.git

配置

第一步：获取微信公众号凭证

1. 登录 https://developers.weixin.qq.com/ 公众号平台 2. 获取 AppID 和 AppSecret

第二步：配置凭证

#### 配置文件（多账号支持）

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

accounts:
  # 账号1（设为默认）
  default:
    name: 技术公众号
    app_id: wx89c409208d11dc5b
    app_secret: your_app_secret_here
  # 账号2
  health:
    name: 养生公众号
    app_id: cli_a95b243c6278dccf
    app_secret: your_app_secret_here
  # 可添加更多账号...
default_account: default
ai:
  provider: qwen
  api_key: your_api_key
  base_url: ""
  model: ""

#### 环境变量（单账号兼容）

export WECHAT_APP_ID=your_wechat_app_id
export WECHAT_APP_SECRET=your_wechat_app_secret
AI 去痕（可选）
export AI_API_KEY=your_api_key
export AI_PROVIDER=qwen  # openai, qwen, zhipu, doubao, minimax, moonshot, hunyuan, yi

第三步：设置 IP 白名单

把运行机器的 IP 添加到微信公众号后台白名单： 1. 登录 https://mp.weixin.qq.com/ 2. 设置与开发 → 基本配置 → 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 output.html

#### 发布到微信

# 发布 HTML 文件到草稿箱（使用默认账号）
wechat-publish-pro publish article.html
指定账号发布
wechat-publish-pro publish article.html --account health
指定标题和封面
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 upload-image image.jpg

Markdown 格式

文件顶部可以包含 frontmatter：

---
title: 文章标题
cover: ./assets/cover.jpg
正文开始（frontmatter 有 title 时会自动移除）
你的内容...

可用主题

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

AI 去痕

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

| Provider | 说明 | |----------|------| | 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/
│   ├── cli.py         # CLI 入口
│   ├── config.py      # 配置管理
│   ├── converter/     # Markdown 转换模块
│   │   ├── wechat_style.py   # 微信公众号样式转换器
│   │   ├── themes.py          # 主题配置
│   │   └── theme_types.py     # 主题数据类型
│   ├── humanizer/     # AI 去痕模块
│   └── platforms/     # 平台适配器
│       └── wechat.py # 微信公众号 API
└── pyproject.toml

设计参考

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

wenyan-cli: Markdown 转微信 HTML 的排版思路

multi-writing-skills: 转换器和主题系统的实现

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

作者

yuesf

许可证

MIT