第五部分,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