md2wechat 是一个面向微信公众号内容生产的命令行工具，核心用途是把 Markdown 转换为微信公众号可用的 HTML，并围绕文章草稿与图片消息提供一整套处理流程。
【主要能力】
- 转换与检查：convert 将 Markdown 转为公众号 HTML，支持 --preview、-o 输出文件、--draft 上传草稿、--mode ai 配合主题转换；inspect 用于查看解析后的文章元数据、就绪状态与发布风险；preview 生成独立的本地 HTML 预览文件。
- 元数据规则：标题解析顺序为 --title → frontmatter.title → 第一个 Markdown 标题 → 未命名文章；作者来自 --author → frontmatter.author；摘要来自 --digest → frontmatter.digest → frontmatter.summary → frontmatter.description。CLI 限制标题最多 32 字、作者最多 16 字、摘要最多 128 字。创建草稿需要 --cover 或 --cover-media-id。
- 图片处理：upload_image 上传本地图片，download_and_upload 下载并上传网络图片，generate_image 生成图片，generate_cover 生成封面，generate_infographic 生成信息图，可配合 preset、article、size、aspect 等参数。
- 草稿与图片消息：create_draft 创建草稿，test-draft 测试草稿，create_image_post 创建图片消息（小绿书/图文笔记/newspic），支持 --images、-m、--dry-run 等。
- 写作与人性化：write 支持按风格写作（如 --style dan-koe）、--list 列出风格、--cover-only、--cover、--humanize 与 --humanize-intensity；humanize 可对文章做去 AI 痕迹处理，支持 --intensity、--show-changes、-o。
【使用方式】 使用前需确保 md2wechat 已在 PATH 中。配置检查顺序为 ~/.config/md2wechat/config.yaml、环境变量（如 MD2WECHAT_BASE_URL）、项目本地 md2wechat.yaml/yml/json。草稿上传与发布相关操作需要 WECHAT_APPID 和 WECHAT_SECRET；图片生成可能需要在配置文件中补充图像服务配置。convert 默认使用 api 模式，除非用户明确要求 --mode ai。选择 provider、theme、prompt 前应先运行发现命令，如 version --json、capabilities --json、providers list --json、themes list --json、prompts list --json 等，并以实时 CLI 输出为准，不要仅凭仓库文件猜测名称。
【发布门禁】 在任何 --draft、create_draft 或 test-draft 推送到微信之前，必须先向用户展示标题（含字数）、作者、封面图、摘要（含折叠线）、排版风格，并等待用户明确回复“发/推/OK”等肯定词后才能继续；沉默不等于同意。
【适用场景】 适合需要把 Markdown 文章发布到微信公众号的个人与团队，尤其是希望统一排版风格、批量生成封面与信息图、创建多图图片消息，或对文稿做风格化写作与去 AI 痕迹处理的场景。
【限制】 草稿上传与发布依赖微信凭据；图片生成可能依赖额外图像服务配置；--title/--author/--digest 影响草稿元数据，不一定影响正文 HTML；Markdown 图片仅在 --upload 或 --draft 时上传替换，普通 convert --preview 不会上传；preview --mode ai 仅为降级确认，不应视为最终 AI 排版；若草稿创建返回 45004，应先检查 digest/summary/description。