封面图

每篇草稿都要封面

草稿创建必须显式给封面，两种互斥形式：

md2wechat convert article.md --draft --cover cover.jpg
md2wechat convert article.md --draft --cover-media-id <permanent_media_id>

• --cover <path> 上传本地图片作为封面素材。
• --cover-media-id <media_id> 复用已有永久素材。此参数拒绝 URL。

校验

inspect 对封面问题 fail-closed，错误码稳定：

• CONFLICTING_COVER_INPUTS——同时给了 --cover 与 --cover-media-id
• COVER_MEDIA_ID_INVALID——media id 不是有效的永久素材 id
• MISSING_COVER——--draft 没带任何封面

生成封面

md2wechat generate_cover --preset cover-default --article article.md

生成会产出并上传封面（微信副作用）。md2wechat write --cover-only 则返回风格匹配的封面提示词，交给宿主 Agent 渲染。

封面与 hero 模块的区别

• 没有 cover-hero 排版模块。cover-hero 是 generate_image 的图片预设。
• :::hero 高级排版模块是文章正文里的开头卡片，与草稿封面无关。
• 草稿封面以微信 thumb_media_id 提交，链路为 uploadCoverImage → UploadMaterial → media_id。

链路

--cover <path> → 上传为素材 → media_id → 附到 draft/add。

相关页面

• 图片生成
• 发布 API
• Convert