feat: establish typed runtime protocol model

README.md

@@ -4,21 +4,22 @@
 
 当前 Kotlin Android 客户端是 IM、协议、设备接入与交互闭环的快速实验基线；长期目标是在系统 WebView / WebKit 之上构建 LineUp Mini Runtime，为内置 Renderer 与受限第三方小程序 Surface 提供统一的运行环境。
 
-## Git 同步约定
+## Git 与开发验证约定
 
-客户端工作区使用独立仓库，远端为 `ssh://git@100.121.118.116:2222/lineup/app.git`，`main` 是 Linux 与 macOS 唯一的共享同步分支。每个可验证的客户端改动都应提交并推送到 `origin/main`；不要再通过复制 `node_modules`、`target` 或打包产物在开发机间同步。
+客户端工作区使用独立仓库，远端为 `ssh://git@100.121.118.116:2222/lineup/app.git`。Git 用于源码版本管理、备份和协作；提交应对应完整、可验证的改动，但**不再作为 Mac 浏览器验证前端改动的传输手段**。
 
-macOS 首次获取：
+日常 Web 联调由 Linux 工作机直接提供可信 Host：
+
+```bash
+cd lineup-app/tauri
+npm run web:dev
+```
+
+Mac 浏览器通过 Tailscale 打开 `http://100.121.118.116:1420`，即可看到 Linux 工作区的 Vite 热更新。Mac 只在首次配置、切换开发机或需要本地桌面打包时再 clone / pull 源码：
 
 ```bash
 git clone ssh://git@100.121.118.116:2222/lineup/app.git ~/Workspace/lineup-app
-cd ~/Workspace/lineup-app/tauri
-npm ci
-```
-
-日常同步（工作区无未提交源码改动时）：
-
-```bash
+cd ~/Workspace/lineup-app
 git pull --ff-only origin main
 ```