托盘窗口
托盘窗口是 CueMate 的快捷操作入口，通过系统托盘图标可以快速查看数据统计、切换应用状态、修改常用设置，无需打开主窗口即可完成日常操作。
1. macOS
在 macOS 系统中，托盘图标位于屏幕右上角的菜单栏区域。
1.1 CueMate 图标
屏幕顶部任务栏：
找到 Cuemate 程序运行的图标：
鼠标右键点击
右键点击托盘图标，会弹出系统原生菜单，提供以下快捷操作：
- ○ 显示模式
- ● 隐藏模式
- ○ 交互模式
- ● 穿透模式
- 退出
| 菜单项 | 功能说明 |
|---|---|
| 显示模式 | 显示悬浮控制栏和所有窗口 |
| 隐藏模式 | 隐藏悬浮控制栏和所有窗口（托盘窗口不受影响） |
| 交互模式 | 窗口可以正常点击和拖动，鼠标点击不会穿透 |
| 穿透模式 | 窗口依然可见，但鼠标点击会穿透到下层应用，不影响其他应用操作 |
| 退出 | 完全退出 CueMate 应用 |
点击穿透模式说明
点击穿透模式用于在面试或其他场景中，既能看到 CueMate 悬浮窗的内容（如 AI 答案），又不影响对其他应用的操作。
- 交互模式：悬浮窗可以点击、拖动、调整大小，适合需要与悬浮窗交互时使用
- 穿透模式：悬浮窗内容可见但鼠标点击会穿透，适合面试时查看答案同时操作其他软件（如在线编码）
使用场景：
- 面试时需要查看答案但不想遮挡屏幕，例如在线编码
- 穿透模式下查看提示词，同时操作面试或其他软件
- 需要与悬浮窗交互时切换到交互模式
快捷键切换：⌘⇧CM（Command + Shift + C + M）可在两种模式间快速切换
TIP
更多穿透模式的详细设置，请参考 系统设置 - 点击穿透模式
鼠标左键点击
点击菜单栏中的 CueMate 图标，即可打开托盘窗口。
1.2 托盘窗口
托盘窗口主界面分为三个区域：顶部标题栏、数据统计区、实用工具区。
顶部标题栏
- CueMate Logo：显示应用品牌标识
- 设置按钮：点击进入系统偏好设置页面
数据统计区
数据统计区显示两张卡片：
- 向量知识库卡片：显示已同步数量、总数据量和同步进度条
- 使用统计卡片：以柱状图展示训练次数、时长（小时）和平均对话数
实用工具区
| 按钮 | 功能说明 |
|---|---|
| 显示模式 | 显示悬浮控制栏和所有窗口 |
| 隐藏模式 | 隐藏悬浮控制栏和所有窗口（托盘窗口不受影响） |
| 交互模式 | 窗口可以正常点击和拖动，鼠标点击不会穿透 |
| 穿透模式 | 窗口依然可见，但鼠标点击会穿透到下层应用，不影响其他应用操作 |
| 退出 | 完全退出 CueMate 应用 |
TIP
当前激活的模式会显示紫色高亮和绿色对勾标识。快捷键 ⌘⇧CM 可在交互/穿透模式间快速切换。
1.3 系统偏好设置
点击顶部的设置按钮，进入系统偏好设置页面。
| 设置项 | 说明 |
|---|---|
| 大模型 | 选择当前使用的大语言模型，下拉列表显示所有已配置的模型 |
| 语言 | 选择界面显示语言：简体中文、繁体中文、English |
| Docker 镜像 | 控制退出应用时 Docker 容器的行为：退出不关闭（默认）或退出关闭 |
| Dock 图标 | 控制应用在 Dock 栏的显示状态：隐藏或显示 |
Docker 镜像设置
Docker 镜像设置用于控制退出 CueMate 应用时，后端 Docker 容器的行为。
- 退出不关闭（默认）：退出应用时 Docker 容器保持运行，下次启动应用时无需等待容器启动，启动更快
- 退出关闭：退出应用时停止所有 CueMate 相关的 Docker 容器，释放系统资源
TIP
如果你将 Docker 服务部署在远程服务器上，建议选择"退出不关闭"，让服务器上的容器持续运行。
Dock 图标设置
Dock 图标设置用于控制 CueMate 应用图标是否显示在 macOS 底部的 Dock 栏中。
- 隐藏：Dock 栏不显示 CueMate 图标，应用仅通过顶部菜单栏托盘图标访问，桌面更加简洁
- 显示：Dock 栏显示 CueMate 图标，方便通过 Dock 快速切换应用
TIP
如果你的 MacBook 有刘海屏，菜单栏空间有限，建议将 Dock 图标设置为"显示"，这样即使托盘图标被系统隐藏，也可以通过 Dock 栏访问应用。
WARNING
将 Dock 图标从"显示"切换为"隐藏"时，只会关闭当前运行时的 Dock 图标显示。如果你之前已将 CueMate 固定在程序坞中（"在程序坞中保留"），需要手动移除固定的图标，否则下次打开应用时图标仍会出现在程序坞中。
手动从 Dock 移除图标
在 Dock 栏中右键点击 CueMate 图标，选择"从程序坞中移除"即可。移除后，再次打开 CueMate 时程序坞将不再显示图标。
1.4 托盘图标不见了？
如果托盘图标消失，请检查：系统设置 > 控制中心 > 菜单栏项目，确认 CueMate 图标未被隐藏。
2. Windows
开发中
Windows 版本正在开发中，敬请期待。
如果你对 Windows 版本有任何建议或需求，欢迎通过以下方式反馈：
- GitHub Issues：https://github.com/cuemate-chat/cuemate/issues
- 邮箱：nuneatonhydroplane@gmail.com