Observability

Observability 技能是专为 PAI (个人 AI 基础设施) 设计的强大监控解决方案，能为复杂的多智能体环境提供深度、即时的可见性。通过利用由 Bun、Express 和 Vue 组成的高性能技术栈，它可以在不依赖繁重持久化数据库的情况下，捕捉 AI 系统的运行脉动。它专为需要掌控瞬时智能体会话、工具执行链及钩子驱动事件流的开发者与高级用户量身打造。当智能体自主运行时，此仪表板成为您观察其决策过程的窗口，记录从会话初始化到结束的每一个重要互动。

• 实时 WebSocket 流提供智能体活动的即时更新，确保您不会错过任何关键转换或工具调用执行。

• 无缝的底层文件系统监控功能可自动跟踪主要的 raw-outputs 事件日志，并实时显示会话时间轴与追踪记录。

• 轻量级且瞬时的架构避免了持久化层，完全在内存中运行，确保快速启动并将对系统性能的影响降至最低。

• 通过专用管理脚本实现全面的状态管理，仅需一条命令即可对后端服务器与前端 UI 进行启动、停止、重启及状态健康检查。

• 集成的钩子支持确保 PAI 钩子框架记录的所有内部系统事件，都能在 http://localhost:5172 的直观浏览器界面中呈现。

• 当您需要调试卡住的工作流、识别循环工具调用，或仅仅想监控智能体协作的效率时，请使用此技能。

• 系统将从 ~/.claude/history/raw-outputs/ 读取 JSONL 文件，并经由 4000 端口的服务器广播事件数据。

• 请确保您的 PAI 钩子已配置为将事件捕捉至每日 raw-outputs 文件中；本技能依赖此日志流来填充仪表板信息。

• 非常适合运行多个并发智能体的环境，对于理解操作序列或识别阻塞的工具调用以进行系统优化至关重要。