微信公众号文章发布

将 Markdown 文章发布到微信公众号，支持 AI 生成封面图片。

首次配置

1. 获取公众号 AppID 和 AppSecret

在 微信公众平台 → 开发 → 基本配置 中获取。

2. 设置 IP 白名单

在基本配置页面，将你的出口 IP 加入白名单。查看出口 IP：

curl -s https://ipinfo.io/ip

3. 创建配置文件

mkdir -p ~/.wechat_publish
cat > ~/.wechat_publish/config.json \x3C\x3C 'EOF'
{
  "app_id": "你的AppID",
  "app_secret": "你的AppSecret"
}
EOF

4. 安装依赖

pip install requests markdown

如需使用 HTML 卡片渲染功能，额外安装：

pip install playwright
playwright install chromium

工作流程

当用户要求发布文章时，按以下步骤执行：

步骤 1：AI 总结摘要

阅读文章内容，用 AI 总结一段摘要，不超过 120 字节（中文约 40 字）。

步骤 2：判断封面来源

如果用户已提供封面图片 → 直接使用，跳到步骤 4。

如果用户未提供封面图片 → 进入步骤 3 用 AI 生成。

步骤 3：用 ImageGen 生成封面图片（仅当用户未提供封面时）

根据文章标题和内容，调用 ImageGen 工具生成封面。提示词参考：

微信公众号封面图，风格简约专业，比例 16:9，主题：{文章标题关键词}，不要出现文字

更多提示词模板见下方"AI 封面生成提示词建议"。

步骤 4：（可选）生成 HTML 卡片

如果文章需要插入排版精美的信息卡片（对比图、步骤说明、工具栈展示等），由 AI 生成 HTML 模板，脚本自动渲染为图片插入文章。

微信公众号对 HTML/CSS 支持有限，有些排版效果无法用内联样式实现。HTML 卡片通过 Playwright 将 HTML 渲染为图片，绕过这个限制。

常见卡片类型和 HTML 模板：

对比卡片：

\x3C!DOCTYPE html>
\x3Chtml>\x3Chead>\x3Cmeta charset="UTF-8">
\x3Cstyle>
*{margin:0;padding:0;box-sizing:border-box}
body{font-family:system-ui,-apple-system,sans-serif;background:#f5f5f7;padding:30px 20px}
.title{font-size:22px;font-weight:bold;color:#1a1a1a;margin-bottom:20px;text-align:center}
.section{margin-bottom:16px;padding:12px 16px;border-radius:8px}
.green{background:#e8f5e9;border-left:4px solid #4CAF50}
.red{background:#fce4ec;border-left:4px solid #f44336}
.section-title{font-size:15px;font-weight:bold;margin-bottom:8px}
.item{font-size:14px;color:#333;margin-bottom:4px;line-height:1.6}
\x3C/style>\x3C/head>\x3Cbody>
\x3Cdiv class="title">标题\x3C/div>
\x3Cdiv class="section green">\x3Cdiv class="section-title">✅ 能做的\x3C/div>\x3Cdiv class="item">• 内容1\x3C/div>\x3C/div>
\x3Cdiv class="section red">\x3Cdiv class="section-title">❌ 不能做的\x3C/div>\x3Cdiv class="item">• 内容1\x3C/div>\x3C/div>
\x3C/body>\x3C/html>

保存为 .html 文件后通过 --html-card 参数传入。可同时传入多个卡片文件。

步骤 5：运行发布脚本

# 仅创建草稿
python scripts/wx_publish.py --title "文章标题" --content article.md --digest "AI总结的摘要" --thumb-image \x3C封面图片路径>

# 带 HTML 卡片
python scripts/wx_publish.py --title "文章标题" --content article.md --digest "AI总结的摘要" --thumb-image \x3C封面图片路径> --html-card card.html

# 多个 HTML 卡片
python scripts/wx_publish.py --title "文章标题" --content article.md --digest "AI总结的摘要" --thumb-image \x3C封面图片路径> --html-card card1.html card2.html

# 创建草稿并自动发布
python scripts/wx_publish.py --title "文章标题" --content article.md --digest "AI总结的摘要" --thumb-image \x3C封面图片路径> --publish

如果用户提供了封面素材 ID 而非图片文件：

python scripts/wx_publish.py --title "文章标题" --content article.md --thumb-media-id \x3C素材ID>

完整参数说明

封面优先级：--thumb-media-id > --thumb-image。均未指定时会提示提供。

AI 封面生成提示词建议

根据文章类型选择合适的提示词：

常见问题

注意事项

• 本工具仅适用于已认证的微信公众号（订阅号/服务号均可）
• access_token 有效期 2 小时，脚本自动缓存和刷新
• 文章中的本地图片会自动上传到微信并替换 URL
• 建议先创建草稿确认效果，再加 --publish 自动发布
• 用户已提供封面图片时，不要再用 ImageGen 生成