docs: define cross-machine Git sync workflow

README.md

@@ -4,6 +4,26 @@
 
 当前 Kotlin Android 客户端是 IM、协议、设备接入与交互闭环的快速实验基线；长期目标是在系统 WebView / WebKit 之上构建 LineUp Mini Runtime，为内置 Renderer 与受限第三方小程序 Surface 提供统一的运行环境。
 
+## Git 同步约定
+
+客户端工作区使用独立仓库，远端为 `ssh://git@100.121.118.116:2222/lineup/app.git`，`main` 是 Linux 与 macOS 唯一的共享同步分支。每个可验证的客户端改动都应提交并推送到 `origin/main`；不要再通过复制 `node_modules`、`target` 或打包产物在开发机间同步。
+
+macOS 首次获取：
+
+```bash
+git clone ssh://git@100.121.118.116:2222/lineup/app.git ~/Workspace/lineup-app
+cd ~/Workspace/lineup-app/tauri
+npm ci
+```
+
+日常同步（工作区无未提交源码改动时）：
+
+```bash
+git pull --ff-only origin main
+```
+
+`tauri/node_modules/`、`tauri/dist/` 和 `tauri/src-tauri/target/` 均为本机可再生文件，已被忽略；每台机器按自身架构重新安装和构建。
+
 ## 文档入口
 
 - [DESIGN.md](DESIGN.md)：Android 实验阶段的产品、连接与交互设计；