系統設定

系統設定頁面用於配置 CueMate 的系統偏好、懸浮窗行為、帳戶資訊和伺服器部署配置。頁面分為四個部分：系統偏好設定、懸浮窗設定、帳戶資訊和伺服器部署配置（僅分散式部署模式下顯示）。

1. 進入設定頁面

1.1 開啟系統設定

點選頂部下拉選單的「系統設定」，進入設定頁面。

頂部下拉選單

進入系統設定

2. 系統偏好設定

2.1 語言選擇

在「語言」下拉框中選擇介面顯示語言。

支援語言：

簡體中文（zh-CN）：中國大陸地區使用者
繁體中文（zh-TW）：中國臺灣、香港地區使用者
English（en-US）：英語使用者

影響範圍：

介面所有文字顯示
系統提示資訊
AI 回答語言偏好
桌面用戶端 TTS 語音選擇

使用場景：

切換到自己熟悉的語言
為不同地區使用者配置介面
配合 TTS 語音選擇對應語言

語言選擇

NOTE

即時儲存說明：系統偏好設定（語言、主題、時區、大模型）修改後即時生效並自動儲存到資料庫，無需點選儲存按鈕。此處的語言選擇與右上角的語言選擇是同一資料來源，修改任意一處，另一處自動重新整理。

2.2 主題切換

點選「主題」按鈕組，切換介面主題。

主題選項：

淺色：白色背景，適合白天使用
深色：深色背景，適合夜間使用，減少眼睛疲勞
自動：跟隨系統主題自動切換

切換方式：

點選對應按鈕立即生效
選中的按鈕高亮顯示（藍色背景）
自動模式會根據系統時間或系統主題設定自動切換

使用場景：

夜間使用切換深色主題
根據環境光線調整主題
保持與系統主題一致

主題切換

2.3 時區設定

在「時區」下拉框中選擇顯示的時區。

支援時區：

北京時間（Asia/Shanghai, UTC+8）：中國大陸
香港時間（Asia/Hong_Kong, UTC+8）：香港地區
日本時間（Asia/Tokyo, UTC+9）：日本
太平洋時間（America/Los_Angeles, UTC-8）：美國西海岸
倫敦時間（Europe/London, UTC+0）：英國

影響範圍：

面試記錄建立時間顯示
通知推送時間顯示
日誌時間戳顯示

使用場景：

在不同地區工作時調整時區
準確記錄面試時間

時區設定

2.4 軟體版本

顯示當前 CueMate 軟體版本號（只讀）。

版本資訊：

顯示當前安裝的版本號（如 v0.1.1）
不可編輯
用於技術支援和問題排查

使用場景：

檢查當前使用的版本
反饋問題時提供版本資訊
確認是否需要更新

2.5 大模型服務商

在「大模型服務商」下拉框中選擇當前帳號繫結的 LLM 模型（模型設定頁面建立）。

模型設定 - 管理和配置 LLM 模型

模型選擇：

下拉框顯示所有已配置的 LLM 模型
格式：模型名稱 (模型型號)
例如：OpenAI GPT-4 (gpt-4-turbo)、訊飛星火 (generalv3.5)

使用場景：

最佳化履歷時呼叫大模型生成最佳化後的文字
模擬面試時生成面試問題和答案
面試訓練時，針對面試官提問生產答案
根據面試資料，生成面試覆盤總結

重要提示：

下拉選擇模型後即時生效並自動儲存，無需點選儲存按鈕
也可以前往「模型設定」頁面管理和新增新模型
確保選擇的模型已正確配置 API Key 和參數

大模型服務商

2.6 政策協議

檢視使用者協議和隱私政策連結。

協議連結：

使用者協議：CueMate 使用條款和服務協議
隱私政策：資料收集、使用和保護政策

使用場景：

瞭解 CueMate 服務條款
檢視隱私和資料保護政策
確認使用者權益和責任

服務協議：

隱私政策：

3. 懸浮窗設定

3.1 點選穿透模式

切換桌面用戶端懸浮窗的互動模式。

模式選項：

