上下文同步

Name: 上下文同步
Author: Intina47

作者：Intina4745 星标更新：2025-11-19

安装使用来源：spider==github.com

项目介绍

Context Sync

<div align="center"> <h1>🧠 用于AI开发的记忆层</h1>

终于，AI有了记忆。

Context Sync 是开源基础设施，它赋予AI系统在所有开发工具、会话和项目中持久的记忆。

# AI辅助开发的未来
npm install -g @context-sync/server

本地优先 • 开源 • 平台无关 • 由开发者为开发者构建

</div> ---

支持：

<img src="https://img.shields.io/badge/Cursor-Supported-00D4AA?style=for-the-badge&logo=cursor&logoColor=white" alt="Cursor"> <img src="https://img.shields.io/badge/Claude%20Desktop-Supported-6366f1?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Desktop"> <img src="https://img.shields.io/badge/VS%20Code-Supported-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="VS Code"> <img src="https://img.shields.io/badge/GitHub%20Copilot-Supported-24292e?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Copilot">  <img src="https://img.shields.io/badge/Continue.dev-Supported-1F8ACB?style=for-the-badge&logo=continue-dot-dev&logoColor=white" alt="Continue.dev">  <img src="https://img.shields.io/badge/Windsurf-Supported-FF6F61?style=for-the-badge&logo=windsurf&logoColor=white" alt="Windsurf">  <img src="https://img.shields.io/badge/TabNine-Supported-4A90E2?style=for-the-badge&logo=tabnine&logoColor=white" alt="TabNine">  <img src="https://img.shields.io/badge/Zed-Supported-000000?style=for-the-badge&logo=zed&logoColor=white" alt="Zed">

每个开发者面临的难题

AI系统在对话之间丢失上下文。你需要花费数小时解释代码库、架构决策和项目背景……然后关闭聊天，第二天从头开始。

记忆丧失的问题影响所有人：

自由职业者同时管理多个客户项目
团队构建复杂应用程序
在不同工具上维护开源项目的人员
使用AI进行严肃开发工作的任何人

这不仅仅是不方便——这是根本性的缺陷。

Context Sync：AI记忆的GitHub

Context Sync 在所有开发环境中创建持久且可查询的记忆层。

想象它是分布式版本控制的AI上下文：

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Claude.ai     │    │   Cursor IDE    │    │   VS Code       │
│   (Web & App)   │    │                 │    │   + Copilot     │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          │           MCP协议（标准化）                   │
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                     ┌───────────▼────────────┐
                     │    Context Sync        │
                     │   内存层               │
                     │                        │
                     │  • 项目上下文          │
                     │  • 代码理解            │
                     │  • 决策历史            │
                     │  • 架构图              │
                     │  • 文件操作            │
                     │  • Git集成             │
                     └────────────────────────┘

每个AI工具都获得相同的共享内存。

为什么是开源？

AI记忆不应该被企业控制。

Context Sync 是由厌倦了以下问题的开发者构建的：

在AI对话之间丢失上下文
被锁定在一个单一的AI平台
对自己的开发数据没有控制权
为基本的记忆功能支付订阅费用

我们的理念：

本地优先：您的数据保留在您的机器上
平台无关：与任何支持MCP的AI兼容
社区驱动：由开发者为开发者构建
可扩展性：开放架构，无限定制

快速入门

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

# 重启您的AI工具（Claude Desktop，Cursor，VS Code）
# 然后询问：“帮助我开始使用context-sync”

就是这样。 Context Sync 自动配置并引导您完成首次设置，提供自然语言指令。

🎯 观察问题的实际效果

在使用Context Sync之前：

周一 - Claude Desktop：
您："我正在用TypeScript构建一个React应用，使用Supabase进行身份验证......"
Claude：*帮助了2个小时*

周二 - 新的聊天：
您："继续我的React应用的工作"
Claude："哪个React应用？你能描述一下你的项目吗？"
您：*花了20分钟重新解释一切*

在使用Context Sync之后：

周一 - Claude Desktop：
您："我正在用TypeScript构建一个React应用，使用Supabase进行身份验证......"
Claude：*帮助了2个小时*

周二 - 新的聊天（或不同的AI工具）：
您："继续我的React应用的工作"
Claude："继续您的带有Supabase身份验证的TypeScript React应用。我们接下来要做什么？"

这就是持久AI记忆的力量。

🚀 两分钟内开始

# 1. 安装Context Sync
npm install -g @context-sync/server

# 2. 重启您的AI工具（Claude Desktop，Cursor，VS Code）

# 3. 请求帮助设置
"帮助我开始使用context-sync"

Context Sync 自动检测您的平台，并通过个性化指令引导您完成设置。

📖 需要详细的文档吗？ 查看 Context Sync v1.0.0 综合文档，获取完整的设置指南、故障排除和高级配置。

🔧 平台特定设置

<details> <summary>VS Code + GitHub Copilot</summary> <details> <summary>VS Code快速设置（30秒）</summary>

全局安装Context Sync后：

完全重启VS Code
打开Copilot聊天（Ctrl+Shift+I / Cmd+Shift+I）
切换到代理模式（如果可用）
查找context-sync在工具列表中
测试：询问Copilot "帮助我开始使用context-sync"

Context Sync 应该出现在可用工具中！✨

</details>

🔧 Cursor 设置

<details> <summary>Cursor快速设置（30秒）</summary>

安装Context Sync后，在Claude Desktop中键入：

setup cursor

Claude 将为您提供特定于操作系统的说明！✨

</details> <details> <summary>手动设置Cursor</summary>

