pi-retry-empty
Pi 扩展：自动重试空模型响应，避免静默中断
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-retry-empty。 它的用途是：Pi 扩展：自动重试空模型响应，避免静默中断 完整的 Skill 内容见：https://321skill.com/skills/pi-retry-empty/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我写一个天气查询的Agent，但需要确保如果模型偶尔返回空响应时能自动重试。' 它会推荐安装 pi-retry-empty 扩展，并在 Pi 配置中添加 'extensions: ["pi-retry-empty"]'，然后重试次数设为 3。之后代理在调用天气 API 时若遇到模型空响应，扩展会自动重试最多 3 次，避免任务静默失败。
介绍
在开发基于大语言模型的应用时，模型偶尔会返回“空响应”——即没有文本、没有工具调用、输出 token 为零，但以 clean stop 结束。这种响应通常不会触发错误，而是让运行流程静默终止，导致任务中断而不留痕迹。
pi-retry-empty 是一个 Pi 框架扩展，它在检测到模型返回空响应后，会自动进行有限次数的重试（默认次数可配置），直到获得有效输出或达到重试上限。使用方式简单：安装后，在 Pi 配置中启用该扩展即可，无需修改现有代码逻辑。
该扩展特别适合使用 Pi 框架构建复杂 Agent 或工作流的开发者，尤其是那些需要高可靠性、长时间运行的任务场景。例如：自动化数据采集、多步骤推理、工具调用链等。如果你曾因模型偶尔“沉默”而导致任务失败，这个扩展能显著提升鲁棒性。
建议根据实际任务对延迟的容忍度调整重试次数（如 2-3 次）。注意：本扩展仅重试“空响应”（clean stop 且无输出），不会处理因内容过滤、长度限制等导致的异常终止。对于其他类型的模型错误，建议配合错误处理机制使用。
核心特点
区别于通用的重试中间件，pi-retry-empty 专门针对模型返回空响应但无错误码的场景（clean stop + 零输出 token），且与 Pi 框架深度集成，不干扰其他正常响应。
注意事项
不适用于模型返回错误码或内容被截断（如 max_tokens 限制）导致的空输出，也无法处理网络超时等底层异常。
常见问题
重试次数可以配置吗？
可以，重试次数通过 Pi 扩展配置项设定，默认通常为 3 次，具体可参考仓库 README 中的参数说明。
什么情况下模型会返回空响应？
常见原因包括模型内部临时故障、采样策略极端（如 temperature 过低导致概率坍塌）、或某些清理逻辑导致输出被丢弃。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-retry-empty/raw/index.md 读取 pi-retry-empty 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-retry-empty/raw/index.md（查看排版版本）