用途:将网络拓扑渲染为浏览器中可交互、全标注的 3D 场景。与同族的 UE5、Blender 可视化技能不同,它不需要桌面应用、GPU 或跨系统桥接,每次可视化都是一个单文件自包含 HTML,直接在浏览器中打开,无需构建步骤,也不需管理服务器进程(real-stencil 模式亦然)。
主要能力:设备按角色以不同颜色和形状渲染(路由器、交换机、防火墙、负载均衡器、客户端);接口是设备的真实子对象,移动设备时接口随之移动;链路渲染为所连接口之间的可见线缆,缺少接口级数据时退化为设备到设备连接;设备、接口、链路均标注来源提供的元数据(IP、描述等,不含凭据与配置);运行状态(健康/降级/故障)叠加在角色配色之上;图例解释所有颜色与形状约定。
拓扑来源:可接入已有的拓扑记录或实验仿真集成,包括 Cisco Modeling Labs、GNS3、containerlab、EVE-NG、Nautobot、NetBox/Infrahub、IP Fabric、Forward Networks,也可直接使用无需实时来源的自然语言描述。示例命令如“Visualize my GNS3 project in Three.js”。输出写到 workspace/output/threejs-network-viz/topology-<timestamp>-<snapshot-id>.html 并在默认浏览器打开。
使用方式:仅需现代桌面浏览器(Chrome/Firefox/Edge),页面打开后可用鼠标或触控板操作,左键拖动旋转、滚轮缩放、右键拖动平移(OrbitControls)。real-stencil 模式为可选,需在 .env 中配置 SKETCHFAB_API_KEY、SKETCHFAB_USERNAME,并注册经 npm install && npm run build 构建的 sketchfab-mcp-server,用于尝试以真实 3D 模型(仅限 CC0 授权)替换程序化形状。
限制:面向数十台设备、数百接口的实验与园区规模,不适用于数千设备的超大拓扑。real-stencil 模式会把完整模型嵌入 HTML(维持零服务器交付),可能产生数 MB 文件;实测一个 CC0 模型约 14MB(base64 嵌入后 19MB)。该模式下无已验证 CC0 模型的设备角色会自动回退为程序化形状,且回退在实践中是常见结果。它不会抓取或自动获取付费市场资源,只检查用户手动放置的 workspace/output/threejs-network-viz/assets/user-supplied/<role>.glb。内置 sketchfab-mcp-server 存在许可证字段丢失的缺陷并已打补丁,若从上游重新克隆需重新应用补丁并 npm run build 后 CC0 验证才正常。其余未提供的事实暂未提供。