# 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 的游戏模式只能做位置和显示策略,不得扩展为输入注入或任意窗口控制。