微信公众号草稿箱发布技能

本技能用于将文章发布到微信公众号草稿箱。脚本仅依赖 Node.js 内置模块；自动封面生成步骤会复用现有 bun 生图脚本。

前置条件

1. 1. Node.js >= 16
2. 若要自动生成封面，还需本机可用 bun
3. 技能目录下 .env 至少包含：

env
WECHATAPPID=你的公众号AppID
WECHATAPPSECRET=你的公众号AppSecret
WECHATDEFAULTTHUMBMEDIAID=默认封面图media_id（可选）
WECHATDEFAULTAUTHOR=AI源来如此（可选）

1. 4. 运行机器公网 IP 已加入公众号后台 IP 白名单
2. 自动生成封面时，需保证 zhy-article-illustrator 的生图环境可用

安装说明

本 skill 适合与 npx skills add ... --skill zhy-wechat-publish 一起安装到 OpenCode、Claude Code 等支持 SKILL.md 的 agent 工具中。

安装后请在本地 skill 目录手动创建 .env，不要将真实凭据提交回仓库。

脚本清单

脚本位于 scripts/：

脚本	用途
wechatdraft.js	上传正文到公众号草稿箱
uploadimage.js

上传本地封面图到永久素材库，获取 media_id |
| publishwithcover.js | 读取文章、生成封面、上传封面并推送草稿 |

核心能力

• - 自动处理正文 CSS 变量兼容
• 自动将正文图片上传到微信正文图片接口并替换 URL
• 自动将 ul/ol 降级为微信公众号编辑态更稳定的段落列表
• 支持默认作者、评论开关、仅粉丝评论设置
• 支持从文章内容生成单张公众号封面，并自动上传为 thumbmediaid

工作流

方式一：已准备好 HTML 与封面 media_id

bash
node scripts/wechatdraft.js --title 文章标题 --file post.html --author AI源来如此 --thumb MEDIAID --need-open-comment 1 --only-fans-can-comment 1

参数说明：

参数	必填	说明
--title	是	文章标题
--file

是 | HTML 正文文件路径 |
| --author | 否 | 作者，不传时默认 WECHATDEFAULTAUTHOR 或 AI源来如此 |
| --digest | 否 | 摘要 |
| --thumb | 否 | 封面 media_id，不传时读取 .env 默认值 |
| --source-url | 否 | 原文链接 |
| --need-open-comment | 否 | 是否开启评论，默认 1 |
| --only-fans-can-comment | 否 | 是否仅粉丝可评论，默认 1 |

方式二：自动生成封面并发布

当你已有文章源文件，以及最终用于上传的 HTML 文件时，可直接运行：

bash
node scripts/publishwithcover.js --article article.md --html post.html --author AI源来如此 --source-url https://example.com

该脚本会自动完成：

1. 1. 读取文章内容并提取标题/摘要
2. 调用 zhy-article-illustrator/scripts/image-gen.ts 生成单张 16:9 封面图
3. 调用 uploadimage.js --json 上传封面，获得 thumbmediaid
4. 调用 wechatdraft.js 推送草稿，并自动带上：

- author - thumbmediaid - needopencomment=1 - onlyfanscan_comment=1

可选参数：

参数	说明
--article	原始文章文件，推荐 Markdown，也可 HTML
--html

最终上传到公众号的 HTML 文件 |
| --title | 显式覆盖标题 |
| --author | 显式覆盖作者 |
| --cover-output | 自定义封面输出路径 |
| --cover-ar | 封面宽高比，默认 16:9 |
| --source-url | 原文链接 |
| --need-open-comment | 是否开启评论，默认 1 |
| --only-fans-can-comment | 是否仅粉丝可评论，默认 1 |

正文兼容说明

发布前，wechat_draft.js 会自动处理：

1. 1. var(--xxx) CSS 变量展开
2. 微信 section 背景样式兼容
3. 首个 h1 去除，避免与标题重复
4. 正文图片上传到 cgi-bin/media/uploadimg
5. 原生列表转换为普通段落列表

错误排查

• - [40013] invalid appid：检查 .env 中 WECHATAPPID
• [40164] invalid ip... not in whitelist：将报错 IP 加入微信后台白名单
• [40007] invalid media_id：封面素材无效，重新上传封面图
• 缺少 Xiaomi/Gemini/OpenAI API Key：自动封面生成所需生图配置缺失
• 正文图片不显示：检查原图路径/URL 是否可访问，以及 media/uploadimg 是否成功

快速示例

bash

已有 HTML，直接发草稿

node scripts/wechat_draft.js --title 技术周报 --file post.html

自动生封面并发布

node scripts/publishwithcover.js --article article.md --html post.html

上传封面图并把 media_id 回写 .env

node scripts/upload_image.js cover.png --write-env --json