Agent API 文档API
Mode Selection
先把 API 模式、AI 模式、普通转换和高级排版的分工看清楚，少走弯路。
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
当你想在 Agent 运行时中采用这套工作流时，可以把 Skill 作为验证候选。安装与配置路径只属于分发证据，不等于已经验证任一具名宿主的端到端兼容性。只有安装、discovery、转换、预览以及（如适用）草稿流程在该运行时通过后，才优先选择这条路径。
Raw API
适合你已经明确要自己接服务端、任务流或自动化平台。
一个更稳的选择顺序
建议按这个顺序来：
- 先决定你是要成品，还是要中间结果
- 再决定这篇是不是需要高级排版
- 最后再决定从 CLI、Skill 还是 Raw API 进入
最常见的误判
- 把 AI 模式当成一步出最终稿
- 内容还很短，也急着上高级排版
- 还没跑 discovery，就先假设 theme、provider、模块都可用
- 其实只是想本地验证，却一上来就直接接 Raw API