公众号一键发布实战：写完直接发，不用开浏览器

发公众号文章是个苦差事。写完Markdown，要打开浏览器登录mp.weixin.qq.com，新建图文，复制标题，粘贴正文，调格式，上传封面图，预览，保存草稿……一篇30分钟就没了。

AI方式完全不同：写完Markdown，一行命令直接发草稿，3分钟搞定。

传统方式 vs AI方式

核心原理：API直连，绕过浏览器

公众号有官方API（api.weixin.qq.com），支持草稿创建（/cgi-bin/draft/add）。传统方式是通过浏览器操作这个API，AI方式是直接调用。

流程：

1. 获取access_token（API鉴权）
2. 上传封面图到素材库（/cgi-bin/material/add_material）
3. 上传正文图片到素材库（/cgi-bin/media/uploadimg）
4. 创建草稿（/cgi-bin/draft/add）

全程无需浏览器，无需扫码，无需手动操作。

实战：一行命令发草稿

第1步：准备Markdown文件

---
title: "我的第一篇文章"
author: "xAI智工场"
---

# 我的第一篇文章

这是正文内容...

第2步：执行发布命令

python3 ~/.hermes/scripts/wechat-upload.py article.md

第3步：查看结果

脚本自动完成：

• ✅ 生成封面图（AI自动设计）
• ✅ 生成配图（根据【配图建议】）
• ✅ 上传所有图片到微信素材库
• ✅ 转换Markdown为微信HTML格式
• ✅ 创建草稿

输出：

{
  "success": true,
  "media_id": "xxx",
  "message": "草稿「我的第一篇文章」已创建成功"
}

第4步：登录mp.weixin.qq.com发布

草稿已创建，登录后台点击"发布"即可。

智能功能：不只是简单发布

1. 自动封面图生成

脚本根据文章内容自动选择封面风格：

• 技术教程 → conceptual + cool + digital
• 生活随笔 → scene + warm + painterly
• 商业文案 → hero + vivid + flat-vector

无需手动设计，AI自动匹配最佳风格。

2. 智能配图生成

Markdown中的【配图建议】标记会被自动识别：

AI自动生成对应的插图，上传到微信素材库，替换为图片标签。

3. 宝玉排版引擎

自动应用专业排版：

• 字体大小、行距、段落间距优化
• 代码块高亮
• 表格样式美化
• 引用块设计
• 图片圆角+阴影

发布即精品，无需手动调格式。

批量发布：10篇文章10分钟

如果你有10篇文章要发：

for file in articles/*.md; do
  python3 ~/.hermes/scripts/wechat-upload.py "$file"
  sleep 5  # 避免API限流
done

10分钟搞定10篇草稿。传统方式要5小时。

3个高级用法

1. 自定义封面风格

python3 ~/.hermes/scripts/wechat-upload.py article.md \
  --cover-type hero \
  --cover-palette vivid \
  --cover-rendering flat-vector

强制使用指定风格，覆盖AI自动选择。

2. 指定作者和摘要

python3 ~/.hermes/scripts/wechat-upload.py article.md \
  --author "火花" \
  --digest "这篇文章讲了..."

覆盖默认的作者和摘要。

3. 跳过封面图生成

如果已有封面图：

python3 ~/.hermes/scripts/wechat-upload.py article.md \
  --skip-cover

节省生成时间。

常见问题

Q: 需要配置什么？

A: 首次运行会自动引导配置微信公众号AppID和AppSecret（在mp.weixin.qq.com → 开发 → 基本配置获取）。配置保存在~/.baoyu-skills/.env，后续无需重复。

Q: 支持哪些Markdown特性？

A: 支持标准Markdown + GFM扩展（表格、任务列表、代码块高亮）。不支持HTML内联（会被转义）。

Q: 图片怎么处理？

A: Markdown中的图片链接会被自动上传到微信素材库，替换为微信CDN链接。本地图片（./image.png）也会被上传。

Q: 草稿创建后还能改吗？

A: 可以。登录mp.weixin.qq.com，在"草稿箱"中找到，点击编辑即可修改。

Q: 能不能直接发布（不经过草稿）？

A: 微信API不支持直接发布，必须经过草稿。这是微信的安全机制，防止误操作。

场景对比

对于内容团队，这意味着：

• 作者写完Markdown，自己一行命令发草稿
• 运营只需审核+发布，无需排版
• 效率提升10倍，人力成本降低80%

完整工作流

日常发文（3分钟）：

# 1. 写文章
vim article.md

# 2. 发布
python3 ~/.hermes/scripts/wechat-upload.py article.md

# 3. 登录mp.weixin.qq.com发布

批量发文（10分钟/10篇）：

# 1. 准备所有文章
ls articles/

# 2. 批量发布
for file in articles/*.md; do
  python3 ~/.hermes/scripts/wechat-upload.py "$file"
  sleep 5
done

# 3. 登录mp.weixin.qq.com逐个发布

团队协作：

# 作者写文章
git commit -m "add: 新文章"

# CI自动发布
.github/workflows/wechat-publish.yml
  → python3 wechat-upload.py $CHANGED_FILES

# 运营审核+发布
mp.weixin.qq.com → 草稿箱 → 发布

关注「xAI智工场」公众号，每天分享AI实操技巧。回复"发布"获取本文同款发布脚本的使用教程。