Article Publishing

微信公众号图文文章发布

MCP 工具

适用于：带 HTML 排版的长文、深度文章。

草稿管理

查看发布历史：调用 list_drafts 和 list_published_articles MCP 工具。

使用方式

通过 MCP 工具调用 publish_draft，传入 articles 数组创建草稿。

draft.json 格式

{
  "articles": [
    {
      "title": "文章标题",
      "content": "<p>HTML 正文...</p>",
      "author": "署名（仅取自 get_project_profile 顶层 author，详见「作者字段来源」）",
      "digest": "摘要（120字符以内）",
      "thumb_media_id": "封面图的 media_id",
      "show_cover_pic": 1,
      "content_source_url": "原文链接（可选）"
    }
  ]
}

作者字段来源（硬性）

draft.json 的 author（公众号署名）必须且仅能取自 get_project_profile 返回的顶层 author 字段（已按 task > project 解析；可看返回的 author_source 追溯来源）。

• 顶层 author 非空 → articles[0].author = <顶层 author>，原样填入，不改写。

• 顶层 author 为空 → 省略 author 字段（或留空），由公众号后台用默认署名。

• 严禁用下列任一字段顶替 author（它们都不是署名）：

  • writer：writer 资源 key（如 dan-koe），决定文风，不决定署名。
  • 写作风格头像/昵称：仅 Studio 展示元数据，不会出现在 get_project_profile，不得用于发布。

• 署名污染自检（防回归闸门）：若顶层 author 命中 get_project_profile 返回的 available_writers 中任一写作风格的人设名（name，如 "Dan Koe"）或 key（english_name，如 dan-koe），几乎肯定是上游把写作风格误写进了署名字段——真实发布署名不该等于某个写作风格人设。此时不要盲目发布：按真实发布者署名修正后再发，并在 submit_agent_feedback 里标注「疑似署名污染：author 命中 writer 人设 X」。仅当署名确属真实同名（如作者本人就叫某人设名）才放行。

映射示例：

get_project_profile 返回            → draft.articles[0].author
author = "张三"                      → "张三"
writer = "dan-koe"                  → 不入 author（仅用于正文口吻）
author 为空                          → 省略 author 字段（切勿用 writer 顶替）

thumb_media_id 来源（按图片开关，硬性）

公众号文章的封面可由用户在创建任务/计划时关闭。thumb_media_id（封面 media_id）的填法严格取决于结构化运行控制 article_image_mode：

关键约束：封面开关关闭 → 一律不设 thumb_media_id，绝不用任何正文配图的 media_id 顶替。服务端 publish_draft 对 thumb_media_id 是可选的，省略它不会导致发布失败——公众号后台只是不显示封面（用户已知情选择）。封面开关开启但封面 media_id 缺失（生成失败）才是真正的发布阻塞，需回到 article-cover-design skill 重新生成。

响应格式

{
  "success": true,
  "data": {
    "media_id": "draft_media_id_xxx",
    "draft_url": "https://mp.weixin.qq.com/..."
  }
}

完整发布工作流

1. 调用 render_template（带 layout_plan）将 Markdown + 节奏计划确定性渲染为 WeChat HTML（替代旧的 convert_markdown）
2. 调用 generate_image（带 verify_with_vision=true, upload_to_cdn=true）生成封面图——生成与上传原子化，同一调用内完成生成→校验→压缩→上传微信 CDN，直接返回 media_id + wechat_url（无需单独 upload_image）。流水线场景：步骤 6d 已取得封面 media_id，直接复用即可，跳过本步
3. （仅当上一步返回 upload_error 时）调用 upload_image(file_path="$DIR/cover.png") 单独重传获取 media_id，不重新生成
4. 调用 publish_draft 创建草稿

流水线集成

本 skill 是 article 流水线的最后一步。前置条件：

发布前验证

创建草稿前，确认以下所有项（封面 media_id 项仅在封面开关开启时要求；关闭时不带 thumb_media_id，见「thumb_media_id 来源」）：

• HTML 文件存在且内容完整
• 封面 media_id 已获取（非空，仅封面开关开启时）
• 标题使用 SEO 优化标题（来自 seo-result.md）
• 摘要使用 SEO 优化摘要（来自 seo-result.md）
• 内容大小 < 20,000 字符或 1MB

注意事项

• 内容格式为 HTML，所有 CSS 必须内联
• 封面图需通过 thumb_media_id 指定
• 内容大小限制：< 20,000 字符或 1MB
• 安全标签：section, p, span, strong, em, h1-h6, ul, ol, li, blockquote, pre, code, table, img, br, hr

常见失败与修复

参考文档

• 微信API参考：wechat-api.md