Context Sync

🚀 上下文同步：🧠 AI 開發的記憶層

Context Sync 是一個開源基礎設施，它為所有開發工具、會話和項目中的 AI 系統提供持久的內存，解決了 AI 系統在對話間丟失上下文的問題，極大提升了開發效率。

🚀 快速開始

安裝

# 全局安裝
npm install -g @context-sync/server

測試使用

重啟你的 AI 工具（如 Claude Desktop、Cursor、VS Code），然後詢問："help me get started with context-sync"，Context Sync 會自動配置並通過自然語言指令引導你完成首次設置。

不同平臺的快速設置

VS Code + GitHub Copilot

1. 完全重啟 VS Code。
2. 打開 Copilot 聊天（Ctrl+Shift+I / Cmd+Shift+I）。
3. 切換到代理模式（如果可用）。
4. 在工具列表中查找 context-sync。
5. 測試：詢問 Copilot "help me get started with context-sync"。

Cursor

在安裝 Context Sync 後，在 Claude Desktop 中輸入：

setup cursor

Claude 會給出特定於操作系統的指令。

Claude Desktop

1. 完全重啟 Claude Desktop。
2. 開始新對話。
3. 測試：詢問 Claude "help me get started with context-sync"，Claude 會自動完成配置。

不同平臺的手動設置

VS Code + GitHub Copilot

無額外手動設置說明。

Cursor

1. 打開 Cursor：Settings → MCP。
2. 添加以下配置：

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

3. 刷新 MCP 服務器。
4. 測試："Help me get started with context-sync"。

Claude Desktop

Windows：

# 編輯配置文件
notepad "%APPDATA%\Claude\claude_desktop_config.json"

macOS：

# 編輯配置文件
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Linux：

# 編輯配置文件
nano ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

重啟 Claude Desktop 並測試："Help me get started with context-sync"。

✨ 主要特性

解決 AI 上下文丟失問題

AI 系統在對話間會丟失上下文，開發者需要反覆解釋代碼庫、架構決策和項目上下文。Context Sync 為 AI 系統創建了持久、可查詢的內存，解決了這一問題。

類似 AI 記憶的版本控制

它就像 AI 上下文的分佈式版本控制，讓每個 AI 工具都能共享相同的內存，例如：

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Claude.ai     │    │   Cursor IDE    │    │   VS Code       │
│   (Web & App)   │    │                 │    │   + Copilot     │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          │           MCP Protocol (standardized)       │
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                     ┌───────────▼────────────┐
                     │    Context Sync        │
                     │   Memory Layer         │
                     │                        │
                     │  • Project Context     │
                     │  • Code Understanding  │
                     │  • Decision History    │
                     │  • Architecture Maps   │
                     │  • File Operations     │
                     │  • Git Integration     │
                     └────────────────────────┘

支持 Notion 集成

v1.0.3 版本新增了與 Notion 的集成，通過交互式設置嚮導可輕鬆完成配置：

# 安裝 Context Sync
npm install -g @context-sync/server

# 運行設置嚮導
context-sync-setup

嚮導會引導你完成以下步驟：

1. 打開瀏覽器到 Notion 的集成頁面。
2. 逐步引導（只需複製/粘貼 2 個值）。
3. 自動測試連接。
4. 為你保存所有設置。

集成特性包括：

• 🔍 搜索你的 Notion 工作區。
• 📖 以正確格式讀取和更新頁面。
• 📝 自動創建新文檔。
• 🎯 導出決策為架構決策記錄（ADRs）。
• 📊 生成包含技術棧和架構的項目儀表盤。
• ✨ 支持 Markdown - 在 Notion 中創建漂亮、格式化的頁面。

分佈式 AI 記憶

Context Sync 使用模型上下文協議（MCP）在你和 AI 系統之間創建一個持久的知識層，其架構如下：

