前言¶
公衆號後臺對排版、封面和素材有固定要求，很多團隊先在本地用 Markdown 寫稿，再手工粘貼或藉助零散腳本轉 HTML。中間環節多，封面、圖片上傳和 Frontmatter 也容易漏項。下面介紹 SkillHub 上的「微信公衆號文章發佈工具」：它把 Wenyan CLI 的發佈流程寫進 Agent 可讀的 SKILL.md，讓 Cursor、Claude Code 等客戶端在對話裏按同一套規範完成排版與發佈。
這是什麼¶
微信公衆號文章發佈工具（座標 @user_d8946e26/wenyan-publish，版本 1.0.0）是社區發佈者 user_d8946e26 在 SkillHub 上架的 content-creation 類 Skill。官方簡介爲：AI-ready skill to format and publish Markdown articles to WeChat Official Accounts using Wenyan CLI.
一句話定位：面向 AI Agent 的技能包，指導 Agent 將標準 Markdown 轉爲符合公衆號要求的富文本，並通過 Wenyan CLI 調用微信接口發佈。Skill 包內標識名爲 publish-to-wechat。SkillHub 標籤含 requires_api_key=true，表示運行依賴微信公衆號憑據等密鑰類配置。
核心功能¶
以下能力均來自 Skill 包內 SKILL.md 的說明：
- 自動化排版：支持多種內置主題（文檔示例含
orangeheart）與代碼高亮方案。 - 素材處理：解析 Markdown 中的本地或網絡圖片，並同步上傳至微信素材庫。
- 元數據驅動：通過 YAML Frontmatter 配置標題、封面、作者、原文鏈接等。
- 樣式定製：支持自定義 CSS 主題注入。
發佈相關 CLI 參數（節選）：
-f, --file：Markdown 文件路徑（必填）。-t, --theme：排版主題，默認default。-h, --highlight：代碼高亮主題，默認solarized-light。--no-mac-style：禁用代碼塊 Mac 風格。
安裝與啓用¶
安裝 SkillHub CLI¶
若本機尚未安裝 skillhub，可先按 SkillHub 安裝文檔 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時可執行（完整安裝，含默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill¶
SkillHub 頁面給出的安裝提示爲：根據 https://skillhub.cn/install/skillhub.md，安裝 @user_d8946e26/wenyan-publish。
命令行安裝時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。搜索索引中的安裝命令爲：
skillhub install wenyan-publish --namespace user_d8946e26 --dir <你的 skills 目錄>
常見客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後需按各客戶端要求重啓或刷新，使新 Skill 生效。
前置環境與密鑰¶
Skill 文檔要求：
- 設置環境變量
WECHAT_APP_ID、WECHAT_APP_SECRET（微信公衆號開發憑據）。 - 全局安裝 Wenyan CLI：
pnpm add -g @wenyan-md/cli
典型用法¶
文章 Frontmatter（必填）¶
發佈前，Markdown 文首須包含 YAML 塊；缺省會導致發佈接口報錯。Skill 規定的模板如下：
---
title: 文章標題
cover: ./cover.jpg
author: 作者名稱
source_url: https://example.com/original-article
---
說明：cover 可省略時由正文第一張圖充當封面；author、source_url 爲可選。
Wenyan CLI 發佈示例¶
標準發佈（默認主題與高亮）：
wenyan publish -f my-article.md
指定主題與高亮：
wenyan publish -f article.md -t orangeheart -h solarized-light
查看可用主題列表：
wenyan theme -l
在 Agent 側，安裝本 Skill 後，可將上述約束與命令作爲對話上下文，由 Agent 檢查 Frontmatter、環境變量與文件路徑後再執行發佈。
適用場景與注意¶
適合誰：已在本地用 Markdown 維護公衆號稿件、希望把「排版 + 傳圖 + 調微信接口」交給 Agent 按文檔執行的開發者或內容團隊。
限制與常見問題（來自 Skill 故障排除說明）：
- invalid ip：需將當前環境出口 IP 加入微信公衆平臺 IP 白名單。
- AppID/Secret 錯誤：檢查
WECHAT_APP_ID、WECHAT_APP_SECRET是否已正確注入運行環境。 - 圖片上傳失敗：確認 Markdown 引用的本地圖片路徑在運行目錄下真實存在。
- 排版異常：優先覈對 YAML Frontmatter 是否完整、字段是否符合規範。
SkillHub 側該 Skill 爲 community 來源；頁面可見版本 v1.0.0。商店統計（以抓取資料爲準）：評分 100000，下載 1487，安裝 117。
結尾¶
「微信公衆號文章發佈工具」把 Wenyan CLI 的公衆號發佈流程固化成 Agent Skill：密鑰、Frontmatter、主題參數和排錯要點都寫在 SKILL.md 裏，減少每次手寫提示詞。需要安裝或查看詳情時，可訪問 SkillHub 頁面：https://www.skillhub.cn/skills/user_d8946e26/wenyan-publish ，API 條目：https://api.skillhub.cn/user_d8946e26/wenyan-publish 。
