wechat-publisher · 微信公众号发布管道
只负责跟微信 API 打交道的部分:封面生成 / 图片上传 / 草稿创建 / 草稿发布 / 文章提取。
常用工作流
工作流 1:发已写好排版好的稿子(最常见)
前提:你已经用 wechat-writer 写好 markdown,用 wechat-formatter 转成了 html。
bash# 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 提取原文
bashpython3 scripts/extract_to_markdown.py \ "https://mp.weixin.qq.com/s/xxx" \ -o drafts/extracted.md
输出为 Markdown,交给 wechat-writer 改写——本 skill 不负责改写,只负责提取。
工作流 3:一键 orchestrator(已有 markdown,跑完整管道)
bashpython3 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 例子时 |
