发布 API（Publishing API）

Publishing API 是国际站的发布服务，位于 https://md2wechat.com/api/v1，与 Convert API 是两个独立服务面。

Convert 与 publishing 的边界

Convert API（https://www.md2wechat.cn/api/convert）把 Markdown 渲染成微信可用 HTML，不会创建公众号草稿。
Publishing API（https://md2wechat.com/api/v1）是发布服务面；草稿创建由 md2wechat CLI 经由该服务完成。

如果你的工作流只需要 HTML，到 Convert API 为止。草稿创建是发布副作用，必须先获得用户明确授权。

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

分步说明：

inspect --json 解析元数据（title ≤ 32 字符、author ≤ 16、digest ≤ 128），返回 readiness.targets（ready/blocked/degraded）与 blockers（如 MISSING_COVER、MISSING_WECHAT_CONFIG）。
Preflight 在任何远程调用前校验意图、素材与封面。
Convert 经 Convert API 渲染 HTML。
--upload 把文章图片上传为微信素材并替换 URL；--cover 上传封面并得到 media_id。
草稿创建落到公众号草稿箱，返回 draft_id 与 draft_url。
--save-draft <file> 只保存草稿 JSON 不提交；create_draft <json> 之后提交；test-draft <html> <cover> 是最小冒烟路径。

微信错误 45004 表示 digest 不合法——先检查摘要长度。
Readiness blockers（MISSING_API_KEY、MISSING_WECHAT_CONFIG、MISSING_COVER、LOCAL_IMAGE_MISSING）需先清除再重试。

Publishing API 是国际站的发布服务，位于 https://md2wechat.com/api/v1，与 Convert API 是两个独立服务面。

Convert API（https://www.md2wechat.cn/api/convert）把 Markdown 渲染成微信可用 HTML，不会创建公众号草稿。
Publishing API（https://md2wechat.com/api/v1）是发布服务面；草稿创建由 md2wechat CLI 经由该服务完成。

如果你的工作流只需要 HTML，到 Convert API 为止。草稿创建是发布副作用，必须先获得用户明确授权。

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

分步说明：

inspect --json 解析元数据（title ≤ 32 字符、author ≤ 16、digest ≤ 128），返回 readiness.targets（ready/blocked/degraded）与 blockers（如 MISSING_COVER、MISSING_WECHAT_CONFIG）。
Preflight 在任何远程调用前校验意图、素材与封面。
Convert 经 Convert API 渲染 HTML。
--upload 把文章图片上传为微信素材并替换 URL；--cover 上传封面并得到 media_id。
草稿创建落到公众号草稿箱，返回 draft_id 与 draft_url。
--save-draft <file> 只保存草稿 JSON 不提交；create_draft <json> 之后提交；test-draft <html> <cover> 是最小冒烟路径。

微信错误 45004 表示 digest 不合法——先检查摘要长度。
Readiness blockers（MISSING_API_KEY、MISSING_WECHAT_CONFIG、MISSING_COVER、LOCAL_IMAGE_MISSING）需先清除再重试。