Pi Session Manager

Pi Session Manager

基于 Tauri + Rust + React 的 Pi 会话管理工具，支持桌面端、无头服务端，以及独立静态 Demo 页面。

Releases · English · Demo · 数据集版

核心功能

• 会话浏览：列表/项目/看板、收藏、标签、重命名、删除、导出。
• 全文检索：基于 SQLite FTS5 与规范化索引，支持精确短语搜索。
• 会话内消息搜索：命中高亮、结果分页跳转、可配置 Cmd/Ctrl+F 行为。
• 会话恢复：内置 PTY 终端，一键恢复 Pi 会话。
• 外部会话 — 扫描和管理来自其他编程 Agent（Claude、OpenCode 等）的会话，统一设置界面控制扫描开关和默认恢复目标。
• 数据集浏览器 — 从 HuggingFace 下载并浏览会话数据集，支持本地缓存、搜索、标签、收藏和统计分析。
• 多协议访问：Tauri IPC、WebSocket、HTTP、SSE。
• 完整 Demo 数据引擎 + 独立静态 Demo 页面构建模式。
• 内置多语言包：en-US、zh-CN、ja-JP、de-DE、fr-FR、es-ES。
• Pi Live 集成：实时同步 Pi agent 活动状态，支持模型切换和思考过程控制。
• 分析仪表盘：活动热力图、Token 趋势、子代理成本统计。

技术架构

Frontend: React + TypeScript + Vite
Backend: Rust + Tauri 2 + Axum + SQLite + FTS5

Protocols: Tauri IPC | WebSocket (/ws) | HTTP (/api) | SSE

四层设计

Commands (thin) <- Tauri IPC / HTTP / WS
Domain (business) <- model_config, session_list, stats, terminal
Data <- search (SQLite FTS5 normalized index) sqlite (cache)
Server (protocol) <- HTTP adapter, WebSocket adapter

技术栈

代码规模

界面预览

首页	会话页

会话树	看板

快速开始

环境要求

• Node.js 20+
• Rust stable（建议通过 rustup 安装）
• Tauri 平台依赖（Xcode / WebView2 / WebKitGTK）

安装

git clone https://github.com/Dwsy/pi-session-manager.git
cd pi-session-manager
pnpm install

常用脚本

运行模式

CLI 参数

• -p, --port <PORT>：HTTP+WS 共享端口（默认 52131）
• -b, --bind <ADDR>：监听地址
• --auth / --no-auth：开启/关闭鉴权
• --token <TOKEN>：运行时 token

服务端接口

数据与配置路径

文档中的 ~/.pi/... 表示“当前用户家目录下的 .pi”。macOS / Linux / Windows 都在运行时按用户 home 目录展开，不是硬编码绝对路径。

扩展系统

Pi 插件

extensions/pi-session-bridge/index.ts

工具渲染插件

src/plugins/tools-render/
├── builtins/    # bash, edit, read, write, generic
└── extensions/  # subagent, ...

搜索插件

src/plugins/
├── message/     # 消息内搜索
├── project/     # 项目搜索
└── session/     # 会话搜索

键盘快捷键

会话视图

开发指南

开发检查

cargo fmt --all --check
cd src-tauri && cargo clippy -- -D warnings
cargo clippy -p pi-session-cli -- -D warnings
cd src-tauri && cargo test

添加新命令

1. 业务逻辑 -> src-tauri/src/domain/
2. 命令层 -> src-tauri/src/commands/
3. 路由注册 -> src-tauri/src/dispatch.rs
4. Tauri 注册 -> src-tauri/src/lib.rs

详细教程请参阅 agent-docs/03-backend.md。

文档索引

许可证

MIT