---
title: "Debugging Visualization"
type: concept
tags: [spatial-computing, debugging, ux, multi-agent]
last_updated: 2026-03-05
---

## Definition

调试可视化（Debugging Visualization）——通过空间叠加将运行时追踪信息直接叠加在工作流结构之上，提供 3D 可视化的调试体验。

由 [[nexus-spatial-discovery]] 中 [[UX-Researcher]] 识别为 **杀手级用例（Killer Use Case）**。

## Why It's the Killer Use Case

1. **Real quantified pain point**：用户花费 40% 时间通过日志检查调试 Agent 失败（[[nexus-spatial-discovery]] 用户画像数据）
2. **2D tools handle it poorly**：现有 2D 工具无法有效可视化复杂的 Agent 执行追踪
3. **3D uniquely suited**：工作流结构（节点+连接）+ 运行时数据（时间序列/调用栈/token消耗）天然适合 3D 叠加

## UX Research Finding

> "Debugging Is the Killer Use Case. Spatial overlay of runtime traces on workflow structure solves a real, quantified pain point that no 2D tool handles well." — [[UX-Researcher]]

[[Product-Trend-Researcher]] 和 [[XR-Interface-Architect]] 均独立得出相同结论。

## Implementation in Nexus Spatial

- 7 种 Agent 状态可视化：Idle / Queued / Running / Streaming / Completed / Error / Paused
- 状态通过边缘光晕、内饰动画、声音、粒子系统区分
- LOD 节点系统：hover 显示最近 I/O，selected 显示完整追踪

## Key Design Insight

空间计算对**结构性**任务（放置、连接、重排节点）增加价值，但对**参数性**任务（文本输入、配置）制造摩擦。界面必须无缝混合空间和 2D 模式——2D 面板锚定在空间位置。

## Related Concepts

- [[Command-Theater-Interface]]：调试可视化的界面容器
- [[Semantic-Zoom]]：调试视图的导航模式
- [[SpatialAIOps]]：调试可视化是 SpatialAIOps 的核心差异化
- [[Nexus-Spatial]]：调试可视化作为核心功能