syncbridge-mcp

Syncbridge

你已经和 Claude 深入聊了 30 条消息。计划很完善。现在你需要在编辑器里实现它。于是你复制、粘贴，却丢失了一半上下文。编辑器不知道 Claude 了解什么。下次你回到 Claude 时，它也不知道编辑器做了什么。

Syncbridge 自动解决这个问题，完全免费，无需命令行。

---

问题

每个使用 AI 聊天的开发者每天都会遇到同样的繁琐操作：

• AI 给出一段包含 5 个代码块的长回复——你复制第 1 个代码块，切换到编辑器，粘贴，再切回来，滚动查找第 2 个代码块，然后复制、切换、粘贴，如此反复
• 你在编辑器里做了修改，想获得 AI 的反馈，于是复制代码，切换到浏览器，粘贴并提问
• 聊天内容太长，你开启一个新会话，然后从头重新解释整个项目
• 你有时用 ChatGPT，有时用 Claude，上下文从不会延续
• 你让 Claude 制定计划，再让 Cursor 实现，二者彼此不知道对方做了什么
• 你使用 Cursor——它可以把终端输出发送到自己的 AI 聊天，但无法自动将 AI 聊天回复发送回终端
• 你使用 Copilot 或 Windsurf——它们的 AI 与浏览器中的 AI 聊天之间完全没有桥梁

这就是复制粘贴的代价，而且每天都在累积。

Syncbridge 消除了这笔代价。

这是一个独立开发的项目，旨在解决日常困扰。结果发现，即使是资金充足、拥有专职 AI 编辑器的团队，也只解决了这个问题的一半。Syncbridge 能解决双向同步问题——而且适用于每个 AI 网站，不限于某个编辑器内置的聊天功能。

---

适用人群

你不需要命令行，不需要付费订阅，只需要一个浏览器。

人群	痛点	Syncbridge 能提供什么
使用免费 AI 聊天的开发者	整天在浏览器和编辑器之间复制粘贴	自动复制 + 一键注入
学生和编程训练营学员	每次开启新会话都要重新解释项目上下文	一键迁移上下文
自由职业者	在不同客户会话之间丢失上下文	在不同聊天中保留上下文
使用多种模型的用户	手动在 Claude、ChatGPT、Gemini 之间切换	在一个平台按 Alt+C，在另一个平台按 Alt+V
Claude Code / Cursor / Copilot CLI 用户	AI 聊天与 CLI 始终不同步	完整的双向自动同步
Cursor 用户	Cursor 支持从终端向 AI 发送内容，但缺少从 AI 向终端发送内容的功能	补齐缺失的方向，并支持任意浏览器 AI
Copilot 和 Windsurf 用户	浏览器中完全没有终端↔AI 桥接功能	与任意 AI 聊天网站实现完整双向同步
内容创作者和技术写作者	整天把 AI 草稿复制粘贴到编辑器中	自动复制，无需来回切换
注重成本的开发者	Claude Code CLI 太贵	Chrome 扩展完全免费
VS Code 高级用户	总是在寻找更好的 AI 工作流工具	30 秒内安装，立即可用

永久免费。无需 API 密钥。无需订阅。无需命令行。

---

快速开始

路径 A——仅使用 Chrome 扩展（无需命令行）

1. 克隆或下载此仓库
2. 前往 chrome://extensions → 启用 Developer mode → Load unpacked → 选择 chrome-extension/ 文件夹
3. 前往任意受支持的 AI 网站，提出问题，回复就会自动复制到剪贴板
4. 在任意其他 AI 网站按 Alt+V 注入内容

就这么简单。无需 VS Code 扩展，无需命令行，无需配置。

Chrome Web Store 版本即将推出。

路径 B — 完整同步（Chrome + VS Code + CLI）

1. 安装 VS Code 扩展：在扩展面板中搜索“Syncbridge”
2. 加载 Chrome 扩展（与路径 A 步骤 2 相同）
3. 按 Ctrl+Shift+A（Mac：Cmd+Shift+A）→ 选择项目文件夹
4. 按 Ctrl+Shift+E（Mac：Cmd+Shift+E）→ 部署文件监视器钩子
5. 按 Ctrl+Shift+S（Mac：Cmd+Shift+S）→ 打开 Syncbridge 面板
6. 在终端中从项目文件夹运行 claude（或你的 CLI）

准备就绪。向 AI 提问即可，Syncbridge 会处理其余事项。

---

功能

Syncbridge 通过两个独立层工作，可使用其中一个或两个：

仅 Chrome 扩展 — 人人可用，无需 CLI：

• AI 回复完成时自动将其复制到剪贴板
• 按 Alt+C 手动复制，按 Alt+V 将内容注入任意 AI 输入框
• 按一个快捷键即可在 Claude、ChatGPT、Gemini、Grok、Mistral、Perplexity、Copilot 之间切换上下文
• 即使小组件处于隐藏状态，也会显示绿色提示，确认已复制

VS Code 扩展 + Chrome 扩展 — 完整双向同步：

