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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-provider-trace/raw/index.md(查看排版版本)