pi-hodor
为pi提供自动重连功能,应对临时网络错误。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-hodor。 它的用途是:为pi提供自动重连功能,应对临时网络错误。 完整的 Skill 内容见:https://321skill.com/skills/pi-hodor/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用pi开始监听这个WebSocket数据流,并实时分析。” 当网络出现短暂波动导致连接断开时,pi-hodor会自动尝试重新建立连接,确保监听和分析任务持续进行,无需你手动重启任务。
介绍
pi-hodor是一个专为pi设计的扩展,核心功能是自动处理在数据流传输或网络连接过程中出现的临时性错误。当pi在执行长时间任务或网络交互时,常因网络波动、服务端短暂中断等“瞬时错误”而意外停止,此扩展能自动检测并尝试恢复,确保任务流程不被中断。
使用方式非常简单,通过npm安装后,在启动pi时加载此扩展即可。它会在后台静默工作,无需用户手动干预。当检测到符合定义的“瞬时错误”(如连接超时、流中断)时,会自动进行重试,直至成功或达到预设的重试上限。
这个扩展非常适合那些依赖pi进行长时间、稳定网络请求或数据流处理的开发者、数据分析师和自动化脚本用户。例如,在爬取大量网页数据、监听实时API推送、执行耗时部署脚本时,它能有效减少因网络抖动导致的人工干预需求。
建议在已知网络环境不稳定或目标服务偶有波动的场景下启用。需要注意,它主要针对“瞬时”或“暂时性”错误,对于永久性错误(如无效API密钥、资源不存在)或逻辑错误无效。建议根据实际情况配置合理的重试次数和间隔,避免无限重试造成资源浪费。
核心特点
专为pi框架设计,精准识别并自动处理“瞬时流错误”和“连接错误”这两类特定故障,而非宽泛的通用错误重试。其重试逻辑深度集成于pi的流处理机制中,能更好地维持任务上下文和状态。
注意事项
不适合处理由代码逻辑错误、权限问题或永久性失效(如API端点变更)导致的失败。
常见问题
pi-hodor支持哪些类型的错误重试?
主要支持网络连接错误(如ECONNRESET, ETIMEDOUT)和HTTP/HTTPS流传输中的瞬时中断。
如何配置重试次数和间隔?
通常通过扩展的配置选项或在pi的启动参数中设置,具体请参考项目文档。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-hodor/raw/index.md 读取 pi-hodor 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-hodor/raw/index.md(查看排版版本)