从 v2.1.0 到 v2.9.0：md2wechat-skill 的 Agent 发布链路怎么成型

md2wechat-skill 的 6 月版本更新很密集。把 v2.1.0 到 v2.9.0 连起来看，主线很清楚：

先把公众号文章排好，再把发布前检查、主题选择、图片生成、标题建议和多账号发布交给 Agent 稳定接管。

这篇按版本梳理这条线。

v2.1.0：高级排版模块上线

v2.1.0 的关键词是 Layout。

这一版把公众号排版从“主题样式”推进到“模块表达”。它解决的问题更具体：

• 文章开头怎么像专题
• 中段信息怎么被读者记住
• 数据和证据怎么摆清楚
• 结尾怎么自然收束到行动

当时的 47 个高级模块名从这里开始成为稳定能力，后续版本继续扩展到当前主推的 77 个高级排版模块条目。

模块为什么重要

主题决定视觉气质。

模块决定读者能不能看懂、记住和行动。

常用模块包括：

• hero：文章第一屏
• toc：阅读导航
• infographic：视觉摘要
• metrics：数据证据
• summary：结论
• cta：行动区

这些模块让 Markdown 草稿接近一篇可以发布的公众号作品。

v2.2.0：Brand Profile 稳定内容身份

v2.2.0 开始强调 Brand Profile。

个人创作者需要文章有自己的识别度。企业账号需要多人写稿时语气稳定、标准一致、对外表达可信。

Brand Profile 让排版不只停留在样式层，还能承接账号长期表达。

v2.3.0：doctor 和发布前诊断

v2.3.0 的重点之一是 doctor --json。

Agent 需要结构化信号，才能判断当前环境是否能继续：

• 配置是否齐全
• 模式是否可用
• 目标是否能执行
• 失败后下一步该查哪里

doctor 是发布稳定性的基础。

v2.4.0：Agent readiness 合约

v2.4.0 加入 inspect --json 的 readiness 信息。

它返回：

• targets
• blockers
• warnings
• recommended_actions
• mode

Agent 可以据此判断能不能预览、转换、上传、生成草稿，以及缺哪些配置。

这一步让“发布前检查”变成机器可读的流程。

v2.5.0：48 个主题和当前版本 SOP

v2.5.0 把 API 主题文档和 CLI 发现能力补齐到 48 个专业主题。

这一版补入了 /theme-gallery 中常用的特色主题：

• nyt-classic
• github-readme
• mint-fresh
• sunset-amber
• ink-minimal
• lavender-dream
• coffee-house
• bauhaus-primary

Agent 选主题时应该先读取主题列表和主题详情：

md2wechat themes list --json
md2wechat themes show github-readme --json

同一版还加入了：

md2wechat skills list
md2wechat skills read md2wechat

这让 Agent 可以读取当前 CLI 内置的 SOP，减少依赖旧教程或外部记忆。

v2.6.0：多公众号账号

v2.6.0 加入了命名公众号账号配置。

一个团队可能同时维护品牌号、个人号、测试号。多账号能力让 Agent 在发布草稿时明确目标账号：

md2wechat draft article.md --wechat-account brand-main

旧的单账号配置仍然可用，已有用户不用被迫迁移。

v2.7.0：微信固定出口代理

v2.7.0 加入 wechat.proxy_url 和 WECHAT_PROXY_URL。

它解决的是微信后台 IP 白名单问题。上传素材、生成草稿、图文发布这类微信 API 调用可以走固定出口。

这个代理只作用在微信侧请求，不影响本地预览、Markdown 转换、图片模型或其它发现流程。

v2.8.0：图片计划模式

v2.8.0 给图片相关命令加入无副作用计划模式：

md2wechat generate_image article.md --plan --json
md2wechat generate_cover article.md --plan --json
md2wechat generate_infographic article.md --plan --json

Agent 可以先拿到结构化图片方案，再用自己所在环境的 Image Gen 工具生成图片。

这样做的价值很直接：md2wechat 不需要持有图片服务密钥，也不会在 plan 阶段写文件、上传图片或改文章。

v2.9.0：标题建议交接

v2.9.0 加入：

md2wechat title suggest article.md --json

命令输出标题建议请求，不直接调用模型，不写回文章，不上传，不创建草稿。

同一版加入 title/wechat-title-expert prompt catalog，并把 title_generation 写入 capabilities --json。

Agent 可以明确知道：

• 标题建议需要 --json
• 需要外部模型执行
• 不需要公众号凭证
• 不需要图片 API key
• 不产生上传、草稿、写回等副作用

这条演进线说明什么

现在的 md2wechat-skill 可以按六层理解：

1. 高级模块：让文章结构更适合公众号阅读
2. 主题系统：让文章视觉风格稳定
3. doctor / validate：检查发布前问题
4. readiness：给 Agent 返回下一步建议
5. 多账号 / 固定出口：处理真实发布环境
6. 图片 plan / 标题建议：把创作辅助交给宿主 Agent

对用户有什么价值

个人用户得到的是更省心的发布流程。写完 Markdown 后，Agent 能检查、选主题、排版、预览、建议标题、规划配图。

团队用户得到的是更可控的流程。不同公众号账号、不同环境出口、不同主题风格都可以在命令层明确表达。

开发者和 Agent 平台得到的是更清晰的边界。哪些命令有副作用，哪些命令只返回计划，哪些能力需要外部模型，CLI 都能用 JSON 说清楚。

给 Agent 的最小路线

md2wechat capabilities --json
md2wechat skills read md2wechat
md2wechat doctor --json
md2wechat inspect article.md --json
md2wechat themes list --json
md2wechat layout validate article.md --json
md2wechat title suggest article.md --json
md2wechat generate_cover article.md --plan --json
md2wechat preview article.md

需要发布草稿时，再选择账号：

md2wechat draft article.md --wechat-account brand-main

延伸阅读

• md2wechat-skill CHANGELOG
• md2wechat-skill 2026 年 6 月更新总览
• md2wechat-skill v2.4.0 更新解读
• Agent 写公众号前应该先检查什么？