--- title: 项目云端同步插件与 Skill description: 使用巴别鸟项目云端同步插件与 Skill 保存智能体的本地工程，跨设备、跨智能体恢复文件记忆；了解安装、API Key 填写、支持平台和下载方法。 slug: project-cloud-sync lang: zh category: 智巢 AI category_order: 5 order: 10 keywords: - 项目云端同步 - Skill - 插件下载 - AI本地记忆 - 跨设备同步 - 跨智能体同步 - Codex - WorkBuddy - CodeBuddy CLI - Claude Code - Cursor - Gemini CLI - Today - Meta Muse - MCP --- # 项目云端同步插件与 Skill **GitHub 项目地址：**[https://github.com/bypassdesign-dev/babelbird-plugins](https://github.com/bypassdesign-dev/babelbird-plugins)。点击可查看最新使用说明、支持平台和项目更新；已发布版本见 [版本发布记录](https://github.com/bypassdesign-dev/babelbird-plugins/releases)。 **「项目云端同步巴别鸟插件」是 MCP 的一个应用，用于同步智能体的本地项目／工程目录，方便换设备、换智能体后继续工作。** 它通过巴别鸟 MCP 传输文件，但与“接入 MCP”不是一回事：MCP 提供访问云端文件的工具，插件和 Skill 负责确定同步目录、执行同步流程，并处理更新和冲突。 | 使用方式 | 解决什么问题 | 是否自动同步工程 | | --- | --- | --- | | 只接入巴别鸟 MCP | 让智能体按指令搜索、读取、上传或下载文件 | 接入本身不会自动绑定或同步本地目录 | | 安装项目云端同步插件 | 将本地工程与一个巴别鸟目录绑定，按任务节奏保存和拉取更新 | 启用后，在宿主加载同步规则的任务中执行 | | 使用配套 Skill | 告诉智能体如何设置账号、绑定工程、恢复文件和处理冲突 | 需要有效 MCP、文件访问权限与可执行环境，单独一个说明文件不够 | ## 适合哪些场景 - **自动保存工程：**让 Codex 或 WorkBuddy 修改代码、设计稿、文档后，将符合同步规则的文件保存到巴别鸟，减少手动上传。 - **换电脑继续工作：**在新电脑连接同一账号，指定原来的云端工程目录，恢复到新的本地目录，再继续修改。 - **换智能体继续工作：**把 Codex 创建的工程交给 WorkBuddy 或其他已适配平台，继续绑定原来的云端目录，不为同一工程另建副本。 - **保存 AI 的文件记忆：**工程中的项目说明、任务记录、指令和写入文件的记忆，可以与工程一起保存。新智能体恢复后，可读取这些文件了解项目背景。 这里的“AI 本地记忆保存”指**保存在工程文件中、且符合同步规则的内容**。插件不会自动迁移聊天记录、模型临时上下文、应用私有数据库或工程目录以外的记忆；不同智能体也可能需要你明确要求它读取这些文件。Git 忽略及文件排除规则仍然生效，账号密钥不随工程同步。 ## 新手上手：安装、填 Key、开启同步 1. 在正在使用的智能体中发送下面的安装指令。无需自己找 Skill 目录或编辑配置。 2. 在巴别鸟“设置 > API秘钥”中，准备一个访问范围为 **完整**、文件元数据与内容读写权限均已开启的 API Key，再填入自动打开的本地设置页，点击“保存并连接”。未打开时，点击智能体给出的“填写 API Key”链接；复用已有连接时也要核对这些权限。获取 Key 的方法见 [巴别鸟 MCP 的 API Key 图文步骤](mcp-integration.md#1-api-key)。 3. 连接检查通过后，在需要保存的本地工程中发送“为当前工程启用巴别鸟自动同步”。仅安装和连接账号不会上传工程。 ```text 帮我安装以下插件，并连接我的巴别鸟账号： https://github.com/bypassdesign-dev/babelbird-plugins ``` ```text 为当前工程启用巴别鸟自动同步。 开始修改前拉取更新，每批修改完成后上传，结束前检查同步结果。 ``` 以上本地设置页适用于下表的六款桌面／CLI 宿主，需要 Node.js 20+，且浏览器与设置助手运行在同一台电脑。环境检查由智能体完成。Key 只填在密码框，不发到聊天；WorkBuddy 的第三方 MCP 权限需你在应用内批准。若提示重新打开会话以加载连接，按提示操作并复用已保存的 Key。 默认目录为 `个人文件/平台名称/工程名/`，例如 Codex 使用 `个人文件/codex/工程名/`，WorkBuddy 使用 `个人文件/workbuddy/工程名/`。**使用本插件或配套 Skill，MCP 的 API Key 必须授予“完整”访问权限，并开启文件元数据和内容的读写权限；“应用程序文件夹”授权不适用。** 当前账号也必须有权访问“个人文件”和目标工程目录。已绑定或明确指定的云端目录优先使用，但仍需满足上述授权要求。 自动同步发生在智能体工作期间：编辑前拉取、每批修改后上传、结束前复查。应用关闭后不会常驻监控，也不把云端挂载成本地磁盘。工程文件按原名和目录结构逐个传输，不打包 ZIP；双方同时修改同一文件时保留冲突，删除不自动传播。 ## 换设备或换智能体 先在原设备完成同步，再在新设备或新智能体中安装并连接账号，然后发送： ```text 我要继续巴别鸟“个人文件/codex/网站改版”这个工程。 请将它恢复到一个新的本地目录，并继续绑定同一云端目录。 不要另建云端副本；如有本地同名文件或冲突，先报告给我。 ``` 把示例路径换成自己的云端工程目录。恢复后可继续说：“请先读取工程里的项目说明和记忆文件，再开始工作。”新的智能体仍需能访问目标本地目录并执行同步 Skill。 ## 插件支持的平台 以下为 **v0.5.1 GitHub 测试版**范围。已有安装适配不等于所有客户端版本都已完成实机验证；GitHub 安装提供 Skills + MCP 组合，不要求先在插件市场找到它。 | 平台 | 适配状态 | API Key 填写方式 | 已验证范围与限制 | | --- | --- | --- | --- | | Codex | 已有安装适配 | 自动打开本地设置页 | 干净会话安装、页面填写和重开会话后的实际目录读取已通过 | | WorkBuddy | 已有安装适配 | 自动打开本地设置页 | 页面及云端目录检查、内置 CLI 连接已通过；完整桌面对话与授权流程仍待验收 | | CodeBuddy CLI | 已有安装适配 | 自动打开本地设置页 | 安装与配置检查通过；独立产品端到端验收未完成 | | Claude Code | 已有安装适配 | 自动打开本地设置页 | 安装与配置检查通过；客户端端到端验收未完成 | | Cursor | 已有安装适配 | 自动打开本地设置页 | 安装与配置检查通过；客户端端到端验收未完成 | | Gemini CLI | 已有安装适配 | 自动打开本地设置页 | 安装与配置检查通过；客户端端到端验收未完成 | | Today 中国版 | 实验适配 | 手动导入配置，在平台 Token 框填写 | 已观察到两项技能安装和“已连接”；工程同步与跨会话触发未验收 | | Today 国际版 | 实验适配 | 需核实当前账号的平台凭据入口 | 尚未完成登录后的安装连接验收 | | Meta Muse 个人智能体 | 实验适配 | 平台安全凭据入口，需核实连接器能力 | 凭据流程、连接器桥接及工程同步未验收；不等同于 Muse Code | OpenClaw、VS Code / GitHub Copilot、Cline、Roo Code、OpenCode、Windsurf、Devin 尚未列入本插件的安装适配。某产品支持 MCP，不代表已经支持本插件的目录同步。macOS 有实际验证记录；Windows/Linux 尚无系统实机验收。持续更新的范围见 [支持清单](https://github.com/bypassdesign-dev/babelbird-plugins/blob/main/docs/SUPPORTED_AGENTS.md) 和 [验证记录](https://github.com/bypassdesign-dev/babelbird-plugins/blob/main/VALIDATION.md)。 ## Today 首次连接 Today 当前不会在安装后自动弹出密钥页。先让 Today 安装插件，再打开中国版的 [连接应用](https://todayai.cn/connectors)（使用与客户端相同的账号）： 1. 点击“添加自定义 MCP → 粘贴代码添加”，粘贴 [现成配置模板](https://github.com/bypassdesign-dev/babelbird-plugins/blob/v0.5.1/plugins/babelbird-cloud/skills/babelbird-setup/references/today-mcp-template.json)，保留其中的占位符。 2. 阅读并确认页面提示，点击“下一步”；清空 Token 框已有内容，填入 APIKey 原值，不加 `Bearer `，点击“添加”。 3. 回到 Today 对话，要求“读取个人文件并列出一页目录，检查巴别鸟连接，不查询配额、不上传文件”。显示“已连接”仍需这一步实际目录检查。 完整中英文步骤及窗口消失时的处理见 [Today 安装说明](https://github.com/bypassdesign-dev/babelbird-plugins/blob/main/plugins/babelbird-cloud/skills/babelbird-setup/references/today-setup.md)。Today 只能同步它有权访问的工作区文件，云端工作区不等于电脑本地目录。 ## 下载与单独使用 Skill | 入口 | 用途 | | --- | --- | | [GitHub 首页](https://github.com/bypassdesign-dev/babelbird-plugins) | 把链接交给智能体，按上方指令安装 | | [v0.5.1 发布页](https://github.com/bypassdesign-dev/babelbird-plugins/releases/tag/v0.5.1) | 查看测试版说明和源码下载 | | [下载 v0.5.1 插件源码 ZIP](https://github.com/bypassdesign-dev/babelbird-plugins/archive/refs/tags/v0.5.1.zip) | 离线保存或手动安装；这是插件分发包，工程同步不使用 ZIP | | [首次设置 Skill：babelbird-setup](https://github.com/bypassdesign-dev/babelbird-plugins/tree/v0.5.1/plugins/babelbird-cloud/skills/babelbird-setup) | 配置账号、打开填写页、检查连接 | | [工程同步 Skill：babelbird-project-cloud](https://github.com/bypassdesign-dev/babelbird-plugins/tree/v0.5.1/plugins/babelbird-cloud/skills/babelbird-project-cloud) | 绑定／恢复工程、拉取和上传更新、处理冲突 | | [新手场景与操作说明](https://github.com/bypassdesign-dev/babelbird-plugins/blob/main/docs/GETTING_STARTED.md) | 自动保存、换电脑、换智能体和文件记忆示例 | 默认安装会自动装好两项 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 权限？ {#faq-sync-mcp-permissions} 在巴别鸟“设置 > 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 项目首页](https://github.com/bypassdesign-dev/babelbird-plugins) 查看最新说明和支持范围，在 [版本发布记录](https://github.com/bypassdesign-dev/babelbird-plugins/releases) 查看已发布版本。也可以把项目首页链接交给智能体，要求安装并打开 API Key 设置页。 ## 相关资料 - [巴别鸟 MCP：能力、接入与使用](mcp-integration.md) - [智巢 AI 概览](ai-overview.md)