# 使用桌宠 Astravia Vivi

> 在设置中显示桌宠、调整置顶与气泡样式。

Canonical page: /product/desktop-pet



Astravia Vivi 是独立的透明桌面窗口，可展示状态反馈与节日气泡样式。它不是另一个 Agent 会话；重要任务仍在主窗口确认。

入口：**设置 → Astravia Vivi**。

## 显示与窗口 [#显示与窗口]

| 设置    | 说明                      |
| ----- | ----------------------- |
| 显示桌宠  | 关闭后隐藏桌宠窗口，并在下次启动时保持隐藏   |
| 保持在最前 | 开启后浮在其他窗口上方；关闭后可被其它窗口遮挡 |

按住桌宠可拖动。指针在桌宠图像上时，滚轮可调整当前动作显示尺寸（不同动作可能记住各自尺寸）。图像外的透明区域会尽量穿透鼠标事件，减少挡操作。

## 会话状态反馈 [#会话状态反馈]

Astravia Vivi 会跟随当前会话显示思考、工作、等待输入、完成、出错和暂停等状态。需要你回答问题、确认计划、授权权限或完成 MCP 配置时，桌宠会保持等待提示；完成会短暂展示后回到待机，错误则保持到下一轮开始，避免错过重要结果。

为了避免短时间内快速闪过多个动作，连续状态变化会合并为最新状态，每个已经显示的状态至少保持约 3 秒。关闭待机时的自动动作切换不会关闭会话状态反馈。

## 气泡样式 [#气泡样式]

在 **气泡样式** 中选择对话气泡外观，选择后立即应用到桌宠窗口。内置包括普通气泡以及春节、端午、中秋、圣诞等节日样式（以客户端列表为准）。

## 开发调试 [#开发调试]

**调试边框** 用于显示窗口边界、视频区域边界及尺寸信息，仅建议开发诊断时开启。

当前设置页主要暴露：显示桌宠、保持在最前、气泡样式与调试边框。其它内部字段（如装饰素材清单）可能未在界面展示，请以实际客户端为准。

## 常见问题 [#常见问题]

* **挡住工作内容**：关闭「保持在最前」，或拖到屏幕边缘。
* **太大或太小**：指针放在桌宠图像上滚动调整。
* **启用后看不见**：关闭再开启显示；检查是否在其它显示器或屏幕外；确认 Astravia 主进程仍在运行。
* **气泡不更新**：确认已选有效气泡样式，并从主窗口触发会更新状态的操作。