复杂产品怎么展示：用导览连接业务问题与真实功能

返回 ResolveAI 项目总览

功能逐渐完整以后，介绍产品反而可能变难。

打开工作台，配置、运行、调查、复测和发布都在菜单里。熟悉系统的人知道它们怎样关联，第一次接触的人却需要一边听解释，一边记住刚才在哪个页面、为什么跳到这里，以及眼前这条记录和前面的例子有什么关系。

这不是再补一份功能清单就能解决的问题。我在 AgentOne 个人复现版中增加了导览页，让业务问题、解释图和真实功能入口处在同一条阅读路径上。本文沿用博客项目名 ResolveAI，讨论这层展示设计。

先建立问题，再打开功能

后台导航回答的是“这里有什么功能”，导览则需要先回答“为什么要看这些功能”。

例如，介绍客服质量治理时，可以先提出一个问题：回答之后，业务真的向前走了吗？接着给出处理目标，再进入具体运行查看动作与结果。此时打开运行记录，就有了清楚的目的。

如果直接从配置字段开始，读者可能知道系统可以编辑版本，却不知道这些版本与客户问题有什么关系。功能介绍没有错，只是顺序不适合第一次理解产品的人。

个人版本的导览页面：先提出业务问题，再给出客户问题、业务执行和质量运营三个支点。

导览因此按问题组织章节：项目解决什么、客户遇到什么、系统怎样处理、实际做到了哪里、怎样继续运营，以及接入需要哪些分工。它没有改变后台对象，只是增加了一条进入它们的路径。

留白是为了保留交流

我没有把完整讲解放进页面。每一节保留一个问题标题、少量关键词、一张主视觉和有限的操作入口，技术细节默认折叠。

原因很实际：页面和讲解者如果同时说完整段落，听者需要在阅读与倾听之间分配注意力。文字越密，交流越容易变成逐句复述。

这里的留白不是减少内容准备，而是分配内容的位置。问题和事实放在主页面；需要解释的因果与取舍交给交流；具体机制和边界放进可展开区域。

这也使同一页面可以适应不同交流深度。有人只想理解业务价值，有人会追问版本绑定和执行边界，不必分别维护两套主体内容。

自由滚动，而不是强制按页播放

导览采用滚动页面和章节锚点，没有倒计时与自动翻页。

真实交流经常被问题打断：看到业务结果时，可能需要回头解释处理标准；讲到配置时，也可能直接进入接入分工。强制按顺序完成步骤，会让这种跳转显得像偏离流程。

锚点允许直接定位章节，刷新和前后导航也能保留章节位置。章节顺序提供默认线索，但不要求读者严格遵循。

机制章节：主图与折叠内容分层呈现。截图中的服务暂不可用时，图文仍保留，业务入口提示重试。

主视觉也采用相同原则。页面先使用静态解释图，不把复杂交互查看器直接嵌进阅读区。静态图提供整体关系，原尺寸入口处理细节阅读。

一张导览页，一张工作页

进入真实功能时，导览留在原标签页，功能使用一个可复用的工作标签页。

如果所有操作都在导览所在标签页完成，返回时容易丢失上下文；如果每次都新开页面，又会积累大量相似标签。复用工作页是在两者之间的选择：导览保留阅读位置，工作页承载当前查看任务。

关闭工作页后可以再次打开；浏览器阻止脚本打开时，链接本身仍然保留。切换工作页还要尊重草稿：未发送消息、已编辑内容需要离页提示，取消后继续保留。

这类细节与文章排版看起来无关，却影响讲解能否接续。用户刚写了一段消息，再点下一条记录时，不应该因为页面切换而突然失去内容。

入口必须准确，不能只保证“有页面可看”

一个“查看案例”按钮如果总是打开列表第一条记录，虽然页面可以正常显示，却可能让上下文发生变化。

因此，导览使用共享清单维护场景、客户记录、业务 Run、调查和历史发布。不同对象使用不同标识，客户路由与关联业务运行分别定位。指定记录不存在时，页面说明原因，不替换成另一条案例。

对于不同历史记录，也要明确它们承担什么说明任务。客户运行展示实际处理，另一条调查可以展示误报判断，历史发布展示版本与变更关系。它们可以出现在同一份导览里，但不能讲成同一事件已经完成修复上线。

历史状态同样需要从当前记录读取。页面中曾经通过的版本，后来可能已经被替代；静态介绍不应该永久保留某次截图中的状态结论。

默认浏览与主动操作分开

默认入口打开已保存记录，现场互动作为次级入口，由使用者主动发送消息或执行操作。

浏览和执行业务的风险不同。为了让一次展示更顺滑而自动发消息、重跑任务或重置数据，会改变正在解释的对象，也会让读者难以区分历史结果与刚刚发生的动作。

导览的准备检查因此只读取记录存在性、关联和当前状态。它在页面加载时执行一次，也允许手动刷新，结果放在折叠区域。模型已配置只说明配置存在，不额外发请求探测。

只读也不能仅靠接口使用 GET 来判断。原发布列表的读取包含状态协调，导览使用专门的只读查询分支跳过这一步。准备检查的职责是报告当前条件，不是自动修复环境。

服务暂不可用时，正文与解释图仍然可读，相关记录入口说明原因。导览保留概览作用，也让需要恢复的条件可见。

导览不替代操作手册

导览适合初次理解产品，也适合交流时快速跳到一个问题。操作手册则需要覆盖字段、前置条件和具体操作步骤。两者不必争取同样的完整度。

如果后续用户已经熟悉工作流程，每天只需要快速处理任务，主要入口仍应是工作台。导览保持轻量，不接管默认首页，也不成为使用产品前必须完成的教程。

手机端的阅读遵循同一原则：卡片纵向排列，导航可换行，图片提供原尺寸入口。投屏时先看关系，个人阅读时再展开细节。

结语

复杂产品的展示，不只是把已经做好的功能依次打开，而是安排理解发生的顺序。

先说明业务问题，再给出判断依据，然后进入真实功能查看；需要深入时展开，需要返回时仍能接续。页面提供视觉支点，讲解保留判断和交流。

导览的目标不是替人说完，而是让大家在同一个问题上开始讨论。