$git clone https://github.com/geekjourneyx/md2wechat-skill面向 AI Agent 的微信公众号创作与发布 CLI
| 1 | <div align="center"> |
| 2 | |
| 3 | <h1> |
| 4 | <img src="assets/favicon.ico" alt="md2wechat logo" width="28" /> |
| 5 | md2wechat |
| 6 | </h1> |
| 7 | |
| 8 | <img src="assets/readme-header.gif" alt="md2wechat CLI demo" width="720" /> |
| 9 | |
| 10 | **面向 AI Agent 的微信公众号创作与发布 CLI** |
| 11 | |
| 12 | 写 Markdown,生成公众号排版,制作封面和文章配图,预览校验后推送草稿箱。 |
| 13 | |
| 14 | 支持 Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent、OpenClaw 等 Agent 通过 JSON discovery 稳定调用。 |
| 15 | |
| 16 | [](https://golang.org) |
| 17 | [](LICENSE) |
| 18 | [](https://github.com/geekjourneyx/md2wechat-skill/releases) |
| 19 | [](#agent-工作流) |
| 20 | [](#专业-api) |
| 21 | |
| 22 | <p> |
| 23 | <a href="https://trendshift.io/repositories/26638?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-26638" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26638/daily?language=Go" alt="geekjourneyx%2Fmd2wechat-skill | Trendshift" width="250" height="55"/></a> |
| 24 | <a href="https://trendshift.io/repositories/26638?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-26638" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26638/weekly?language=Go" alt="geekjourneyx%2Fmd2wechat-skill | Trendshift" width="250" height="55"/></a> |
| 25 | </p> |
| 26 | |
| 27 | [快速开始](#快速开始) · [专业 API](#专业-api) · [Agent 工作流](#agent-工作流) · [高级排版](#高级排版) · [文档](#文档) |
| 28 | |
| 29 | </div> |
| 30 | |
| 31 | --- |
| 32 | |
| 33 | ## 这个项目解决什么问题 |
| 34 | |
| 35 | md2wechat 把公众号发布流程拆成一组可验证的 CLI 命令: |
| 36 | |
| 37 | | 场景 | md2wechat 提供 | |
| 38 | |---|---| |
| 39 | | Markdown 转微信 HTML | `convert`,支持预览、上传图片、创建草稿 | |
| 40 | | 发布前检查 | `inspect --json` 输出标题、摘要、图片、cover、draft readiness | |
| 41 | | 稳定排版 | API 模式返回确定性 HTML,覆盖 68 个主推高级排版场景条目和 53 个主推 `:::` 语法名 | |
| 42 | | Agent 自动化 | `capabilities`、`doctor`、`themes`、`layout`、`providers` 等 discovery 命令 | |
| 43 | | 内容生产 | `write`、`humanize`、`title suggest`、`generate_cover`、`generate_infographic` | |
| 44 | | 多账号发布 | 命名公众号账号,本地只读发现,不输出 Secret | |
| 45 | | 微信白名单 | 高级 API 服务可提供微信接口固定出口能力 | |
| 46 | |
| 47 | --- |
| 48 | |
| 49 | ## 快速开始 |
| 50 | |
| 51 | ```bash |
| 52 | npm install -g @geekjourneyx/md2wechat |
| 53 | md2wechat config init |
| 54 | ``` |
| 55 | |
| 56 | 确认文章状态: |
| 57 | |
| 58 | ```bash |
| 59 | md2wechat inspect article.md --json |
| 60 | md2wechat preview article.md |
| 61 | ``` |
| 62 | |
| 63 | 转换并创建微信草稿: |
| 64 | |
| 65 | ```bash |
| 66 | md2wechat convert article.md --draft --cover cover.jpg |
| 67 | ``` |
| 68 | |
| 69 | 安装方式、微信凭证和 IP 白名单配置见: |
| 70 | |
| 71 | - [安装指南](docs/INSTALL.md) |
| 72 | - [微信凭证与 IP 白名单指南](docs/WECHAT-CREDENTIALS.md) |
| 73 | - [配置保姆级指南](docs/CONFIG-WALKTHROUGH.md) |
| 74 | |
| 75 | --- |
| 76 | |
| 77 | ## 专业 API |
| 78 | |
| 79 | API 模式适合需要稳定输出、多人协作、批量发布或 Agent 自动化的场景。 |
| 80 | |
| 81 | | 能力 | 免费 AI 模式 | 专业 API 模式 | |
| 82 | |---|---|---| |
| 83 | | 输出方式 | 生成 prompt,由外部 LLM 继续处理 | 直接返回微信 HTML | |
| 84 | | 主题 | 3 个基础主题 | 48 个专业主题 | |
| 85 | | 高级排版模块 | 不支持 | 53 个推荐 `:::module` 语法 | |
| 86 | | 输出一致性 | 取决于外部 LLM | 同样输入得到同样输出 | |
| 87 | | 响应速度 | 取决于外部 LLM | 秒级 | |
| 88 | | 发布自动化 | 适合实验 | 适合团队、客户号、矩阵号 | |
| 89 | |
| 90 | 专业能力包括: |
| 91 | |
| 92 | - 48 个微信渲染精调主题:[theme-gallery](https://md2wechat.app/theme-gallery) |
| 93 | - 68 个主推高级排版场景条目,对应 53 个主推 `:::` 语法名:[docs/LAYOUT.md](docs/LAYOUT.md) |
| 94 | - 3 个兼容模块只用于旧稿迁移;加上 4 个基础增强能力,共计 60 项渲染层语法能力 |
| 95 | - 多公众号账号:[docs/CONFIG.md](docs/CONFIG.md) |
| 96 | - 微信接口固定出口:[docs/WECHAT-CREDENTIALS.md](docs/WECHAT-CREDENTIALS.md) |
| 97 | - 发布前 readiness 检查:[docs/DISCOVERY.md](docs/DISCOVERY.md) |
| 98 | |
| 99 | 申请 API 服务:关注公众号「极客杰尼」,备注「API咨询」。 |
| 100 | |
| 101 | <p align="center"> |
| 102 | <img src="assets/wechat.png" alt="公众号:极客杰尼" width="160" /> |
| 103 | </p> |
| 104 | |
| 105 | --- |
| 106 | |
| 107 | ## Agent 工作流 |
| 108 | |
| 109 | md2wechat 给 Agent 提供可机读接口,减少猜测和误操作。 |
| 110 | |
| 111 | ```bash |
| 112 | md2wechat capabilities --json |
| 113 | md2wechat doctor --json |
| 114 | md2wechat inspect article.md --json |
| 115 | md2wechat themes list --json |
| 116 | md2wechat layout list --json |
| 117 | md2wechat title suggest article.md --json |
| 118 | md2wechat title suggest article.md --json --hook-level 2 |
| 119 | md2wechat skills list --json |
| 120 | md2wechat skills read md2wechat --json |
| 121 | ``` |
| 122 | |
| 123 | 这些命令适合 Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent、OpenClaw 以及其他能调用本地 CLI 的 Agent 使用。 |
| 124 | |
| 125 | Agent 可以据此判断: |
| 126 | |
| 127 | - 当前 CLI 支持哪些命令 |
| 128 | - API、草稿、上传是否具备执行条件 |
| 129 | - 某篇文章能不能发草稿 |
| 130 | - 当前主题和排版模块是否可用 |
| 131 | - 标题建议是否应交给宿主 Agent / 外部模型完成 |
| 132 | - 当前二进制内置的 Agent SOP 是什么 |
| 133 | |
| 134 | Brand Profile 支持把长期风格偏好写入 `~/.config/md2wechat/brand.md`,由 A |