Your Development Environment
┌─────────────────────────────────────────────────────────┐
│  IDE/Editor        AI Tool           Browser/Web        │
│  ┌───────────┐    ┌───────────┐     ┌─────────────┐    │
│  │  Cursor   │    │  Claude   │     │ Claude.ai   │    │
│  │  VS Code  │    │  Desktop  │     │  Web app    │    │
│  │  Vim/etc  │    │  Copilot  │     │  Other AIs  │    │
│  └─────┬─────┘    └─────┬─────┘     └──────┬──────┘    │
└────────┼──────────────────┼─────────────────┼───────────┘
         │                  │                 │
         └──────────────────┼─────────────────┘
                            │ MCP Protocol
                            │
┌───────────────────────────▼─────────────────────────────┐
│              Context Sync (Open Source)                 │
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐ │
│  │   Memory    │  │   Files     │  │    Git & Code   │ │
│  │  • Projects │  │  • Read     │  │  • Status       │ │
│  │  • Context  │  │  • Write    │  │  • Diffs        │ │
│  │  • History  │  │  • Search   │  │  • Analysis     │ │
│  └─────────────┘  └─────────────┘  └─────────────────┘ │
│                                                         │
│            Local SQLite Database (~/.context-sync/)    │
└─────────────────────────────────────────────────────────┘

其主要優勢包括：

• 通用兼容性：與任何支持 MCP 的 AI 工具兼容。
• 本地所有權：所有數據存儲在本地機器上。
• 無供應商鎖定：開源且可擴展。
• 智能緩存：僅在 AI 需要時加載詳細信息。

獨特的優勢

通用 AI 記憶層

Context Sync 不僅僅是一個工具，更是一種基礎設施，類似於代碼的 Git 版本控制，它是 AI 知識的版本控制：

• 分佈式：每個 AI 工具都能共享相同的內存。
• 本地優先：數據由你控制，保障隱私。
• 平臺無關：與任何支持 MCP 的 AI 工具兼容。
• 可擴展：開源架構支持無限定製。

目前支持的平臺包括：

• ✅ Claude Desktop (Mac/Windows/Linux)
• ✅ Cursor IDE
• ✅ VS Code + GitHub Copilot
• ✅ Continue.dev
• ✅ Windsurf
• ✅ Zed Editor
• ✅ TabNine
• ✅ 任何支持 MCP 的 AI 工具
• 🔄 更多平臺通過社區貢獻定期添加。

智能上下文管理

項目感知上下文：

• 自動檢測和初始化項目。
• 識別技術棧（如 TypeScript、React、Python 等）。
• 跟蹤架構決策並記錄推理過程。
• 理解和分析代碼結構。

高效內存使用：

• 每個項目使用 1 - 3K 個令牌（而非完整的對話轉儲）。
• 按需查詢（AI 根據需要請求詳細信息）。
• 使用結構化摘要而非原始聊天記錄。
• 不會使上下文窗口飽和。

開發者關注的特性：

• 文件操作（讀取、寫入、搜索）並帶有審批工作流。
• Git 集成（狀態、差異、分支）。
• 依賴分析和調用圖跟蹤。
• 跨項目跟蹤的 TODO 管理。
• 代碼符號搜索和類型分析。

隱私優先架構

• 100% 本地存儲：數據存儲在本地的 SQLite 數據庫中。
• 無雲依賴：（可選基於 Git 的同步）。
• 無跟蹤或分析：不使用服務器。
• 開源透明：可審計每一行代碼。
• 無供應商鎖定：可隨時導出數據。

📦 安裝指南

全局安裝

npm install -g @context-sync/server

Notion 集成安裝

# 安裝 Context Sync
npm install -g @context-sync/server

# 運行設置嚮導
context-sync-setup

💻 使用示例

自由開發者工作流示例

週一上午（Cursor）

You: "Initialize project 'EcommerceClient' - Next.js 14, Stripe, PostgreSQL"
AI: "Project created! ✓"
*Build product catalog for 3 hours*

