Voyager 上下文同步Context Sync把 Gemini 网页会话「传输」到 VS Code 的实操指南【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager传输记忆上下文同步实验性是 Voyager 增强套件内置的一项实验性能力。它通过本地 IDE 中的 CoBridge 扩展作为桥梁把你在 Gemini、AI Studio 等网页端已经讨论成熟的对话上下文——包括复杂的数据表格和参考图片——一键同步到 VS Code / Trae / Cursor 等本地编辑器中让 IDE 中的 AI 助手Copilot、Cursor、Trae 内置助手无需重新解释需求即可直接继承网页端的「思考过程」。读完本文你将掌握从安装 CoBridge、端口握手到一键同步的完整流程并能结合源码理解其底层传输机制与可配置项。为什么需要「上下文同步」网页是大脑IDE 是双手开发者最头疼的场景之一在 Gemini 网页端与 AI 长时间讨论一套解决方案后回到 VS Code / Trae / Cursor却要向本地 AI 重新解释一遍需求仿佛面对一个陌生人。由于响应配额与速度的差异网页端往往承担「思考」brain的职责而 IDE 承担「执行」hands的职责。Voyager 的 Context Sync 让两者共享同一份「灵魂」——不再需要反复横跳标签页。这一功能在仓库中的定位很清晰前端设置界面位于 ContextSyncSettings.tsx核心传输逻辑位于 SyncService.ts页面内采集逻辑位于 content/contextSync整体属于实验性特性英文文案中亦标注为 Context Sync。三步完成同步从安装到落地第一步安装并启动 CoBridgeCoBridge 是连接网页端与本地 IDE 的中央桥接扩展需要在 VS Code 中安装。安装完成后打开任意工作目录点击右侧图标启动本地同步服务器。启动服务器后它会监听一个本地 HTTP 端口默认 3030用于接收来自浏览器扩展的数据。从源码看这个端口既不是写死的魔法数字也不是用户不可见的配置在 SyncService.ts 中定义了private readonly DEFAULT_PORT 3030端口值通过chrome.storage.sync中的contextSyncPort键读取取不到时回退到默认值 3030getServerUrl。第二步连接与握手端口对齐在 Voyager 弹窗设置中启用「Context Sync」将 Voyager 中配置的端口与 CoBridge 服务器端口对齐默认均为 3030当状态指示变为「IDE Online」时表示握手成功。关于连接状态的检测源码给出了非常明确的实现细节ContextSyncSettings.tsx前端会对http://127.0.0.1:{port}/sync发起一次GET请求超时时间为 200ms使用AbortController中止启用状态时每5 秒轮询一次连接状态绿色圆点表示在线、红色表示离线端口输入框限定在1–65535的合法端口范围越界会自动收敛见 handlePortChange。值得注意的细节是连接检测与同步请求并非由页面直接发起而是通过浏览器扩展的 background 以消息gv.checkSyncStatus/gv.syncToIDE转发其注释明确写着 bypasses page CSP绕过页面内容安全策略见 background/index.ts。这是为了规避 Gemini 等站点对跨域请求的 CSP 限制保证本地回环请求可以正常发出。第三步一键同步点击「Sync to IDE」按钮Voyager 会执行以下调用链content/contextSync/index.ts弹窗向当前标签页发送{ action: sync_to_ide }消息ContextSyncSettings.tsx内容脚本侧的ContextCaptureService调用captureDialogue()采集当前对话——包括对话节点文本与图片SyncService.syncToIDE(data)将数据以 JSON 形式POST到本地服务器SyncService.tsbackground 侧执行真正的fetch(url, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify(data) })background/index.ts。采集到的数据结构可以从 types.ts 中看到每个DialogNode包含页面 URL、CSS 类名、文本内容、图片数组images?: string[]、AI/用户归属判断is_ai_likely/is_user_likely以及元素位置矩形。也就是说复杂的数据表格、参考图片都会作为对话节点一并采集并同步与官方文档中「无论是数据表格还是参考图片都能即时同步到 IDE」的描述完全一致。在 IDE 中落地.cobridge 目录结构同步完成后IDE 工作目录会出现.cobridge/AI_CONTEXT.md文件以及用于存放同步图片的images/子目录。Trae、Cursor、Copilot 会通过各自的规则文件Rule files自动读取这份「记忆」your-project/ ├── .cobridge/ │ ├── images/ │ │ ├── context_img_1_1.png │ │ └── context_img_1_2.png │ └── AI_CONTEXT.md ├── .github/ │ └── copilot-instructions.md ├── .gitignore ├── .traerules └── .cursorrules这份AI_CONTEXT.md是完整的 Markdown 格式对 IDE 中的 AI 而言阅读它就像阅读一份操作手册一样顺畅——这正是该功能「适配 AI」AI-friendly设计目标的体现。页面适配原理从选择器到通用回退网页结构千差万别Voyager 如何判断哪些 DOM 节点属于对话内容答案是「适配器」机制定义在 adapters/index.ts对gemini.google.com使用精确选择器用户消息取div.user-query-containerAI 回复取.response-content对其他站点default适配器采用更通用的策略遍历div、p等通用容器再通过ai/assistantAI 侧与user/human用户侧等标记词判断归属匹配规则为「主机名包含即命中」getMatchedAdapter(host)逐个比对站点键未命中时回退到默认适配器getMatchedAdapter。这种「精确适配 通用回退」的双层设计使得功能在核心站点上可以获得高质量的结构化采集同时保持对其他网页的基本可用性。弹窗对非内置支持页面如非 gemini.google.com / chatgpt.com / claude.ai会给出提示但仍尝试同步ContextSyncSettings.tsx。设计原则与使用建议零污染Zéro pollutionCoBridge 会自动维护工作目录的.gitignore确保私人对话内容永远不会被提交到 Git 仓库——同步产出的.cobridge/目录默认处于忽略状态。适配 AIAI_CONTEXT.md采用完整 Markdown 格式便于 IDE 内 AI 像读操作手册一样高效读取。建议如果对话时间较久建议先用 Voyager 的 时间线Timeline 功能回滚网页端上下文让网页端「回忆」起相关语境以获得更好的同步效果。常见问题排查一直显示「IDE Offline」确认 CoBridge 服务器已启动、端口与 Voyager 设置中的端口一致默认 3030并确认弹窗端口输入在 1–65535 合法范围内同步失败提示服务器无响应检查本地127.0.0.1:{port}/sync是否可访问background 中的错误会以HTTP {status}或网络异常消息形式回传background/index.ts找不到.cobridge/AI_CONTEXT.md确认同步按钮已点击且显示「Synced successfully!」并检查当前 VS Code 窗口打开的是否为期望的工作目录。小结Voyager 的上下文同步通过「浏览器扩展采集对话 → background 转发本地请求 → CoBridge 服务器写入.cobridge/」这条链路实现了网页端与 IDE 之间的记忆传输。理解其端口配置、握手检测和选择器适配机制后你不仅能顺畅完成三步骤同步也能在遇到问题时快速定位原因。网页端负责思考IDE 负责落地——「大模型不再失忆即可立即行动」。【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
