mesalogo
374968d50b
Adds the full documentation set for the planned desktop pet feature under docs/features/desktop-pet: README, PRD, user stories, logic design, UI design, and technical design. The pet is scoped as a lightweight always-on entry point for quick drafting, drag-and-drop staging, and task status at a glance; it does not introduce a second Ask/Execute channel, task execution path, or independent task-state store. Design only, no implementation yet.
3.2 KiB
3.2 KiB
桌面宠物
桌面宠物是 GoodBuddy 桌面端一个可选的常驻悬浮入口，用于随时发起提问、暂存文件或文字， 并直观查看当前任务状态。桌面宠物不建立新的对话、任务或执行体系：它只是现有 Conversation、 Task 和 Runtime 能力的一个轻量触发面和状态镜面。
核心边界
- 桌面宠物不新增 Ask/Execute 执行通道，也不在自身窗口内直接展示模型回复。快速发起 和拖放暂存的内容始终交给主窗口现有输入区确认后发送，从不自动发送或自动执行。
- 桌面宠物不持续读取屏幕内容、剪贴板或全局选中文本。
- 桌面宠物显示的任务状态、通知和历史记录均来自现有 Task/Conversation 数据，不建立第二套 存储或索引。
文档导航
| 文档 | 权威职责 |
|---|---|
| PRD | 用户问题、范围、功能需求和产品验收 |
| User Stories | 首次启用、正常使用、失败恢复、兼容和边界场景 |
| 功能逻辑 | 不变量、状态维度、决策表和失败结果 |
| UI 设计 | 窗口交互、设置入口、状态呈现、无障碍和响应式行为 |
| 技术设计 | 窗口与进程边界、IPC 边界、持久化、生命周期和验证策略 |
功能尚未实施，因此不创建 progress.md；实施开始后按 docs/features/AGENTS.md
的证据要求补充。
术语
- 桌面宠物窗口：应用启用该功能后创建的常驻、无边框、可置顶悬浮窗口。
- 快速发起：点击宠物打开的小型输入框，用于输入文字或附加单个文件，提交后转入主窗口。
- 暂存：快速发起或拖放产生的文字和附件在提交前的中间状态，不代表已发送或已执行。
- 状态镜面：宠物窗口对当前任务状态（等待处理、执行中、已完成、失败、空闲）的展示， 数据权威来自 Task 与 Conversation，不是独立状态源。
- 安静模式：抑制宠物完成/失败气泡提示的设置，可访问的状态查询不受影响。
相关功能
- Task 与 Job 文档集：任务状态、状态优先级和 Task Center 导航的权威定义，宠物的状态镜面必须与其保持一致，不重新定义任务生命周期。
- 助手工作栏：主窗口执行空间和输入区的权威定义，宠物的 快速发起和拖放暂存最终落地到该输入区，不复制其行为。
- 直连模型 Agent 能力、远程主机与远程执行： Ask/Execute 授权边界的权威定义，宠物不扩大或绕过该边界。
- 文档处理：拖放文件解析和格式支持的权威定义，宠物拖放 暂存复用同一处理管线，不重新定义支持类型。
- 根
UI-DESIGN.md：全局视觉、通知视口、Switch/Checkbox 语义和 无障碍规则的权威定义。 docs/development/release-runbook.md：跨平台打包 矩阵和交付物的权威定义。