Remote Space 与同步

Remote Space 属于 Federation Organization。Duobox Server 保存 bare Git repository，每个用户在自己的电脑上使用完整的本地 clone。

在 App 中创建或打开

打开 Space Selector 并选择 Organization。拥有 manager 权限的用户可以创建项目；成员可以打开已有项目并选择本地目录。App 会从 Organization 和 Space 元数据中取得 clone 地址，用户不需要粘贴 Git URL。

使用 CLI

duobox space list --organization <id-or-key>
duobox space create . --organization <id-or-key> --name "Project name"
duobox space clone <space-id> ./project --organization <id-or-key>
duobox space settings ./project

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

同步做了什么

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

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

Git Extension 继续适合 status、stage、history、branch 和手动 Git 操作。Organization 权限与 Core Sync 属于 Duobox Core，即使停用 Git Extension 也能继续工作。

文件与大小限制

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