md2wechat-skill 2.0 正式发布：从一组命令，收口成可发布的公众号工作流

md2wechat-skill 这一轮发版，我更愿意把它理解成一次收口，而不是一次常规功能追加。

很多工具的问题不在于“不能用”，而在于每一块都能跑一点，但主链不够稳，入口不够清楚，文档和安装方式也不完全对齐。
到了 2.0，这些分散的问题基本被压到同一层里了。

先放公开入口：

• ClawHub: geekjourneyx/md2wechat

需要说明一个时间点差异：

• 这篇讨论的是 v2.0.0 这一轮正式发版收口
• 截至 2026 年 3 月 21 日，ClawHub 公开页显示的当前版本已经是 v2.0.1

也就是说，2.0.0 是这轮大版本成立的节点，2.0.1 更像发版后的公开元数据和安装说明校准。

这次为什么不是“小修小补”

如果只是多几个命令、多一个主题、多一页文档，这种变化通常不需要升到 2.0。

这次不一样的地方在于，几个原本容易漂移的层面被一起收口了：

• CLI 主链
• 图片生成与 prompt 资产层
• Coding Agent / OpenClaw 双 skill 路径
• 安装器与 release 资产
• 文档、配置、发现命令和发布元数据

对外看，变化是“功能更多了”。
对内看，更重要的是：

这些层终于在同一事实面上运行了。

先看用户真正能感知到的变化

如果你是第一次接触 md2wechat-skill，最直接的变化不是某个单命令，而是整条工作流终于更完整了。

现在这条主链已经被收口成稳定路径：

1. Markdown 转换
2. 图片处理或生成
3. 上传素材
4. 创建草稿
5. 创建图片消息

这件事听起来普通，但以前很多“能用”的工具，往往只把其中两三步做稳。
剩下的部分还要靠仓库里的说明、脚本猜测，或者用户自己补流程。

到了 2.0，md2wechat-skill 更像一个完整发布链，而不是若干命令的集合。

CLI 契约终于稳定下来了

这一轮最重要的基础工作，不是加功能，而是把 CLI 行为收紧。

几个关键点值得单独提：

1. 主链命令已经成型

从 Markdown 转 HTML、处理图片、上传、建草稿到图片消息创建，主流程已经不再像“边走边试”的状态。

对使用者来说，这意味着：

• 你可以按一条清晰主链设计自己的自动化
• 不需要在中途频繁切回 README 猜下一步命令

2. JSON 输出 envelope 统一了

这件事对人类用户未必最显眼，但对 Agent、脚本和自动化接入很重要。

输出结构不稳定，会直接导致这些问题：

• 上一版能解析，下一版字段变了
• 错误和成功输出风格不统一
• 同一流程里不同命令没法稳定串起来

2.0 把这层契约收紧后，后续 workflow 会更容易维护。

3. convert 默认模式继续明确保持为 api

这一点看起来像小细节，实际影响很大。

当用户没有显式传 --mode 时，convert 现在仍然默认走 api。
这等于把默认行为固定住了，避免旧脚本或旧习惯因为默认值漂移而出问题。

4. AI 模式的返回边界也说清楚了

这次另一个重要校准是：

• AI 模式当前返回的是 AI request / prompt
• 不是直接产出最终 HTML

这类边界如果不写清楚，用户最容易在“结果长什么样”这件事上产生错误预期。

Prompt Catalog 和图片工作流，终于不是散的

如果你之前用过图片相关命令，应该会很清楚：
图片生成这层最怕的不是“没有 prompt”，而是 prompt 资产散、命名不统一、能力发现靠猜。

2.0 解决的是这个问题。

新的发现命令已经成体系

这次稳定下来的发现命令包括：

• capabilities
• providers
• themes
• prompts

这意味着你不用再先翻文档，才能知道这个版本到底支持什么。

更直接的做法变成了：

1. 先查能力
2. 再查 provider
3. 再查 theme
4. 最后查 prompt

这比先翻 README 再猜命令可靠得多。

prompt 资产开始和二进制绑定

这轮发布把内置主题、默认 writer style、prompt 资产直接 embed 进二进制。

这件事带来的变化很实际：

• 少依赖 repo 相对路径
• 少依赖运行环境里有没有把资源文件带全
• 版本一致性更容易保证

换句话说，prompt 不再更像一堆散在仓库里的配套文件，而是正式进入 runtime 资产层。

图片 archetype 也终于像一个产品层

这次图片 prompt archetype 覆盖的范围已经很完整，包括：

• 封面图
• 信息图
• 横幅总结图
• 暗黑票券风
• 手绘 sketchnote
• Apple keynote 风格
• 维多利亚版画风

这不是“风格越多越好”的问题。
真正有价值的是：这些 archetype 已经被纳入可发现、可调用、可覆盖的体系里。

再往下走，图片命令已经不只是“给一段 raw prompt 去碰碰运气”，而是开始有稳定入口：

