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.
51 lines
3.2 KiB
Markdown
51 lines
3.2 KiB
Markdown
# 桌面宠物
|
||
|
||
桌面宠物是 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)：跨平台打包
|
||
矩阵和交付物的权威定义。
|