md2wechat：AI Agent 公众号创作与发布 CLI
面向 AI Agent 的微信公众号排版与发布命令行工具，支持 Markdown 转换、40+ 排版样式、AI 配图与批量发布。
- Star 数
- ★ 3.7k
- 最近更新
- 4 天前
- License
- NOASSERTION
- 主语言
- Go
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 内容创作者用 Markdown 写文章，通过 md2wechat 一键转换并发布到微信公众号，节省排版时间。
- 不适合
- 需要完全离线、数据不出本地的团队：发布依赖微信接口与外部图片服务
- 不愿申请 API Key 或购买商业授权的商业团队：高级排版与批量发布需专业 API
- 只想用免费 AI 模式做复杂排版的用户：:::module 模块不会被解析
- 源码审查
- 47/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
md2wechat 是一款面向 AI Agent 的微信公众号创作与发布 CLI，将公众号发布流程拆解为一组可验证的命令。它支持 Markdown 转微信 HTML、发布前检查（inspect）、专业 API 模式（48 个主题、53 个高级排版语法）、AI 配图（封面、信息图）、多账号管理等能力。通过 JSON discovery 命令（capabilities、doctor、themes、layout 等），Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent、OpenClaw 等 Agent 可稳定调用。项目采用 Source Available 许可，个人免费，商业使用需授权，并提供 API 服务与微信接口固定出口。
md2wechat 读取 Markdown 文件，通过 convert 命令生成微信 HTML，支持预览与创建草稿。inspect 命令输出结构化元数据、检查和 readiness 信息。专业 API 模式返回最终 HTML，支持 48 个专业主题和 :::module 高级排版。generate_cover 与 generate_infographic 调用图片 provider 生成封面和信息图，或输出图片计划。它还提供 title suggest、humanize、write 等 AI 内容增强命令。发布流程中，inspect 和 convert 可附带 --draft 与 --cover 参数，显式创建微信草稿。多账号通过 config wechat-accounts 管理，避免输出 Secret。
- 内容创作者用 Markdown 写文章，通过 md2wechat 一键转换并发布到微信公众号，节省排版时间。
- 运营团队批量处理多篇文章，使用多账号管理功能，支持矩阵号发布。
- AI Agent（如 Claude Code）在自动化工作流中调用 CLI，完成文章检查、转换与草稿创建。
- 设计人员利用 generate_cover 和 generate_infographic 生成封面和信息图，无需设计师介入。
- 需要稳定排版的用户使用专业 API 模式，获得 48 个主题和 53 个高级排版模块支持。
- 有微信 IP 白名单需求的用户，通过高级 API 服务获得固定出口能力。
如何安装或部署这个 Agent？
通过 npm 全局安装：npm install -g @geekjourneyx/md2wechat。安装后运行 md2wechat version --json 验证。需要 Node.js 环境。
如何使用这个 Agent？
初始化配置：md2wechat config init --json，然后 md2wechat config validate --json。转换文章：md2wechat convert article.md --output article.html（需 API Key）。检查文章：md2wechat inspect article.md --json。创建草稿：md2wechat convert article.md --draft --cover cover.jpg。Agent 使用 discovery 命令：md2wechat capabilities --json、themes list、layout list 等。
这个 Agent 有哪些优点和局限？
- 原生支持 AI Agent 调用，提供丰富的 JSON discovery 命令，降低集成成本。
- 专业 API 模式提供 48 个主题和 53 个高级排版模块，排版能力强。
- 内置图片生成能力，支持封面和信息图，并可无缝衔接宿主 Agent 的 Image Gen。
- 多账号管理和微信白名单支持，适合团队和矩阵运营。
- 专业 API 模式需要申请 API Key，并依赖外部服务，增加使用成本。
- 高级排版模块仅在 API 模式下解析，免费 AI 模式不解析 :::module。
- 商业使用需授权，采用 Source Available 许可，限制再分发。
- 微信凭证配置复杂，涉及 IP 白名单，需要阅读相关文档。
这个 Agent 与同类方案有什么区别？
未在源材料中提及具体替代品，但可类比其他 Markdown 转微信工具，如 markdown-nice 等，但 md2wechat 强调 Agent 集成与 API 服务。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| md2wechat：AI Agent 公众号创作与发布 CLI 当前 | 47 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 3.7k | 4 天前 | Go | Codex · Claude Code |
| Wonda CLI | 56 · 缺口较多 | 命令行工具付费 | ★ 158 | 6 天前 | TypeScript | Codex · Claude Code |
| AIWriteX 智能内容创作平台 | 43 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.1k | 1 个月前 | Python | — |
| gzh-design-skill · 公众号排版技能 | 68 · 存在缺口 | Agent 插件 / 技能免费 | ★ 4k | 10 天前 | HTML | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 明确区分了无副作用的 inspect/preview 与显式副作用的 convert（--draft/--upload），并要求用户明确请求才执行上传/草稿副作用，这体现了用户确认原则。但缺少对权限最小化的系统说明，例如未说明 CLI 是否请求超出所需的最小权限。数据流透明度不足：未详细说明哪些数据被发送到哪些外部服务（如 API 服务、图片 provider）。敏感数据处理：提到不输出 Secret，但未说明如何存储和保护凭证。依赖安全：go.mod 列出依赖，但未提供漏洞扫描或版本更新策略。外部影响：明确说明 convert 的副作用需显式请求，但未说明对微信账号的潜在影响。回滚：未提供回滚机制或撤销操作。来源归属：README 和 LICENSE 提供了作者信息，但发布者未经验证。
证据显示：README 和文档对命令行为描述一致，例如 inspect 返回结构化 metadata，preview 只写入成功转换的 HTML，convert 仅在显式请求时执行副作用，这体现了自洽性。但依赖可用性：依赖外部 API 服务（专业 API 模式）和图片 provider，未说明这些服务的可用性保障。失败消息：文档提到失败时 preview 不创建文件，但未提供详细的错误消息示例或故障排查指南。
证据显示：README 明确了目标受众（AI Agent、个人创作者）和场景（Markdown 转微信 HTML、发布前检查、多账号发布），并提供了多种 Agent 的适配说明。能力边界：通过 capabilities、doctor、themes、layout 等 discovery 命令明确能力范围。触发精度：命令边界固定，如 inspect 不执行副作用，convert 需显式请求。环境适配：提供了安装指南和配置文档，但未说明对非 Linux 环境的支持情况。
证据显示：README 提供了清晰的信息架构，包括快速开始、专业 API、Agent 工作流、高级排版、常用命令和文档链接。安装说明：提供了 npm 安装和配置指南。命名稳定性：命令名称稳定，但未说明版本命名策略。示例和 FAQ：提供了示例命令和 FAQ 文档。已知限制：提到本地 layout validate 不能证明远端 renderer 已部署，但未全面列出其他限制。许可证：提供了 Source Available License 的详细条款。版本变更日志：package.json 有版本号，但未提供 CHANGELOG 内容。维护责任：提供了联系方式和商业授权信息，但未明确维护承诺。
证据显示：输出可用性：convert 返回最终 HTML，inspect 返回结构化 metadata，适合 Agent 使用。边际价值：提供了 AI 配图、多账号管理、高级排版等独特功能。成本效益：免费 AI 模式适合实验，专业 API 模式需付费，但未提供定价信息，难以评估成本效益。
证据显示：声明可追溯性：README 中的功能声明（如 68 个排版场景、53 个语法名）有文档支持，但未提供测试证据。跨来源佐证：未提供第三方验证或用户反馈。事实与推断分离：文档区分了本地验证和远端渲染验证，但未明确区分事实和推断。
- 发布者身份未经验证，使用前请自行评估风险。
- 专业 API 模式依赖外部服务，需注意数据隐私和可用性。
- 许可证为 Source Available，商业使用需授权，请仔细阅读条款。
- 未提供回滚机制，发布操作需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Full Changelog: https://github.com/geekjourneyx/md2wechat-skill/compare/v3.7.0...v3.8.0在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/geekjourneyx/md2wechat-skill/compare/v3.6.0...v3.7.0在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/geekjourneyx/md2wechat-skill/compare/v3.5.0...v3.6.0在 GitHub 查看 ↗