wechat-pipeline

name	wechat-pipeline
description	公众号文章全自动流水线：写作→封面→发布。三段式编排 wechat-article-writer / code-to-image / md2wechat， 每段设断点检查，用户确认后才进入下一段。触发: '公众号创作' '写公众号文章' '公众号发布' '公众号流水线' '发公众号'。 Author: Daniel Li
homepage	https://github.com/aAAaqwq/AGI-Super-Team
metadata	{"openclaw":{"emoji":"📝→🎨→📤"},"requires":{"bins":["python3","node","md2wechat"],"packages":["playwright"],"env":["WECHAT_APPID","WECHAT_SECRET"],"skills":["wechat-article-writer","code-to-image","md2wechat"]}}

公众号流水线 · WeChat Pipeline

三段式自动流水线：写作 → 封面 → 发布，每段设断点检查，用户拍板才继续。

核心理念

用户说"写一篇公众号文章"
        │
        ▼
┌──────────────────────────────────────┐
│  STAGE 1 — 内容创作                   │
│  wechat-article-writer               │
│  搜索→撰写→标题→排版                  │
│                                      │
│  🔴 CHECKPOINT 1: 内容审查           │
│  → 展示文章 + 5个标题，等用户确认     │
└──────────────┬───────────────────────┘
               │ 用户回复"继续"
               ▼
┌──────────────────────────────────────┐
│  STAGE 2 — 封面生成                   │
│  code-to-image                       │
│  设计HTML→渲染PNG                     │
│                                      │
│  🔴 CHECKPOINT 2: 封面审查           │
│  → 展示封面图，等用户确认或要求重做    │
└──────────────┬───────────────────────┘
               │ 用户回复"继续"
               ▼
┌──────────────────────────────────────┐
│  STAGE 3 — 发布推送                   │
│  md2wechat                           │
│  门禁审查→create_draft→草稿入库       │
│                                      │
│  🔴 CHECKPOINT 3: 发布门禁           │
│  → 标题/作者/封面/摘要全展示          │
│  → 等用户回复"发"                    │
└──────────────────────────────────────┘

触发词

以下任一关键词触发此流水线：

• 公众号创作、写公众号文章、公众号发布
• 公众号流水线、发公众号、公众号全流程
• 写一篇公众号、帮我发公众号

核心铁律（不可违反）

1. 三段必须串行 — 不能跳过任何一段，不能两段并行
2. 每段必须断点 — 每段结束后必须停下来等用户确认，不得自动进入下一段
3. 不得跳过门禁 — Stage 3 的发布门禁必须完整展示标题/作者/封面/摘要
4. 封面必须代码生成 — 禁止用 image_generate（AI 生图）替代 code-to-image（代码渲染），因为中文文字准确率、主题直连度、风格可复现性差距悬殊
5. 发布必须 create_draft — 禁止用 test-draft（测试命令不传标题/作者，会导致「AI生成测试文章」）
6. 错误必记录 — 每段失败时截图保存、记录根因，不静默重试

---

Stage 1: 内容创作

子 skill: wechat-article-writer

4 步流程：搜索资料 → 撰写文章 → 生成标题 → 排版建议

Step 1.1: 搜索资料

使用 WebSearch 并行搜索：

• 官方文档 / GitHub / 技术论坛
• 优先当月/当季资料
• 深度总结，标注来源

Step 1.2: 撰写文章

• 读取 CLAUDE.md 获取写作风格（如存在）
• 字数：按用户要求，默认 2000-3000 字
• 结构：故事化开头 → 问题描述 → 步骤教学 → 升华总结
• 准备 2-3 个备选标题
• 输出 Markdown 文件到 output/ 目录

Step 1.3: 生成标题

生成 5 个爆款标题：

• 痛点明确（"还在手动..."）
• 数字吸引（"3分钟""5个技巧"）
• 结果导向（"效率暴涨10倍"）
• 情绪调动（"惊艳""神技"）
• 标题 ≤ 32 字符（微信限制）

Step 1.4: 排版建议

• 段落结构：每段 3-5 行
• 代码块：前后留白，标注语言
• 金句：单独成段加粗
• 配图标记：标注 [图: 描述] 供后续生成

---

🔴 CHECKPOINT 1: 内容审查

必须展示给用户并等待确认：

📝 内容审查

📖 文章标题候选（选一个）：
   1. xxx
   2. xxx
   3. xxx
   4. xxx
   5. xxx

📊 文章概况：
   - 字数：约 X,XXX 字
   - 结构：[段落数] 段，[代码块数] 个代码块

📄 内容预览：
   [展示文章前 3 段或关键段落]

---
请选择标题编号，或告诉我修改意见。
回复"继续"进入封面生成阶段。

