Mode Selection

第一次接 md2wechat Agent API，最容易乱的不是命令，而是模式。

很多人一上来就把这些东西混在一起：

• API 模式
• AI 模式
• 普通转换
• 高级排版
• CLI / Skill / Raw API

其实它们不是一回事。

先记住一个最短判断

• 只想把 Markdown 稳定转成微信 HTML：先用 API 模式
• 想让结构更稳，读起来更顺：在 API 模式里加高级排版
• 想把结果交给外部模型继续处理：再用 AI 模式

API 模式和 AI 模式怎么分

API 模式

适合：

• 想直接拿到稳定结果
• 想少走一步
• 想让 Agent 更容易跑通流程

这条路更像“直接做成品”。

AI 模式

适合：

• 你明确知道后面还有一段模型处理
• 你要把结构化结果继续交给别的生成链路
• 你接受这不是一步出最终稿

这条路更像“先给下一步准备材料”。

普通转换和高级排版怎么分

普通转换

适合：

• 短文
• 简单通知
• 只想快速发出去

高级排版

适合：

• 发布稿
• 教程
• 方法论长文
• 服务介绍页

这不是“更花”，而是“更会讲”。

CLI、Skill、Raw API 又该怎么选

CLI

适合先本地验证。你想先看转换、预览、发现命令，先从 CLI 起步最稳。

Skill

适合已经在 Claude Code、Codex、OpenCode、Claudian、OpenClaw 里工作的人。它解决的是“怎么接进现有 Agent 工作流”。

Raw API

适合你已经明确要自己接服务端、任务流或自动化平台。

一个更稳的选择顺序

建议按这个顺序来：

1. 先决定你是要成品，还是要中间结果
2. 再决定这篇是不是需要高级排版
3. 最后再决定从 CLI、Skill 还是 Raw API 进入

最常见的误判

• 把 AI 模式当成一步出最终稿
• 内容还很短，也急着上高级排版
• 还没跑 discovery，就先假设 theme、provider、模块都可用
• 其实只是想本地验证，却一上来就直接接 Raw API

接下来该看哪页

• Advanced Layout
• Advanced Layout Use Cases
• Discovery-First Workflow
• Setup and Troubleshooting