微信公众号发布工具

微信公众号文章发布工具，支持 Markdown 转换、AI 去痕、多主题

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
• 使用特定主题发布公众号文章
• 测试微信连接

安装

bash

# 从 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

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: ""

环境变量（单账号兼容）

bash

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 转换

bash

# 基本转换（默认绿色主题）
wechat-publish-pro convert article.md

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

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

发布到微信

bash

# 发布 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 → 转换 → 发布

bash

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

测试连接

bash

wechat-publish-pro test

上传图片

bash

wechat-publish-pro upload-image image.jpg

Markdown 格式

文件顶部可以包含 frontmatter：

markdown

---
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 到白名单

发布成功但看不到文章？

• 原因：文章在草稿箱，需要审核发布
• 解决：草稿箱 → 选中文章 → 发布

架构说明

text

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