前言¶
在公众号后台直接写长文,或从 Markdown 粘贴进编辑器,常见问题是样式丢失、标题层级错乱、代码块与引用在手机上显示不一致。手工把每段改成内联样式,再对照预览改一遍,耗时长且难复用。若团队习惯用 Markdown 写稿、又需要固定版式,更需要一条从文稿到可发布 HTML 的流水线。
下面介绍 SkillHub 社区技能「微信公众号发布器」(@user_c442d9a2/wechat-publisher-plus):在 Agent 对话里把 Markdown 转成微信公众号兼容的内联样式 HTML,可选模板、可预览,并支持通过 API 写入草稿箱。
这是什么¶
「微信公众号发布器」是面向内容创作的 Agent Skill,坐标为 @user_c442d9a2/wechat-publisher-plus,当前版本 1.0.0,来源为 community,发布者为 user_c442d9a2,在 SkillHub 上归类为 content-creation。Skill 页标注 requires_api_key=true,使用与微信开放平台相关的发布能力时,需要自行准备并配置 API 凭证。
它解决的核心问题是:用 Markdown 写正文,由 Skill 按选定模板生成内联样式 HTML,减少在公众号编辑器里手工排版;需要上线流程时,可将结果发布到草稿箱,再在后台核对后群发。
核心功能¶
以下能力均来自 SkillHub 官方简介与技能页说明,未在资料中出现的细节不展开。
- 六种排版模板:科技极客、优雅文艺、商务简约、时尚活力、经典阅读、温暖治愈。写稿时选定风格,由 Skill 套用对应样式。
- Markdown 一键转换:将 Markdown 转为微信公众号兼容的内联样式 HTML(公众号编辑器对复杂 CSS 支持有限,内联样式是常见做法)。
- 预览:转换后可预览效果,便于在发布前调整正文或模板。
- API 发布到草稿箱:在配置好 API 的前提下,可将图文送入公众号草稿箱,而非直接在 Skill 内完成群发(具体接口与字段以 Skill 内说明为准)。
- 自然语言触发:对话中可使用与公众号相关的表述唤起 Skill,官方列出的触发词包括:微信公众号、公众号排版、公众号发布、微信图文、模板排版。
安装与启用¶
方式一:通过 SkillHub CLI 安装¶
若尚未安装 SkillHub CLI,可先检查版本:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档执行完整安装(含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认会装到 ./skills/,Agent 可能无法识别。常用路径示例(以你实际使用的客户端为准):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装命令形式如下(将 <skills 目录> 替换为上述路径之一):
skillhub install user_c442d9a2/wechat-publisher-plus --dir <skills 目录>
也可先搜索再安装:
skillhub search wechat-publisher
skillhub install user_c442d9a2/wechat-publisher-plus --dir <skills 目录>
安装后按你所用 Agent 的要求重启或重新加载 skills(SkillHub 文档提示:装错目录时即使重启也不会被识别)。
方式二:让 Agent 按官方提示安装¶
SkillHub 技能页提供的安装提示为:请 Agent 根据 SkillHub 安装说明 安装 @user_c442d9a2/wechat-publisher-plus。适合已习惯用对话管理技能、不想手写 CLI 的场景。
API Key¶
技能标签 requires_api_key=true 表示发布等与微信 API 相关的步骤需要密钥。具体环境变量名、配置文件路径以 Skill 包内 SKILL.md 或对话中 Skill 的说明为准;资料中未列出字段名时,应在安装后向 Agent 询问本 Skill 的凭证配置方式,勿猜测未公开的配置项。
典型用法¶
官方资料未提供逐步复制的命令示例,可复现的工作流可按下面顺序在 Agent 中完成(具体措辞因客户端而异,核心是触发词与 Skill 坐标)。
- 确认 Skill 已安装到正确的 skills 目录,且 API 凭证(若要走发布)已按 Skill 要求配置。
- 在对话中用触发词说明意图,例如:「用公众号排版,把下面 Markdown 转成微信图文 HTML,模板选商务简约。」
- 粘贴或附上 Markdown 正文,让 Skill 完成转换;需要时要求生成预览说明或预览 HTML。
- 若只需本地 HTML 用于后台粘贴,取生成的内联 HTML 即可。
- 若需进草稿箱,在凭证齐全的前提下明确要求「通过 API 发布到草稿箱」,并补充标题、封面等 Skill 所要求的元信息(以 Skill 运行时提示为准)。
六种模板名称在选型时可原样使用:科技极客、优雅文艺、商务简约、时尚活力、经典阅读、温暖治愈。
适用场景与注意¶
适合谁
- 用 Markdown 写公众号长文、希望版式统一的内容作者或运营。
- 需要在 Agent 工作流里完成「写稿 → 排版 → 草稿」、减少重复手工样式的团队。
- 已具备或可申请微信公众号开放平台 API 权限、愿意在本地安全保存 API Key 的维护者。
限制与注意
- 生成的是公众号场景下的内联 HTML,复杂交互、外链策略、原创声明等仍须在公众号后台按平台规则处理。
- 发布能力依赖微信 API 与有效凭证;标签要求 API Key,未配置时排版与预览类能力可能与发布能力可用性不同,以 Skill 实际行为为准。
- SkillHub 页显示:评分 100000,下载 1694 次,安装计数 0(页面统计,随时间变化)。选型时建议结合自己的 Agent 环境与 Skill 版本 1.0.0 自行验证。
- 官方 API 地址
https://api.skillhub.cn/user_c442d9a2/wechat-publisher-plus在抓取时返回 HTTP 405,日常安装与说明以 SkillHub 技能页与skillhub install为准。
结尾¶
「微信公众号发布器」把 Markdown、六种固定模板、内联 HTML 与草稿箱 API 串成一条可对话驱动的排版发布链路,适合已经把公众号当作常规渠道的写作者。安装与优先源策略见 SkillHub 安装文档;技能详情与安装提示见 SkillHub 页面:
https://www.skillhub.cn/skills/user_c442d9a2/wechat-publisher-plus