会话浏览器
通过多种视图浏览、组织和管理你的 Pi 会话。
会话浏览器是浏览 Pi 会话的主界面,提供四种不同的视图,分别针对不同的工作流进行了优化。
视图
列表视图
默认视图,按时间顺序展示所有会话。每个条目显示:
- 会话名称(自动生成或自定义)
- 项目目录
- 消息数量和时间戳
- 收藏星标和标签指示器
点击任意会话即可在会话查看器中打开。
项目视图
按工作目录(cwd)对会话进行分组。当你在多个代码库之间工作时,可以方便地查看特定项目的所有会话。
按 Cmd/Ctrl + P 切换到项目视图。
目录视图
按文件系统位置组织会话——当你配置了多个会话路径时特别有用。
看板视图
会话操作
收藏
为会话加星标,将其固定在任意视图的顶部。收藏状态通过 SQLite 数据库持久化,重启后依然保留。
重命名
右键点击会话或使用工具栏的重命名按钮(查看器中按 Cmd/Ctrl + R),为会话赋予有意义的名称。原始 JSONL 文件不会被修改——名称存储在数据库中。
批量导出
选择多个会话并批量导出。支持格式:HTML、Markdown、JSON。详见导出。
右键菜单
右键点击任意会话可快速执行操作:
- 在终端中打开
- 在文件浏览器中打开项目
- 切换收藏
- 分配标签
- 导出
- 删除(需确认)
搜索与过滤
统一的 SearchFilterBar 出现在每个视图的顶部,集成了:
- 文本搜索 — 按会话名称、首条/末条消息和项目目录过滤
- 标签过滤 — 带分组和后代过滤的下拉菜单
在任意位置按 Cmd/Ctrl + F 即可聚焦搜索输入框。
在移动端,过滤栏会自适应为紧凑布局,提供搜索和标签切换按钮。长按会话可打开右键菜单(替代桌面端的右键点击)。
多路径扫描
默认从 ~/.pi/agent/sessions/ 扫描会话。你可以在配置中添加额外目录,从多个位置扫描会话(如 Gateway 会话、项目特定路径等)。
增量更新
后端使用文件监听器进行增量扫描。当磁盘上的会话文件发生变化时,仅重新解析该文件并将差异推送到前端——无需完整重载。