62 lines
3.8 KiB
Markdown
62 lines
3.8 KiB
Markdown
# Tauri / Web Reference Host 源码导航
|
|
|
|
`src/` 是 LineUp 的前端实现目录。可以把它理解为三层协作：Runtime 负责连接、状态、
|
|
存储和恢复；Chat 是用户首先看见的聊天功能；Tauri 或浏览器则是装载这套程序的运行外壳。
|
|
同一份源码既可放进正式桌面窗口，也可在浏览器中用于开发和验证。
|
|
|
|
`main.ts` 是应用启动时的装配入口：它把 Host 侧实现、`LineUpRuntime` 和默认 Core App
|
|
接起来。它不负责网络收发、消息存储、同步循环或原始 Agent 消息解析；这些都由 Runtime
|
|
统一管理。
|
|
|
|
```text
|
|
src/
|
|
├── main.ts # 启动装配入口：连接 Tauri/Web Host、Runtime 与默认 App
|
|
├── core-apps/
|
|
│ └── chat/ # 第一个可信 Core App
|
|
│ ├── chat-app-host.ts # Chat 的 Host 装配器：样式、Shell、Renderer 与 SDK
|
|
│ ├── chat-shell.ts # Chat 的 DOM Shell
|
|
│ ├── trusted-dom-renderers.ts # 已验证消息 → 可信 DOM
|
|
│ ├── renderer-registry.ts # Chat Renderer 分派
|
|
│ └── styles/ # Chat 专属样式
|
|
└── runtime/
|
|
├── app-management/ # Core App Registry、Chat SDK、App Host
|
|
├── artifacts/ # Artifact 元数据与短生命周期内容缓存
|
|
├── capabilities/ # Capability Registry、状态机、审计与执行器
|
|
├── communication/ # AppServer Transport
|
|
├── coordination/ # Runtime、Kernel、scope 路由、Tool/Task 状态
|
|
├── inventory/ # Agent 可见 Client/Tool Inventory
|
|
├── persistence/ # Conversation Store、Outbox、App Inbox
|
|
├── protocol/ # LineUp v1 解码与 golden fixture
|
|
└── surfaces/ # Surface Registry、实例、Bundle 与隔离 Host
|
|
```
|
|
|
|
## 谁可以依赖谁
|
|
|
|
```text
|
|
core-apps/chat ──ChatRuntimeSDK──► runtime/app-management
|
|
│
|
|
Host adapters ───────────────► runtime/coordination/LineUpRuntime
|
|
│
|
|
communication · persistence · protocol · capabilities
|
|
│
|
|
surfaces / inventory / artifacts
|
|
```
|
|
|
|
- App 不直接导入 `communication`、`persistence` 或原始协议解码模块；Chat 通过
|
|
`ChatRuntimeSDK` 接收已筛选的状态、消息和 Inbox，并以 Runtime Action 发起用户动作。
|
|
简单说，Chat 可以向 Runtime 说“请发送这段文字”，但不能自己连服务器或改数据库。
|
|
- `CoreAppRegistry` 决定默认启动哪个应用；`CoreAppHostRegistry` 决定如何挂载这个应用。
|
|
当前注册的实现仍是 `chat`，但 `main.ts` 不再直接导入 Chat 的样式、Renderer 或 DOM
|
|
Shell。
|
|
- Runtime 通过 `openApp(app_scope)` 打开对应的 SDK 投影；`openChatApp()` 只作为旧调用方的
|
|
兼容别名，新的 Core App Host 应使用注册表作用域打开 SDK。
|
|
- `runtime/coordination/lineup-runtime.ts` 是 Transport、Store、sync loop 和 outbox
|
|
的唯一所有者。
|
|
- 每个模块的测试与实现同目录放置；`runtime/protocol/golden/` 保存兼容协议 fixture。
|
|
- `@/` 指向 `src/`，由 `tsconfig.json` 与 `vite.config.ts` 共同配置。新增代码应使用该
|
|
别名，避免跨层的相对路径依赖。
|
|
|
|
未来新增 `voice`、`whiteboard` 等 Core/Installed App 时，应给它们各自的目录和 SDK
|
|
投影；不能把页面、网络连接或持久化逻辑重新堆回 `main.ts`。这样新应用只增加自己的体验，
|
|
不会破坏已有聊天和连接逻辑。
|