md2wechat：AI Agent 公众号创作与发布 CLI
面向 AI Agent 的微信公众号排版与发布命令行工具，支持 Markdown 转换、40+ 排版样式、AI 配图与批量发布。
证据显示：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，商业使用需授权，请仔细阅读条款。
- 未提供回滚机制，发布操作需谨慎。
这个 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 有哪些优点和局限？
- 原生支持 AI Agent 调用，提供丰富的 JSON discovery 命令，降低集成成本。
- 专业 API 模式提供 48 个主题和 53 个高级排版模块，排版能力强。
- 内置图片生成能力，支持封面和信息图，并可无缝衔接宿主 Agent 的 Image Gen。
- 多账号管理和微信白名单支持，适合团队和矩阵运营。
- 专业 API 模式需要申请 API Key，并依赖外部服务，增加使用成本。
- 高级排版模块仅在 API 模式下解析，免费 AI 模式不解析 :::module。
- 商业使用需授权，采用 Source Available 许可，限制再分发。
- 微信凭证配置复杂，涉及 IP 白名单，需要阅读相关文档。
如何安装或部署这个 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 与同类方案有什么区别？
未在源材料中提及具体替代品，但可类比其他 Markdown 转微信工具，如 markdown-nice 等，但 md2wechat 强调 Agent 集成与 API 服务。