// Use when publishing HTML articles to WeChat Official Account drafts, especially when you need cover upload, automatic cover generation, body image rewriting, CSS-variable compatibility, or draft metadata like author and comment settings.
Use when illustrating a Markdown article with high-finish editorial visuals, visual-bible planning, structured prompts, optional Qiniu upload, and inserted image references for article publishing workflows.
Use when converting Markdown into WeChat-compatible inline HTML with theme styles for preview, copy-paste, or downstream draft publishing.
Use when generating a complete WeChat article from a topic, with optional source research, evidence tracking, illustration, HTML conversion, and draft-box publishing.
| name | wechat-publish |
| description | Use when publishing HTML articles to WeChat Official Account drafts, especially when you need cover upload, automatic cover generation, body image rewriting, CSS-variable compatibility, or draft metadata like author and comment settings. |
| argument-hint | ["html-file-path"] |
本技能用于将文章发布到微信公众号草稿箱。脚本仅依赖 Node.js 内置模块；自动封面生成步骤会复用现有 bun 生图脚本。
Node.js >= 16bun.env 至少包含：WECHAT_APP_ID=你的公众号AppID
WECHAT_APP_SECRET=你的公众号AppSecret
WECHAT_DEFAULT_THUMB_MEDIA_ID=默认封面图media_id（可选）
WECHAT_DEFAULT_AUTHOR=AI源来如此（可选）
article-illustrator 的生图环境可用本 skill 适合与 npx skills add ... --skill wechat-publish 一起安装到 OpenCode、Claude Code 等支持 SKILL.md 的 agent 工具中。
安装后请在本地 skill 目录手动创建 .env，不要将真实凭据提交回仓库。
脚本位于 scripts/：
| 脚本 | 用途 |
|---|---|
wechat_draft.js | 上传正文到公众号草稿箱 |
upload_image.js | 上传本地封面图到永久素材库，获取 media_id |
publish_with_cover.js | 读取文章、生成封面、上传封面并推送草稿 |
ul/ol 降级为微信公众号编辑态更稳定的段落列表thumb_media_idnode scripts/wechat_draft.js --title "文章标题" --file "post.html" --author "AI源来如此" --thumb "MEDIA_ID" --need-open-comment "1" --only-fans-can-comment "1"
参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
--title | 是 | 文章标题 |
--file | 是 | HTML 正文文件路径 |
--author | 否 | 作者，不传时默认 WECHAT_DEFAULT_AUTHOR 或 AI源来如此 |
--digest | 否 | 摘要 |
--thumb | 否 | 封面 media_id，不传时读取 .env 默认值 |
--source-url | 否 | 原文链接 |
--need-open-comment | 否 | 是否开启评论，默认 1 |
--only-fans-can-comment | 否 | 是否仅粉丝可评论，默认 1 |
当你已有文章源文件，以及最终用于上传的 HTML 文件时，可直接运行：
node scripts/publish_with_cover.js --article "article.md" --html "post.html" --author "AI源来如此" --source-url "https://example.com"
该脚本会自动完成：
article-illustrator/scripts/image-gen.ts 生成单张 16:9 封面图upload_image.js --json 上传封面，获得 thumb_media_idwechat_draft.js 推送草稿，并自动带上：
authorthumb_media_idneed_open_comment=1only_fans_can_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 会自动处理：
var(--xxx) CSS 变量展开h1 去除，避免与标题重复cgi-bin/media/uploadimg[40013] invalid appid：检查 .env 中 WECHAT_APP_ID[40164] invalid ip... not in whitelist：将报错 IP 加入微信后台白名单[40007] invalid media_id：封面素材无效，重新上传封面图缺少 Xiaomi/Gemini/OpenAI API Key：自动封面生成所需生图配置缺失media/uploadimg 是否成功# 已有 HTML，直接发草稿
node scripts/wechat_draft.js --title "技术周报" --file "post.html"
# 自动生封面并发布
node scripts/publish_with_cover.js --article "article.md" --html "post.html"
# 上传封面图并把 media_id 回写 .env
node scripts/upload_image.js "cover.png" --write-env --json