打开Cursor：设置 → MCP
添加此配置：

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

刷新MCP服务器
测试："帮助我开始使用context-sync"

完成！✅

</details> </details> <details> <summary>Claude Desktop</summary> <details> <summary>Claude Desktop快速设置（30秒）</summary>

全局安装Context Sync后：

完全重启Claude Desktop
启动新的对话
测试：询问Claude "帮助我开始使用context-sync"

Claude 将自动配置自己！✨

</details> <details> <summary>手动设置Claude Desktop</summary>

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并测试："帮助我开始使用context-sync"

</details> </details> <details> <summary>Continue.dev（VS Code扩展）</summary> <details> <summary>Continue.dev快速设置（30秒）</summary>

全局安装Context Sync后：

在VS Code中安装Continue.dev扩展
完全重启VS Code
打开Continue聊天（Ctrl+Shift+M / Cmd+Shift+M）
测试：询问Continue "帮助我开始使用context-sync"

Context Sync 应作为MCP工具可用！✨

</details> <details> <summary>手动设置Continue.dev</summary>

打开Continue配置：~/.continue/config.yaml
添加MCP服务器配置：

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

重启VS Code
测试："帮助我开始使用context-sync"

</details> </details> <details> <summary>Windsurf IDE</summary> <details> <summary>Windsurf快速设置（30秒）</summary>

全局安装Context Sync后：

打开Windsurf设置 → MCP
添加新服务器，名称为context-sync
命令：npx
参数：-y @context-sync/server
保存并重启Windsurf
测试：询问Windsurf "帮助我开始使用context-sync"

</details> </details> <details> <summary>Zed Editor</summary> <details> <summary>Zed快速设置（30秒）</summary>

全局安装Context Sync后：

打开Zed设置（Cmd+, / Ctrl+,）
导航到MCP部分
添加服务器：
- 名称：context-sync
- 命令：npx
- 参数：["-y", "@context-sync/server"]
重启Zed
测试：询问Zed助手 "帮助我开始使用context-sync"

</details> </details> <details> <summary>TabNine</summary> <details> <summary>TabNine快速设置（30秒）</summary>

全局安装Context Sync后：

打开TabNine设置
导航到MCP服务器
添加新服务器：

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

重启您的编辑器
测试：询问TabNine "帮助我开始使用context-sync"

</details> </details>

工作原理：分布式AI记忆

Context Sync 使用模型上下文协议（MCP）在您和AI系统之间创建一个持久的知识层。

架构：

您的开发环境
┌─────────────────────────────────────────────────────────┐
│  IDE/编辑器        AI工具           浏览器/网页        │
│  ┌───────────┐    ┌───────────┐     ┌─────────────┐    │
│  │  Cursor   │    │  Claude   │     │ Claude.ai   │    │
│  │  VS Code  │    │  Desktop  │     │  Web app    │    │
│  │  Vim/etc  │    │  Copilot  │     │  其他AI     │    │
│  └─────┬─────┘    └─────┬─────┘     └──────┬──────┘    │
└────────┼──────────────────┼─────────────────┼───────────┘
         │                  │                 │
         └──────────────────┼─────────────────┘
                            │ MCP协议
                            │
┌───────────────────────────▼─────────────────────────────┐
│              Context Sync（开源）                       │
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐ │
│  │   内存      │  │   文件      │  │    Git & 代码   │ │
│  │  • 项目     │  │  • 读取     │  │  • 状态         │ │
│  │  • 上下文   │  │  • 写入     │  │  • 差异         │ │
│  │  • 历史     │  │  • 搜索     │  │  • 分析         │ │
│  └─────────────┘  └─────────────┘  └─────────────────┘ │
│                                                         │
│            本地SQLite数据库（~/.context-sync/）         │
└─────────────────────────────────────────────────────────┘

关键优势：

通用兼容性：适用于任何启用MCP的AI
本地所有权：所有数据保留在您的机器上
零供应商锁定：开源且可扩展
智能缓存：仅在需要时加载AI所需的内容

Context Sync与其他解决方案有何不同

🌍 通用AI记忆层

Context Sync 不仅仅是一个工具——它是基础设施。

就像Git对代码一样，Context Sync 是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的同步）
无跟踪或分析（我们甚至没有服务器！）
开源透明度（审计每一行代码）
零供应商锁定（随时导出您的数据）

Context Sync vs. 现有解决方案

根本区别：Context Sync 是基础设施，而不是产品。

其他方法：

基于聊天的解决方案：存储对话→变得臃肿和缓慢
特定平台的工具：将您锁定在一个AI工具中
基于云的服务：您的数据在别人的服务器上
专有解决方案：无法定制，缺乏透明度

Context Sync 方法：

记忆基础设施：结构化的、可查询的知识库
通用兼容性：适用于任何启用MCP的AI
本地优先：您的数据保留在您的机器上
开源：社区驱动的开发和定制

互补而非竞争：

与Claude Pro结合使用以获得更多每日消息
与/compact一起使用以压缩对话
增强现有AI工具而不是替换它们

上下文同步

项目介绍

Context Sync

每个开发者面临的难题

Context Sync：AI记忆的GitHub

为什么是开源？

快速入门

🎯 观察问题的实际效果

🚀 两分钟内开始

🔧 平台特定设置

🔧 Cursor 设置

工作原理：分布式AI记忆

Context Sync与其他解决方案有何不同

🌍 通用AI记忆层

🧠 智能上下文管理

🔒 首先考虑隐私的架构

Context Sync vs. 现有解决方案

💬