项目云端同步插件与 Skill

GitHub 项目地址：https://github.com/bypassdesign-dev/babelbird-plugins。点击可查看最新使用说明、支持平台和项目更新；已发布版本见 版本发布记录。

「项目云端同步巴别鸟插件」是 MCP 的一个应用，用于同步智能体的本地项目／工程目录，方便换设备、换智能体后继续工作。 它通过巴别鸟 MCP 传输文件，但与“接入 MCP”不是一回事：MCP 提供访问云端文件的工具，插件和 Skill 负责确定同步目录、执行同步流程，并处理更新和冲突。

表格可左右滚动查看

适合哪些场景

• 自动保存工程：让 Codex 或 WorkBuddy 修改代码、设计稿、文档后，将符合同步规则的文件保存到巴别鸟，减少手动上传。
• 换电脑继续工作：在新电脑连接同一账号，指定原来的云端工程目录，恢复到新的本地目录，再继续修改。
• 换智能体继续工作：把 Codex 创建的工程交给 WorkBuddy 或其他已适配平台，继续绑定原来的云端目录，不为同一工程另建副本。
• 保存 AI 的文件记忆：工程中的项目说明、任务记录、指令和写入文件的记忆，可以与工程一起保存。新智能体恢复后，可读取这些文件了解项目背景。

这里的“AI 本地记忆保存”指保存在工程文件中、且符合同步规则的内容。插件不会自动迁移聊天记录、模型临时上下文、应用私有数据库或工程目录以外的记忆；不同智能体也可能需要你明确要求它读取这些文件。Git 忽略及文件排除规则仍然生效，账号密钥不随工程同步。

新手上手：安装、填 Key、开启同步

1. 在正在使用的智能体中发送下面的安装指令。无需自己找 Skill 目录或编辑配置。
2. 在巴别鸟“设置 > API秘钥”中，准备一个访问范围为 完整、文件元数据与内容读写权限均已开启的 API Key，再填入自动打开的本地设置页，点击“保存并连接”。未打开时，点击智能体给出的“填写 API Key”链接；复用已有连接时也要核对这些权限。获取 Key 的方法见 巴别鸟 MCP 的 API Key 图文步骤。
3. 连接检查通过后，在需要保存的本地工程中发送“为当前工程启用巴别鸟自动同步”。仅安装和连接账号不会上传工程。

帮我安装以下插件，并连接我的巴别鸟账号：
https://github.com/bypassdesign-dev/babelbird-plugins

为当前工程启用巴别鸟自动同步。
开始修改前拉取更新，每批修改完成后上传，结束前检查同步结果。

以上本地设置页适用于下表的六款桌面／CLI 宿主，需要 Node.js 20+，且浏览器与设置助手运行在同一台电脑。环境检查由智能体完成。Key 只填在密码框，不发到聊天；WorkBuddy 的第三方 MCP 权限需你在应用内批准。若提示重新打开会话以加载连接，按提示操作并复用已保存的 Key。

默认目录为 个人文件/平台名称/工程名/，例如 Codex 使用 个人文件/codex/工程名/，WorkBuddy 使用 个人文件/workbuddy/工程名/。使用本插件或配套 Skill，MCP 的 API Key 必须授予“完整”访问权限，并开启文件元数据和内容的读写权限；“应用程序文件夹”授权不适用。 当前账号也必须有权访问“个人文件”和目标工程目录。已绑定或明确指定的云端目录优先使用，但仍需满足上述授权要求。

自动同步发生在智能体工作期间：编辑前拉取、每批修改后上传、结束前复查。应用关闭后不会常驻监控，也不把云端挂载成本地磁盘。工程文件按原名和目录结构逐个传输，不打包 ZIP；双方同时修改同一文件时保留冲突，删除不自动传播。

换设备或换智能体

先在原设备完成同步，再在新设备或新智能体中安装并连接账号，然后发送：

我要继续巴别鸟“个人文件/codex/网站改版”这个工程。
请将它恢复到一个新的本地目录，并继续绑定同一云端目录。
不要另建云端副本；如有本地同名文件或冲突，先报告给我。

把示例路径换成自己的云端工程目录。恢复后可继续说：“请先读取工程里的项目说明和记忆文件，再开始工作。”新的智能体仍需能访问目标本地目录并执行同步 Skill。

插件支持的平台

以下为 v0.5.1 GitHub 测试版范围。已有安装适配不等于所有客户端版本都已完成实机验证；GitHub 安装提供 Skills + MCP 组合，不要求先在插件市场找到它。

表格可左右滚动查看

OpenClaw、VS Code / GitHub Copilot、Cline、Roo Code、OpenCode、Windsurf、Devin 尚未列入本插件的安装适配。某产品支持 MCP，不代表已经支持本插件的目录同步。macOS 有实际验证记录；Windows/Linux 尚无系统实机验收。持续更新的范围见 支持清单 和 验证记录。

