cosmtrek/mindwalk

解決的問題

Mindwalk 將編碼代理產生的原始線性會話日誌轉換為程式碼庫的視覺化 3D 地圖。它解決了理解代理如何探索和修改倉儲的問題——識別哪些檔案相關，它在何處徘徊，其足跡是否符合預期範圍——這些資訊僅從閱讀 JSONL 日誌中難以察覺。

工作原理

Mindwalk 建立倉儲的決定性「城市地圖」，並疊加代理會話的重播。它使用適配器將不同代理（如 Claude Code、Codex 和 pi）的日誌標準化為檔案接觸事件流。

關鍵視覺元素包括：

• 地形與樹狀檢視：程式碼庫以徑向樹或樹狀圖形式渲染，光亮強度表示檔案被接觸的頻率。
• 接觸狀態：檔案根據其最深的互動狀態著色（例如，苔蘚綠表示已查看，月光藍表示已讀，暖琥珀色表示已編輯）。
• 播放控制面板：時間軸允許使用者瀏覽會話，區分觀察（冷色調）與修改（暖色調）。
• 代理透鏡：如果會話涉及子代理，使用者可以切換「透鏡」，在相同地圖上重播特定子代理的軌跡。
• 會話評估：可選功能，使用本地代理 CLI 根據過程維度（探索、範圍、徘徊、驗證）和任務特定評分卡，評估會話的軌跡。

適用對象

需要透過可視化代理與程式碼庫的互動來調試、分析和評估編碼代理效能的開發者與 AI 代理研究人員。

主要亮點

• 3D 程式碼庫可視化：將代理活動可視化為光在倉儲 3D 地圖中移動。
• 本地優先：Go 二進位檔與 UI 在本地執行；檢視會話不會將資料傳送至外部。
• 多代理支援：支援 Claude Code、Codex 和 pi 的日誌。
• 子代理透鏡：能夠隔離並重播複雜會話中的子代理軌跡。
• 基於證據的評估：LLM 生成的會話報告，將發現直接連結到時間軸事件。
• 客戶端影片匯出：在瀏覽器中完全執行，可將播放會話匯出為 .webm 檔案。