Agent API 文档Examples
Tutorial Post Example
教程文最怕在手机里读着累。这页给一个更稳的结构骨架。
Tutorial Post Example
教程文的难点通常不是内容不够，而是读者做到一半就累了，或者不知道下一步该看哪。
这类内容最适合的模块组合
herostepsnoticeimage-text或image-stepschecklist
一个可直接照着改的骨架
:::hero
eyebrow: 实战教程
title: 先把这 3 步走通，再去碰更复杂的自动化
subtitle: 这篇只做一件事：让你第一次完整跑通
:::
:::steps[主流程]
01 | 安装 CLI | 先确认命令真实可用
02 | 做 discovery | 先看当前能力，不靠猜
03 | 跑预览 | 先通转换，再做草稿
:::
:::notice
title: 先别急着发草稿
body: 如果预览都还没跑通，先不要碰封面图、素材上传和公众号凭证。
kind: warning
:::
:::image-text
title: 关键检查点
body: 先确认 version、capabilities、providers 和 themes 都有正常输出。
image_url: https://dummyimage.com/1200x800/f3f4f6/111827&text=Checklist
image_alt: 关键检查点示意图
:::
:::checklist[做完这页后你该确认]
命令能执行
配置能初始化
预览链路已跑通
下一步知道该看哪页
:::写教程时最常见的问题
- 一上来信息太多
- 步骤顺序不稳
- 没区分“必须做”和“后面再做”