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