第四部分,Extensions 开发

状态、错误与 Project Trust

持久化扩展状态,处理 Session replacement、错误和项目信任边界。

状态跟随 Session

扩展可以 appendEntry 保存自定义条目,也可以发送 custom message。状态应能从 Session 历史重建,不要只留在模块级变量。

new、resume、fork、clone 和 switch 会替换 Session。扩展必须在对应生命周期中刷新引用,避免继续写旧 Session。

  • 持久数据使用带版本的 schema。
  • 会话切换前 flush 必要写入。
  • 加载失败时提供安全默认值。
  • 错误包含扩展名称和操作上下文。
  • 不在 UI 错误中输出凭据。

Project Trust

项目 Extensions 只有在信任后加载。信任只控制本地资源加载,不限制模型后续通过工具能做什么。

扩展可读取 ctx.isProjectTrusted,但不能把它误解为沙箱或安全审计通过。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License