Pi Session Manager

会话浏览器

通过多种视图浏览、组织和管理你的 Pi 会话。

会话浏览器是浏览 Pi 会话的主界面,提供四种不同的视图,分别针对不同的工作流进行了优化。

视图

列表视图

默认视图,按时间顺序展示所有会话。每个条目显示:

  • 会话名称(自动生成或自定义)
  • 项目目录
  • 消息数量和时间戳
  • 收藏星标和标签指示器

点击任意会话即可在会话查看器中打开。

项目视图

按工作目录(cwd)对会话进行分组。当你在多个代码库之间工作时,可以方便地查看特定项目的所有会话。

Cmd/Ctrl + P 切换到项目视图。

目录视图

按文件系统位置组织会话——当你配置了多个会话路径时特别有用。

看板视图

基于标签将会话组织到列中的拖拽式看板。详见看板页面。

会话操作

收藏

为会话加星标,将其固定在任意视图的顶部。收藏状态通过 SQLite 数据库持久化,重启后依然保留。

重命名

右键点击会话或使用工具栏的重命名按钮(查看器中按 Cmd/Ctrl + R),为会话赋予有意义的名称。原始 JSONL 文件不会被修改——名称存储在数据库中。

批量导出

选择多个会话并批量导出。支持格式:HTML、Markdown、JSON。详见导出

右键菜单

右键点击任意会话可快速执行操作:

  • 在终端中打开
  • 在文件浏览器中打开项目
  • 切换收藏
  • 分配标签
  • 导出
  • 删除(需确认)

搜索与过滤

统一的 SearchFilterBar 出现在每个视图的顶部,集成了:

  • 文本搜索 — 按会话名称、首条/末条消息和项目目录过滤
  • 标签过滤 — 带分组和后代过滤的下拉菜单

在任意位置按 Cmd/Ctrl + F 即可聚焦搜索输入框。

在移动端,过滤栏会自适应为紧凑布局,提供搜索和标签切换按钮。长按会话可打开右键菜单(替代桌面端的右键点击)。

多路径扫描

默认从 ~/.pi/agent/sessions/ 扫描会话。你可以在配置中添加额外目录,从多个位置扫描会话(如 Gateway 会话、项目特定路径等)。

增量更新

后端使用文件监听器进行增量扫描。当磁盘上的会话文件发生变化时,仅重新解析该文件并将差异推送到前端——无需完整重载。

目录