AI Flight Recorder：开源 AI 会话录制与回放调试工具

AI Flight Recorder 是一款开源的 AI 应用开发调试工具，旨在为开发者提供类似浏览器 DevTools 的可视化能力，用于录制、回放并审查 AI 会话中的每一次交互，包括 prompt、流式 token、工具调用、延迟与成本等关键信息。项目已在 Hacker News 以 Show HN 形式发布。

核心功能

工具围绕「一次安装、全程录制」的设计思路，开发者只需通过一行 SDK 包裹现有客户端，即可获得结构化的事件流与可暂停、可回放的时间轴视图。主要能力包括：

会话录制：将 prompt、token、工具调用与 completion 捕获为结构化事件流
流式回放：支持 0.25× 至 8× 倍速控制，实时回放会话
时间轴与瀑布图：可视化请求完整生命周期，包括并行工具调用与流式延迟
成本分析：按会话拆分 token 使用量与估算花费
检索与过滤：按事件类型或关键字在时间轴内筛选
.flight 文件导出/导入：以可移植文件形式分享会话，供他人本地回放
插件与传输系统：支持自定义观察者与多种存储后端（内存、文件系统或自建 API）
OpenTelemetry 导出：可将任意会话转换为 OTLP trace payload，接入 Jaeger、Grafana Tempo、Honeycomb 等兼容后端

架构与适配器

项目采用 monorepo 结构组织，核心代码与应用层分离：

core/：领域模型，包括事件、会话、录制器与回放引擎
sdk/：面向开发者的 API、Provider 适配器、插件与传输层
apps/devtools/：基于 Next.js 的可视化 DevTools 应用
apps/vscode/：用于编辑 .flight 文件的 VS Code 扩展
examples/：分别提供 OpenAI、Anthropic、Google Gemini 的集成示例

SDK 内置三家主流 Provider 的一行式包裹适配器，覆盖流式与非流式调用场景：

OpenAI：通过 wrapOpenAI 包裹客户端，自动记录 chat.completions.create 调用
Anthropic：通过 wrapAnthropic 拦截 messages.create，支持 Claude 系列模型
Google Gemini：通过 wrapGeminiModel 包裹 GenerativeModel，适配 generateContent

所有适配器均支持流式输出，开发者无需改动现有业务逻辑即可启用录制。

快速上手

环境要求为 Node.js 18+ 与 pnpm 10+。克隆仓库后执行 pnpm install 安装依赖，pnpm dev 启动 DevTools 应用，访问 http://localhost:3000 即可看到内置的两段演示会话，无需配置 API Key。运行 pnpm smoke 可执行端到端集成冒烟测试，覆盖录制、插件、传输、序列化与回放等环节，共 40 项断言。

小结

AI Flight Recorder 填补了 AI 应用开发中「事后拼凑控制台日志」的空白，把会话级录制、回放与成本分析整合到统一的 DevTools 体验中，并可通过 OpenTelemetry 与现有可观测性栈打通。对于正在构建多 Provider、长会话或复杂工具调用链路的团队来说，这是一个轻量、可扩展的可观测性补充方案。