# 🐤 咕咕嘎嘎桌宠 · 使用文档

一个基于 Quicker 自定义窗口（`sys:customwindow`）的桌面宠物动作。桌宠是一只矢量绘制的小黄鸭，头顶「咕咕嘎嘎」气泡，支持调节透明度、大小、自由拖动，并且会记住你离开时的样子。

---

> 💡 建议将动作按钮设置为「单击启动」，桌宠会一直显示在桌面上，直到你通过右键菜单让它休息。

---

## 操作方式

| 操作 | 效果 |

|---|---|

| 🖱️ 滚轮上下滑动（桌宠上） | 调节桌宠**透明度**，范围 10%～100%，每次 ±5% |

| 🖱️ Ctrl + 滚轮上下滑动 | 调节桌宠**大小**，范围 0.3～3 倍，每次 ±0.1 |

| 🖱️ 左键按住拖动 | **移动**桌宠位置（顺便换一句台词） |

| 🖱️ 右键 →「恢复默认大小和透明度」 | 大小、透明度重置为 100%，台词回到「咕咕嘎嘎」 |

| 🖱️ 右键 →「咕咕嘎嘎~ 再见（关闭桌宠并退出动作）」 | 关闭桌宠并**退出动作** |

### 台词彩蛋

小鸭会根据你的操作说话：

- 点一下或拖动时轮播：「咕咕嘎嘎」→「嘎嘎嘎嘎~」→「咕咕~」→「嘎嘎!」

- Ctrl+滚轮放大：「咕咕（变大）」；缩小：「嘎嘎（变小）」

- 滚轮调透明度变亮：「咕咕（显形）」；变淡：「嘎嘎（隐身）」

---

## 记忆功能

动作会自动持久化以下状态（基于 Quicker 变量 `SaveState` + 自定义窗口 dataMapping 回写机制）：

- ✅ **透明度**（`petOpacity`）

- ✅ **大小**（`petScale`）

- ✅ **桌面位置**（`petLeft` / `petTop`）

下次启动动作时，桌宠会**在上次关闭时的位置**、以上次的大小和透明度出现，直接继续陪你。

**位置保护逻辑**：如果保存的位置已经超出当前虚拟屏幕范围（比如换了显示器、改了分辨率），桌宠会自动回落到屏幕内可见位置，不会"消失"在屏幕外。

---

## 常见问题

**Q1：滚轮没反应？**

Windows 的滚轮消息优先发给有焦点的窗口，而桌宠默认不抢焦点（`activateMode = NotActivated`）。**先在桌宠上点一下（拖一下也行），再使用滚轮即可。** 如果想一打开就能滚，可在动作编辑器中把自定义窗口步骤的 `activateMode` 参数改为 `AutoActivate`。

**Q2：右键菜单弹不出来？**

同上，右键菜单需要窗口可激活，先在桌宠上点一下再右键。

**Q3：桌宠太挡视线了？**

用滚轮把透明度调低（最低 10%），它会变成若隐若现的小可爱；或用 Ctrl+滚轮缩小（最小 0.3 倍），再拖到屏幕角落。

**Q4：怎么彻底退出？**

右键桌宠 →「咕咕嘎嘎~ 再见」，桌宠关闭的同时动作也会结束。直接在 Quicker 面板再次点击动作按钮，可以重新召唤它。

**Q5：想重置所有记忆？**

在 Quicker 动作编辑器中删除变量 `petOpacity`、`petScale`、`petLeft`、`petTop` 的保存状态（或在动作右键菜单中清除保存的变量状态），下次启动即恢复默认。

---

*咕咕嘎嘎~ 祝使用愉快！* 🐤