桌面宠物

桌面宠物是 Aichat 的辅助交互功能。它可以作为桌面上的轻量入口或提示载体，帮助你更快注意到客户端状态。

Aichat 的宠物样式来自公开宠物目录，不需要 License 鉴权。当前默认目录是：

https://aichat-pets.vercel.app/pets/manifest.json

它能做什么

桌面宠物可以用于：

1. 展示客户端状态。
2. 提示任务进度。
3. 作为快速交互入口。
4. 显示部分授权或通知提示。
5. 展示点击、拖拽、悬停、空闲随机等互动动画。

不同宠物支持的动作不完全一样。如果某个宠物素材没有定义某类动作，客户端会自动回退到它支持的状态。

选择宠物和尺寸

设置页会以图片宫格展示可选宠物。你可以直接看图选择，而不需要只靠名称判断。

常见设置包括：

1. 开启或关闭桌面宠物。
2. 选择宠物样式。
3. 选择小、中、大等尺寸。
4. 启用或关闭勿扰模式。

勿扰模式通常用于减少宠物主动提示和打扰，但不会影响主客户端对话能力。

自定义宠物

如果你有符合格式的宠物资源，可以导入自定义宠物。通常需要准备：

1. pet.json：描述宠物名称、尺寸、动画状态和 spritesheet 布局。
2. spritesheet.webp 或同类图片素材：宠物动画图。

自定义宠物适合个人美化或通过技能生成宠物素材。导入前建议确认素材来源可信，并保留原始文件方便后续调整。

授权气泡

当 Agent 需要你确认工具调用时，桌面宠物可以显示授权气泡。这个气泡只是把主客户端授权提示做成更轻量的入口，不会绕过原本的安全确认。

是否必须开启

不是。桌面宠物属于辅助体验，不影响 Aichat 的核心对话、模型、Agent 和技能能力。

如果你更喜欢安静的桌面环境，可以在设置中关闭它。

使用建议

1. 第一次使用可以先保持默认。
2. 如果觉得遮挡窗口或打扰工作，可以关闭。
3. 选择更符合自己偏好的宠物样式和尺寸。
4. 如果某个宠物动作过于频繁，可以换一个样式或开启勿扰。

排错

如果桌面宠物显示异常，可以尝试：

1. 关闭后重新开启。
2. 重启客户端。
3. 检查客户端是否有更新。
4. 如果仍异常，关闭该功能继续使用主客户端。