网页信息设计实验:架构图、流程图与交互图解的六种表达
从系统蓝图、泳道流程到注释型工程图和渐进解释,用一组真实可浏览的网页示例研究如何让复杂信息更容易理解。
本文目录 8 节 · 展开收起
网页不只是把正文装进漂亮的容器。图纸、流程、说明书、地图、交互模型、数据新闻都在解决同一个问题:让读者看见对象之间的关系,而不是逐句在脑中拼接关系。
这是一份可直接比较展示效果的视觉实验:用「ChatGPT 通过 MCP 访问本地工具」这个共同题材,尝试六种不同的信息表达。图中地址、链路、测试状态如无特别注明均是教学示意,不是实时生产监控数据。
想了解完整的实际连接步骤,可以对照 《让 ChatGPT 连接本地 MCP:三种接入方案与完整实践》;这里专门研究「信息怎样被画清楚」。
01 · 多路径系统地图:先看共同点,再看分歧
表达原理:首尾固定,分叉表示三条备选连接路径,不是先后经过三套方案;本地图中箭头仅辅助阅读连接关系,不统一代表公网入站方向。适合 API 架构、网络隧道、部署拓扑。不宜:把认证握手、部署依赖和请求方向都画成同一种箭头。
02 · 泳道流程:同时回答「谁做」「何时做」
- ChatGPT选择并调用 MCP 工具
- 连接层收到工具请求
- 连接层转发到本地
- 本地 MCP执行操作并生成结果
- 连接层回传执行结果
- ChatGPT展示工具结果
表达原理:桌面纵向比较参与者、横向呈现阶段;手机改为依次列出六个事件。序号是逻辑顺序,不表示每格耗时相同。适合跨部门协作、订单履约、API 生命周期。不宜:把并行任务误画成顺序流程。
03 · 注释型工程图:让结构、边界和接口都可定位
← 横向滑动图纸查看完整标注 →
图纸路径:安全边界外的 ChatGPT → 本地入口 → 受控边界内的 MCP;MCP 只能访问授权资源。图纸按原始字号横向查看,无需缩小文字。
表达原理:结构居中,注释依附对象,明确连接线与说明引线。适合设备原理、网络边界和系统职责。移动端保留可横向查看的原尺寸图纸,并提供文字路径。不宜:只有两三个普通概念,却用大量装饰线冒充工程复杂度。
04 · 决策路线图:问题比技术名词更靠前
表达原理:条件必须真实分叉,分支标签贴近对应结果;这里是教学选型路径,不等于已验证的接入资格。适合故障排查、权限判断、方案选型。不宜:条件多且交叉时硬画巨大树,此时决策表更清楚。
05 · 渐进式图解:先展示一层,允许读者展开证据
对于要求 OAuth 的 MCP 服务,未携带凭据时返回 401 可能说明接口存在且鉴权生效。
展开 · 这条结论成立还需要什么条件?
至少确认请求确实到达正确的 /mcp 端点、认证设计就是拒绝未授权请求、并且 OAuth 发现文档正常;否则 401 也可能来自错误的网关或路径。
展开 · 最后怎样验证是真正可用?
ChatGPT 完成插件授权,通过目标 MCP 工具只读打开允许目录里的测试文件,并核对实际返回内容。公网状态码不是端到端验收。
表达原理:默认阅读层要自洽;需要背景、异常和技术细节的读者再展开。适合复杂教程、数据口径解释、API 文档、审查报告。不宜:把关键结论藏在必须点击才能看到的折叠内容中。
06 · 时序图:当顺序与往返比布局更重要
sequenceDiagram participant U as 用户 participant C as ChatGPT participant T as 连接层 participant M as 本地 MCP U->>C: 请求使用本地工具 C->>T: 发起 MCP 工具调用 T->>M: 转发请求 M-->>T: 返回执行结果 T-->>C: 返回 MCP 结果 C-->>U: 基于工具结果作答
箭头为消息传递,不保证每条链路均有相同实现或相同耗时;OpenAI 私有隧道由本地客户端主动轮询,不是外部主动连入内网。
表达原理:当请求、应答、重试、回调的时间顺序是核心信息时,时序图比组件卡片更清楚。复杂协议建议拆成「正常调用」和「异常分支」。不宜:只想展示模块归属,却画成虚构时间顺序的消息图。
哪种视觉适合哪类内容?
| 主要问题 | 更合适的表达 | 不宜这样用 |
|---|---|---|
| 有哪些层和路径? | 系统地图 / 拓扑图 | 不区分数据、控制和部署关系 |
| 谁在哪一步负责什么? | 泳道流程 | 参与者与时间阶段混为一轴 |
| 部件在哪、边界在哪? | 注释型图纸 | 标注线被误读为连接线 |
| 选择哪套方案? | 决策树 | 把所有背景文字塞进节点 |
| 需要先易后难地理解? | 渐进展示 / 折叠细节 | 把核心结论藏在交互之后 |
| 多系统如何往返? | 时序图 | 用虚构耗时误导读者 |
| 需要比较大量量化证据? | 标注型数据图 / 交互图表 | 不写时间、单位、来源与统计口径 |
从哪些优秀网页和设计实践借鉴?
这次检索不局限于个人博客,也参考了数据新闻、工程架构、教学交互和数据可视化:
- The Pudding:用滚动叙事和内容驱动的图形变化解释复杂议题;其 Resources 提供制作方法。
- Explorable Explanations:读者可操作参数、观察结果,适合把抽象逻辑变成小实验;不一定需要大型交互框架。
- Observable Plot 示例集:适合密度图、分布、比较、趋势与注释型数据图,强调数据关系而不是装饰。
- Ilograph:适合分层架构、多视角系统关系与复杂系统的逐层展开。
- Mermaid 文档:适合维护成本低的流程图、时序图、状态图;不追求替代所有自由布局工程图。
- Shorthand 互动信息图案例:可参考注释、视觉场景与滚动讲解的协调方式。