@jsynowiec/pi-provider-logger

记录Pi平台所有Provider请求与响应的日志工具

安装使用

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

帮我安装这个 AI Skill:@jsynowiec/pi-provider-logger。
它的用途是:记录Pi平台所有Provider请求与响应的日志工具
完整的 Skill 内容见:https://321skill.com/skills/jsynowiec-pi-provider-logger/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“检查一下最近的天气查询结果”,它会调用天气Provider。此时,Skill会在界面弹出“Provider请求已记录”的通知,并同时在后台将这次查询的请求地址、参数以及返回的完整天气数据JSON,都写入到你电脑的日志文件中,方便你事后查看原始数据。

介绍

这个Skill是一个专为Pi平台设计的扩展工具,它解决了开发者在调试和监控AI Agent与外部数据源(Provider)交互时缺乏透明度和记录的问题。当Agent调用任何Provider(如天气、搜索、数据库等)时,原始请求和返回的响应数据往往一闪而过,难以回溯和分析。

使用方式非常简便。安装此Skill后,它会在后台自动运行,无需额外配置。每当有Provider被调用,它不仅会在Pi的用户界面弹出一个简短的通知,提示请求已发生,更重要的是,它会将完整的请求和响应数据(包括URL、参数、返回结果等)以结构化的格式(如JSON)记录到指定的本地文件中。

它非常适合Pi平台的开发者和高级使用者。对于开发者,这是调试Agent工作流、验证Provider返回数据准确性的利器;对于希望深入了解Agent决策过程或审计其外部交互的用户,它提供了宝贵的数据追踪能力。

需要注意的是,由于它会记录所有交互数据,其中可能包含敏感信息。建议仅在开发、测试或受信任的调试环境中使用,并妥善管理生成的日志文件,避免隐私泄露。对于生产环境,应评估其性能影响和日志存储策略。

核心特点

与仅提供简单控制台输出或UI提示的同类工具不同,它强制将所有Provider交互的完整载荷持久化存储到本地文件,为离线分析和问题复现提供了不可篡改的记录;同时,其通知与日志记录是自动且无侵入的,无需修改现有Skill代码。

注意事项

不适合对性能极其敏感或严格限制本地文件写入的生产环境。

常见问题

日志文件存在哪里?

默认保存在Pi运行目录或用户主目录下的特定文件中,具体路径请查看Skill文档。

会影响我的Skill运行速度吗?

会有轻微影响,因为涉及文件IO操作,在频繁调用Provider的场景下可能更明显。

给 AI 助手的安装指引

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

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