寻找一篇笔记

↑ ↓ 移动 · Esc 关闭查看全部文章
视觉实验室

网页信息设计实验:架构图、流程图与交互图解的六种表达

从系统蓝图、泳道流程到注释型工程图和渐进解释,用一组真实可浏览的网页示例研究如何让复杂信息更容易理解。

作者:黄撑 更新于 2026-10-24
本文目录 8 节 · 展开收起

网页不只是把正文装进漂亮的容器。图纸、流程、说明书、地图、交互模型、数据新闻都在解决同一个问题:让读者看见对象之间的关系,而不是逐句在脑中拼接关系。

这是一份可直接比较展示效果的视觉实验:用「ChatGPT 通过 MCP 访问本地工具」这个共同题材,尝试六种不同的信息表达。图中地址、链路、测试状态如无特别注明均是教学示意,不是实时生产监控数据。

想了解完整的实际连接步骤,可以对照 《让 ChatGPT 连接本地 MCP:三种接入方案与完整实践》;这里专门研究「信息怎样被画清楚」。

01 · 多路径系统地图:先看共同点,再看分歧

表达原理:首尾固定,分叉表示三条备选连接路径,不是先后经过三套方案;本地图中箭头仅辅助阅读连接关系,不统一代表公网入站方向。适合 API 架构、网络隧道、部署拓扑。不宜:把认证握手、部署依赖和请求方向都画成同一种箭头。

02 · 泳道流程:同时回答「谁做」「何时做」

参与方 ↓ / 阶段 →发起 / 接入转发 / 执行返回
ChatGPT
选择并调用 MCP 工具① 发起
等待
展示工具结果⑥ 呈现
连接层
收到工具请求② 接入
转发到本地③ 路由
回传执行结果⑤ 回传
本地 MCP
等待
执行操作并生成结果④ 执行
已完成
  1. ChatGPT选择并调用 MCP 工具
  2. 连接层收到工具请求
  3. 连接层转发到本地
  4. 本地 MCP执行操作并生成结果
  5. 连接层回传执行结果
  6. ChatGPT展示工具结果

表达原理:桌面纵向比较参与者、横向呈现阶段;手机改为依次列出六个事件。序号是逻辑顺序,不表示每格耗时相同。适合跨部门协作、订单履约、API 生命周期。不宜:把并行任务误画成顺序流程。

03 · 注释型工程图:让结构、边界和接口都可定位

← 横向滑动图纸查看完整标注 →

本地受控网络边界ChatGPT发起 MCP 请求本地入口HTTPS / Tunnel 客户端MCP工具 / 权限受限目录云端调用端安全边界分界线NETWORK PLAN · 示意图(并非真实网络拓扑)
工程图表达要点:边界线、节点连接线、说明引线使用不同视觉语义,黄色标注线不代表数据流。

图纸路径:安全边界外的 ChatGPT → 本地入口 → 受控边界内的 MCP;MCP 只能访问授权资源。图纸按原始字号横向查看,无需缩小文字。

表达原理:结构居中,注释依附对象,明确连接线与说明引线。适合设备原理、网络边界和系统职责。移动端保留可横向查看的原尺寸图纸,并提供文字路径。不宜:只有两三个普通概念,却用大量装饰线冒充工程复杂度。

04 · 决策路线图:问题比技术名词更靠前

你的 MCP 服务允许公网 HTTPS 入口吗?
否 · 不想开放公网入口优先评估 OpenAI Secure MCP Tunnel还需确认工作区、Tunnel 权限及 OAuth 条件
是 · 允许公网入口已有域名、反代和 FRP 环境?
已有Caddy + ChmlFrp复用自管入口
没有评估 Tailscale Funnel检查公网 HTTPS 前提

表达原理:条件必须真实分叉,分支标签贴近对应结果;这里是教学选型路径,不等于已验证的接入资格。适合故障排查、权限判断、方案选型。不宜:条件多且交叉时硬画巨大树,此时决策表更清楚。

05 · 渐进式图解:先展示一层,允许读者展开证据

默认层能看到 401,不代表连接失败

对于要求 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 互动信息图案例:可参考注释、视觉场景与滚动讲解的协调方式。