用户未确认前，绝对不进入 Stage 2。

---

Stage 2: 封面生成

子 skill: code-to-image

Step 2.1: 选择模板

从 15 套模板库中推荐 2-3 个跟文章主题匹配的风格：

• 科技教程 → Blueprint / MIT Tech Review / Swiss
• 创业感悟 → Kinfolk / Coffee Notes / Notebook
• 深度分析 → Editorial / Monocle / Paper & Ink

Step 2.2: 设计封面 HTML

• 封面尺寸：公众号 900×383（16:9），渲染 -w 900 -H 383 --scale 2
• 必须跟文章主题直连（不是通用图！）
• 包含：核心概念视觉化 + 关键数据指标 + 风格色调
• 示例：md2wechat 教程 → 终端命令 + 排版转换箭头 + "1行命令/20套主题/2min全流程"

Step 2.3: 渲染

python3 ~/.openclaw/skills/code-to-image/render.py cover.html -w 900 -H 383 --scale 2 -o cover.png

---

🔴 CHECKPOINT 2: 封面审查

必须发送封面图给用户，等待确认：

🖼️ 封面审查

[发送封面图片]

🎨 封面信息：
   - 风格：[模板名]
   - 尺寸：1800×766 (2x)
   - 色调：[主色/强调色]

---
封面满意吗？
- 回复"继续"接受此封面
- 回复"重做 + 要求"重新生成（如"重做 更暗的色调"）

用户未确认前，绝对不进入 Stage 3。

---

Stage 3: 发布推送

子 skill: md2wechat

Step 3.1: 前置校验

md2wechat config validate      # 检查 WECHAT_APPID/SECRET
md2wechat inspect article.md   # 检查标题/摘要/图片

Step 3.2: 渲染 HTML

根据用户选择的排版主题（如 Coffee Notes / Deep Ocean / Swiss Minimal），将 Markdown 转换为带内联 CSS 的 WeChat 兼容 HTML。

如果 md2wechat.cn API key 不可用：

• 使用 Python 脚本渲染 HTML（内联 CSS + 主题色板）
• 参考：coffee_notes_renderer.py（Coffee Notes 示例）

Step 3.3: 上传封面

md2wechat upload_image cover.png
# 获取 thumb_media_id

Step 3.4: 生成摘要

• 从文章前 120 字提取
• 微信折叠线在 ~60 字处，核心信息必须在 60 字内露出
• 可通过 --digest 覆盖

---

🔴 CHECKPOINT 3: 发布门禁（Publish Gate）

这是最后一道关卡。必须展示所有字段，等用户说"发"。

📋 发布审查

🏷️ 标题（XX/32字）：
[完整标题文本]

✍️ 作者（XX/16字）：
[作者名]

📝 摘要（XX/128字，折叠线≈60字）：
[完整摘要文本]

🖼️ 封面：
[发送封面图]

🎨 排版风格：[主题名]

---
以上信息确认无误？回复"发"推送到草稿箱，或告知修改内容。

Step 3.5: 推草稿

用户回复"发"/"推"/"OK"后：

md2wechat create_draft draft.json

draft.json 必须包含完整字段：

{
  "articles": [{
    "title": "完整标题",
    "author": "完整作者",
    "digest": "完整摘要",
    "thumb_media_id": "封面media_id",
    "content": "HTML正文",
    "show_cover_pic": 1,
    "need_open_comment": 0,
    "only_fans_can_comment": 0
  }]
}

⚠️ 禁止使用 test-draft — 它不传 title/author/digest，会导致标题显示「AI生成测试文章」。

Step 3.6: 完成确认

✅ 发布完成

📋 草稿信息：
   media_id: dpn_xxx
   位置：微信公众号后台 → 内容管理 → 草稿箱

🧹 如有旧版草稿，请手动删除。
   去后台扫码预览，满意后一键群发。

---

常见错误与对策

错误	根因	对策
标题显示「AI生成测试文章」	用了 test-draft 而非 create_draft	改用 create_draft + 完整 JSON
封面跟文章无关	用了 image_generate 通用生图	改用 code-to-image 代码渲染
md2wechat.cn API key 失效	wme_* key 过期	用 Python 内联 CSS 渲染 + create_draft 推送
火山引擎生图 key 过期	ARK API key 过期	改用 code-to-image（永远免费）
create_draft 报「no articles」	JSON 缺少 articles 数组包裹	用 {"articles":[{...}]} 格式

---

版本历史

版本	日期	变更
v1.0	2026-06-01	初始版本。基于真实发布过程沉淀：写作(wechat-article-writer) → 封面(code-to-image) → 发布(md2wechat+Publish Gate)。记录 5 个踩坑经验。

---

Copyright © Daniel Li. All rights reserved.