app/README.md

LineUp App

这里是 LineUp 多端客户端的工作区。

当前 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 首次获取：

git clone ssh://git@100.121.118.116:2222/lineup/app.git ~/Workspace/lineup-app
cd ~/Workspace/lineup-app/tauri
npm ci

日常同步（工作区无未提交源码改动时）：

git pull --ff-only origin main

tauri/node_modules/、tauri/dist/ 和 tauri/src-tauri/target/ 均为本机可再生文件，已被忽略；每台机器按自身架构重新安装和构建。

文档入口

• DESIGN.md：Android 实验阶段的产品、连接与交互设计；
• TECHNOLOGY_SELECTION.md：已确认的客户端与 Mini Runtime 技术路线；Tauri 2 是第一优先的 Reference Host Spike，Wails v3 在同一基线后续评估；
• tauri/README.md：Tauri 2 Reference Host 的实现、构建状态和下一阶段范围；
• LineUp App 层架构设计方案：跨端 App Shell、Interaction Kernel、Renderer、Surface 与 Capability 的正式架构；
• LineUp UI Surface 与 App Capability 协议：小程序 Surface 和 Agent 调 App 能力的协议定义。

当前目录边界

lineup-app/
├── DESIGN.md                    # Android 快速实验设计
├── TECHNOLOGY_SELECTION.md       # 已确认的客户端 / Mini Runtime 技术路线
├── tauri/                        # Tauri 2 Reference Host（第一优先 Spike）
└── README.md                     # 本目录说明与文档入口

实际的唐僧叨叨 Android 上游实验代码保留在 ../upstream/tangsengdaodao-android/，不与未来的 LineUp 多端客户端工程混放。