週二下午（Claude Desktop）

You: "Continue EcommerceClient - add shopping cart"
AI: "Adding cart to your Next.js app with Stripe integration.
     Using the product schema we defined yesterday..."

週三（Cursor）

You: "Switch back to Cursor. Review cart implementation"
AI: "Analyzing cart code... found 2 potential improvements..."

📚 詳細文檔

常見問題解答

為什麼 Claude 本身沒有內置這個功能？

主要是商業激勵的原因。如果 Claude 能完美記住所有內容，開發者的對話會更短，使用的消息更少，達到速率限制的速度也會更慢，這可能會降低 AI 公司的利潤。而 Context Sync 是開源的，以本地優先，由社區驅動開發。

這會填滿我的上下文窗口嗎？

不會。Context Sync 每個項目僅使用 1 - 3K 個令牌，它存儲結構化摘要，AI 按需查詢詳細信息，不會將所有內容一次性加載到新對話中。

我的數據安全和隱私有保障嗎？

數據 100% 存儲在本地（SQLite 數據庫），無需依賴雲服務（可選基於 Git 的同步），無跟蹤或分析，開源透明，可隨時刪除數據（只需刪除 ~/.context-sync/）。

它能與 VS Code 一起使用嗎？

可以，自 v0.6.0 版本起支持。安裝步驟如下：

1. 安裝 Context Sync：npm install -g @context-sync/server。
2. 重啟 VS Code。
3. 打開 Copilot 聊天。
4. 切換到代理模式。
5. 在工具列表中查找 context-sync。

它能與 Claude Code CLI 一起使用嗎？

自 v0.6.0 版本起也支持。Claude Code 支持 MCP，集成應該很簡單。目前的優先級是：

1. VS Code 擴展。
2. Claude Code CLI。
3. 更好的入門引導。

我可以在移動設備上使用嗎？

目前還不支持。移動設備使用需要 Claude 移動應用支持 MCP（目前不可用）或開發自定義移動應用（計劃未來實現）。當前的解決方法是在移動設備上使用 Claude.ai 網頁版（只讀），僅桌面端支持完整功能。

這需要花費多少錢？

Context Sync 是 100% 免費且開源的（MIT 許可證）。可能需要支付的費用包括：

• Claude Pro 訂閱（推薦但非必需）。
• 安裝設置所需的時間（約 2 分鐘）。

如果我有多個項目怎麼辦？

Context Sync 可以很好地處理多個項目，例如：

You: "Switch to my blog project"
AI: [loads blog context instantly]

You: "List my projects"
AI: 
  1. TaskFlow (Next.js + Supabase)
  2. Personal Blog (Astro)
  3. Client Website (WordPress)

You: "Switch to TaskFlow"
AI: [back to TaskFlow context]

每個項目都有自己獨立的架構決策、技術棧、TODO 列表、代碼上下文和對話歷史。

路線圖

高級特性

項目管理

• 初始化和切換項目。
• 跟蹤架構和技術棧。
• 存儲帶有推理的設計決策。
• 管理 TODO 和優先級。

代碼分析

• 依賴圖分析。
• 函數調用跟蹤。
• 類型定義查找。
• 查找所有引用。
• 影響分析。

文件操作

• 讀取項目結構。
• 搜索文件和內容。
• 修改文件（需審批）。
• 應用更改前預覽。

Git 集成

• 查看狀態和差異。
• 分支信息。
• 提交消息建議。
• 更改跟蹤。

跨平臺

• 無縫的 Cursor ↔ Claude 同步。
• 特定平臺優化。
• 上下文切換自動化。

開發者工具

• 50 + MCP 工具。
• 可擴展架構。
• TypeScript + SQLite。
• 開源。

參與貢獻

為什麼要貢獻？

