pi-phoenix
为pi编码代理添加可视化追踪能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-phoenix。 它的用途是：为pi编码代理添加可视化追踪能力 完整的 Skill 内容见：https://321skill.com/skills/pi-phoenix/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'安装pi-phoenix，连接到本地Phoenix服务，并追踪我的pi会话'，它会自动通过pi安装扩展，配置环境变量PHOENIX_COLLECTOR_ENDPOINT=http://localhost:6006，然后启动pi。之后每次执行编码任务时，你可以在Phoenix页面查看每个会话的详细调用链，包括模型输入输出、工具执行结果和系统提示。
介绍
这个Skill解决了AI编码代理调试困难的问题。在使用pi编码代理进行复杂任务时，开发者往往难以观察模型调用、工具执行和系统提示的内部流程，导致问题排查费时费力。pi-phoenix通过OpenInference协议将追踪数据发送到Arize Phoenix，让开发者可以直观地查看每个会话的完整调用链。
使用方式很简单，你只需要先通过pi安装该扩展，然后运行一个本地或云端的Phoenix服务。安装命令为pi install npm:pi-phoenix，之后通过环境变量配置Phoenix端点（默认本地localhost:6006）。启动pi后，所有代理会话的追踪数据会自动上报，你可以在Phoenix Web界面中按会话、按步骤查看详细的追踪信息，包括模型响应、工具调用、系统提示等。
它非常适合需要调试和优化AI编码代理行为的开发者和团队。尤其是那些使用pi作为核心编码工具、希望深入理解代理决策过程、或需要监控Token消耗和调用延迟的用户。对于需要审计代理行为或排查复杂Bug的场景，这个Skill能极大提升效率。
建议在本地开发环境中先以Docker方式运行Phoenix（docker run -d -p 6006:6006 arizephoenix/phoenix:latest），待稳定后再接入云端。需要注意的是，它主要面向pi编码代理，不适用于其他代理框架，且需要确保pi版本兼容。如果使用OpenRouter模型，还可以通过npx pi-phoenix-sync-openrouter同步模型定价信息，实现精确的成本追踪。
常见问题
如何安装pi-phoenix？
可以通过pi安装：`pi install npm:pi-phoenix` 或 `pi install github:philipbjorge/pi-phoenix`。也可以从本地目录安装。安装后需要配置环境变量连接Phoenix服务。
如何查看追踪数据？
启动Phoenix服务（本地Docker：`docker run -d -p 6006:6006 arizephoenix/phoenix:latest`），然后运行pi，打开浏览器访问http://localhost:6006即可看到会话概览和追踪详情。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-phoenix/raw/index.md 读取 pi-phoenix 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-phoenix/raw/index.md（查看排版版本）