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工具更好的上下文連續性需求啟發
• 基於模型上下文協議構建