前言¶

寫公衆號文章時，常見流程是：在本地用 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）