互動模式（floating_window_visible = 1）：
- 懸浮窗可以點選和互動
- 可以拖動、調整大小
- 滑鼠點選不會穿透
穿透模式（floating_window_visible = 0）：
- 懸浮窗依然可見
- 滑鼠點選會穿透到下層應用
- 不影響其他應用操作

快捷鍵切換：

macOS：⌘⇧CM（Command + Shift + C + M，為了不與頁面其他所有軟體熱鍵衝突）
在兩種模式間快速切換

使用場景：

面試時需要檢視答案但不想遮擋螢幕，例如線上編碼
穿透模式下檢視提示詞，同時操作面試或其他軟體
需要與懸浮窗互動時切換到互動模式

點選穿透模式

3.2 視窗高度

設定桌面用戶端懸浮視窗的螢幕高度佔比。

高度選項：

50%：懸浮窗佔螢幕高度的一半
75%：懸浮窗佔螢幕高度的 3/4
100%：懸浮窗佔滿整個螢幕高度

調整建議：

50%：適合小螢幕或需要同時檢視多個視窗
75%：平衡視野和螢幕空間（推薦）
100%：最大化顯示內容，適合大螢幕

使用場景：

根據螢幕尺寸調整懸浮窗大小
最佳化答案顯示區域
避免懸浮窗遮擋其他重要內容

50% 視窗高度： 75% 視窗高度： 100% 視窗高度：

4. 帳戶資訊

4.1 ID 和使用者名稱

檢視和編輯帳戶 ID 和使用者名稱，右上角顯示名稱。

ID 欄位（只讀）：

顯示帳戶唯一識別碼
UUID 格式
用於技術支援和日誌定位

使用者名稱欄位（可編輯）：

顯示當前使用者名稱
可以修改為任意名稱
修改後需要點選「儲存設定」按鈕

使用場景：

檢視帳戶 ID 用於問題排查
修改使用者名稱為個性化名稱

ID 和使用者名稱

4.2 郵箱

編輯帳戶郵箱地址。

郵箱欄位（可編輯）：

顯示當前繫結的郵箱地址
可以修改為新的郵箱
修改後需要點選「儲存設定」按鈕

使用場景：

更新郵箱地址
接收系統通知和重要資訊
用於帳戶找回和驗證

4.3 建立時間

檢視帳戶建立時間（只讀）。

建立時間欄位：

顯示帳戶註冊日期和時間
不可編輯
本地時間格式顯示

使用場景：

檢視帳戶使用時長
確認帳戶建立日期

4.4 修改密碼

點選「修改密碼」按鈕，編輯並儲存新密碼。

NOTE

預設登入憑證：

預設使用者名稱：admin
預設密碼：cuemate
首次登入後建議立即修改密碼以確保帳戶安全

修改流程：

點選「修改密碼」按鈕，進入編輯模式
在左側輸入框輸入原密碼（至少 6 位）
在右側輸入框輸入新密碼（至少 6 位）
點選眼睛圖示可以顯示/隱藏密碼
輸入密碼長度不足時顯示紅色錯誤提示
點選「儲存密碼」按鈕，單獨提交密碼修改請求
密碼修改成功後，再點選頁面底部「儲存」按鈕應用其他設定

密碼要求：

最小長度：6 位
原密碼必須正確
新密碼不能與原密碼相同

安全提示：

定期修改密碼提高安全性
使用強密碼（包含大小寫字母、數字、特殊字元）
不要與其他網站共用密碼

修改密碼

5. 伺服器部署配置

NOTE

顯示條件：此卡片僅在分散式部署模式下顯示。當 server.json 配置檔案中 mode 設定為 "server" 時，才會在設定頁面顯示此配置卡片。本地模式（mode: "local"）下不會顯示。

伺服器部署配置用於管理遠端伺服器的連線資訊和服務埠配置。

WARNING

重要提示：如果伺服器配置錯誤導致無法連線到 Web 服務，此頁面將無法開啟。在這種情況下，請使用托盤視窗 - 伺服器配置來修改配置，因為托盤視窗是本地渲染的，不受遠端伺服器連線狀態影響。

伺服器部署配置

5.1 伺服器基本資訊

伺服器名稱：

