Ai Session Bridge

🚀 AI会话桥

AI会话桥是一款跨工具的AI对话历史读取器，它能让任何AI编码代理在同一工作空间中访问其他AI工具的对话历史，极大提升了工作效率和信息连贯性。

🚀 快速开始

AI会话桥是一个MCP（模型上下文协议）服务器和命令行工具，它允许AI编码助手从多个工具中读取对话历史。当你在VS Code Copilot、Cursor或Rovodev之间切换时，你的AI代理现在可以访问你正在处理的所有上下文，而无需每次都重新开始。

┌─────────────────────────────────────────────────────────────────────┐
│                         Your Workspace                               │
│  /Users/you/dev/my-project                                          │
└─────────────────────────────────────────────────────────────────────┘
                                    │
            ┌───────────────┬───────┼───────┬───────────────┐
            ▼               ▼       ▼       ▼
    ┌───────────┐   ┌───────────┐  ┌───────────┐
    │ Copilot   │   │ Cursor    │  │ Rovodev   │
    │ Sessions  │   │ Sessions  │  │ Sessions  │
    └─────┬─────┘   └─────┬─────┘  └─────┬─────┘
          └───────────────┴───────┬───────┴───────
                                  ▼
                  ┌───────────────────────────┐
                  │   ai-session-bridge       │
                  │   MCP Server + CLI        │
                  │                           │
                  │  Tools:                   │
                  │  - list_sessions          │
                  │  - get_session            │
                  │  - search_sessions        │
                  │  - get_recent_context     │
                  └───────────────────────────┘

✨ 主要特性

• 📚 统一会话读取：从VS Code Copilot、Cursor和Rovodev读取对话。
• 🔍 全文搜索：使用SQLite FTS5在所有对话中进行快速搜索。
• 🚀 MCP服务器：通过模型上下文协议公开会话历史。
• 💻 命令行工具：从命令行列出、搜索和导出会话。
• 🔒 安全保障：自动过滤API密钥、机密和敏感数据。
• ⚡ 高性能：智能缓存和索引，实现即时访问。
• 🎯 工作空间感知：自动将会话与当前工作空间匹配。

📷 截图

列出所有工具的会话

以简洁、有条理的表格格式查看所有AI对话：

工作空间感知搜索

搜索会考虑当前工作空间，精准找到你需要的内容：

会话详情

以正确的格式查看完整的对话历史：

📦 安装指南

生产环境使用（推荐）

使用pipx（隔离且全局可用）：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
pipx install .

这将全局安装ai-session-bridge，同时使其与系统Python隔离。

从PyPI安装（发布后）：

pipx install ai-session-bridge

开发环境设置

快速设置（自动化）：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
./setup.sh

设置脚本将：

• ✅ 创建虚拟环境
• ✅ 安装所有依赖项（可编辑模式）
• ✅ 设置预提交钩子
• ✅ 创建配置目录
• ✅ 测试安装
• ✅ 显示venv和pipx安装选项

手动设置：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
python3 -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

💻 使用示例

命令行工具使用

# 列出最近的会话
ai-session-bridge list

# 列出带有过滤器的会话
ai-session-bridge list --tool copilot --limit 5

# 显示完整对话
ai-session-bridge show <session-id> --tool copilot

# 在所有会话中搜索
ai-session-bridge search "bug fix"

# 清除缓存
ai-session-bridge cache clear

MCP服务器

将其添加到你的AI工具的MCP配置中：

如果你使用pipx安装（推荐）

VS Code Copilot（settings.json）：

{
  "servers": {
    "ai-session-bridge": {
      "command": "/Users/YOUR_USERNAME/.local/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

Cursor/Rovodev（~/.config/mcp/mcp.json）：

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "/Users/YOUR_USERNAME/.local/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

如果你使用venv（开发环境）

使用虚拟环境二进制文件的完整路径：

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "/absolute/path/to/ai-session-bridge/venv/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

提示：运行./setup.sh，它将显示你需要使用的确切路径！

PyPI发布后

使用uvx自动下载并运行：

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "uvx",
      "args": ["ai-session-bridge", "serve"]
    }
  }
}

