你盯着终端里 Claude Code 滚过的几百行输出,试图回想它为什么要在第74轮对话突然改那个配置文件——但你根本看不下去。日志是平的,时间是线性的,而代理的注意力却在文件树里跳跃,留下一堆你事后完全拼不起来的线索。Mindwalk 做的事情极其简单、极其粗暴:它把这堆会话日志扔进一个三维的代码库地图,用暗色打底,让代理碰过的文件像夜空里亮起的街灯。你没看过的,一片漆黑;它读过的,冷蓝;它反复编辑的,烧成橙色。所有动作就在你眼前的地形上重新演一遍。不需要联网,一个 Go 二进制文件搞定。
把会话日志投进 3D 地图,黑暗的代码库里亮起一盏盏试探的灯
树状图与地形图,两种夜视仪
Mindwalk 同时提供两套视图,不是为了炫技,而是两种审视代理的姿势。树状图会真实还原仓库的目录层级,node_modules 这种巨型依赖目录被打包成一个节点,不然整个画面会挤成一锅粥。地形图则把整个库压成一个平坦的矩形网格,每个文件是一个小方块,面积取决于代码行数。你想看宏观的探索轨迹,用地形图;想顺着目录追溯某个模块的读取链,切成树状图。切换几乎没有延迟,因为所有渲染都在本地完成。
颜色说了算:未访问、已查看、已读取、已编辑
四种状态,四色标记,毫不含糊。代理根本没碰过的文件是暗灰的,像没有路灯的巷子。已查看——意味着它在搜索结果或者目录扫描里瞥到了文件名——一种冷调的蓝绿。一旦文件被真正读取、内容被吞进上下文窗口,颜色升格成浅蓝。最亮的是已编辑,橙黄甚至偏红,在暗色背景上像焊点一样刺眼。你会立刻发现:代理在某个没被你注意到的工具函数上反复修改了七次,而旁边一整片模块它连看都没看。这不叫可视化,这叫把代理的注意力缺陷摊在你面前。
时间轴上的隐形标记——压缩、分叉、人类乱入
光标在时间轴上一拖,你能看到的不只是文件亮灭。Mindwalk 从日志里抓出了上下文压缩的时刻,当时代理觉得上下文太长,自己把一些东西挤掉了。也抓出了子代理启动的节点——它派生出一个小分身去干一件杂活,然后回收结果。还有你本人的介入:你在哪一步插了一句话,纠正了方向,或者塞了一截文档。这些标记像电影里的场记板,帮你把一段原本长达几十分钟的自动编码过程切出章节。没有这些,回放就是一片混沌。
本地优先,没有比安全更性感的特性
单个二进制文件,跑完即忘
Mindwalk 没有 Electron 壳,没有一堆 Python 依赖,也不在浏览器里跑一个肥厚的 Web 服务器。一个 Go 编译的二进制文件,传入那个存着 Claude Code 或 Codex 会话的目录,它就在你的机器上把地图构建出来。会话数据——包括每一个提示、每一次文件读写、报错信息——从磁盘读到内存,解析,渲染,全部留在你的机器上。没有任何字节被发到作者那里,连打点统计都没有。对于手里攥着生产环境代码、客户代码或者未发布产品源码的人来说,这个设计是底线。
那些把你日志拖上云端的工具,你不心虚吗?
市面上一些看起来更炫的代理调试平台,一上来就要求你登录、上传会话、甚至全量同步仓库。它们的可视化确实漂亮,但你得先把整个开发过程剥光了送进别人的服务器。Mindwalk 的作者显然不信任那套。二进制在你手里,跑完你可以立刻删掉,干净得连残留文件都不留。如果哪天你想把一段回放分享给同事,你能做的也只是把屏幕录下来——数据本身绝不出门。
像调查空难那样审查代理,摩擦信号全开
摩擦信号面板:错误、修改量与抖动
回放不是让你欣赏一段发光的艺术品。Mindwalk 右边嵌着一个面板,实时跳出摩擦信号:当前步的错误率、文件修改量剧烈放大的瞬间、代理在不同思路之间反复横跳的迹像。比如,错误率突然飙升,同时你看到橙色光点在一个文件上来回闪烁,你就知道代理在那儿卡壳了,不断重写、报错、再重写。事后你可以慢放那一段,揪出是提示词里的表述让它产生了误解,还是代码本身的设计有问题,连人类也绕不过去。
快捷键驱动的回放——跳过废话,直奔崩溃点
完整的会话可能长达几百步,你没时间从头看到尾。Mindwalk 允许用键盘精确控制播放速度,一个键直接跳到下一个编辑点,另一个键跳到下一个错误点。你甚至可以在几秒内扫完整段会话里所有被实际写入磁盘的时刻,忽略掉中间漫长的搜索和阅读。想复盘代理为什么在一个不是目标文件的目录下乱翻,只需把播放速度推高,看见不该亮的灯亮了,啪,暂停。这种交互方式让审计变得像快进一部监控录像,而不是翻一本没有页数的书。
不只是回放,是理解代理认知边界的一面镜子
黑暗区域比亮光更说明问题
当你把一段会话播完,整张地图上接近三分之二的文件从来没亮过。那些安静的、大块的黑暗区域才是真正值得盯着看的地方。代理完成任务时,它真的理解整个代码库吗?它只是在几条窄巷里反复摸索,碰巧交了一个能跑的结果。那些从未被读取的文件里有更优雅的实现、有现成可复用的函数,而代理完全忽略它们——因为你给它的上下文或指令没有引导它看过去。Mindwalk 让你一眼看出代理的知识缺口,这件事光靠读日志永远感知不到。
养成习惯:每次复杂任务后都播一遍
这个工具不重,花几十秒就能跑一次回放。真正的价值会在你第五次、第六次回看不同会话时浮现。你开始认出代理在哪些文件上反复绕圈,哪个模块永远被它跳过,哪种提示词会让它不必要地抓取一堆无用文档。这些模式的沉淀,比任何“最佳实践”文档都更接近真相。你调的是一段系统性的合作节奏,而你手里终于有了一个能像看飞行轨迹那样审视每一次起降的工具。对于 Claude Code 和 Codex 的重度用户,Mindwalk 不是花哨的玩具,是必须留在工具箱里的一把卡尺。

