会话文件

本文档详细描述了 Pi AI 编程代理的会话文件格式。会话以 JSONL 文件形式存储，每行是一个包含 type 字段的 JSON 对象，通过 id 和 parentId 形成树形结构，支持原地分支。文档介绍了文件位置、版本迁移、消息类型（用户、助手、工具结果、bash 执行、自定义等）以及各种条目（会话头、消息、模型更改、思考级别更改、压缩、分支摘要、自定义条目等）。还解释了上下文构建算法和 SessionManager API 的关键方法。适合需要解析会话文件或为 Pi 编写扩展的开发者。

本文介绍了Pi（一个AI编程代理）的会话管理功能，包括会话的自动存储、恢复、命名、分支（/tree）、分叉（/fork）和克隆（/clone）操作，以及会话树形结构的使用。详细说明了通过命令行和交互模式管理会话，如继续最近会话、浏览历史、设置名称、导出HTML、分享为GitHub Gist等。还涵盖分支摘要功能，帮助保留上下文。会话文件采用JSONL格式，包含消息、模型更改、标签、压缩等条目。