Wechat Publisher

wechat-publisher · 微信公众号发布管道

只负责跟微信 API 打交道的部分:封面生成 / 图片上传 / 草稿创建 / 草稿发布 / 文章提取。

常用工作流

工作流 1:发已写好排版好的稿子(最常见)

前提:你已经用 wechat-writer 写好 markdown,用 wechat-formatter 转成了 html。

# 0. 加载凭证
source <(grep -E '^WECHAT_' .env | sed 's/^/export /')

# 1. 生成封面图(五要素 prompt 见 references/image-prompts.md)
python3 scripts/generate_cover.py \
  --prompt "<五要素 prompt>" \
  --output cover.jpg

# 2. 上传封面到微信永久素材
python3 scripts/upload_material.py \
  --app_id "$WECHAT_APP_ID" --app_secret "$WECHAT_APP_SECRET" \
  --image_path cover.jpg
# 输出: thumb_media_id=THUMB_XXX

# 3. 创建草稿
python3 scripts/create_draft.py \
  --title "文章标题" \
  --content "$(cat drafts/article.html)" \
  --thumb_media_id "THUMB_XXX" \
  --author "意疏"

# 4. (可选)直接发布
python3 scripts/publish_draft.py \
  --app_id "$WECHAT_APP_ID" --app_secret "$WECHAT_APP_SECRET" \
  --media_id "MEDIA_XXX"

默认到 step 3 就停——保留为草稿,让用户登录公众号后台预览再决定是否发布。只有用户明确说"直接发"才执行 step 4。

工作流 2:从 mp.weixin URL 提取原文

python3 scripts/extract_to_markdown.py \
  "https://mp.weixin.qq.com/s/xxx" \
  -o drafts/extracted.md

输出为 Markdown,交给 wechat-writer 改写——本 skill 不负责改写,只负责提取。

工作流 3:一键 orchestrator(已有 markdown,跑完整管道)

python3 scripts/publish_article.py \
  --input article.md \
  --title "文章标题" \
  --author "意疏"

这个脚本会内部调用排版 + 封面 + 上传 + 草稿。适合用户明确说"一条命令直接给我发草稿箱"时用。

如果用户对中间产物(封面 / 配图 / 排版)有要求,不要走 orchestrator,改用工作流 1 分步执行。

封面图 prompt 必须用五要素结构

禁止写「科技风格插画」「为文章 XX 生成封面」这种空泛 prompt。详见 references/image-prompts.md。

五要素(中文逗号分隔,顺序固定):

• 核心意象:文章前 200 字提取 2-4 个具象名词(不要"效率""创新"这种抽象概念)
• 情绪基调:从 7 选 1——温暖治愈 / 专业冷静 / 紧张焦虑 / 轻松愉悦 / 怀旧沉思 / 励志昂扬 / 神秘高级
• 画面风格:按文章主题查 references/image-prompts.md 的 9 种风格映射表
• 构图与镜头(固定文本):2.35:1 横向构图,主体居中偏左,右上角嵌入小字「意疏的AI口袋」,中部区域小字「<标题关键词 3-5 字>」(避开底部 15% 遮挡区)
• 负面提示(固定文本):画面主体不要出现任何文字、字母、汉字,水印、logo、签名

文中配图(发布模式才出,预览模式跳过)

如果用户明确要"发布模式 + 配图",生成 3 张配图,按故事弧线:

| 序号 | 定位 | 元素 |

| --- | --- | --- |

| 1 | 痛点 | 文章开头的困境/焦虑具象化 |

| 2 | 转折 | 解决方案出现的关键时刻/工具 |

| 3 | 升华 | 文章结尾的理想状态/成果 |

3 张 prompt 必须互不相同,禁止复用模板。

凭证管理

凭证只写进 .env(已 gitignore)。

| 变量 | 必填 | 来源 |

| --- | --- | --- |

| WECHAT_APP_ID | ✅ | mp.weixin.qq.com → 开发 → 基本配置 |

| WECHAT_APP_SECRET | ✅ | 同上 |

| DASHSCOPE_API_KEY | 二选一 | 千问(推荐),dashscope.console.aliyun.com |

| DOUBAO_API_KEY | 二选一 | 豆包,console.volc.com/iam/keylist |

| IMAGE_PROVIDER | 可选 | qwen(默认) / doubao |

脚本对 .env 的支持

| 脚本 | 支持 .env | 不支持 → CLI 必传 |

| --- | --- | --- |

| generate_cover.py | ✅ 完全免参 | — |

| create_draft.py | ✅ 回退 | — |

| publish_article.py | ✅ 全部 | — |

| extract_to_markdown.py | ✅ 不需要凭证 | — |

| upload_material.py | ❌ | --app_id --app_secret |

| publish_draft.py | ❌ | --app_id --app_secret |

Agent 实践:调 upload_material.py / publish_draft.py 前,先 source <(grep -E '^WECHAT_' .env | sed 's/^/export /') 把凭证拼成环境变量,不要让用户重复输。

配图本地路径处理(常见坑)

如果 Markdown 里有 ! 这种本地图片路径:

• 微信 HTML 不能直接引用本地路径——需要先 upload_material.py 把图片上传到微信永久素材
• 拿到返回的 url,替换 Markdown 里的本地路径
• 再送给 wechat-formatter 转 HTML

否则 HTML 粘到微信编辑器图片会裂。

不做的事

• 不写文章 → wechat-writer
• 不做 Markdown → HTML 排版 → wechat-formatter
• 不改稿 / 不审校 → wechat-writer

子文档导航

| 文档 | 何时读 |

| --- | --- |

| references/image-prompts.md | 写封面 / 配图 prompt 时 |

| references/wechat-api.md | 微信 API 返回错误码,看不懂时 |

| references/examples.md | 想看完整 bash 例子时 |