Today 首次连接

Today 当前不会在安装后自动弹出密钥页。先让 Today 安装插件，再打开中国版的 连接应用（使用与客户端相同的账号）：

1. 点击“添加自定义 MCP → 粘贴代码添加”，粘贴 现成配置模板，保留其中的占位符。
2. 阅读并确认页面提示，点击“下一步”；清空 Token 框已有内容，填入 APIKey 原值，不加 Bearer ，点击“添加”。
3. 回到 Today 对话，要求“读取个人文件并列出一页目录，检查巴别鸟连接，不查询配额、不上传文件”。显示“已连接”仍需这一步实际目录检查。

完整中英文步骤及窗口消失时的处理见 Today 安装说明。Today 只能同步它有权访问的工作区文件，云端工作区不等于电脑本地目录。

下载与单独使用 Skill

默认安装会自动装好两项 Skill，不需要重复安装。单独使用时，从下载包的 plugins/babelbird-cloud/skills/ 中导入两个完整 Skill 文件夹，保留脚本、资源和引用文档；不要只复制 SKILL.md。由当前智能体确认自己的 Skill 安装位置，并复用有效 MCP。安装后直接说“检查巴别鸟连接”或“为当前工程启用巴别鸟自动同步”即可。

常见问题

接入 MCP 后，工程就会自动同步吗？

不会。MCP 提供文件操作工具；项目同步插件和 Skill 负责绑定目录、安排拉取和上传。安装并连接后，还需要在目标工程中说“为当前工程启用巴别鸟自动同步”。

安装后在哪里填写 API Key？设置页没有打开怎么办？

已适配的桌面／CLI 宿主会打开本机设置页，在密码框填入 Key 后点击“保存并连接”。未打开时，点击智能体给出的“填写 API Key”链接，或要求它重新打开设置页。浏览器和设置助手需在同一台电脑；Today 首次连接使用自己的 Token 填写入口，具体见本页安装步骤。不要把 Key 发到聊天。

工程默认保存到哪里？

默认保存到“个人文件/平台名称/工程名/”，例如“个人文件/codex/网站改版/”或“个人文件/workbuddy/网站改版/”。已绑定或明确指定的云端目录优先。API Key 必须为“完整”访问范围并具备文件读写权限，账号本身也必须有目标目录权限。

项目同步插件与 Skill 需要哪些 MCP 权限？

在巴别鸟“设置 > API秘钥”中，为对应 APP 选择 完整 访问范围，并开启 files.metadata.read、files.metadata.write、files.content.read、files.content.write 四项权限。仅有“应用程序文件夹”授权或只读权限不能满足工程拉取、目录创建和更新上传的需要。将符合要求的 API Key 填入插件设置页，再执行“个人文件”的只读连接检查。“完整”只覆盖当前账号本来有权访问的文件，不是全企业管理员权限。

什么时候同步？关闭智能体后还会同步吗？

在启用同步并加载规则的智能体任务中，编辑前拉取更新、每批修改后上传、结束前复查。它不会在应用关闭后常驻监控，也不会把云端目录挂载成本地磁盘。可要求智能体报告本次拉取、上传和失败项，确认结果。

换电脑或换智能体，怎样继续同一个工程？

先在原设备完成同步，再在新设备安装、连接同一账号，并明确指定原云端工程目录。要求恢复到一个新的本地目录并继续使用同一绑定；不要为同一工程另建云端副本。恢复后可要求新智能体读取工程中的项目说明和记忆文件。

会保存聊天记录、所有 AI 记忆和电脑上的全部文件吗？

只同步已绑定工程中、符合同步规则的文件。项目说明、任务记录和写入文件的记忆可以一起保存；聊天记录、模型临时上下文、应用私有数据库及工程外文件不会自动迁移。文件排除规则仍然生效，账号密钥不随工程同步。

两台设备同时修改，或删除了文件，会怎样？

同一文件两边都有修改时保留冲突，不直接覆盖；删除不自动传播。让智能体先报告冲突和双方版本，再决定保留哪一份。每次开始工作前先拉取，换设备前先完成上传，可减少冲突。

Today 和 WorkBuddy 的安装方式完全相同吗？

不同。WorkBuddy 已有本地设置页适配，但完整桌面对话与授权流程仍待验收。Today 中国版目前需要手动导入 MCP 配置并在 Token 框填 Key；“已连接”后还要执行实际目录读取。各平台的适配和验证范围见本页支持清单，不应把 MCP 兼容等同于完整工程同步已验证。

去哪里下载插件或查看最新更新？

打开 GitHub 项目首页 查看最新说明和支持范围，在 版本发布记录 查看已发布版本。也可以把项目首页链接交给智能体，要求安装并打开 API Key 设置页。

相关资料

• 巴别鸟 MCP：能力、接入与使用
• 智巢 AI 概览