@alexeiled/pi-provider-compat
桥接Pi自定义provider到旧版兼容调度器
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@alexeiled/pi-provider-compat。 它的用途是:桥接Pi自定义provider到旧版兼容调度器 完整的 Skill 内容见:https://321skill.com/skills/alexeiled-pi-provider-compat/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的Pi扩展在升级到0.80后报错No API provider registered for api: router-local-api,请帮我安装兼容桥接解决。' 它会执行pi install npm:@alexeiled/pi-provider-compat,然后/reload,之后自动扫描provider并注册兼容调度器,错误消失。
介绍
这个Skill解决了Pi 0.80版本升级后,自定义provider注册与旧版全局pi-ai调度器不兼容的问题。许多使用pi.registerProvider()注册的provider在更新后会出现“No API provider registered”错误,影响模型路由、看门狗、后台命令等依赖streamSimple()的扩展功能。
使用方式很简单,只需执行pi install npm:@alexeiled/pi-provider-compat安装,然后执行/reload重启Pi。之后它会自动扫描所有已注册的provider,找到同时具有api和streamSimple属性的provider,并在兼容注册表中注册一个provider感知的调度器。调用时根据model.provider自动路由到正确的provider,且不会覆盖已存在的兼容provider。
它非常适合需要维护大量自定义provider的Pi扩展开发者,尤其是那些依赖旧版全局streamSimple()调用的团队或个人。对于已经迁移到新版provider作用域运行时的用户,则不需要此桥接。
建议在升级Pi到0.80.8及以上版本后,如果遇到provider注册相关报错,立即安装此工具。需要注意的是,它仅作为临时兼容方案,不会替换provider实现、不会注册凭据,也不改变模型路由逻辑。如果某个API本来就没有注册provider作用域的streamSimple实现,此桥接也无法生效。
常见问题
安装后仍然报No API provider registered错误
请确认你的provider注册时传入了api和streamSimple字段,且Pi版本≥0.80.8。如果provider本身没有streamSimple实现,桥接无法生效。
这个桥接会覆盖我已有的兼容provider吗
不会。它只会在兼容注册表中没有对应API的provider时进行注册,已有provider保持不变,其所有权和清理逻辑不受影响。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/alexeiled-pi-provider-compat/raw/index.md 读取 @alexeiled/pi-provider-compat 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/alexeiled-pi-provider-compat/raw/index.md(查看排版版本)