• AI 回复自动复制 → 按一个快捷键即可将其发送到 CLI 指令文件
• CLI 运行任务 → VS Code 面板实时显示每项操作
• 上下文迁移会重建会话，方便开始新聊天

支持的 AI 聊天界面（Chrome 扩展）：

• Claude.ai
• ChatGPT
• Google Gemini
• Perplexity
• Grok (x.ai)
• Mistral
• Microsoft Copilot

支持的编码 CLI（VS Code 扩展）：

• Claude Code（通过钩子实现完整自动同步）
• Cursor
• GitHub Copilot CLI
• Windsurf
• Aider
• 自定义（用户定义的文件名）

---

截图

问题 — 在 AI 和 CLI 之间手动复制粘贴

解决方案 — Syncbridge 自动复制 AI 回复

两种模式 — 浮动小组件和带提示通知的隐藏模式

隐藏模式 — 小组件隐藏时，绿色提示会确认已自动复制

CLI 实时状态 — CLI 运行时，VS Code 面板会实时更新

---

工作原理

AI → CLI — 向 AI 提问。Chrome 扩展会在回复完成时自动复制内容。在 VS Code 中按 Ctrl+Shift+X（Mac：Cmd+Shift+X），将其写入指令文件。在 Claude Code CLI 中运行 /sync 执行。

CLI → AI — Claude Code CLI 运行任务，钩子会在每次写入文件和执行 bash 命令后自动更新 claude-state.md。VS Code 面板会实时显示这些更新。复制状态并粘贴到任意 AI 聊天中，即可在完整上下文下继续对话。

上下文迁移 — 聊天内容变长时，点击 Syncbridge 面板中的 ⟳ Regenerate。它会将最近的指令和最近 10 项 CLI 操作合并成结构化的迁移提示词。粘贴到新聊天中，AI 就能从中断处准确继续。

---

架构

• VS Code 扩展 — 侧边栏面板、文件监视器、状态栏、剪贴板桥接、项目钩子部署
• Chrome 扩展 — 浮动小组件界面、各 AI 平台的网站适配器、回复完成时自动复制
• MCP 服务 — 通过 MCP 工具与 Claude Code CLI 集成（可选）

---

安装

VS Code 扩展

从 Marketplace 安装： 在扩展面板中搜索“Syncbridge”，然后点击 Install。

从 .vsix 文件安装：

code --install-extension syncbridge-0.1.0.vsix

Chrome 扩展

开发者模式（现已可用）：

1. 下载或克隆此仓库
2. 前往 chrome://extensions
3. 启用开发者模式
4. 点击 Load unpacked → 选择 chrome-extension/ 文件夹

Chrome 网上应用店： 正在审核中 — 即将推出。

MCP 服务（Claude Code CLI）

claude mcp add syncbridge npx syncbridge-mcp

可用的 MCP 工具：

• update_state — 将 CLI 状态推送到 Syncbridge
• read_instructions — 拉取最新的 AI 指令
• get_context — 获取合并后的完整上下文
• clear_state — 为新会话重置状态

---

VS Code 扩展

命令

命令	描述
Syncbridge: Open Panel	在第二列打开同步面板
Syncbridge: Send Clipboard to CLI	将剪贴板内容写入指令文件
Syncbridge: Set Active Project	设置活动项目文件夹
Syncbridge: Setup Project	将文件监视器钩子部署到当前项目

面板 UI

在 VS Code 的第二列中打开。显示三个控制文件的实时内容，并提供：

• 每个文件对应一个 复制 按钮
• ⟳ Regenerate context.md — 根据当前状态重新生成迁移提示词
• ⚠ Clear all control files — 重置全部三个文件

每当磁盘上的状态文件发生变化，面板都会自动刷新。

状态栏

在状态栏中显示最近的 CLI 操作。点击即可打开 Claude.ai 使用情况页面。 当 claude-state.md 发生变化时自动更新，无需手动重新加载。

activeCli 设置

Syncbridge 会根据你使用的 CLI 调整控制文件名称。

前往 VS Code 设置 → 搜索“syncbridge” → 设置 Active CLI：

设置	指令文件	状态文件	上下文文件
claudecode（默认）	claude-ai.md	claude-state.md	claude-context.md
cursor	cursor-ai.md	cursor-state.md	cursor-context.md
copilot	copilot-ai.md	copilot-state.md	copilot-context.md
windsurf	windsurf-ai.md	windsurf-state.md	windsurf-context.md
aider	aider-ai.md	aider-state.md	aider-context.md
custom	用户定义	用户定义	用户定义

非 Claude Code CLI 会在面板中显示琥珀色横幅——这些 CLI 的状态文件必须手动更新。

---

Chrome 扩展

功能

• 纤薄的右侧边缘浮动小组件——悬停即可展开，点击标签页即可固定打开
• 可沿右侧边缘垂直拖动
• 悬停时点击 X 按钮即可从页面移除小组件——它会在后台静默运行
• 可通过 Chrome 扩展栏中的工具栏弹出窗口显示/隐藏浮动小组件
• AI 回复完成时自动将回复复制到剪贴板（每条回复复制一次）
• 绿色提示通知确认自动复制，即使小组件隐藏时也可见
• 提供站点适配器，使用各站点专属选择器读取输出并注入输入

