pi-provider-trace

Pi 生态的 LLM 提供商网络请求透明追踪与可视化工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-provider-trace。
它的用途是:Pi 生态的 LLM 提供商网络请求透明追踪与可视化工具。
完整的 Skill 内容见:https://321skill.com/skills/pi-provider-trace/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

对 AI 说:“启用 pi-provider-trace 并打开 Web UI。”,它会启动本地监控服务并给出访问地址。然后,你在 Pi 中进行任何 LLM 对话或调用,都可以在 Web UI 中实时看到对应的网络请求详情、耗时和完整的请求响应体,就像给 LLM 对话装上了“网络抓包器”。

介绍

pi-provider-trace 是一个 Pi 扩展,旨在解决开发者在集成和使用不同大语言模型(LLM)提供商时,因网络请求不透明而导致的调试困难、性能监控缺失问题。它通过拦截并记录 Pi 与 LLM 提供商(如 OpenAI、Anthropic 等)之间的所有 HTTP 和 SSE 网络流量,让开发者能够清晰地看到请求与响应的原始数据、耗时和状态。

使用方式非常简单。开发者只需通过 npm 安装此扩展,并在 Pi 环境中启用它。启用后,该工具会自动在本地启动一个 Web UI 服务。开发者只需打开这个 Web 界面,即可实时查看或回顾所有经过 Pi 发往 LLM 提供商的 API 调用详情,包括请求头、请求体、响应头、响应流等完整信息。

这个工具非常适合 AI 应用开发者、集成工程师以及对 LLM 调用性能和可靠性有较高要求的团队。无论是调试复杂的提示词工程、排查 API 调用失败原因,还是分析不同模型或提供商的响应延迟,它都能提供关键的一手数据。

使用建议是,在开发和测试阶段强烈建议启用此工具以提升调试效率。需要注意的是,由于它会记录所有请求数据,在生产环境中使用需谨慎,避免敏感信息泄露。建议结合具体业务场景,评估其对性能的微小影响及数据安全风险。

核心特点

与同类日志工具相比,它深度集成于 Pi 框架,能无损捕获并可视化原始的 HTTP/SSE 网络层流量,而非仅仅记录应用层的日志;其提供的 Web UI 专为观察 LLM API 交互设计,支持对流式响应(SSE)的逐 token 追踪,这是许多通用代理工具所不具备的。

注意事项

不适合在生产环境长期开启用于性能监控,因其可能引入额外开销并记录敏感数据。

常见问题

pi-provider-trace 会影响 Pi 的正常运行速度吗?

会有轻微性能开销,主要用于开发和调试,不建议在生产环境持续使用。

它能追踪哪些 LLM 提供商的请求?

能追踪所有通过 Pi 框架发出的、支持 HTTP/SSE 协议的 LLM 提供商请求,如 OpenAI、Anthropic 等。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-provider-trace/raw/index.md 读取 pi-provider-trace 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。