AstrBot-Desktop/docs/decisions/ADR-0006-chat-quick-window-and-pet-shell.md

47 行
2.4 KiB
Markdown

# ADR-0006: 共享聊天运行时与桌宠展示层
## 状态
提议,作为 P03-P07 的实现顺序基线,2026-07-20。
## 背景
产品需要同时支持完整聊天页面、小型快速回复窗口和后续桌面气泡/桌宠。三者如果各自维护连接、会话和消息,会产生重复状态、窗口间不同步以及双槽位权限绕过风险。
Hermes 与 Codex 展示出相似的产品形态,但没有可直接复用的共同运行时或公开稳定 SDK。因此本项目需要自有 Tauri/React/Rust 实现,只借鉴交互模式和素材包组织方式。
## 隔离基线
账号、Profile、槽位和 Session 是不同层级:账号标识本地使用者,Profile 标识 AstrBot 连接,槽位标识本地职责,Session 标识聊天上下文。不同账号和不同槽位均不得共享本地消息、未读数、错误状态或本机权限。
## 决策
1. 建立单一 Rust-owned ChatRuntime,主窗口、快速窗口和气泡均作为展示层订阅它。
2. 快速窗口只支持一个可配置目标槽位:Companion 或 Operations。
3. 气泡默认不置顶;设置决定气泡点击打开主页面还是快速窗口。
4. 桌宠先实现状态模型、素材包校验、窗口控制器和多显示器几何模型;动画引擎和复杂素材格式后置。
5. 全屏浮动和游戏模式只能通过受限窗口策略和只读前台/显示器检测实现,不引入任意桌面控制能力。
6. 主窗口、快速窗口和气泡关闭时不销毁连接运行时;连接由 Rust 槽位生命周期管理。
## 结果
### 优点
- 三种 UI 共享消息状态,避免重复实现和串线。
- 窗口能力与本机工具权限分离,桌宠不会获得额外操作权。
- 可以先完成真实文字聊天,再逐步加入视觉和游戏陪伴能力。
- 未来替换 PNG/WebP 为 Live2D/Spine 时不会改变聊天协议。
### 代价
- 需要设计 Rust 到多个 Tauri 窗口的事件广播和生命周期管理。
- SQLite 需要新增会话、消息和窗口偏好迁移。
- 多显示器和游戏模式需要 Windows 专用测试矩阵。
## 后续影响
- Q1 必须先定义规范化 ChatEvent 和共享订阅语义。
- Q4 必须验证独立窗口与单实例/托盘行为。
- Q6 的 pet-pack manifest 必须是数据文件,不允许携带可执行逻辑。
- Q7 的游戏模式只能做位置和显示策略,不得扩展为输入注入或任意窗口控制。