wjs-publishing-wechat

写并发布微信公众号文章的 Claude Code skill。AI 生成题图和解释图，一行命令把草稿推到公众号后台。

三条原则：

1. 轻润色，不重写。 保留作者的语气，只修错字、切段，不"提升"文笔。
2. 每篇两张图。 2.35:1 的题图（封面用）+ 比例自由的卡通解释图（正文用）。
3. 一行命令发草稿。 upload-draft.sh 走 md2wechat API：上传封面、生成正文 HTML、建/更新草稿，自动打开后台草稿箱。手机预览后点发布。

怎么用

直接跟 Claude Code 说「写一篇公众号文章，思路是…」或 /wjs-publishing-wechat，把草稿粘进来。skill 会问 1–2 个问题，然后产出文章目录：

articles/2026-05-09-my-slug/
├── original.md          # 你的原始输入（备份）
├── article.md           # 轻润色后的 markdown
├── cover.png            # 题图 900×383（严格 2.35:1）
├── illustration.png     # 解释图（比例由模型按内容定）
├── meta.json            # title / summary / author / slug
├── content.html         # 生成的正文 HTML
└── draft.json           # 提交给 md2wechat 的草稿体

三个脚本分别管配图和发布：

DIR=articles/YYYY-MM-DD-slug

# 题图（2.35:1，自动裁到 900×383）
~/.claude/skills/wjs-publishing-wechat/scripts/gen-cover-ai.sh "$DIR" "目标字词"

# 解释图（比例自由，不裁）
~/.claude/skills/wjs-publishing-wechat/scripts/gen-illustration.sh "$DIR"

# 发布：建/更新草稿到 mp.weixin.qq.com 后台
~/.claude/skills/wjs-publishing-wechat/scripts/upload-draft.sh "$DIR"

图片脚本是幂等的——再跑一次得到不同结果（生成有随机性）。

安装

git clone https://github.com/jianshuo/wjs-publishing-wechat ~/.claude/skills/wjs-publishing-wechat

之后在 Claude Code 里说「写一篇公众号」「润色」「准备发布」或 /wjs-publishing-wechat 就会触发。

依赖

• macOS / Linux（open / xdg-open 打开浏览器）

• Python 3、Node.js

• md2wechat CLI — 发草稿用。需配好 WECHAT_APPID + WECHAT_SECRET（md2wechat config show），并把当前公网 IP 加进公众号后台 IP 白名单（设置与开发 → 基本配置 → IP 白名单），否则报 errcode=40164。

• gpt-image-2-skill — AI 配图用：

  git clone https://github.com/Wangnov/gpt-image-2-skill /tmp/g
  cp -r /tmp/g/skills/gpt-image-2-skill ~/.claude/skills/
  

  鉴权：OPENAI_API_KEY（gpt-image-2 需 OpenAI 组织认证）或 Codex ~/.codex/auth.json（任意 ChatGPT Plus 账号即可，免认证，推荐）。

自定义

两个图片生成器读可编辑的 prompt 模板：

• prompts/cover-prompt.md — 题图设计哲学，含 [目标字词] 占位符，锁定 2.35:1
• prompts/illustration-prompt.md — 解释图风格指南，含 [文章内容] 占位符，比例由模型按内容选

upload-draft.sh 的环境变量：

• WECHAT_PUBLISH_FORCE_NEW=1 — 强制建新草稿（不复用 draft_media_id）
• WECHAT_PUBLISH_NO_OPEN=1 — 不自动打开浏览器
• WECHAT_PUBLISH_NO_PUSH=1 — 不自动 push 文章目录到 git

文件结构

.
├── SKILL.md                    # skill 的行为（它的 prompt）
├── prompts/
│   ├── cover-prompt.md         # 题图 prompt 模板
│   └── illustration-prompt.md  # 解释图 prompt 模板
└── scripts/
    ├── gen-cover-ai.sh         # gpt-image-2 题图 → 900×383
    ├── gen-illustration.sh     # 解释图，不裁
    ├── upload-draft.sh         # 生成 content.html + 经 md2wechat API 建/更新草稿
    ├── pangu.py                # 盘古之白（中英间加空格）
    ├── update-draft-via-api.py # 草稿原地更新
    └── …                       # 留言抓取 / 群发等辅助脚本

为什么两张图？

题图是读者在公众号信息流里点开之前看到的封面，要在 2.35:1（900×383，公众号封面槽的精确尺寸）里一击命中，靠的是字体和构图。

解释图在文章里，要帮读者在读文字前先抓住概念。把它硬塞进封面比例会毁掉它。不同的活，不同的比例。

它明确不做的事

• 不替你重写文笔。想让 LLM 代笔，这工具不对路。
• 不管理公众号账号、粉丝分析、定时发送。

License

MIT — 见 LICENSE。

作者

王建硕 — 为自己的公众号工作流而做，分享给有同样问题的人。