★ FEATURED ARTICLE 【免费下载链接】mindwalkA visualization tool that replays coding-agent sessions on a 3D map of your codebase.项目地址https://gitcode.com/gh_mirrors/mi/mindwalk点击查看免费下载mindwalk 是一个开源的 AI 编程会话可视化工具它能把 Claude Code、Codex 等 coding agent 的会话日志回放到一张由你的仓库生成的3D 代码地图上。Agent 搜索过哪里、读过哪些文件、改动了什么地图会随之发光——其余部分保持黑暗。一眼就能看清 Agent 对任务的理解是否跑偏AI 编程过程不再是黑盒 AI编程的黑盒问题Agent会话日志为什么难读用 Claude Code、Codex 这类 AI 编程助手时你常会遇到这样的困惑Agent 说已完成修复但它到底看了哪些文件它的探索范围是否符合你的预期还是满仓库乱逛报错几次改了又改的文件churned files有多少会话日志JSONL只记录了 Agent做了什么却无法回答它如何理解任务把原始日志逐行读一遍这些疑问一个也回答不了。mindwalk 的思路很巧妙把仓库画成一张夜景地图把会话回放成光在地图上移动——Agent 搜索、读取、编辑过的地方亮起来其他区域保持黑暗。Agent 对任务的理解变成了一个你一眼就能看出的形状。mindwalk快速安装3步本地跑起3D代码地图mindwalk 是一个纯 Go 编写的单二进制程序完全本地运行浏览会话不会向任何地方发送数据。# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/mi/mindwalk cd mindwalk # 2. 构建安装前端依赖并生成 bin/mindwalk make setup make build # 3. 启动 ./bin/mindwalk不带任何参数直接运行mindwalk时它会自动扫描~/.claude/projects和~/.codex/sessions下的会话记录在本地随机端口启动 UI 并打开浏览器。常用命令一览命令作用mindwalk serve [--port N]启动本地服务并打开浏览器mindwalk open session.jsonl只回放某一个指定会话mindwalk map repo无需会话直接生成仓库的3D地图mindwalk build repo -o out导出仓库 citymap JSONmindwalk trace session -o out导出归一化后的 trace JSONmindwalk analyze session用本地 Agent 对会话做评估见下文更完整的说明见 README.md官方安装脚本为 scripts/install.sh。读懂3D代码地图颜色、高度与播放台打开回放界面后地图提供Tree径向树和Terrain方块城市两种视图方块越高、越亮代表该文件被触碰得越深、频率越高。文件触碰状态一眼看懂Agent行为每个文件保留它在整个会话中最深的一次触碰状态状态颜色含义EDITED暖琥珀色被 Agent 编辑过READ月光蓝被完整读取SEEN苔藓绿仅被搜索/提及UNVISITED深色会话中没有访问GHOST线框幽灵会话触碰过、但现已从仓库中消失的文件播放台与时间轴底部的**播放台Playback Deck**支持拖动进度条、变速、回放甚至把整个回放导出为.webm视频纯客户端完成。直方图柱体按冷/暖色谱着色观测类事件search、read、exec保持冷色变更类事件edit、verify呈现暖色——编辑阶段会直接跳出来。时间轴上的标记也都可以点击跳转◇上下文压缩、○子 Agent 启动、›用户发言轮次。回放Agent会话像导演一样审视每一次文件触碰几个高价值操作帮你快速定位问题点击文件固定它的访问历史Inspector 面板再点击某条访问记录播放头会直接跳到那一刻快捷键Space播放/暂停、←/→单步⇧×10 步、E跳到下一个编辑、X跳到下一个错误、M跳到下一个标记REVIEW 条HUD 会把摩擦信号——错误率、被反复修改的文件数、最后一次验证之后的改动——折叠成一条审查条例如~27 errors · 7 files edited 3 times提示你重点复核。当会话启动了多个子 Agent 时HUD 会显示子 Agent 数量并打开Agents 面板选择一个镜头lens即可在同一张地图上回放任意一个子 Agent 的完整轨迹再切回主轨迹。这对排查多 Agent 协作到底谁干了什么极其有用。Session evaluation让本地Agent给你的会话当裁判除了看mindwalk 还能评。在 UI 的 Evaluate 面板执行mindwalk analyze它会调用你本机的claude或codexCLI 作为裁判评估这次会话的探索质量、范围控制、是否乱逛、是否做了验证——每一条结论都锚定在可点击跳转的时间轴事件上。隐私边界很清晰仅在你明确发起评估时才会把该会话的摘要任务措辞、文件路径、单行事件摘要发给你自己账号背后的模型裁判子进程是密封的无工具、无 MCP、无用户配置、无会话持久化评估报告缓存在~/.mindwalk/reports会话内容变化后报告标记为过期但绝不自动重跑。mindwalk工作原理trace、citymap与report三大构件mindwalk 有意把三种产物保持独立这也是它跨会话可比的前提trace会话轨迹——把 Agent 日志归一化为有序的文件触碰事件流并关联子 Agent 会话形成 Agent 图实现位于 internal/adapter/Claude Code 与 Codex 各有独立适配器citymap城市地图——仓库的确定性布局同一棵树永远生成同一张地图实现位于 internal/citymap/report评估报告——LLM 裁判基于证据的发现结论始终由严重程度机械汇总实现位于 internal/judge/。本地 Go 服务internal/server/把三者拼接后交给 React Three.js 前端web/src/scene/CityScene.tsx渲染。三类 JSON 契约的 schema 文件在 schema/ 下想深入原理可以配合 AGENTS.md 阅读。常见问题FAQ会泄露我的代码吗浏览和回放完全本地进行不发送任何数据唯一例外是你主动发起的会话评估且只发送单次会话摘要。支持哪些AgentClaude Code 与 Codex 的会话日志后续新格式会通过 adapter 边界接入。可以只看不回放吗可以mindwalk map repo直接渲染任意仓库的 citymap此时高度编码的是代码行数而非关注度。小结AI 编程的瓶颈往往不在Agent 能不能干活而在你敢不敢信它怎么干的。mindwalk 用一张发光的 3D 代码地图把 Agent 的每一步探索变成可见的光影轨迹——从黑盒到透明只差一次make build。赞分享【免费下载链接】mindwalkA visualization tool that replays coding-agent sessions on a 3D map of your codebase.项目地址https://gitcode.com/gh_mirrors/mi/mindwalk点击查看免费下载相关推荐终极代码字体指南为什么Iosevka是为编程而生的完美选择终极代码字体指南为什么Iosevka是为编程而生的完美选择 Iosevka是一款开源的等宽字体家族专为编写代码、终端使用和技术文档准备而设计。它融合了无衬线开发工具技能包是解药还是新枷锁当工程纪律被写进 MarkdownAI 编码正在失去什么技能包是解药还是新枷锁当工程纪律被写进 MarkdownAI 编码正在失去什么 把资深工程师十几年的经验塞进一个 SKILL.md 然后让 ClaudAI 技能AI 插件agent-desktop 会话与Trace追踪终极指南如何调试并完整回放AI桌面操作全过程agent desktop 会话与Trace追踪终极指南如何调试并完整回放AI桌面操作全过程 当 AI Agent 开始代你在桌面上点鼠标、输文字时一个困扰GUI 自动化AI 应用桌面应用AI 技能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