自訂的伺服器標識名稱
便於區分多個伺服器配置
例如：Production Server、Test Server

伺服器地址：

遠端伺服器的 IP 地址或域名
例如：192.168.1.100 或 server.example.com

SSH 埠：

SSH 連線埠，預設為 22
用於遠端管理和部署

5.2 認證資訊

SSH 使用者名稱：

用於 SSH 連線的使用者名稱
通常為 root 或具有 sudo 權限的使用者

認證方式：

密碼認證：使用密碼進行 SSH 認證
私鑰認證：使用 SSH 私鑰進行認證（更安全）

密碼/私鑰：

非編輯模式下顯示為 ********（已設定時）或「未設定」
點選「編輯伺服器配置」按鈕後可檢視和修改真實值
私鑰認證時需要貼上完整的私鑰內容

編輯伺服器配置

5.3 部署路徑

部署路徑：

CueMate 服務在遠端伺服器上的安裝目錄
預設為 /opt/cuemate
所有服務元件將部署到此目錄下

5.4 服務埠配置

配置各個服務元件的埠號：

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

埠配置建議：

確保埠未被其他服務佔用
防火牆需開放對應埠
生產環境建議使用 HTTPS（443 埠）

5.5 最後連線時間

顯示上次成功連線到伺服器的時間（只讀）。

使用場景：

確認伺服器連線狀態
排查連線問題時參考

5.6 儲存伺服器配置

點選「儲存伺服器配置」按鈕，將修改儲存到本地配置檔案。

儲存流程：

點選「編輯伺服器配置」按鈕進入編輯模式
修改需要更新的欄位
點選「儲存伺服器配置」按鈕
配置儲存成功後顯示提示資訊

重要提示：

伺服器配置儲存在本地 server.json 檔案中
修改埠後需要重新部署服務才能生效
確保伺服器地址和認證資訊正確

5.7 測試連線

在儲存配置前，可以點選「測試連線」按鈕驗證 SSH 連線是否正常。

測試連線成功

測試流程：

填寫伺服器地址、埠、使用者名稱和認證資訊
點選「測試連線」按鈕
系統嘗試建立 SSH 連線
連線成功顯示綠色提示，失敗顯示紅色錯誤資訊

測試內容：

SSH 連線是否可達
使用者名稱和密碼/私鑰是否正確
埠是否開放

使用場景：

首次配置伺服器前驗證連線資訊
修改認證資訊後確認配置正確
排查連線問題時定位錯誤原因

TIP

建議在儲存配置前先進行連線測試，確保伺服器連線資訊正確無誤。測試成功後再點選「儲存伺服器配置」按鈕。

5.8 Web 系統設定 vs 托盤視窗

伺服器配置可以在兩個位置修改，功能相同但可用性不同：

對比項	Web 系統設定（本頁面）	托盤視窗
渲染位置	遠端伺服器	本地桌面用戶端
依賴條件	需要伺服器連線正常	不依賴任何遠端服務
可用性	配置錯誤時可能無法開啟	始終可用
適用場景	日常配置修改	緊急修復、首次配置
推薦程度	一般	推薦

TIP

推薦使用托盤視窗修改伺服器配置。托盤視窗執行在本地桌面用戶端，是最可靠的配置入口。當以下情況發生時，Web 系統設定頁面可能無法開啟：

伺服器地址填寫錯誤
遠端伺服器上的 CueMate 服務未啟動
網路連線問題
防火牆阻止訪問

此時只能透過托盤視窗或手動編輯配置檔案來修復。詳情請參考托盤視窗 - 伺服器配置。

手動修改配置檔案

如果兩個介面都無法正常操作，可以直接編輯配置檔案：

bash

# macOS 配置檔案位置
~/Library/Application Support/cuemate-desktop-client/config/server.json

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

WARNING

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

6. 儲存設定

6.1 即時儲存與手動儲存

CueMate 系統設定採用混合儲存機制：

即時儲存（自動）：

系統偏好設定：語言、主題、時區、大模型服務商
懸浮窗設定：點選穿透模式、視窗高度
修改後立即生效並自動儲存到伺服器，無需點選儲存按鈕

