前言¶
在公衆號裏發技術文，常見路徑是：本地用 Markdown 寫完，再複製到編輯器裏調格式、一張張傳圖、單獨處理封面。微信後臺對 HTML 和圖片域名也有要求，手工對齊容易漏步驟。若你已經在 Cursor、Claude Code 等環境裏用 Agent 寫稿，更希望一句話把成稿送進草稿箱，而不是再開一套發佈腳本。
下面介紹 SkillHub 上的社區 Skill「微信公衆號推送 Skill」（座標 @user_cc41bf5e/wechat-mp-publish，版本 v1.0.0），它把 Markdown 渲染、圖片上傳、封面永久素材和草稿創建串成一條流水線。
這是什麼¶
微信公衆號推送 Skill 是面向內容創作的 Agent Skill，由社區發佈者 user_cc41bf5e 維護，在 SkillHub 分類爲 content-creation，來源標註爲 community。
一句話定位：把 Markdown 文章推送到微信公衆號草稿箱，支持文中圖片自動上傳、封面圖走永久素材接口，以及將 Markdown 渲染爲微信可用的 HTML。在對話裏可用觸發詞「推送公衆號」「發佈公衆號」「發到微信」喚起相關流程。SkillHub 頁面標註 requires_api_key=true，實際憑證對應微信公衆平臺的 AppID 與 AppSecret（見下文配置）。
Skill 詳情與安裝入口：
- API 地址：https://api.skillhub.cn/user_cc41bf5e/wechat-mp-publish
- SkillHub 頁面：https://www.skillhub.cn/skills/user_cc41bf5e/wechat-mp-publish
（SkillHub 抓取數據：評分 100000，下載 1791，安裝 26。）
核心功能¶
以下能力均來自 Skill 包內 SKILL.md 與說明文檔的表述，可按需裁剪使用。
- access_token：自動獲取與刷新，支持通過環境變量配置憑證。
- 正文圖片：掃描文章中的圖片並上傳到微信 CDN，替換爲可用地址。
- 封面：通過永久素材接口上傳封面（文檔強調封面必須用永久素材，否則創建草稿可能失敗）。
- Markdown → HTML：渲染爲微信公衆號可用的 HTML，並配合 HTML 清理相關腳本。
- 草稿：調用接口在公衆號草稿箱創建草稿，而非直接羣發。
處理順序在 Skill 文檔中概括爲：access_token → 上傳圖片 → 上傳封面 → 創建草稿。
Skill 包內主要腳本包括 publish.py、token_manager.py、image_uploader.py、cover_uploader.py、html_renderer.py、html_sanitizer.py、config.py 等，Agent 或本地命令行會圍繞這些腳本執行。
安裝與啓用¶
通過 SkillHub CLI 安裝到 Agent¶
SkillHub 官方安裝說明見：https://skillhub.cn/install/skillhub.md
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。SkillHub 文檔給出的常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
以 Cursor 爲例，安裝命令爲：
skillhub install @user_cc41bf5e/wechat-mp-publish --dir ~/.cursor/skills/
也可在對話中讓 Agent 按 https://skillhub.cn/install/skillhub.md 安裝 @user_cc41bf5e/wechat-mp-publish。
運行依賴與憑證¶
Skill 的 README 說明本地執行腳本需要 Python 環境，並安裝 requests：
pip install requests
微信公衆平臺側配置（SKILL.md 中的三步）：
- 在 微信公衆平臺 設置與開發 → 基本配置 獲取 AppID、AppSecret（AppSecret 通常只完整展示一次，需自行妥善保存）。
- 在同一開發者配置區域，將調用接口機器的公網 IP 加入 IP 白名單；Skill 文檔建議通過 https://ip.sb 或 https://ifconfig.me 查詢公網 IP。
- 注入環境變量：
export WECHAT_APPID="your_appid"
export WECHAT_APPSECRET="your_appsecret"
或使用 Skill 目錄下的配置腳本（會在 scripts/ 下生成 config.json，文檔要求勿提交版本庫）：
python scripts/config.py <AppID> <AppSecret>
典型用法¶
在 Agent 對話中¶
安裝並配置憑證後，對 Agent 說明要推送的文章路徑、標題、作者、摘要與封面圖等，並使用觸發詞「推送公衆號」「發佈公衆號」或「發到微信」。Agent 會按 SKILL.md 中的流程調用 scripts/publish.py 等腳本完成上傳與建草稿。
命令行直接發佈¶
在 Skill 安裝目錄下（例如 ~/.cursor/skills/@user_cc41bf5e/wechat-mp-publish/），可顯式調用發佈腳本。content 推薦傳 Markdown 文件路徑，腳本會讀取文件內容：
python scripts/publish.py \
--title "文章標題" \
--content "/path/to/article.md" \
--author "作者名" \
--digest "摘要（不填則自動截取）" \
--cover "/path/to/cover.jpg"
經過上面的步驟，成稿應出現在公衆號後臺的草稿箱中，可在微信側再做預覽與羣發（是否允許羣發取決於賬號類型與平臺權限）。
適用場景與注意¶
適合誰
- 習慣 Markdown 寫作、希望減少向公衆號編輯器手工排版的人。
- 已在 Cursor / Claude Code 等環境使用 Skill，希望發佈動作與寫稿在同一對話裏完成的人。
- 接受「先進草稿箱、再在後臺確認」工作流的人（Skill 明確以草稿箱爲目標）。
限制與注意
- 個人訂閱號：Skill 文檔寫明支持推送到草稿箱；不支持直接羣發、讀取閱讀量/用戶分析等數據接口，以及部分「已發佈」相關 API；完整能力通常需要認證服務號等平臺權限。
- 封面與圖片：封面必須走永久素材；正文圖片由工具上傳 CDN，無需手改 URL，但仍需保證圖片文件可讀、路徑正確。
- 敏感文件：勿將
scripts/config.json、token_store.json等提交到 Git；Skill 包內.gitignore已做相關提示。 - 網絡與 IP：access_token 與上傳接口受微信 IP 白名單約束，換機器或換出口 IP 需同步更新白名單。
結尾¶
微信公衆號推送 Skill 把 Markdown 成稿、HTML 渲染、圖片與封面處理、草稿創建收成一條可復現鏈路，適合作爲 SkillHub 上 content-creation 類工具接入寫作 Agent。安裝與座標以 SkillHub 爲準：https://www.skillhub.cn/skills/user_cc41bf5e/wechat-mp-publish，API 入口：https://api.skillhub.cn/user_cc41bf5e/wechat-mp-publish。
