前言¶
用 AI 寫公衆號時，後半段往往卡在排版和發佈：Markdown 在編輯器裏粘貼會丟樣式，第三方排版工具主題固定，手動複製 HTML 再進後臺又費時間。若希望「寫完 MD → 按自定義主題出稿 → 直接進草稿箱」，需要把渲染服務和微信公衆平臺 API 串成一條 Agent 可執行的流程。下面介紹 SkillHub 上的 公衆號排版 skill（座標 @user_5223609c/md-to-wechat）如何承擔這條鏈路。
這是什麼¶
公衆號排版 skill 是社區發佈的 Agent Skill（版本 1.0.0，分類 content-creation），將本地 Markdown 按你在排版服務裏配置的主題渲染成微信公衆號可用 HTML，並調用公衆號接口寫入草稿箱。渲染側依賴 feishu2weixin.maolai.cc 的賬號與主題 ID；推送側使用本機 .env 中的公衆號 AppID / AppSecret。SkillHub 頁面標註 requires_api_key=true，對應上述憑據與賬號配置，而非單一第三方大模型 Key。
核心功能¶
依據 SkillHub 簡介與倉庫內 SKILL.md，已覈實能力包括：
- 主題化渲染：背景色、圓角、標題、代碼塊、圖片邊框與陰影、有序/無序列表等可在網站側自定義，通過
THEME_ID綁定到推送結果。 - 一步發佈腳本：使用
scripts/publish.cjs完成渲染與推送，無需在本地落盤 HTML（需 Node.js 18+，腳本爲 CommonJS，零 npm 外部依賴）。 - Agent 觸發約定：當用戶表達「把這篇文章推到公衆號」「發佈到微信公衆號」「推送草稿」「同步到公衆號草稿箱」等意圖時，Skill 要求 Agent 主動走本流程，而不是隻生成排版說明。
- 輔助查詢：
scripts/list_themes.cjs可列出賬號下主題名稱與 ID，便於覈對.env。 - 運行緩存：目錄下會自動生成
.cache.json，用於緩存已上傳圖片，減少重複上傳。
安裝與啓用¶
通過 SkillHub 安裝¶
SkillHub 技能頁給出的安裝提示爲：按 SkillHub 安裝說明 安裝座標 @user_5223609c/md-to-wechat。
若本機已有 skillhub CLI，安裝時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。Cursor 常見路徑爲 ~/.cursor/skills/，也可使用項目內的 .cursor/skills/。示例：
command -v skillhub && skillhub --version
skillhub install user_5223609c/md-to-wechat --dir ~/.cursor/skills/
CLI 未安裝時，可按官方文檔執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
手動安裝¶
發佈者在介紹文中提供 GitHub 路徑：https://github.com/maolai7/agent-skills/tree/main/md-to-wechat。無法訪問 GitHub 時，需按發佈者 SkillHub / 公衆號說明獲取 skill 包，再將目錄放入 Agent 的 skills 文件夾。
首次配置¶
安裝後，在 SKILL.md 所在目錄（記爲 <SKILL_DIR>）編輯 .env。references/setup.md 要求至少填寫：
ACCOUNT=你的 feishu2weixin 登錄郵箱或手機號
THEME_ID=在 https://feishu2weixin.maolai.cc 創建或選擇的主題 ID
WECHAT_APP_ID=公衆號 AppID
WECHAT_APP_SECRET=公衆號 AppSecret
可選字段包括 AUTHOR_NAME（默認作者）、WECHAT_DEFAULT_COVER（無正文圖片時的封面 URL）。主題 ID 可在網站「我的主題」中複製，或執行：
node "<SKILL_DIR>/scripts/list_themes.cjs"
微信公衆平臺需在 設置與開發 → 基本配置 中將調用 API 的機器 IPv4 加入 API IP 白名單；換網絡後 IP 變化需重新添加，否則會返回 40164。
典型用法¶
人工確認後推送（推薦流程）¶
Skill 規定 Agent 先檢查 .env 是否已填實，再定位 Markdown 的絕對路徑。首次推送或未確認白名單時，先不帶 --confirmed 運行以打印本機公網 IP，並一次性讓用戶確認 IP、標題、作者、封面：
node "<SKILL_DIR>/scripts/publish.cjs" --file "/path/to/article.md"
用戶確認後正式推送：
node "<SKILL_DIR>/scripts/publish.cjs" \
--file "/path/to/article.md" \
--confirmed \
--title "文章標題" \
--author "作者名" \
--cover "https://example.com/cover.jpg"
成功時腳本輸出 JSON，包含 success、media_id、title 等字段；隨後到公衆號後臺 草稿箱 查看。
封面優先級（Skill 內說明）：正文 MD 中第一張圖 → .env 的 WECHAT_DEFAULT_COVER → 均無則需用戶通過 --cover 提供，否則推送失敗。
在對話裏觸發¶
配置完成後，對 Agent 說「把這篇文章推到公衆號」並附上或 @ 引用 MD 文件即可；Agent 應讀取本 Skill 的 SKILL.md 按步驟執行，而不是僅輸出 HTML 片段。
適用場景與注意¶
適合：已在本地或倉庫中用 Markdown 寫稿；需要在 feishu2weixin 調好主題並長期複用；希望由 Cursor 等 Agent 完成「渲染 + 草稿箱」而不是手工粘貼後臺。
限制與注意：
- 須有可調用接口的微信公衆號，並完成 AppID、AppSecret、IP 白名單配置。
- 渲染樣式取決於網站側主題，不是純本地 CSS；
ACCOUNT/THEME_ID錯誤會表現爲api_error，可用list_themes.cjs排查。 - 推送自本機或當前運行 Agent 的環境發起，公網 IP 須與白名單一致。
- SkillHub 統計（以技能頁抓取爲準）：評分 100000，下載約 27984 次，安裝約 179 次；標籤含
requires_api_key=true，部署前請妥善保管.env，勿提交到版本庫。
更完整的配圖步驟見發佈者公衆號文：《我決定 開源公衆號排版skill：打通AI寫公衆號的最後1公里》。
結尾¶
公衆號排版 skill 把「自定義主題渲染」和「微信草稿箱 API」封裝成 Agent 可執行的 publish.cjs 工作流，適合把 AI 寫作的後半程從複製粘貼改成一條命令。安裝與座標以 SkillHub 爲準：
- API / 安裝入口：https://api.skillhub.cn/user_5223609c/md-to-wechat
- SkillHub 技能頁：https://www.skillhub.cn/skills/user_5223609c/md-to-wechat
- 座標：
@user_5223609c/md-to-wechat