📚 详细文档

MCP工具

配置完成后，你的AI助手将可以使用以下工具：

list_sessions

列出当前工作空间的所有AI会话。

{
  "workspace_path": "/path/to/workspace",
  "tool_filter": ["copilot", "rovodev"],
  "limit": 10
}

get_session

获取特定会话的完整对话。

{
  "session_id": "abc123",
  "tool": "copilot",
  "workspace_path": "/path/to/workspace"
}

search_sessions

在所有会话中搜索关键字。

{
  "query": "authentication bug",
  "workspace_path": "/path/to/workspace",
  "limit": 20
}

get_recent_context

从最近的会话中获取摘要上下文（有助于“继续上次未完成的工作”）。

{
  "workspace_path": "/path/to/workspace",
  "max_sessions": 3,
  "max_messages": 20
}

配置

创建~/.config/ai-session-bridge/config.yaml：

# 范围：包含哪些会话
scope:
  mode: current_workspace  # current_workspace, all_workspaces, specified
  workspaces: []  # 仅在mode为"specified"时使用

# 从哪些工具读取
tools:
  copilot: true
  cursor: true
  rovodev: true

# 缓存设置
cache:
  enabled: true
  max_age_days: 30

# 搜索索引
search:
  enabled: true
  use_fts: true  # 使用SQLite FTS5进行快速搜索

# 安全：过滤敏感内容
filtering:
  enabled: true
  patterns:
    - "(?i)(api[_-]?key|apikey)[\"']?\\s*[:=]\\s*[\"']?[a-zA-Z0-9_-]{20,}"
    - "(?i)(secret|password|token)[\"']?\\s*[:=]\\s*[\"']?[^\\s\"']{8,}"
  replacement: "[REDACTED]"

# MCP服务器设置
mcp:
  max_context_messages: 50
  max_context_sessions: 5

支持的工具

工作原理

会话发现

1. VS Code Copilot：扫描工作空间目录并读取workspace.json文件以匹配工作空间路径。
2. Cursor：从包含Composer对话的全局SQLite数据库（state.vscdb）中读取。
3. Rovodev：从每个会话文件的metadata.json中读取工作空间路径。

缓存与性能

• 会话缓存：存储元数据以避免重新解析未更改的文件。
• 搜索索引：使用SQLite FTS5进行即时全文搜索。
• 懒加载：仅在需要时加载完整的会话内容。

安全

自动过滤：

• API密钥和令牌
• 密码和机密
• 私钥
• AWS凭证
• GitHub/Slack令牌

示例

示例1：继续之前的工作

用户：“继续我们上次未完成的工作” AI使用get_recent_context获取最后几个会话及其消息，了解正在处理的内容。

示例2：查找相关讨论

用户：“我们在之前的对话中讨论过身份验证问题吗？” AI使用search_sessions并以“authentication”为查询词，在所有工具中查找相关消息。

示例3：回顾过去的解决方案

用户：“给我展示我们修复数据库连接问题的会话” AI使用search_sessions查找会话，然后使用get_session检索完整的对话。

🔧 技术细节

开发

# 克隆仓库
git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge

# 安装开发依赖项
pip install -e ".[dev]"

# 安装预提交钩子
pre-commit install

# 运行测试
pytest

# 运行代码检查
ruff check .

# 自动修复代码检查问题
ruff check --fix .

# 格式化代码
ruff format .

详细的开发指南请参阅CONTRIBUTING.md。

🗺️ 路线图

• [ ] 会话标签和分类
• [ ] 使用大语言模型进行自动摘要
• [ ] 用于浏览会话的Web UI
• [ ] 跨机器会话同步
• [ ] 支持更多AI工具（Continue、Windsurf等）
• [ ] 导出为各种格式（PDF、HTML）

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE。

👨‍💻 作者

Furkan Yıldız

🙏 致谢

• 受跨AI工具更好的上下文连续性需求启发
• 基于模型上下文协议构建