Remote Space 与同步

Remote Space 是 Vibecape Group 中的 Space。服务端保存 bare Git repository，每个用户在自己的电脑上使用完整的本地 clone。

在 App 中创建或打开

打开 Space Selector，选择一个状态为 joined 的 Group。Owner 可以创建项目；成员可以打开已有项目并选择本地目录。App 会从 Group 和 Space 元数据中取得 clone 地址，用户不需要粘贴 Git URL。

使用 CLI

vibecape space list --group <group-url>
vibecape space create . --group <group-url> --name "Project name"
vibecape space clone <space-id> ./project --group <group-url>
vibecape space settings ./project

连接信息保存在 Git remote 中。Vibecape 不创建 .vibecape/space.json，也不会把服务端数据库放进 Space 目录。

同步做了什么

Core Sync 会先 flush 已打开文档，建立本地 checkpoint，fetch 远端 main，整合可自动处理的改动，并在权限允许时 push。发生冲突时，内容会保留在本地 clone 中等待处理；网络失败不会删除本地修改。

.downcity/ 与 .vibecape/ 是本机运行状态。App 和 CLI 会维护 .gitignore 并自动解除这些目录的 Git 跟踪，但不会删除本地文件。真实内容发生冲突时，可以逐个选择“保留我的版本”或“使用远端版本”，也可以手动编辑后继续同步。

Git Extension 继续适合 status、stage、history、branch 和手动 Git 操作。Remote Space 成员关系与 Core Sync 属于 Vibecape Core，即使停用 Git Extension 也能继续工作。

文件与大小限制

文本和常见图片可以正常提交。服务端 hook 会拒绝任何超过 20 MiB 的单个 Git blob。在 Git LFS 上线前，请不要把视频或大型二进制资源放进 Space。