wechat-publisher

Category: Tools & Productivity | Uploader: jiji262 | Downloads: 0 | Version: v1.0（Latest）
微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息，使用 baoyu-infographic 生成手绘风格配图，生成图文并茂的公众号文章，并发布到微信公众号草稿箱。触发场景（只要沾边就该使用本skill）： - 用户提到"公众号"、"微信文章"、"推文"、"公号"、"发文"、"mp"等关键词 - 用户要求写文章并发布到微信 - 用户提供参考素材并希望生成公众号内容 - 用户希望把文档/笔记转为微信公众号文章 - 用户要求搜索某个话题并写成公众号文章 - 用户提到"草稿箱"、"群发"等微信公众号相关操作 - 用户要求写一篇适合在微信上传播的文章 --- # 微信公众号文章自动创作与发布本skill实现从素材输入到公众号草稿箱的完整自动化流程。核心价值在于：用户只需要提供一个话题或几篇参考资料，skill就能自动完成搜索调研、撰写文章、生成配图、排版美化、上传发布的全部环节。 **默认作者：飞哥**（除非用户另行指定） ## 前置条件检查在开始任何工作之前，先检查环境是否就绪： **第一步：检查账号配置** 支持两种配置方式： **方式一：`accounts.yaml` 多账号配置（推荐）** 在工作目录下创建 `accounts.yaml`（参考 `accounts.yaml.example`）： ```yaml
Changelog: Source: GitHub https://github.com/jiji262/wechat-publisher
Directory Structure

Current level: tree/main/
📁 assets/
- 📄 style_config.json 2.9 KB
📁 references/
- 📄 api_reference.md 3.2 KB
📁 scripts/
- 📄 html_converter.py 12.1 KB
- 📄 image_handler.py 11.6 KB
- 📄 publish.py 9.5 KB
- 📄 wechat_api.py 18.5 KB
📄 .gitignore 338 B
📄 accounts.yaml.example 622 B
📄 README.md 8.6 KB
📄 SKILL.md 18.6 KB
SKILL.md

---
name: wechat-publisher
description: |
  微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息，使用 baoyu-infographic 生成手绘风格配图，生成图文并茂的公众号文章，并发布到微信公众号草稿箱。

  触发场景（只要沾边就该使用本skill）：
  - 用户提到"公众号"、"微信文章"、"推文"、"公号"、"发文"、"mp"等关键词
  - 用户要求写文章并发布到微信
  - 用户提供参考素材并希望生成公众号内容
  - 用户希望把文档/笔记转为微信公众号文章
  - 用户要求搜索某个话题并写成公众号文章
  - 用户提到"草稿箱"、"群发"等微信公众号相关操作
  - 用户要求写一篇适合在微信上传播的文章
---

# 微信公众号文章自动创作与发布

本skill实现从素材输入到公众号草稿箱的完整自动化流程。核心价值在于：用户只需要提供一个话题或几篇参考资料，skill就能自动完成搜索调研、撰写文章、生成配图、排版美化、上传发布的全部环节。

**默认作者：飞哥**（除非用户另行指定）

## 前置条件检查

在开始任何工作之前，先检查环境是否就绪：

**第一步：检查账号配置**

支持两种配置方式：

**方式一：`accounts.yaml` 多账号配置（推荐）**

在工作目录下创建 `accounts.yaml`（参考 `accounts.yaml.example`）：

```yaml
default: main  # 默认账号

accounts:
  main:
    name: "我的主公众号"
    app_id: "wx1234567890abcdef"
    app_secret: "your_app_secret_here"
    author: "飞哥"

  tech:
    name: "技术博客号"
    app_id: "wx0987654321fedcba"
    app_secret: "another_app_secret"
    author: "技术团队"
```

使用时通过 `--account` 指定账号：
```bash
python3 scripts/publish.py --account tech --html article.html --cover cover.jpg --title "标题"
python3 scripts/image_handler.py --account tech upload image.png
```

不指定 `--account` 时使用 `default` 指定的账号。作者名自动从账号配置中获取。

查看已配置的账号：
```bash
python3 scripts/wechat_api.py list-accounts
```

**方式二：`.env` 单账号配置（向后兼容）**

在工作目录（或skill目录、用户主目录）下查找 `.env` 文件，确认包含：

