前言¶

写公众号文章时，常见流程是：在本地用 Markdown 起草，再手动配图、把图片传到素材库，最后在后台粘贴排版。配图数量往往要随章节结构调整，本地路径的图片还要换成微信 CDN 地址，否则正文里会显示空白。若你已经在用 Agent 写稿，更希望把「生图 → 渲染 → 上传 → 推草稿箱」收成一条可复现的命令链，下面介绍 SkillHub 上的 微信公众号内容生成发布（@user_d369ea45/wechat-article-gen，v1.0.3）。

这是什么¶

微信公众号内容生成发布 是 SkillHub 社区 Skill（发布者 user_d369ea45，分类 content-creation），坐标 @user_d369ea45/wechat-article-gen。官方简介为：微信公众号智能配图 + 一键发布；基于 wenyan-cli，支持本地图片自动上传到微信 CDN。

它面向「已有 Markdown 文稿、需要配图并发布到公众号草稿箱」的场景，把即梦 AI 生图脚本与 wenyan publish 封装在同一套 Skill 目录里，由 Agent 按 SKILL.md 引导执行。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与脚本说明。

1. 智能配图：generate_images.py 分析文章结构，按章节数量生成 1～4 张 16:9 配图，内容图带圆角；封面按 2.35:1 比例生成。
2. 一键发布：publish.sh 调用 wenyan publish，完成 Markdown 渲染、本地/网络图片上传微信 CDN、替换为 data-src 地址，并推送到草稿箱。
3. 排版主题：支持 lapis、phycat、default 等主题，以及 solarized-light、monokai、github 等代码高亮；可用 wenyan theme -l 查看全部主题。
4. 凭证与加载：微信与即梦凭证写在 Skill 目录下的 config.env，或通过 OpenClaw 工作区 TOOLS.md 的 export 形式提供；setup.sh / publish.sh 会按优先级读取。

SkillHub 标签为 requires_api_key=true，实际需配置即梦 AI 与微信公众号两类密钥（见下文）。

安装与启用¶

通过 SkillHub 安装 Skill¶

先确认本机有 skillhub CLI（安装方式见 SkillHub 安装文档）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

Cursor 示例如下：

skillhub install @user_d369ea45/wechat-article-gen --dir ~/.cursor/skills/

Claude Code、Codex 等客户端路径不同，常见目录分别为 ~/.claude/skills/、~/.codex/skills/ 或项目下的 .agents/skills/，安装命令中的 --dir 换成对应路径即可。

也可在对话中让 Agent 按官方提示安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d369ea45/wechat-article-gen`。

依赖与凭证¶

Skill 快速开始要求全局安装 wenyan-cli：

npm install -g @wenyan-md/cli

在 Skill 目录编辑 config.env（当前 v1.0.3 包内直接提供该文件；SKILL.md 快速开始亦提到 cp config.env.example config.env，若你本地只有 config.env，直接改即可）：

需要填写的关键字段（摘自 config.env）：

JIMENG_ACCESS_KEY_ID=your_access_key_id
JIMENG_SECRET_ACCESS_KEY=your_secret_access_key
WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret

凭证来源：

• 微信公众号：https://mp.weixin.qq.com/ → 设置与开发 → 基本配置
• 即梦 AI / 火山引擎 Access Key：https://console.volcengine.cn/

发布前还需把运行环境的公网 IP 加入公众号 IP 白名单，否则可能出现错误码 45166。可用 curl ifconfig.me 查看本机公网 IP。

典型用法¶

1. 准备带 frontmatter 的 Markdown¶

文件顶部必须包含 title 与 cover：

---
title: 文章标题（必填）
cover: ./cover.png
---

# 正文

![配图](images/img01.png)

2. 生成配图¶

在 Skill 目录下执行（路径相对于你存放 article.md 的位置调整）：

python3 scripts/generate_images.py --article article.md --output ./images/

配图数量与章节数对应关系（Skill 文档中的规则）：

3. 发布到草稿箱¶

./scripts/publish.sh article.md
./scripts/publish.sh article.md phycat
./scripts/publish.sh article.md lapis solarized-light

仅渲染、不发布时，可直接使用 wenyan-cli：

wenyan render -f article.md -t lapis

发布成功后到 https://mp.weixin.qq.com/ 草稿箱查看；Skill 文档提到 API 可能有数秒延迟。

适用场景与注意¶

适合谁

• 已用 Markdown 管理公众号稿件，希望 Agent 按固定脚本完成配图与发布。
• 已开通公众号开发者配置、即梦 AI，并接受在 config.env 或 TOOLS.md 中维护密钥。
• 愿意依赖 wenyan-cli 的主题与微信 CDN 上传逻辑，而不是在后台手工粘贴 HTML。

限制与常见坑

1. 未安装 @wenyan-md/cli 会报 wenyan: command not found；publish.sh 会尝试 npm install -g 自动安装。
2. frontmatter 缺少 title 或 cover 会导致「未能找到文章封面」类错误。
3. IP 未入白名单、AppID/AppSecret 错误会导致发布失败；即梦凭证错误会导致配图异常（文档中亦提到历史版本圆角处理 bug，需保持 generate_images.py 为 Skill 包内最新版）。
4. 本 Skill 输出的是草稿箱流程，群发、定时发布等仍需在公众号后台操作。
5. 用户要求「不要做公众号 HTML 排版」时，应区分：本 Skill 的排版由 wenyan 主题完成；若你只需要纯文稿，可使用 wenyan render 或 --no-publish 类工作流，勿强行走发布脚本。

结尾¶

微信公众号内容生成发布 把即梦配图、wenyan-cli 渲染与微信 CDN 上传串成可脚本化流程，适合在 Agent 会话里从一篇 Markdown 推到草稿箱。安装与说明以 SkillHub 与包内 SKILL.md 为准。

• SkillHub 页面：https://www.skillhub.cn/skills/user_d369ea45/wechat-article-gen
• 安装坐标：@user_d369ea45/wechat-article-gen（v1.0.3）