Agent API 文档Skills
Setup and Troubleshooting
把安装、验证、发现和排错收成一条顺路，适合第一次接 md2wechat 的人直接照着走。
Setup and Troubleshooting
第一次接 md2wechat，最容易浪费时间的地方不是命令难，而是顺序乱。
这页只做一件事：把安装、验证、发现和排错收成一条顺路。
第一步：先把 CLI 装好
优先顺序很简单：
- mac 用户先用 Homebrew
- 已有 Node/npm 环境再用 npm
- 已有 Go 环境再用
go install - 其他情况走固定版本安装脚本
先看：
第二步：不要只看 version
安装完别只跑 version 就停。
更稳的验证顺序是：
md2wechat version --json
md2wechat config init
md2wechat capabilities --json
md2wechat providers list --json
md2wechat themes list --json这样你能更早看见：
- CLI 到底能不能执行
- 配置能不能初始化
- 当前运行时有没有把关键能力暴露出来
第三步：第一次先走纯预览
不要一上来就发草稿。
先走：
md2wechat inspect article.md
md2wechat preview article.md
md2wechat convert article.md --preview先把转换链路跑通，再去碰图片、草稿和公众号凭证。
第四步：报错先按层排
命令找不到
先查：
command -v md2wechat运行时看起来不完整
先查：
md2wechat capabilities --json图片相关报错
先查：
md2wechat providers list --json
md2wechat providers show volcengine --json高级排版不渲染
先查：
md2wechat layout list --json
md2wechat layout validate --file article.md --json草稿创建失败
先回头看微信凭证、封面图和当前模式。
第五步：遇到环境问题，不要在总文档里绕
如果你已经知道问题只发生在某个环境，就直接去对应页：
最短排错顺序
如果你只记一条，记这个：
- 先确认命令存在
- 再确认能力已暴露
- 再确认当前 provider / theme / layout 可用
- 最后才怀疑正文、提示词或接口本身