md2wechat 2.4.0 发布：让 Agent 先判断准备状态，再执行发布流程

md2wechat-skill 已经超过 2.7k GitHub star，官方内容也需要跟上当前工具的真实能力。

md2wechat 2.4.0 最重要的变化不是多了一个新命令，而是给 Agent 一个更清楚的判断依据。

现在 Agent 可以先检查一篇文章，再判断 preview、convert、upload、draft 分别是 ready、blocked、degraded，还是 not requested。

2.4.0 改了什么

inspect --json 现在提供了更清楚的准备状态结构：

{
  "data": {
    "readiness": {
      "schema_version": "1",
      "targets": {
        "preview": "ready",
        "convert": "ready",
        "upload": "not_requested",
        "draft": "blocked"
      },
      "blockers": [
        {
          "code": "MISSING_COVER",
          "target": "draft"
        }
      ]
    }
  }
}

重点字段是：

• data.readiness.targets
• data.readiness.blockers
• data.readiness.schema_version

旧字段仍然保留，比如 convert_ready、upload_ready、draft_ready、preview_fidelity。但新的 Agent 工作流应该优先使用 targets 和 blockers。

为什么这对 Agent 重要

以前 Agent 经常需要猜：

• 能不能预览
• 能不能转换
• 是否请求了上传
• 创建草稿是不是缺封面
• 问题来自本机配置，还是来自这篇文章本身

猜出来的流程很容易不稳定。

有了 targets 和 blockers，Agent 可以给出更小、更准确的判断：

这篇文章可以预览和转换，但创建草稿被阻塞，因为缺少封面。

这类回答用户能直接处理。

doctor 检查本机环境

md2wechat 2.3.0 增加了：

md2wechat doctor --json

做 API 相关任务前应该先跑它。

doctor 检查的是本机是否具备尝试条件：配置能不能加载、默认转换模式、API key 是否存在、默认主题是否兼容、排版目录是否可用、公众号草稿凭据是否存在。

它不会做真实登录，不会上传图片，也不会创建草稿。

实际顺序建议是：

md2wechat version --json
md2wechat doctor --json
md2wechat capabilities --json
md2wechat inspect article.md --json
md2wechat preview article.md
md2wechat convert article.md

inspect 检查单篇文章

inspect --json 回答的是另一个问题：

这篇文章能不能执行用户要的目标？

如果要创建草稿：

md2wechat inspect article.md --draft --cover cover.jpg --json

如果草稿目标被阻塞，inspect 会把阻塞项映射到目标上：

• MISSING_API_KEY
• LOCAL_IMAGE_MISSING
• MISSING_COVER

这比把所有问题都当成普通转换失败要清楚得多。

主题发现也变严格了

md2wechat 2.3.1 和 2.3.0 收紧了主题发现。

Agent 现在应该读取 themes list/show --json，而不是从旧文档里猜主题名。

重点字段包括：

• selectable
• style
• metadata_incomplete

API 模式会拒绝 AI 主题。AI 模式会拒绝 API 主题。不可选择的主题集合不能当成具体主题来用。

安全写法是：

md2wechat themes list --json
md2wechat themes show wechat-native --json
md2wechat convert article.md --theme wechat-native

排版模块现在有 body_format

高级排版模块应该先从发现结果里选择：

md2wechat layout list --json
md2wechat layout show hero --json

新增的关键信息是 body_format。它告诉 Agent 这个模块需要哪种正文格式：

• fields
• rows
• json_object
• json_array

这样 Agent 不需要再靠示例猜语法。

生成带模块的 Markdown 后，建议先验证：

md2wechat layout validate --file article.formatted.md --json

验证通过后再转换。

Brand Profile 已经进入 Agent 工作流

md2wechat 2.2.0 增加了：

md2wechat brand init
md2wechat brand show --json

Brand Profile 文件在：

~/.config/md2wechat/brand.md

它是 Markdown，不是 YAML。CLI 返回原文，Agent 用它判断语气、排版偏好、引导动作和禁用表达。

这很重要，因为高级发布不是单纯转换问题，也是一致性问题。

2.2.1 之后图片默认值也变了

md2wechat 2.2.1 修复了 OpenAI GPT Image 返回 b64_json 时的处理问题，并把 OpenAI 默认图片模型更新为 gpt-image-2，默认尺寸更新为 auto。

如果升级后生图行为不同，先检查：

md2wechat providers list --json
md2wechat providers show openai --json
md2wechat config show --format json

不要把旧图片配置直接复制到新环境里。

当前推荐流程

现在做 Agent 发布流程，建议按这个顺序：

1. 用 doctor --json 检查本机环境。
2. 只发现当前任务需要的 provider、theme、prompt 或 layout。
3. 不直接修改用户原始 Markdown。
4. 需要高级排版时，生成临时 Markdown。
5. 先验证排版语法。
6. 再检查文章目标准备状态。
7. 用户没看过结果时，先预览，再转换或创建草稿。

紧凑命令是：

md2wechat doctor --json
md2wechat themes list --json
md2wechat layout list --json
md2wechat layout validate --file article.formatted.md --json
md2wechat inspect article.formatted.md --json
md2wechat preview article.formatted.md
md2wechat convert article.formatted.md

继续阅读

• doctor 与 inspect 准备状态
• 品牌档案 Brand Profile
• 发现优先工作流
• md2wechat-skill

来源：md2wechat-skill changelog