转赞推荐：从《向日葵远程控制使用手册》学“步骤型”应用的写法

在 万象云档 翻到《向日葵远程控制使用手册》，本来只是找一条操作说明，读完却把它当成了一份“步骤型内容该怎么写”的范例收进了收藏。

它好在哪

远程控制这类操作有个特点：步骤有严格先后，漏一步就走不下去，而且用户往往在两个设备之间来回切换。手册对此的处理很值得学：

• 每一步只描述一个动作，不把两件事塞进一句；
• 明确写出“做完这一步你应该看到什么”，给完成判据；
• 把两端设备分开标注，避免读者搞混当前在哪一侧操作；
• 常见失败单独成段，给出报错特征和排查方向。

第三条尤其关键。步骤型内容最容易翻车的地方不是步骤错，而是没说清“现在是谁在做什么”。

搬到 AI 应用里

做引导流程、配置向导、操作类问答时，这四点几乎可以照搬。很多应用把一堆说明一次铺给用户，用户卡住也不知道卡在哪一步。改成“一步一动作 + 完成判据 + 失败分支”，可用性立刻不同。

我自己给一个配置流程写提示时，就借了它的结构：先让模型输出当前步骤编号与预期结果，用户确认后再进入下一步，而不是一次性生成整篇指南。想补接口与参数那部分的可核对写法，可以配合 BackendWiki 的文档条目 一起看。

一点延伸

手册里那种“先给最短可用路径，再列可选设置”的编排也挺聪明。新手不会被可选项淹没，熟手也能找到细节。这个顺序对任何引导类界面都适用。

小结

一份工具手册，讲的其实是怎么把“依赖顺序的操作”写清楚。做 AI 应用时我们常盯着模型输出什么，却忽略了用户要按什么顺序行动——这篇文档正好补上那一块。推荐给做配置向导、操作指引和步骤型问答的人。