```
WECHAT_APP_ID=你的公众号AppID
WECHAT_APP_SECRET=你的公众号AppSecret
```

如果用户未配置，告知用户需要：
1. 登录 [微信公众平台](https://mp.weixin.qq.com) → 设置与开发 → 基本配置
2. 获取 AppID 和 AppSecret（第一次使用需要手动启用开发者密码）
3. 在「IP白名单」中添加当前机器的公网IP（可通过 `curl ifconfig.me` 查询）
4. 将凭证保存到 `.env` 文件或 `accounts.yaml`

**第二步：验证API连接**

```bash
cd <skill-path>/scripts && python3 -c "from wechat_api import get_access_token; print('API连接正常:', get_access_token()[:10]+'...')"
```

如果报错 `40164`，说明IP白名单未配置。如果报错 `40001`/`40002`，说明AppID或AppSecret不正确。

**第三步：安装依赖**

脚本仅依赖 `requests` 库：
```bash
pip install requests --break-system-packages 2>/dev/null || pip install requests
```

## 完整工作流程（6个阶段）

拿到用户的需求后，按以下6个阶段依次推进。每个阶段完成后简要告知用户进度。

---

### 阶段一：理解需求与收集素材

目标：搞清楚用户到底想要什么样的文章。

1. **分析用户输入**：
   - 如果用户提供了参考文章/文档，仔细阅读并提取核心观点、写作风格、目标受众
   - 如果用户只给了一个话题，先简短确认：目标读者是谁？偏科普还是深度？要不要带营销性质？
   - 如果用户上传了文件，用Read工具读取内容

2. **提炼写作方向**：从素材中提取3-5个核心关键词，形成写作大纲的雏形

这个阶段要快，不要过度确认。如果用户的意图已经很清楚（比如"帮我写一篇关于XXX的公众号文章"），直接进入下一阶段。

---

### 阶段二：全网信息搜索与整理

目标：围绕主题收集足够多的高质量素材，让文章有深度、有料。

1. **多轮搜索**（使用WebSearch工具）：
   - 第1轮：搜索核心话题的最新资讯和数据（如"2025年XX行业趋势"）
   - 第2轮：搜索相关案例和故事（如"XX成功案例"）
   - 第3轮：搜索专家观点或权威报告（如"XX领域专家观点"）

2. **信息筛选**：
   - 去重，交叉验证关键数据
   - 优先使用最近6个月的数据和案例
   - 标注信息来源，方便后续引用

3. **形成写作提纲**：将素材按逻辑分组，规划文章结构（标题→引言→正文2-4节→总结）

搜索时注意：每次搜索用不同的关键词组合，避免信息同质化。如果某个方向搜索结果不理想，灵活调整关键词。

---

### 阶段三：撰写文章

目标：写出一篇适合微信公众号传播的高质量文章。

**文章结构模板**（Markdown格式）：

**注意**：Markdown 中的第一个 `# 标题` 会被 html_converter 自动跳过（不输出到正文HTML中），因为微信公众号会在文章顶部自动显示标题，正文中重复标题会冗余。标题仅用于 `publish.py --title` 参数和文件内部标记。

```markdown
# 标题（抓眼球，15-25字为佳）

> 摘要引言（1-2句话概括核心观点，会显示在分享卡片中）

![开篇配图描述](placeholder)

## 开篇引入
（用故事、数据或热点事件，3-5行内抓住读者注意力）

![开篇配图描述](placeholder)

## 正文小节一：XXX
（展开第一个论点，配合数据/案例，深入分析）

![小节一配图描述](placeholder)

## 正文小节二：XXX
（展开第二个论点，补充不同角度的论据）

![小节二配图描述](placeholder)

## 正文小节三：XXX
（展开第三个论点，加入实操建议或案例故事）

![小节三配图描述](placeholder)

## 正文小节四：XXX（可选）
（如果话题足够丰富，可以展开第四个甚至第五个小节）

![小节四配图描述](placeholder)

## 正文小节五：XXX（可选）
（延伸讨论、未来展望、行业影响等）

![小节五配图描述](placeholder)

## 写在最后
（不要简单总结，给出有力的收束观点、行动建议或开放问题。可加互动引导语。）
```

**文章规模指南**：
- **正文小节数量：4-6个**，每个小节围绕一个独立论点展开，做到"有料、有例、有图"
- **每个小节 400-800 字**，包含论点阐述、数据/案例支撑、以及一段引用块（金句或关键数据）
- **配图数量：6-10张**，确保每个小节至少配1张图，重要小节可配2张（如一张概念图+一张数据图）
- **总字数目标：3000-5000字**，做到深度够、节奏好、读起来不累

#### 写作风格指南（参考宝玉AI、量子位等头部AI博主）

**整体调性**：专业但不学术，通俗但不肤浅，有观点但不偏激。让读者觉得"这个作者懂行，而且说人话"。

**具体要求**：

- **标题要有信息量，不做标题党**：好标题 = 核心信息 + 情绪钩子。15-25字为佳。参考以下爆款标题公式：
  - **痛点+方案+数字**："告别排版地狱：这个AI神器让公众号发文从3小时变成10分钟"
  - **身份代入+结果**："我用AI写了个工具，现在公众号文章从写作到发布只要10分钟"
  - **反常识/悬念**："写代码的时代结束了，设计Agent工作环境的时代开始了"
  - **干货承诺+具体数字**："Claude迎来史上最大更新：8个新功能一文看懂"
  - **对比冲突**："3小时 vs 10分钟：一个AI工具如何改变我的公众号写作流程"
  - 避免纯标题党（"震惊！"、"竟然！"），避免信息量为零的悬念标题
- **开头直切主题**：不要铺垫太多。第一段就要让读者知道这篇文章讲什么、跟他有什么关系。可以用一个反常识的数据、一个最新的事件、或者一个读者关心的问题来开头。
- **段落要短，3-4行最佳**：手机屏幕一屏大约能显示4-5行文字。段落超过5行就会让读者感到压迫。善用换行来制造"呼吸感"。
- **语言有温度但不油腻**：用"你"而不是"读者"，用"我们"拉近距离。但避免过度亲昵（"亲"、"宝子"）或过度口语化。保持一种"聪明朋友跟你聊天"的感觉。
- **善用加粗突出重点**：文章中**关键观点和数据**要加粗，因为大多数读者是"扫读"模式。但不要每段都加粗，否则等于没加粗。
- **每200-400字配一张图**：图文交错能显著降低阅读疲劳感。配图要和内容相关，每个小节至少一张图。一篇完整文章通常需要6-10张配图。
- **金句点缀**：每个小节可以有1个引用块（blockquote），放金句或关键数据。在微信排版中引用块非常醒目，是天然的"视觉锚点"。
- **深度展开每个论点**：不要蜻蜓点水。每个小节围绕一个核心论点，至少包含：论点阐述（是什么）、原因分析（为什么）、案例/数据佐证（怎么证明）、实操建议或延伸思考（怎么用）。
- **善用小标题和列表**：长文章需要清晰的导航结构。二级标题划分大板块，三级标题拆分细节，列表呈现并列信息。
- **结尾要有余韵**：不要用"综上所述"这种学生作文式结尾。可以抛一个开放问题、给一个行动建议、或者用一句有力的总结收束。
- **文末互动自然**：可以加"你怎么看？欢迎留言讨论"之类的引导语，但要写得自然，像是顺口一说，而不是模板化的"点赞关注转发"。
- **总字数目标3000-5000字**：要有足够的深度和信息量。每个小节要展开充分，配合具体的数据、案例和分析，让读者觉得"这篇文章值得收藏"。

**要避免的"AI味"写法**：
- 不要用"首先...其次...再次...最后..."这种教科书式的枚举
- 不要每段开头都用"值得一提的是"、"不可否认"、"毋庸置疑"等套话
- 不要用过于工整的排比句，真人写作有自然的参差感
- 不要在文末做过于全面的"总结回顾"，读者已经看过了，不需要你复述一遍
- 不要把所有信息平铺直叙，要有主次、有取舍、有节奏

**关于图片**：在写文章时，先用占位符描述需要什么图片，格式为 `![图片主题描述](placeholder)`。后续阶段再替换为真实图片。

---

### 阶段四：生成配图

目标：为文章生成与主题相关的高质量手绘风格配图。

**优先使用 `baoyu-danger-gemini-web` skill 生成配图**：

这是首选的配图方案。通过 gemini-web 可以根据文字描述生成精美的手绘/信息图风格图片，风格统一、与文章内容高度相关。

1. **规划配图内容**：根据文章中每个 `![描述](placeholder)` 的位置和上下文，确定每张配图应该表达的核心信息。一篇完整文章通常需要 **6-10张配图**，类型可以包括：
   - 概念解释图（用图示说明抽象概念）
   - 流程/架构图（展示步骤或系统结构）
   - 对比图（before/after、A vs B）
   - 数据可视化（趋势、占比、排名）
   - 场景示意图（应用场景、使用方式）
   - 总结提炼图（核心要点的视觉化归纳）

2. **调用 baoyu-danger-gemini-web 生成图片**（首选方案）：
   - 直接使用 gemini-web skill 的图片生成能力，为每张图提供详细的中文描述 prompt
   - 可以并行生成多张图片（使用 `run_in_background`），提高效率
   - 也可使用 `Skill("baoyu-infographic")` 生成更复杂的信息图，适合需要结构化展示数据的场景

3. **配图风格规范（默认风格：手绘信息图）**：

   所有配图必须保持统一的视觉风格。以下是经过验证的默认风格 prompt 模板：

   ```
   Generate a hand-drawn sketch style infographic in Chinese.
   Theme: [具体主题].
   [具体内容描述：展示什么元素、什么布局、什么标注文字].
   Use blue (#4a6cf7) as accent color on white background.
   Style: clean hand-drawn lines, minimalist, tech-illustration feel.
   ```

   **风格要点**：
   - **画风**：手绘线条风（hand-drawn sketch style），干净简约，有科技插画感
   - **背景**：纯白色背景，不要复杂的纹理或渐变
   - **主色调**：蓝色 `#4a6cf7` 作为强调色，与文章排版主题色一致
   - **辅助色**：可根据需要添加橙色 `#ff8c42` 等对比色，但整体不超过2-3种颜色
   - **文字**：配图中的标注文字使用中文，字体清晰可读
   - **构图**：信息层次分明，有清晰的视觉流向（从上到下、从左到右）
   - **元素**：善用箭头、连接线、分层结构、图标符号等信息图常见元素
   - **禁忌**：不要写实照片风格、不要3D渲染、不要过于花哨的装饰、不要深色背景

   **不同类型配图的 prompt 侧重点**：
   - **架构图**：强调层次（Top/Middle/Bottom layer）、箭头流向、组件名称标注
   - **对比图**：左右分栏，各自标注特征，中间用 vs 或箭头连接
   - **流程图**：步骤编号，箭头串联，每步简短标注
   - **雷达图/数据图**：清晰的坐标轴/维度标签，不同颜色区分数据系列
   - **趋势图**：时间线布局，里程碑节点标注，方向箭头暗示趋势

3. **下载并上传到微信**：将生成的图片上传到微信服务器获取CDN链接
   ```bash
   python3 scripts/image_handler.py upload /path/to/generated_image.png
   ```

4. **替换Markdown中的图片链接**：将 placeholder 替换为微信CDN返回的URL

**备选方案：使用外部图片**

如果 baoyu-infographic 不可用或不适合当前场景，可以退回到搜索免费图片：
- 使用WebSearch搜索相关图片（关键词加 "unsplash" / "pexels" / "free stock"）
- 下载图片：`python3 scripts/image_handler.py download "图片URL" -d /tmp/wechat_images`
- 上传微信：`python3 scripts/image_handler.py upload /tmp/wechat_images/图片文件名`

**自动批量处理**：如果文章中的图片链接已经是真实URL（而非placeholder），可以一步到位：
```bash
python3 scripts/image_handler.py process article.md -o article_processed.md
```

**封面图**：从文章图片中选一张最有视觉冲击力的作为封面，或使用 baoyu-infographic 单独生成。封面图建议尺寸：900×383像素（2.35:1比例），这是微信公众号的推荐比例。

---

### 阶段五：格式转换与排版

目标：将Markdown转换为微信兼容的精美HTML。

**为什么需要特殊转换**：微信公众号编辑器有许多限制——不支持外部CSS/JS、不支持class属性、所有样式必须内联到每个标签的style属性中。普通的Markdown转HTML工具生成的代码在微信中会显示为纯文本。

**执行转换**：
```bash
python3 scripts/html_converter.py article_processed.md -o article.html
```

转换器会自动：
- 将所有CSS样式内联到每个HTML标签
- 应用清新现代的蓝色主题排版（标题渐变背景、圆点列表、柔和阴影等）
- 处理微信不支持的HTML特性

**排版风格说明**：
- 主色调：#4a6cf7（优雅蓝），用于标题边框、加粗文字、列表圆点等
- 正文字号：15px，行高2倍，字间距0.8px，阅读舒适
- 段落间距宽松，给内容"呼吸感"
- 引用块使用淡蓝灰背景，柔和不抢眼
- 代码块使用深色主题（Catppuccin风格），圆角10px
- 图片带柔和阴影（0 4px 16px），圆角6px

**自定义样式**：样式配置在 `assets/style_config.json`，可以修改颜色、字号、间距等。如果用户要求不同的配色，可以直接编辑这个JSON文件。

**检查HTML**：转换后可以检查HTML文件，确保没有异常。常见问题：
- 图片URL是否都是 `mmbiz.qpic.cn` 开头的微信CDN链接
- 是否有遗留的 placeholder 未替换
- 表格是否正确渲染

---

### 阶段六：发布到草稿箱

目标：将完成的文章上传到微信公众号草稿箱。

**一键发布**：
```bash
python3 scripts/publish.py \
  --input article.md \
  --cover /tmp/wechat_images/cover.jpg \
  --title "文章标题" \
  --digest "120字以内的摘要"
```

默认作者为"飞哥"，无需额外指定。如需自定义作者，添加 `--author "其他作者"` 参数。

publish.py 会自动完成：图片处理 → HTML转换 → 封面图上传 → 创建草稿

**如果已有排版好的HTML**：
```bash
python3 scripts/publish.py \
  --html article.html \
  --cover /tmp/wechat_images/cover.jpg \
  --title "文章标题"
```

**发布成功后**：脚本会返回草稿的 `media_id`。告诉用户：
- 文章已成功保存到草稿箱
- 请登录微信公众平台（mp.weixin.qq.com）查看草稿并确认发布
- 文章不会自动群发，需要手动点击发布

---

## 脚本说明

所有脚本位于 `scripts/` 目录下：

| 脚本 | 用途 | 何时使用 |
|------|------|----------|
| `wechat_api.py` | 微信API封装（token、上传、草稿） | 需要直接调用API时 |
| `html_converter.py` | Markdown→微信HTML转换 | 需要转换排版时 |
| `image_handler.py` | 图片下载/上传/替换 | 需要处理图片时 |
| `publish.py` | 完整发布流程（一键执行） | 最终发布时 |

详细API文档见 `references/api_reference.md`。

## 错误处理指南

| 错误 | 原因 | 解决方法 |
|------|------|----------|
| `40164 IP不在白名单` | 机器IP未加白名单 | 用 `curl ifconfig.me` 获取IP，添加到公众平台白名单 |
| `40001 access_token无效` | token过期或凭证错误 | 检查 .env 中的 AppID/AppSecret 是否正确 |
| `40009 图片大小超限` | 图片超过10MB | 压缩图片或换一张 |
| `48001 接口未授权` | 公众号类型不支持 | 需要认证的服务号或订阅号（已认证） |
| 图片下载失败 | 网络问题或URL无效 | 重新搜索图片或使用其他图片源 |
| HTML中图片不显示 | 未上传到微信CDN | 确保所有图片都通过 uploadimg 接口上传 |

## 注意事项

- 文章始终发布到**草稿箱**，不会自动群发，用户可放心使用
- 默认作者为"飞哥"，可通过 `--author` 参数自定义
- access_token 有效期2小时，脚本自动管理刷新，无需手动操作
- 微信API有频率限制（每日100次素材上传），不要短时间大量操作
- 正文图片通过 uploadimg 接口上传，不占用永久素材名额
- 如果用户没有提供封面图，使用文章第一张配图作为封面
- 配图优先使用 baoyu-infographic skill 生成手绘风格图片，保证风格统一
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
wechat-publisher

Directory Structure

SKILL.md

Report

Notice
