Mindwalk：在 3D 中可视化 AI 编码代理会话

Mindwalk：在 3D 中可视化 AI 编码代理会话

Mindwalk 提供了一种空间化的方法来审计 AI 编码代理，通过在仓库的 3D 地图上回放会话日志。标准的会话日志记录了代理做了什么，而 Mindwalk 则可视化代理是如何理解任务的——具体来说，它将哪些文件视为相关，以及在执行之前在哪里进行探索。

代理行为的空间分析

Mindwalk 将仓库转换为一张“夜图”，代理的活动会产生光亮。这使开发者能够一眼看到代理的足迹，判断其探索是否符合任务的预期范围。

可视化模式和指示器

  • 树形视图和地形视图：代码库可以表现为径向树或树状图平面。光辉的强度表示文件被触及的深度和频率。
  • 触碰状态：文件根据其最深的交互方式进行颜色编码：
    • 苔藓绿：已看到
    • 月白：已读取
    • 暖琥珀：已编辑
    • 暗色：未访问
  • 回放面板：分桶直方图允许用户在会话中拖动。观察阶段（搜索、读取、执行）用冷色表示，变更阶段（编辑、验证）则用暖色发光。
  • 时间线标记：特定符号标记关键事件：◇ 表示上下文压缩，○ 表示子代理启动，› 表示用户回合。

技术架构

Mindwalk 以本地 Go 二进制文件的形式构建，确保没有会话数据离开用户机器。它将数据分为两个独立的构件：

  1. Trace（轨迹）：通过适配器从会话日志中提取的文件触碰事件的标准化流。目前支持 Claude Code 和 Codex 会话日志。
  2. Citymap（城市地图）：仓库的确定性布局。因为相同的树始终生成相同的地图，回放可以在不同会话之间进行比较。

系统使用本地 Go 服务器将 trace 与 citymap 合并，并提供基于 React 和 Three.js 构建的前端。

安装与使用

Mindwalk 可以通过 shell 脚本安装，或使用 Makefile 从源码构建。

快速开始：

curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
mindwalk

核心命令：

  • mindwalk serve：扫描 ~/.claude/projects 和 ~/.codex/sessions，在本地端口提供 UI。
  • mindwalk open <session.jsonl>：打开指定的会话日志。
  • mindwalk build <repo>：生成仓库 citymap JSON。
  • mindwalk trace <session>：写入标准化的 trace JSON。

社区洞察与使用案例

虽然有用户质疑相较于传统 diff，3D 可视化的即时价值，但也有用户指出空间代理审计的高价值潜在用例：

“我觉得可能很酷的是一种空间/表示的比较：看看两个不同模型在同一问题上如何与代码库交互，它们触碰了哪些文件，做了什么。”

其他社区成员指出，基于终端的“读取文件”日志往往难以追踪，而空间表示可以更容易地定位 LLM 获取信息的具体位置。有用户建议将工具扩展为提供跨所有代理的累计历史，而不是仅限于单会话历史。

摘要： Mindwalk 是一款本地可视化工具，将 AI 编码代理的会话日志转换为交互式的代码库 3D 地图，以揭示代理如何探索和修改文件。

标题： Mindwalk：在 3D 中可视化 AI 编码代理会话

Sources