支持的站点

Claude.ai · ChatGPT · Google Gemini · Perplexity · Grok · Mistral · Microsoft Copilot

---

键盘快捷键

快捷键（Windows/Linux）	快捷键（Mac）	位置	操作
Ctrl+Shift+S	Cmd+Shift+S	VS Code	打开 Syncbridge 面板
Ctrl+Shift+X	Cmd+Shift+X	VS Code	将剪贴板发送到指令文件
Ctrl+Shift+A	Cmd+Shift+A	VS Code	设置活动项目
Ctrl+Shift+E	Cmd+Shift+E	VS Code	设置当前项目（部署钩子）
Alt+C	Option+C	Chrome	将 AI 回复复制到剪贴板
Alt+V	Option+V	Chrome	将剪贴板内容注入 AI 输入框

重新映射 VS Code 快捷键：

• 编辑 package.json 中的 contributes.keybindings，重新编译并重新安装
• 或使用 VS Code 内置编辑器：Ctrl+K Ctrl+S（Mac：Cmd+K Cmd+S）

重新映射 Chrome 快捷键： 编辑 chrome-extension/src/bot.js 中的 keydown 监听器，然后在 chrome://extensions 中重新加载。

---

控制文件

首次激活时，所有三个文件都会自动创建在工作区根目录中。 文件名会根据你的 activeCli 设置进行调整（见上文）。

文件（claudecode 默认）	方向	用途
claude-ai.md	AI → CLI	来自聊天的指令；/sync 会读取并执行
claude-state.md	CLI → AI	每次写入文件和执行 bash 命令后，由钩子自动更新
claude-context.md	共享	迁移提示词；通过 ⟳ Regenerate 按钮重新生成

---

上下文迁移

当聊天过长或上下文开始偏离时使用。

步骤：

1. 点击 Syncbridge 面板中的 ⟳ Regenerate context.md
2. 将最近的指令和最近 10 条 CLI 操作合并为结构化提示词
3. 复制 claude-context.md 的内容
4. 粘贴到新聊天中 — AI 会从你离开的地方准确接续

适用场景：

• 聊天回复开始偏离或准确性下降
• 同一项目开始新的一天
• 在会话中途切换 AI 模型

---

文件监视器 Hook

该 Hook 配置在 .claude/settings.json 中，并会在 Claude Code CLI 每次写入文件和执行 bash 命令后自动触发。

部署到项目：在 VS Code 中按 Ctrl+Shift+E（Mac：Cmd+Shift+E）。

手动复制到其他项目：

cp .claude/settings.json <project>/.claude/

Hook 捕获：

✓ HH:MM:SS wrote <file_path>
✓ HH:MM:SS ran: <command>

---

多文件夹工作区

工作区有多个根文件夹时，活动根文件夹按以下顺序确定：

1. 包含当前打开文件的文件夹
2. 通过 Ctrl+Shift+A（Mac：Cmd+Shift+A）设置的文件夹
3. 作为回退选项的工作区列表中的第一个文件夹

---

路线图

• 首次运行时自动检测已安装的 CLI
• 在 Chrome 网上应用店公开发布
• 面向新用户的入门引导
• 更多 AI 平台适配器
• 改进上下文迁移，支持令牌感知

---

要求

• VS Code 1.100.0 或更高版本
• Node.js v18+
• 至少一个受支持的 CLI（Claude Code、Cursor、Copilot CLI、Windsurf 或 Aider）
• 用于 Chrome 扩展的 Chrome 或基于 Chromium 的浏览器

---

扩展测试运行器

测试位于 src/test/extension.test.ts — 共 7 项确定性测试，涵盖控制文件创建、写入稳定性、追加顺序、上下文重新生成和扩展激活。

运行方法：点击 VS Code 侧边栏中的烧杯图标（Testing）→ 按 ▷ Run All Tests。

打包前必须通过所有测试。

---

开发

使用 VS Code Extension API + Claude Code CLI，通过基于 SEP 的确定性工作流构建。

代码仓库：https://github.com/rehmansherazi/syncbridge

---

已知限制

• Chrome 扩展的网站适配器使用回退选择器链 — 能适应细微的 DOM 变化，但网站重大改版可能需要更新
• 文件监视器 Hook 需要通过 Ctrl+Shift+E（Mac：Cmd+Shift+E）在每个项目中手动设置
• 自动同步 Hook 仅适用于 Claude Code CLI — 其他 CLI 需要手动更新状态文件
• CLI 同步要求 CLI 从已部署 Hook 的项目目录中运行

---

隐私

Syncbridge 不会在外部服务器上收集、传输或存储任何用户数据。

• 剪贴板访问仅用于读取 AI 回复，并将上下文写入项目文件
• 存储权限仅在浏览器本地保存小组件的可见状态
• 不进行分析、跟踪或遥测
• 数据不会离开你的设备
• 所有处理均在浏览器、VS Code 和终端之间本地完成

如有问题，请联系：[email protected]