FanBox：Coding Agent 的驾驶舱

当你的 AI agent 消失在十个项目里

想象一个这样的下午：你用 AI 工具一个下午起了十个项目，周五复盘时想去某个项目里改一行代码——翻遍 Finder 找不到、用 grep 搜关键词对不上号、最后想起来那个项目在网盘备份里。这是一个真实的工程痛点：AI coding agent 的工作方式，与人类工程师管理文件的方式之间，存在巨大的鸿沟。

AI coding agent（Claude Code、Codex 等）可以一个下午生成大量文件，但这些文件散落在本地各处，命名随意，改动历史不透明。开发者面临的核心困境是：找文件难、追踪改动难、随时接管 agent 难。三个窗口（文件管理器 + 终端 + 浏览器）来回跳，人被工具牵着走。

FanBox 解决的就是这个问题——它不是一个新的 IDE，也不是一个高级终端，而是一个专门给 coding agent 用的驾驶舱界面。

诞生背景：vibe coding 时代的工程管理危机

FanBox 的作者花叔（alchaincyf）是 Claude Code 和开源 Agent 工具的老用户。在频繁使用 agent 做开发的过程中，他发现 AI coding agent 的效率瓶颈不在 agent 本身，而在人机协作的界面层。

传统的命令行 agent 使用体验有几个根本问题：

• agent 在终端里跑，你不知道它具体在哪个目录工作
• 文件系统全靠 agent 自己描述，你无法直观看到改动了什么
• agent 写完代码后，你需要手动去 IDE 或 Finder 里找文件
• agent 可能在多个项目里同时工作，你无法集中管理

FanBox 的设计思路是：把文件和终端做在同一窗口，让 agent 的每一步操作都有界面反馈。这不是重新发明 IDE，而是一种专注在"找文件 + 轻量编辑 + 指挥 agent"这条链路的垂直工具。

核心架构：三区同屏设计

FanBox 的界面分为三个核心区域：

左侧：文件浏览器 实时浏览本地文件系统，支持代码高亮预览（Markdown、代码文件均可原地预览），不依赖 VS Code 或其他编辑器就能看内容。每当 agent 修改了某个文件，对应的文件卡片会亮起高亮，让改动一目了然。

右侧 / 下侧：内嵌真实终端 内嵌真实的系统终端（基于 node-pty），不是模拟的伪终端。这意味着你可以在里面跑任何命令行工具：Claude Code、Codex、bash 脚本、git 命令等。agent 的输出实时显示，你随时可以打断输入。

中间：改动追踪 agent 每写一个文件，对应卡片亮起；你可以预览 diff、对比改动、随时手动介入。这是 FanBox 与其他文件管理器最核心的差异——它不只是显示文件列表，而是将 agent 的工作流与文件系统状态联动。

内置 11 种 Agent 一键启动器

FanBox 预置了对 11 种主流 coding agent 的官方启动配置：

Agent	启动命令	状态
Claude Code	claude	官方支持
Codex	codex	官方支持
Hermes Agent	hermes	官方支持
OpenClaw	openclaw	官方支持
Kimi Code	kimi-code	官方支持
ZCode	zcode	官方支持
opencode	opencode	官方支持
pi (π)	pi	官方支持
CodeBuddy	codebuddy	官方支持
WorkBuddy	workbuddy	官方支持
Qoder CLI	qoder	官方支持

用户可以在设置面板中勾选启用哪些 agent，FanBox 会自动检查是否已安装，未安装的会提供一键复制安装命令。配置文件在 ~/.fanbox/config.json，agents 数组支持自定义命令或追加新 agent。

精确态势感知：Hooks 机制

FanBox 在启动 Claude Code / Codex 时会挂上官方的 hooks（只叠加一份自己的 settings 文件，不碰用户的原有配置）。这使得 agent 的状态不再靠猜终端文字，而是精确事件驱动：

• Working（正在工作）
• Needs Approval（需要人工确认）
• Needs Input（等待输入）
• Done（已完成）

这四种状态是精确事件而非模糊的终端文字解析。没有挂上 hooks 的 agent 退回到传统的文字判断模式。

三套皮肤：Volt / Index / Archive

FanBox 提供三套内置主题，分别适配不同场景：

• Volt：高对比度深色风格，适合长时间 coding
• Index：经典 macOS 风格，适合轻量浏览
• Archive：复古界面，适合管理旧项目

所有截图均为 Playwright 从实际运行的 App 中直接拍摄，不经过修图。

技术栈与开发体验

FanBox 基于 Electron + JavaScript 开发，使用 node-pty 实现真正的伪终端，复用成熟的 Web 技术栈：

• 渲染层：Electron WebView，内置 Milkdown（Markdown 渲染）、Highlight.js（代码高亮）、Marked（Markdown 解析）、DOMPurify（XSS 防护）
• 终端层：node-pty，连接真实的系统 PTY，支持所有终端程序
• 构建工具：esbuild 打包，electron-builder 打包 dmg/exe
• 包管理：npm，Node.js 18+

开发时只需 npm start 即可启动（node server.js），无需额外构建步骤。正式发布使用 electron-builder 打包为 macOS dmg 和 Windows exe。

项目遵循 MIT 许可证，由花叔个人维护，2026 年 6 月创建，2026 年 9 月活跃更新。

局限与争议

不支持 Linux：官方目前仅支持 macOS（Apple Silicon + Intel）和 Windows，Linux 用户无法使用。Electron 本身跨平台，但作者目前精力有限，仅提供 macOS 和 Windows 版本。

非通用 IDE：FanBox 的定位是驾驶舱，不是完整的开发环境。它不追求替代 VS Code 或 JetBrains 系列 IDE。如果你需要完整的调试、LSP、重构功能，仍然需要专用 IDE。FanBox 的核心价值在"轻量文件管理 + agent 指挥 + 改动追踪"这条链路。

agent 生态锁定：虽然支持 11 种 agent，但每种 agent 需要预先安装在系统中。FanBox 本身不包含任何 LLM 能力，完全依赖外部 agent。

hooks 机制限制：精确状态感知功能目前仅支持 Claude Code 和 Codex 对应的 hooks 规范，其他 agent 只能使用传统的终端文字判断。

行业意义：填补人机协作的界面鸿沟

FanBox 反映了一个更大的趋势：当 AI coding agent 的能力已经足够强时，下一个竞争维度是人机协作体验。2026 年，Claude Code、Codex、Cursor 等工具在纯 agent 能力上已经趋同，差异化竞争正在向"人与 agent 如何高效协作"转移。

FanBox 属于这一趋势中的"工具层"创新——不改变 agent 本身，而是改善人与 agent 共享工作空间时的信息透明度。对于频繁使用 coding agent 的开发者，FanBox 提供了一个更自然的交互界面：不用在 Finder、iTerm、Chrome 之间来回跳，一个窗口搞定所有。

其 1000 star 的增长轨迹（2026年6月创建，到9月已达1000 star）也说明这个痛点是真实存在的，而非伪需求。