公众号图文

公众号图文页覆盖草稿箱和发表记录两类能力。RuoYi Office 当前使用微信草稿接口维护图文草稿，通过发布接口将草稿发表为可引用内容。前端分别位于 views/mp/draft 与 views/mp/freePublish，后端由 MpDraftController 和 MpFreePublishController 提供。

功能边界

能力	管理端页面	后端接口	说明
草稿列表	views/mp/draft	GET /mp/draft/page	从微信草稿箱分页读取
新建草稿	views/mp/draft/modules/form.vue	POST /mp/draft/create	支持单图文/多图文结构
更新草稿	草稿操作列	PUT /mp/draft/update	按 mediaId 更新文章数组
删除草稿	草稿操作列	DELETE /mp/draft/delete	删除微信草稿
发布草稿	草稿操作列	POST /mp/free-publish/submit	发布不等同于群发
发表记录	views/mp/freePublish	GET /mp/free-publish/page	查看已发布图文

草稿到发布链路

关键实现细节

• 草稿列表来自微信草稿箱，不是单纯读取本地数据库。
• 后端会根据草稿中的 thumbMediaId 回查本地素材表，把 thumbUrl 补回给前端，解决微信图片链接在后台预览不稳定的问题。
• “发布”不占用群发次数，发布后不会主动推送给用户，也不会自动展示在公众号主页，可用于菜单、自动回复、话题等入口引用。
• 发表记录删除调用微信发布能力接口，删除前应确认是否已有菜单或自动回复引用该内容链接。

写作与运营建议

• 封面素材先准备好：封面使用素材库图片，确保后台预览和微信侧发布都能访问。
• 多图文结构保持清晰：多篇文章要保证标题、摘要、封面风格一致。
• 发布前人工预览：草稿编辑器生成的是微信草稿结构，发布前应检查正文排版、链接和图片。
• 发布后记录用途：如果文章被菜单或自动回复引用，建议在运营台账中记录引用位置。

排查清单

现象	优先检查
草稿列表加载失败	公众号账号是否有效；微信草稿接口权限；后端错误码 DRAFT_LIST_FAIL
封面不显示	本地素材表是否存在对应 thumbMediaId；素材 URL 是否可访问
发布失败	mediaId 是否为有效草稿；权限 mp:free-publish:submit；微信返回错误信息
发表记录为空	是否选择公众号；发布是否成功；微信发表记录接口是否有数据