Coding Agent 怎么评估 md2wechat：Claude Code、Codex 与通用 Agent 验证指南

如果你正在评估 Claude Code、Codex 或其他能执行 shell 的 Coding Agent，可以先把 md2wechat 作为发布层候选进行验证。

安装路径不等于宿主兼容验证。只有安装、discovery、转换、预览以及（如适用）草稿流程在对应运行时通过后，才应把该宿主视为已验证。

这篇文章讲三件事：

1. README 记录的 Claude Code 分发路径与验证方法。
2. 通用 Coding Agent 的 CLI 接法。
3. 通用 Coding Agent 的 API 接法。

先说结论：优先顺序怎么选？

如果你在 Claude Code 里工作

先把 README 记录的 Skill 安装路径作为验证候选。

README 给出的命令是：

/plugin marketplace add geekjourneyx/md2wechat-skill
/plugin install md2wechat@geekjourneyx-md2wechat-skill

安装后先用最小任务验证，例如：

请用秋日暖光主题将 article.md 转换为微信公众号格式

如果你用的是 Codex 或其他通用 Coding Agent

更推荐两条路径：

1. CLI 接法：让 Agent 直接执行 md2wechat 命令。
2. API 接法：让 Agent 直接调 API 文档 对外接口。

如果你的目标是“写作 + 排版 + 草稿发布”的整条链路，CLI 接法通常更顺手。

如果你的目标是“服务编排 + HTTP 接口集成”，API 接法更清晰。

一、Claude Code：为什么先验证公开路径？

因为 README 已记录安装方式和对话样例；这些属于分发与配置证据，不等于端到端兼容已经完成验证。

候选验证场景

• 你本来就在 Claude Code 里写文章或维护内容仓库。
• 你想要 Agent 边读文件边发布。
• 你想把 write、humanize、convert、草稿推送串起来。

一条典型链路

1. Agent 读取 article.md
2. 必要时先润色内容
3. 调 md2wechat convert
4. 预览输出
5. 满意后继续发草稿

二、通用 Coding Agent：CLI 接法

这是可以优先验证的通用路径。

如果 Agent 具备下面三项能力，就具备开始验证的前提；是否兼容仍以端到端冒烟结果为准：

• 能执行 shell
• 能读取 Markdown 文件
• 能访问本地配置或环境变量

1. 先把 md2wechat 装到 Agent 所在环境

不要只装在你自己的交互终端里。真正需要的是：

• 本地 Agent 就装在本机
• 容器里的 Agent 就装在容器里
• 远程执行环境就装在远程环境里

2. 先初始化配置

md2wechat config init

优先把稳定配置放在：

• ~/.config/md2wechat/config.yaml

3. 给 Agent 一个最小工作协议

我建议你把 Agent 使用 md2wechat 的顺序固定下来：

1. 先确认文章文件存在
2. 再跑 discovery 命令确认主题和能力
3. 先 --preview
4. 预览没问题再 --draft

推荐给 Agent 的最小命令集

md2wechat capabilities --json
md2wechat themes list --json
md2wechat convert article.md --preview
md2wechat convert article.md --draft --cover cover.jpg

为什么不建议一上来就发草稿？

因为 Agent 最容易出的问题是：

• 主题猜错
• 封面路径不对
• 正文内容没最终确认
• 微信配置不完整

先预览，能让问题停留在本地。

三、通用 Coding Agent：API 接法

如果你的 Agent 更擅长发 HTTP 请求，或者你本来就在服务端编排工作流，可以直接调用对应的 API。

目前有两个职责分离的 API 服务面：

• Convert API：POST https://www.md2wechat.cn/api/convert，用于转换
• Publishing API：https://md2wechat.com/api/v1，用于发布工作流

下面的示例只调用 Convert API。

认证头

Md2wechat-API-Key: wme_xxx

一个最小 convert 请求

curl -X POST "https://www.md2wechat.cn/api/convert" \
  -H "Content-Type: application/json" \
  -H "Md2wechat-API-Key: wme_your_api_key_here" \
  -d '{
    "markdown": "# 标题\n\n正文内容",
    "theme": "default",
    "fontSize": "medium"
  }'

API 接法更适合什么？

• 你要从数据库拿内容，不走本地文件。
• 你要把发布动作嵌进后端服务。
• 你已经有任务编排系统。
• 你不想在 Agent 环境里装完整 CLI。

四、对 Codex 之类 Agent 的实际建议

这里给一个更工程化的判断标准。

适合用 CLI 的情况

• Agent 直接改仓库里的 Markdown 文件。
• 文章就放在本地工作区。
• 你希望 Agent 顺便查主题、预览、调 Prompt。

适合用 API 的情况

• 内容不在本地文件，而在服务端。
• 你已经有统一的 HTTP 工具层。
• 你希望所有调用都走同一组密钥管理。

五、给 Agent 的提示词不要写成“玄学”

我更建议你给出明确约束，例如：

读取 article.md。
先运行 md2wechat themes list --json 确认主题。
默认先用 default 主题做一次预览。
如果预览成功，再按 article.md 内容推荐 2 个更合适的主题。
除非我明确确认，否则不要直接发草稿。

这种提示词比一句“帮我发公众号”稳定得多。

六、Secrets 和配置怎么放更稳？

不要写死在 Prompt 里

下面这些不应该直接写进通用提示词：

• API Key
• AppID
• AppSecret

推荐放置位置

1. ~/.config/md2wechat/config.yaml
2. Agent 环境变量
3. 安全密钥服务

Convert API base URL 怎么切换？

中文站 Convert API：

• https://www.md2wechat.cn

Convert API 的可选备用域名：

• https://md2wechat.app

如果你只要切换 Convert API，改：

• api.md2wechat_base_url
• 或 MD2WECHAT_BASE_URL

这两个设置只切换 Convert API，不会选择独立的 Publishing API。

Publishing API 是独立服务

国际英文站提供独立的 Publishing API：

• https://md2wechat.com/api/v1

Publishing API 请按国际站 API 文档或独立客户端调用，不要把 https://md2wechat.com 写入 Convert API 的 base URL 设置。

七、上线前最后检查什么？

如果你的 Agent 真要接生产发布，至少检查：

1. capabilities --json
2. themes list --json
3. 预览结果
4. 公众号 AppID / Secret
5. IP 白名单
6. 封面图和素材 URL 是否可访问

最后的建议

把 md2wechat 放进 Agent 工作流时，最重要的是“失败时能不能很好地停下来”。

稳定做法永远是：

1. 先探测
2. 再预览
3. 最后发布

如果你下一步要接 OpenClaw，继续读：

• OpenClaw 接入指南