Agent Skill

公众号排版skill

>一键将markdown内容,按照自定义的主题样式进行渲染,并推送到公众号草稿箱。 主题样式支持高度自定义,包括:背景色颜色、背景圆角、标题、代码块、图片边框和阴影、无序列表、有序列表等。 具体请看这篇文章:https://mp.weixin.qq.com/s/CuCqqNgGw0Y1D97Of-rJtw

内容创作·猫来gogogo·来自 skill_hub·skillhub.cn ↗
skillhub install @user_5223609c/md-to-wechat
34 Stars·6.1万 综合热度·2,175 字文档·源站更新 2026-11-22

README 文档

2,175 字

md-to-wechat Skill

将本地 Markdown 文章渲染为微信公众号样式 HTML,并自动推送到公众号草稿箱。

首次使用:编辑 Skill 目录下的 .env 文件填入配置,详见 references/setup.md


Skill 目录结构

本 Skill 安装后的完整目录如下(<SKILL_DIR> 为 SKILL.md 所在目录的绝对路径):

<SKILL_DIR>/
├── SKILL.md                  ← 本文件
├── .env                      ← 填写你的配置(必须)
├── .cache.json               ← 运行时自动生成,缓存已上传图片
├── references/
│   └── setup.md              ← 首次配置详细说明
└── scripts/
    ├── publish.cjs           ← 主脚本:渲染 + 推送一步完成
    └── list_themes.cjs       ← 辅助:查询可用主题 ID

AI 如何确定 <SKILLDIR>:本文件(SKILL.md)所在的目录即为 <SKILLDIR>。AI 工具读取本文件时,可从文件路径中直接获取目录部分。例如,若本文件路径为 C:\Users\alice\.cursor\skills\md-to-wechat\SKILL.md,则 <SKILL_DIR> = C:\Users\alice\.cursor\skills\md-to-wechat。


AI 执行指南

按以下流程执行,每步均为必要步骤,不得跳过:

  1. 确认前置配置:读取 <SKILLDIR>/.env,检查 ACCOUNT、THEMEID、WECHATAPPID、WECHATAPPSECRET 是否已填写(非占位符)。如有未填项,告知用户参考 references/setup.md 完成配置后再继续。
  2. 确认 MD 文件路径:从对话上下文或 @引用 获取 MD 文件的绝对路径。
  3. 一次性确认 IP + 文章信息:
  • 如果用户明确表示"IP 已加好",跳到步骤 4。
  • 否则运行一次(无 --confirmed)获取本机 IP:
     node "<SKILL_DIR>/scripts/publish.cjs" --file "<md文件绝对路径>"
  • 同时读取 MD 文件和 .env,提取以下信息,一次性呈现给用户确认:
     📌 请确认以下信息,全部 OK 后统一告诉我:

     1. IP 白名单:请将 <上方打印的 IPv4> 加入公众号后台 → 基础信息 → API IP 白名单
     2. 文章标题:《XXX》(如需修改请告知)
     3. 作者名称:YYY(如需修改请告知;为空则草稿中作者栏留空)
     4. 封面图:<来源>(如需修改请提供 URL 或本地路径)
  • 封面图来源按以下优先级确定并告知用户:
  • MD 文件中有图片 → 显示「使用 MD 中第一张图片:<URL>」
  • MD 无图片但 .env 的 WECHATDEFAULTCOVER 已填写 → 显示「使用兜底封面:<URL>」
  • 两者均为空 → 显示「⚠️ 未找到封面图,请提供图片 URL 或本地路径,否则推送会失败」并强制等待用户提供
  • 等待用户一次回复,收集所有修改意见后再继续。
  1. 正式推送:加 --confirmed 运行,根据用户反馈传入对应参数:
   node "<SKILL_DIR>/scripts/publish.cjs" \
     --file "<md文件绝对路径>" \
     --confirmed \
     [--title "标题"] [--author "作者"] [--cover "封面图URL或路径"]

成功输出:

   { "success": true, "media_id": "XXXX", "title": "文章标题", "message": "草稿已推送成功..." }
  1. 推送成功:告知用户「✅ 草稿已推送,请前往公众号后台 → 草稿箱查看」

常见错误处理

错误码含义处理方式
40164IP 不在白名单重新运行 publish.cjs(无 --confirmed)查询当前 IP,更新公众号后台白名单
missing_env.env 未配置或缺字段检查 .env 文件,参考 references/setup.md
api_error账号/主题 ID 错误运行 listthemes.cjs 确认 THEMEID
filenotfound文件不存在确认 MD 文件路径正确
coverdownloadfailed封面图无法下载检查图片 URL 是否可访问,或用 --cover 指定本地图片

辅助工具

查询主题列表(首次配置时使用):

node "<SKILL_DIR>/scripts/list_themes.cjs"

输出所有主题名称和 ID,将目标 ID 填入 .env 的 THEME_ID。


参数速查

publish.cjs

参数必填说明
--file✅MD 文件路径
--confirmed否跳过 IP 检查,直接渲染并推送
--title否指定文章标题,覆盖 MD 中的一级标题
--author否指定作者名称,覆盖 .env 中的 AUTHOR_NAME
--cover否指定封面图(URL 或本地路径),覆盖自动检测

同分类其他技能

查看全部 ›