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 项目。