手動儲存（需點選按鈕）：

帳戶資訊：使用者名稱、電子郵件
修改後需要點選「儲存設定」按鈕才會儲存到伺服器

6.2 重新整理設定

點選「重新整理」按鈕，重新載入伺服器端的最新設定。

重新整理功能：

從伺服器重新獲取使用者資訊
更新模型列表
恢復表單到伺服器儲存的狀態

使用場景：

放棄本地修改，恢復到伺服器狀態
在其他裝置修改設定後同步
確認設定是否已正確儲存

6.3 儲存設定

點選「儲存設定」按鈕，將帳戶資訊儲存到伺服器。

儲存內容：

使用者名稱
電子郵件

儲存流程：

點選「儲存設定」按鈕
顯示「正在儲存設定...」全屏載入提示
提交資料到伺服器
儲存成功後顯示「設定已儲存」提示
更新本地快取

重要提示：

修改密碼是單獨儲存的，不在此按鈕範圍內
系統偏好和懸浮窗設定已即時儲存，此按鈕僅用於儲存帳戶資訊
確保使用者名稱和電子郵件填寫正確後再點選儲存

儲存設定

最佳實踐

定期維護

建議操作：

每月檢查並更新郵箱地址
定期修改密碼提高安全性
根據使用習慣調整主題和語言
確認大模型配置正確

懸浮窗最佳化

最佳化建議：

面試前測試懸浮窗設定是否符合預期
熟練使用快捷鍵切換穿透模式
根據螢幕大小調整視窗高度
穿透模式下確保能看清答案內容

模型選擇

選擇技巧：

根據任務類型選擇合適的模型
技術面試推薦使用 OpenAI 或阿里雲百鍊
測試不同模型的回答品質
前往「模型設定」頁面配置和管理模型

時區和語言

配置建議：

在不同地區工作時及時調整時區
語言選擇與 TTS 語音保持一致
確保時間顯示準確，避免混淆

系統設定 ​

1. 進入設定頁面 ​

1.1 開啟系統設定 ​

2. 系統偏好設定 ​

2.1 語言選擇 ​

2.2 主題切換 ​

2.3 時區設定 ​

2.4 軟體版本 ​

2.5 大模型服務商 ​

2.6 政策協議 ​

3. 懸浮窗設定 ​

3.1 點選穿透模式 ​

3.2 視窗高度 ​

4. 帳戶資訊 ​

4.1 ID 和使用者名稱 ​

4.2 郵箱 ​

4.3 建立時間 ​

4.4 修改密碼 ​

5. 伺服器部署配置 ​

5.1 伺服器基本資訊 ​

5.2 認證資訊 ​

5.3 部署路徑 ​

5.4 服務埠配置 ​

5.5 最後連線時間 ​

5.6 儲存伺服器配置 ​

5.7 測試連線 ​

5.8 Web 系統設定 vs 托盤視窗 ​

6. 儲存設定 ​

6.1 即時儲存與手動儲存 ​

6.2 重新整理設定 ​

6.3 儲存設定 ​

最佳實踐 ​

定期維護 ​

懸浮窗最佳化 ​

模型選擇 ​

時區和語言 ​

相關頁面 ​

系統設定

1. 進入設定頁面

1.1 開啟系統設定

2. 系統偏好設定

2.1 語言選擇

2.2 主題切換

2.3 時區設定

2.4 軟體版本

2.5 大模型服務商

2.6 政策協議

3. 懸浮窗設定

3.1 點選穿透模式

3.2 視窗高度

4. 帳戶資訊

4.1 ID 和使用者名稱

4.2 郵箱

4.3 建立時間

4.4 修改密碼

5. 伺服器部署配置

5.1 伺服器基本資訊

5.2 認證資訊

5.3 部署路徑

5.4 服務埠配置

5.5 最後連線時間

5.6 儲存伺服器配置

5.7 測試連線

5.8 Web 系統設定 vs 托盤視窗

6. 儲存設定

6.1 即時儲存與手動儲存

6.2 重新整理設定

6.3 儲存設定

最佳實踐

定期維護

懸浮窗最佳化

模型選擇

時區和語言

相關頁面