用途:为 Angular 应用提供类似浏览器 Network 标签页的浮动 DevTools 面板,用于调试 LLM API 调用,无需离开浏览器即可查看提示词、响应、token 数、成本与流式数据。
主要能力:自动拦截 Angular 应用发出的 LLM 调用(fetch、HttpClient 或官方 SDK),自动识别服务商并解析请求/响应;按内置价格表计算每次调用成本;处理 SSE 流式响应并累积增量;展示工具/函数调用及参数;支持一键重放;跟踪首 token 时间与会话累计数据;可选跨刷新持久化历史;兼容任意 SDK 或原始 fetch。
使用方式:安装 npm install ngx-ai-devtools,要求 Angular 18.1+。在应用配置中调用 provideAiDevtools(),例如 provideAiDevtools({ enabled: !environment.production })。右下角会出现浮动启动按钮。可选配置包括 maxCalls、persist、position、redact、autoMount、additionalEndpoints。可通过 AiDevtoolsService 以编程方式访问 calls、filtered、selected、stats、ui 等信号,以及 clear()、setOpen()、select()、setFilter()、replay() 方法。autoMount 为 false 时可手动放置 <ngx-ai-devtools /> 组件。
适用场景:开发阶段调试提示词、追踪成本、检查流式行为、迭代 AI 功能,以及测试与 CI 中对成本或模型进行断言。
限制:生产环境应设置 enabled: false;Cohere 仅检测请求,响应与成本支持不完整;Gemini 流式支持为部分;未收录价格表的模型不显示成本;持久化可能占满 localStorage;SSR 场景需确保仅在客户端启用。