LineUp 不只是一个聊天客户端，而是用户设备上的协作 Runtime：它连接 AppServer 与 Remote Agent，维护会话、消息、Store、outbox、App Inbox、权限与恢复；当前 chat 兼容实现是其上的第一个系统级 MiniApp：Interact 的 IM Mode。

当前唯一的客户端实现与验收基线是：

Tauri 2 Desktop Host + Web Reference Host

这里的 Host（运行外壳） 指的是把同一套 LineUp 程序放进不同运行环境的方式，并不表示有两套客户端或两套聊天逻辑。它们共用同一份 TypeScript LineUpRuntime 和 Chat Core App：

Tauri Desktop Host 是正式桌面应用的外壳。它负责创建桌面窗口，并在 Runtime 授权后提供文件、通知等操作系统能力。
Web Reference Host 是浏览器中的同代码开发和验证入口。它用于 Vite 开发、 Tailscale 联调与自动化回归，不能替代桌面版的系统能力。

无论运行在哪个 Host 中，连接、同步、消息存储和 Agent 协议都只能由 Runtime 管理，不能各自实现一套。

不再规划、实现或维护独立 Android/Kotlin 客户端，也不再维护 Wails Host。旧实验设计仅在 Git 历史中保留，不是当前产品、协议或交付路线。

MVP-R1：Runtime 托管 Chat

当前 MVP 已验证以下边界：

Chat Core App
  └── ChatRuntimeSDK
        └── LineUpRuntime
              ├── Transport / sync loop / outbox
              ├── Conversation Store / App Inbox
              ├── app_scope + conversation_id 路由
              └── lineup.v1 Compatibility Adapter

LineUpRuntime 是网络连接、消息存储、同步循环和待发送队列的唯一管理者；
Runtime 从本地 Core App Registry（内置应用清单）加载默认 chat，而不是由 main.ts 直接拼出聊天页面；
Chat 只能通过 Runtime SDK 接收已筛选的消息和状态、恢复并确认已处理的 Inbox 消息，再向 Runtime 提交用户动作；
Runtime 拒绝非法或不匹配的 app_scope / conversation_id，并在内部兼容既有 lineup.v1；
登录、同步、发送、本地回显、Markdown、Agent 状态和刷新恢复保持回归通过；
当前 Tauri/Web 回归为 23 个测试文件、99 个测试，npm run build 通过。

完整边界、MiniApp SDK 路线和发布安全约束见 APP架构设计.md。

开发与验证

客户端工作区使用独立仓库，远端为 ssh://git@100.121.118.116:2222/lineup/app.git。 Linux 开发机通过 Vite 启动 Web Reference Host；Mac 或其他设备可经 Tailscale 用浏览器直接打开它，看到的就是 Linux 工作区中正在修改的同一份前端，无须每次改动都同步或重新 clone 源码。

cd lineup-app/tauri
npm run web:dev

当前开发地址：

http://100.121.118.116:1420/

常用命令：

# Runtime / SDK / Renderer 自动化回归
npm test -- --run

# TypeScript 检查与 Web production build
npm run build

# Tauri 桌面 Host 开发
npm run desktop:dev

tauri/node_modules/、tauri/dist/ 和 tauri/src-tauri/target/ 都是可再生本机构建产物，已被忽略。

文档入口

设计/README.md：当前设计文档入口和文档分工说明；
APP架构设计.md：LineUp App、Runtime、MiniApp SDK、Surface/Capability 安全与后续迭代的权威架构设计；
程序文件清单与功能说明.md：客户端 Runtime、Chat Core App、Tauri/Web Host 与测试的文件清单；
tauri/src/README.md：源码目录、依赖方向与模块放置规则；
tauri/README.md：Tauri/Web Host 的运行、构建、行为回归和历史里程碑；
迭代/：按迭代目录记录当前基线、设计评审和后续 Runtime Kernel / 应用编排目标；
LineUp App 最终设计方案：当前架构的唯一汇总入口；
LineUp App 层架构方案：M0～M4 历史实施记录与迁移基础；
LineUp Runtime 与 App SDK 架构方案：Runtime / SDK 的详细契约来源；
LineUp UI Surface 与 App Capability 协议：Surface sandbox 和 Capability Gateway 协议；

工作区目录

lineup-app/
├── README.md                    # LineUp App 工作区入口
├── 设计/                        # 当前设计文档
│   ├── README.md
│   ├── APP架构设计.md
│   └── 02.正式方案/
└── tauri/                        # Tauri Desktop + Web Reference Host
    ├── src/                      # Runtime、Core App 与 Host 组合入口
    └── src-tauri/                # Tauri Rust Host

README.md Unescape Escape

LineUp App

当前实现基线

MVP-R1：Runtime 托管 Chat

开发与验证

文档入口

工作区目录

README.md