# 桌面宠物

桌面宠物是 GoodBuddy 桌面端一个可选的常驻悬浮入口，用于随时发起提问、暂存文件或文字，
并直观查看当前任务状态。桌面宠物不建立新的对话、任务或执行体系：它只是现有 Conversation、
Task 和 Runtime 能力的一个轻量触发面和状态镜面。

## 核心边界

- 桌面宠物**不**新增 Ask/Execute 执行通道，也不在自身窗口内直接展示模型回复。快速发起
  和拖放暂存的内容始终交给主窗口现有输入区确认后发送，从不自动发送或自动执行。
- 桌面宠物**不**持续读取屏幕内容、剪贴板或全局选中文本。
- 桌面宠物显示的任务状态、通知和历史记录均来自现有 Task/Conversation 数据，不建立第二套
  存储或索引。

## 文档导航

| 文档 | 权威职责 |
| --- | --- |
| [PRD](./prd.md) | 用户问题、范围、功能需求和产品验收 |
| [User Stories](./user-stories.md) | 首次启用、正常使用、失败恢复、兼容和边界场景 |
| [功能逻辑](./logic-design.md) | 不变量、状态维度、决策表和失败结果 |
| [UI 设计](./ui-design.md) | 窗口交互、设置入口、状态呈现、无障碍和响应式行为 |
| [技术设计](./technical-design.md) | 窗口与进程边界、IPC 边界、持久化、生命周期和验证策略 |

功能尚未实施，因此不创建 `progress.md`；实施开始后按 [`docs/features/AGENTS.md`](../AGENTS.md)
的证据要求补充。

## 术语

- **桌面宠物窗口**：应用启用该功能后创建的常驻、无边框、可置顶悬浮窗口。
- **快速发起**：点击宠物打开的小型输入框，用于输入文字或附加单个文件，提交后转入主窗口。
- **暂存**：快速发起或拖放产生的文字和附件在提交前的中间状态，不代表已发送或已执行。
- **状态镜面**：宠物窗口对当前任务状态（等待处理、执行中、已完成、失败、空闲）的展示，
  数据权威来自 Task 与 Conversation，不是独立状态源。
- **安静模式**：抑制宠物完成/失败气泡提示的设置，可访问的状态查询不受影响。

## 相关功能

- [Task 与 Job 文档集](../task-and-job/README.md)：任务状态、状态优先级和 Task Center
  导航的权威定义，宠物的状态镜面必须与其保持一致，不重新定义任务生命周期。
- [助手工作栏](../assistant-workbar/README.md)：主窗口执行空间和输入区的权威定义，宠物的
  快速发起和拖放暂存最终落地到该输入区，不复制其行为。
- [直连模型 Agent 能力](../direct-model-agent/README.md)、[远程主机与远程执行](../remote-host/README.md)：
  Ask/Execute 授权边界的权威定义，宠物不扩大或绕过该边界。
- [文档处理](../document-processing/README.md)：拖放文件解析和格式支持的权威定义，宠物拖放
  暂存复用同一处理管线，不重新定义支持类型。
- 根 [`UI-DESIGN.md`](../../../UI-DESIGN.md)：全局视觉、通知视口、Switch/Checkbox 语义和
  无障碍规则的权威定义。
- [`docs/development/release-runbook.md`](../../development/release-runbook.md)：跨平台打包
  矩阵和交付物的权威定义。