托盤視窗

托盤視窗是 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 部署為伺服器模式時，托盤視窗的頁面頂部會顯示「伺服器配置」按鈕。點選可以進入伺服器配置頁面，修改遠端伺服器的連線資訊。

伺服器配置頁面

伺服器配置頁面用於配置遠端伺服器的 SSH 連線資訊和服務埠。

配置項	說明
伺服器名稱	自訂伺服器名稱，便於識別和管理
伺服器地址	遠端伺服器的 IP 地址或域名
SSH 埠	SSH 連線埠，預設為 22
使用者名稱	SSH 登入使用者名稱
認證方式	支援密碼認證或私鑰認證兩種方式
密碼/私鑰	根據認證方式填寫對應的密碼或私鑰內容
部署路徑	CueMate 服務在遠端伺服器上的部署目錄

埠配置

伺服器配置頁面還可以配置各個服務的埠號：

埠配置項	預設值	說明
Web API 埠	3001	Web API 服務埠
LLM Router 埠	3002	大模型路由服務埠
RAG Service 埠	3003	向量檢索服務埠
Web 埠	3004	Web 前端服務埠
Chroma 埠	8000	Chroma 向量資料庫埠
ASR 埠	10095	語音識別服務埠

測試連線

配置完成後，點選「測試連線」按鈕可以驗證 SSH 連線是否正常。測試成功後會顯示綠色提示，失敗則顯示紅色錯誤訊息。

TIP

建議在儲存配置前先進行連線測試，確保伺服器連線資訊正確無誤。

儲存配置

點選「儲存」按鈕將配置儲存到本地。儲存成功後，CueMate 會使用新的伺服器配置連線遠端服務。

WARNING

修改伺服器配置後，需要重啟 CueMate 應用才能使新配置生效。

連線錯誤處理

如果伺服器配置填寫錯誤，或者遠端伺服器上的服務未啟動，主視窗會顯示連線錯誤頁面：

錯誤頁面會顯示：

連線失敗的目標地址（如 http://127.0.0.11:3004）
具體的錯誤訊息（如 ERR_CONNECTION_TIMED_OUT）
「重試連線」按鈕

常見錯誤原因：

伺服器地址填寫錯誤
SSH 埠或服務埠配置不正確
遠端伺服器上的 CueMate 服務未啟動
防火牆阻止了埠訪問
網路連線問題

TIP

遇到連線錯誤時，可以透過托盤視窗的「伺服器配置」頁面修改配置，因為托盤視窗是本地渲染的，不受遠端伺服器連線狀態影響。

手動修改配置檔案

如果托盤視窗無法正常操作，或者需要批次修改配置，可以直接編輯配置檔案：

配置檔案位置：

bash

# macOS
~/Library/Application Support/cuemate-desktop-client/config/server.json

# 使用 VS Code 開啟
code ~/Library/Application\ Support/cuemate-desktop-client/config/server.json

# 使用 vim 開啟
vim ~/Library/Application\ Support/cuemate-desktop-client/config/server.json

# 使用 cat 檢視內容
cat ~/Library/Application\ Support/cuemate-desktop-client/config/server.json

配置檔案格式：

json

{
  "version": "v0.1.0",
  "mode": "server",
  "server": {
    "id": "server-001",
    "name": "My Server",
    "host": "192.168.1.100",
    "sshPort": 22,
    "username": "root",
    "authType": "password",
    "password": "your-password",
    "privateKey": null,
    "passphrase": null,
    "deployPath": "/opt/cuemate",
    "ports": {
      "webApi": 3001,
      "llmRouter": 3002,
      "ragService": 3003,
      "chroma": 8000,
      "asr": 10095,
      "web": 3004
    }
  }
}

WARNING

手動修改配置檔案後，需要重啟 CueMate 應用才能生效。

托盤視窗 vs Web 系統設定

伺服器配置可以在兩個位置修改：

位置	特點
托盤視窗（推薦）	本地渲染，不依賴遠端伺服器，即使伺服器連線失敗也能正常操作
Web 系統設定	需要連線到遠端伺服器才能開啟，如果配置錯誤可能無法訪問

TIP

推薦使用托盤視窗修改伺服器配置。托盤視窗執行在本地，是最可靠的配置入口。當 Web 頁面因伺服器連線問題無法開啟時，托盤視窗仍然可以正常使用。

Web 系統設定中的伺服器配置功能，請參考系統設定 - 伺服器部署配置。

1.5 托盤圖示不見了？

如果托盤圖示消失，請檢查：系統設定 > 控制中心 > 選單欄專案，確認 CueMate 圖示未被隱藏。

2. Windows

開發中

Windows 版本正在開發中，敬請期待。

如果你對 Windows 版本有任何建議或需求，歡迎透過以下方式反饋：

GitHub Issues：https://github.com/cuemate-chat/cuemate/issues
郵箱：nuneatonhydroplane@gmail.com

模型設定

托盤視窗

1. macOS

1.1 CueMate 圖示

1.2 托盤視窗

1.3 系統偏好設定

1.4 伺服器配置

1.5 托盤圖示不見了？

2. Windows

相關頁面

托盤視窗 ​

1. macOS ​

1.1 CueMate 圖示 ​

1.2 托盤視窗 ​

1.3 系統偏好設定 ​

1.4 伺服器配置 ​

1.5 托盤圖示不見了？ ​

2. Windows ​

相關頁面 ​

托盤視窗

1. macOS

1.1 CueMate 圖示

1.2 托盤視窗

1.3 系統偏好設定

1.4 伺服器配置

1.5 托盤圖示不見了？

2. Windows

相關頁面