前言¶
在公众号里发技术文，常见路径是：本地用 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。