• generate_image --preset
• generate_cover
• generate_infographic
• --model 级别的命令覆盖

两条 skill 路径终于拆开了

以前最容易混淆的一个点，是不同平台的 skill 需求并不完全一样，但事实层和平台层容易写在一起。

这次拆分很关键：

• Coding Agent：skills/md2wechat/
• OpenClaw：platforms/openclaw/md2wechat/

这个调整的价值，不只是目录更好看。
它解决的是平台差异不再污染共享事实层的问题。

比如这些东西，本来就应该按平台处理：

• 安装方式
• runtime 边界
• 元数据
• 安全披露

平台拆开后，文档、安装器和 metadata 的责任边界也清楚了很多。

安装和 release 终于更像正式产品

2.0 还有一个非常明显的变化：release 工程化终于补齐了。

单一版本真相源

以单一 VERSION 文件作为版本真相源，这件事本身不花哨，但非常必要。

只要版本号在多个地方各写一份，迟早会发生：

• tag 对不上
• 安装脚本对不上
• 文档写的是一个版本
• 发布元数据又是另一个版本

统一版本真相源以后，发布动作才容易压稳。

build / smoke / release 开始走同一资产链

这次收口的主线是：

• build once
• smoke same artifact
• release same artifact

这意味着：

• 你测试的东西和你发布的东西更接近同一份
• 不容易出现“本地过了，release 包不是这个东西”的问题

installer 和 release 元数据也一起校准了

这点从 ClawHub 当前公开页也能看出来。
截至 2026 年 3 月 21 日，页面已经明确把固定版本资源和 installer 入口公开出来，并强调运行时版本匹配和 OpenClaw 安装边界。

这说明发版已经不只是“把二进制传上去”，而是把：

• release 资产
• skill 包
• 安装器路径
• 元数据入口

作为一个整体对外发布。

文档层终于对齐到同一事实层

这一轮发版如果只改命令，不改文档，其实还不算收口完成。

2.0 文档层做对的一点是：
它不是再加几篇零散说明，而是把 onboarding 信息重新排过了。

新用户现在更容易先回答这些问题：

• 默认模式是什么
• API 服务怎么联系
• 支持哪些主题、prompt、provider
• 不同安装场景该走哪条路径

另外，一些过去最容易散落在 issue、聊天记录或临时说明里的东西，这次也被补回正式文档层：

• 配置指南
• 能力发现文档
• FAQ
• 微信 AppID / AppSecret / IP 白名单 说明
• 图片服务说明
• OpenClaw 文档

这一步其实很重要。
因为真正会拖慢使用体验的，往往不是功能没有，而是信息分散。

为什么这次升到 2.0.0 是合理的

从工程和产品角度看，这一轮已经跨过了“小版本叠加”的边界。

它的变化更接近下面这几类：

• 从单一命令工具，演进成更完整的发布工作流
• 从手工文档说明，演进成 discovery-first 的 Agent 可发现系统
• 从 repo 相对路径依赖，演进成内置资产加覆盖机制
• 从单 skill 混用，演进成平台分层
• 从“可用”，演进到“可发布、可校验、可维护”

如果你用版本号表达产品状态，这一轮升到 2.0.0 是成立的。

老用户现在最该做什么

如果你已经在用旧版本，我更建议先做四件事，而不是直接上所有新能力。

1. 先跑 discovery 命令

先确认当前版本到底支持什么：

md2wechat capabilities --json
md2wechat providers list --json
md2wechat themes list --json
md2wechat prompts list --json

2. 把图片能力按 preset 来用

如果你的目标是封面图或信息图，优先试这些入口：

• generate_cover
• generate_infographic
• generate_image --preset

这比一上来写 raw prompt 更稳。

3. 按平台选 skill 路径

如果你跑的是 Coding Agent，就走 Coding Agent 那条路径。
如果你跑的是 OpenClaw，就走 OpenClaw 那条路径。
不要再把平台特有的安装方式混在一起看。

4. 把安装和 release 视为固定版本资产

尤其在 OpenClaw 场景里，先认固定版本 installer，再认 runtime 和 skill 包，不要把“发现入口”和“完整安装路径”混成一件事。

结论

md2wechat-skill 2.0.0 的意义，不在于这次又多了几个命令。

更关键的是，它把原本分散在 CLI、prompt 资产、图片工作流、平台封装、安装器、release 和文档里的事实，压到了一套更稳定的发布面上。

对用户来说，这意味着上手路径更清楚，默认行为更稳定，图片和 prompt 能力更容易发现。
对维护者来说，这意味着版本、安装、元数据和文档终于更接近同一份事实。

如果你接下来想继续看相关内容，可以从这里继续：

• md2wechat 已上架 ClawHub：在 OpenClaw 中安装前先看这 4 件事
• md2wechat-skill：让 Claude Code 和 OpenClaw 接入公众号排版
• md2wechat-lite 和 md2wechat-skill 怎么选？