前言¶
公众号后台对排版、封面和素材有固定要求，很多团队先在本地用 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 。