• 塑造 AI 工具標準：幫助定義 AI 系統應如何處理持久內存。
• 解決自身問題：構建滿足自己工作流程的功能。
• 學習前沿技術：使用 MCP、TypeScript、SQLite 和 AI 集成技術。
• 加入變革運動：推動 AI 開發工具真正開放和可擴展。

貢獻方式

代碼貢獻：

• 為新的 AI 平臺（如 Gemini、Ollama 等）添加支持。
• 實現新的分析工具（如 Python 依賴跟蹤等）。
• 為更多編輯器（如 Vim、Emacs 等）構建集成。
• 優化性能和內存使用。

非代碼貢獻：

• 編寫文檔和教程。
• 測試 beta 功能並報告 bug。
• 分享用例和工作流程。
• 在討論中幫助其他開發者。
• 創建示例項目和模板。

社區建設：

• 向其他開發者分享 Context Sync。
• 撰寫關於使用體驗的博客文章。
• 在會議或聚會上發言。
• 參與路線圖規劃。

當前優先事項

• [ ] Python 生態系統支持 - pip、poetry、需求分析。
• [ ] 移動/網頁集成 - React Native、Expo、網頁開發工作流程。
• [ ] Docker/容器化 - 容器化應用的工作區檢測。
• [ ] 更多 Git 集成 - PR 分析、提交消息生成。
• [ ] 性能優化 - 更快的工作區掃描、更好的緩存。
• [ ] UI/儀表盤開發 - 用於內存管理的網頁界面。

開始貢獻

1. 給倉庫加星以表示支持。
2. 加入討論分享想法並獲取幫助。
3. 閱讀 CONTRIBUTING.md 瞭解技術指南。
4. 選擇一個標記為 good-first-issue 或 help-wanted 的問題。
5. 提交 PR - 我們會快速審核並提供反饋。

故障排除

Claude Desktop 找不到 Context Sync

1. 驗證安裝：

context-sync --version

2. 檢查配置文件：

# Mac/Linux
cat ~/.config/Claude/claude_desktop_config.json

# Windows
type %APPDATA%\Claude\claude_desktop_config.json

3. 完全重啟 Claude：

• Mac: ⌘ + Q（強制退出）
• Windows: 右鍵單擊任務欄圖標 → 退出

4. 在 Claude 設置中檢查 MCP 服務器，查找 Context Sync。

如果仍然遇到問題，創建一個 issue。

Cursor 找不到 Context Sync

1. 打開 Cursor 設置：Settings → MCP。
2. 驗證配置是否存在：

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

3. 刷新 Cursor 中的 MCP 服務器。
4. 測試：詢問 AI "What's my current project?"。

“No active project” 錯誤

先設置工作區：

You: "Set workspace to /path/to/your/project"

或者檢查現有項目：

You: "What projects do I have?"
You: "Switch to [project-name]"

平臺間上下文不同步

1. 檢查平臺狀態：

You: "Check platform status"

2. 驗證兩個平臺都已配置。
3. 嘗試手動同步：

You: "Sync context to Cursor"

更多幫助請參考 TROUBLESHOOTING.md。

🔧 技術細節

Context Sync 使用模型上下文協議（MCP）在開發者和 AI 系統之間創建一個持久的知識層。它通過本地的 SQLite 數據庫存儲數據，實現了數據的本地存儲和管理。在架構上，它連接了各種開發環境（如 IDE、AI 工具、瀏覽器等），使得不同的 AI 工具能夠共享相同的上下文信息。同時，它還具備智能緩存和按需查詢的功能，提高了系統的性能和效率。

📄 許可證

Context Sync 採用 MIT 許可證，允許商業使用、自由修改和公開再分發。它是真正的開源項目，沒有雙重許可方案，沒有 “企業版” 與 “社區版” 之分，沒有功能付費牆或訂閱層級，也沒有專有擴展或鎖定的生態系統。選擇 MIT 許可證是因為 AI 工具基礎設施應該屬於開發者社區，而不是企業。