alchaincyf/fanbox

解決的問題

FanBox 是為使用 AI 編碼代理（如 Claude Code 或 Codex）快速原型開發專案的開發者所設計。它解決了「AI 散亂」問題——多個 AI 生成的專案分散在本地檔案系統中，難以追蹤哪些檔案被修改、專案目前的狀態為何，以及如何在不同代理會話之間切換。

如何運作

FanBox 作為一個「駕駛艙」，將檔案瀏覽器、真實的內嵌終端與即時預覽視窗整合至單一介面。它監控檔案系統，當代理修改檔案時提供視覺反饋，讓使用者能即時追蹤 AI 的進度。透過官方鉤子與基於終端的代理直接整合，精確偵測代理何時正在工作、等待輸入或已完成任務。

適用對象

依賴終端型 AI 編碼代理在本機建構專案的開發者與「氛圍編碼」者，他們需要一種簡化的方式來尋找、預覽與管理這些代理的輸出，而無需在多個視窗間切換。

主要亮點

• 代理感知檔案瀏覽器：當代理修改檔案時，檔案卡片會發光並泛起漣漪，「追蹤模式」會自動捲動至並預覽目前正在編輯的檔案。
• 整合終端：基於 node-pty 與 xterm.js 的完整終端，支援拖曳檔案以提供上下文，以及可點擊的檔案路徑。
• 會話管理：追蹤專案記憶，包括歷史會話與每個會話中變更的檔案，支援像 Claude Code 這樣的代理一鍵「恢復」。
• 分輪次差異比對：專用面板用於審查單個代理「輪次」中的變更，支援並排差異對比，並可回滾特定檔案或整個輪次。
• 豐富預覽功能：內建對 Markdown、HTML、圖片、PDF 與影片的渲染支援，還包含一個類似 Notion 的 Markdown WYSIWYG 編輯器。
• AI 驅動的組織功能：基於元資料提出清理計畫，協助整理散亂的 AI 專案。