1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | md2wechat-skill |
| 项目自述名称 | md2wechat（README 标题即用此名，未使用意译名） |
| 作者/维护者 | geekjourneyx（个人开发者） |
| 来源链接 | https://github.com/geekjourneyx/md2wechat-skill |
| 许可证 | md2wechat Source Available License（基于 Business Source License 1.1；个人非商业用途免费，含个人创作、学习研究、评估、非营利用途；直接商业获利需另行授权，见仓库 LICENSE 全文） |
| GitHub Stars / Forks | 3,542 / 401（GitHub API 实测） |
| 最新版本 | v3.2.0（GitHub Release，发布于 2026-07-24） |
| 安装方式 | npm install -g @geekjourneyx/md2wechat；另提供 Claude Code 官方插件市场包与 OpenClaw 专属安装脚本 |
2. 功能介绍与亮点
一个把“写 Markdown”和“发布公众号文章”这两件事之间的手动排版、切图、上传草稿全部接管的 CLI 工具，设计目标是让 Agent 通过一组结构化 JSON 命令稳定驱动整条发布流程：
- 排版转换：
convert把 Markdown 转成微信公众号可直接使用的 HTML，覆盖 68 个高级排版场景与 53 个:::语法模块（引导语、要点卡、金句强调等），API 模式下所有样式内联，粘贴进公众号编辑器不掉格式 - 发布前把关：
inspect --json给出标题、摘要、配图、封面、草稿就绪状态的结构化检查结果，明确哪些环节还缺什么，而不是发布后才发现问题 - 配图与内容生产：
generate_cover、generate_infographic生成封面与信息图；title suggest给出标题候选；humanize用于弱化机器写作痕迹；write支持指定作者风格草拟正文 - 多账号管理：本地保存多个公众号账号配置，凭据只做本地只读发现、不在任何输出中打印明文
- 副作用显式确认：上传图片、创建草稿等有实际后果的操作必须用户显式要求才执行，纯排版预览不触碰任何账号
3. 适用场景
固定分类：集成与工作流自动化
适用于经常在微信公众号发布文章的个人内容创作者——写完 Markdown 后不想再手动调整字体、间距、代码块样式，也不想在多个公众号账号间来回切换登录状态。技能本身可在纯本地生成 HTML 供手动粘贴（免费、无需账号凭据），也可选择配置公众号凭据后由 Agent 直接创建并检查草稿。对偶尔发一两篇文章的用户，手动排版可能已经够用，本技能的价值随发布频率与账号数量增加而放大。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库内含 .claude-plugin/marketplace.json，可通过官方插件市场机制直接安装 |
| Codex | ✅ 官方声明支持 | README 明确列出 Codex，机制是标准 SKILL.md + 本地 CLI JSON discovery 调用；未见 Codex 专属适配文件，依赖 Codex 自身调用本地命令行的能力 |
| OpenClaw | ✅ 原生支持 | 仓库内有专属 platforms/openclaw/md2wechat/SKILL.md 变体、独立安装脚本与 docs/OPENCLAW.md 说明文档 |
| Hermes Agent | ✅ 官方声明支持 | README 明确列出 Hermes Agent，机制同 Codex（本地 CLI JSON discovery），未见专属适配文件 |
5. 推荐理由
多数“Markdown 转公众号”类技能只解决排版这一步，做完还要你手动登录公众号后台上传草稿；这个技能把排版检查、配图生成、草稿创建串成一条 Agent 可以直接驱动的流水线，并且是当前索引里少数明确同时声明支持 Claude Code、Codex、OpenClaw、Hermes Agent 四个目标生态的技能。3,542 星与横跨半年多个独立用户的 GitHub issue 反馈，加上第三方博主的实测记录，说明确有持续真实使用而非昙花一现的展示项目。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,542 stars，处于 1k–5k 独立开发者项目的较高区间；GitHub issue 区自 2026 年初至今有 12 条来自不同独立用户账号的具体功能反馈与缺陷报告，另有第三方技术博客的独立实测文章，形态健康、非集中刷量 |
| 可用性 | 8 | npm install -g 一条命令安装；只读排版预览无需任何凭据即可使用，进阶发布功能才需要配置 API Key 与公众号凭据；文档拆分为安装指南、凭据配置指南、配置走查指南三份，近一个月仍有版本发布，维护活跃 |
| 安全性 | 7 | 见下方检查清单 |
安全检查清单： ① Shell 命令：CLI 内部脚本会调用子进程完成格式转换（第三方安全扫描曾标记此处，作者确认为固定路径的受控调用，非任意命令执行） ② 联网外发：转换与发布功能会调用作者自建的 md2wechat API 与微信官方接口，均为完成“排版转换/发布文章”这一声明功能所必需，行为透明可预期 ③ 凭据处理：需要 API Key 与微信公众号凭据；文档明确说明账号发现命令“本地只读、不输出明文密钥” ④ 可疑指令：通读 SKILL.md 全文未发现夹带无关推广或隐蔽指令 ⑤ 作者信誉：个人开发者，对外部安全扫描发现的问题公开、及时回应，issue 区响应及时 ⑥ License：Source Available，条款明确（个人非商业免费，商业使用需授权） ⑦ 最近维护：近一个月内仍有正式版本发布，维护活跃
综合评分 = 三项均值 = 7.67
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| gzh-design-skill | 本地生成微信公众号 HTML 排版（6 套主题 + AI 主题生成器），手动粘贴进编辑器 | 止步于“生成好看的 HTML”，不连接公众号账号、不能直接创建草稿或管理多账号 |
| guizang-social-card-skill | 生成适合社交平台分享的图文卡片 | 产出物是单张图文卡片而非完整长文排版，不覆盖标题建议、草稿检查、多账号发布等完整流程 |
本技能的差异化在于把“排版”到“发布”整条链路做成 Agent 可驱动的结构化命令，而不是停在生成一份可复制粘贴的 HTML——这也是它被归入“集成与工作流自动化”而非纯内容/设计类的原因。
8. 用户评价
- 花萍雨（codefather.cn 技术博客作者）：在实测安装配置全流程后评价“对于多数用户来说，这个版本已经足够满足日常使用的需求了”，并提到自己用它完成了公众号文章发布，认为开源版本对个人日常使用已经够用，不必强求付费的进阶 API。
9. 其他补充
仓库同时提供 Claude Code 官方插件市场包（.claude-plugin/marketplace.json）与面向 OpenClaw 的独立安装脚本；README 与三份配置文档均为中文撰写，面向中文内容创作者的使用门槛较低。
10. 安装使用方式
- 通用安装：
npm install -g @geekjourneyx/md2wechat，随后md2wechat config init --json初始化配置 - Claude Code：通过官方插件市场安装
.claude-plugin/marketplace.json所声明的插件包 - OpenClaw：使用仓库内
platforms/openclaw/md2wechat/SKILL.md及配套安装脚本 - Codex / Hermes Agent / 其他支持本地 CLI 调用的 Agent：安装 CLI 后，Agent 通过
md2wechat capabilities --json等 discovery 命令自动发现可用能力 - 安装后注意事项：纯排版预览（
inspect、preview、convert不带--draft）无需任何凭据；需要上传图片或创建草稿箱时，才需按docs/WECHAT-CREDENTIALS.md配置微信公众号凭据与 API Key
11. 注意事项
- 直接商业获利场景（如为客户代运营收费）不在免费授权范围内，需查阅 LICENSE 全文确认是否需要另行授权
- 高级排版模块（68 个场景条目）仅在 API 模式下渲染，AI 模式（不配置 API Key 的轻量路径）不支持这部分语法
- Codex 与 Hermes Agent 的支持依赖这两个 Agent 自身调用本地 CLI 的能力，未见针对它们的专属适配文件，与 Claude Code、OpenClaw 的原生打包方式不同