第五部分,Skills、模板与 Packages
自定义 Provider、OAuth 与流式 API
通过 Extension 注册自定义 Provider、模型、Auth Header、OAuth 和非标准流式协议。
Provider 注册层次
pi.registerProvider 可以覆盖现有 Provider 或注册新的 Provider,声明模型、API 类型、端点、认证和兼容性。企业代理网关通常只需标准 API 配置,完全非标准协议才需要自定义 streamSimple。
OAuth 实现需要登录回调、凭据存储、刷新和注销。不要在 Extension 日志中输出 token。
- 优先使用内置 API 类型。
- 准确上报 usage、cost 和 stop reason。
- 识别 context overflow 并给出可恢复错误。
- 工具调用增量必须保持合法事件顺序。
- 用错误、取消和网络中断测试流式实现。
测试与兼容
Provider 不只要能返回文本,还要验证 reasoning、图片、工具调用、重试、取消和模型切换。
覆盖内置 Provider 时要记录差异,避免更新 Pi 后静默改变行为。
官方资料
本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。
Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License。