wechat-publisher-auto（微信发布商汽车）

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 时会自动移除）

你的内容...

可用主题

AI 去痕

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

去痕强度：

• 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