系統要求
使用 CueMate 前，請確認你的裝置滿足以下系統要求。
1. macOS 平臺
1.1 桌面客戶端要求
NOTE
CueMate 同時支援 Intel 和 Apple Silicon 晶片的 Mac。下載時請選擇對應架構的安裝包。
1.1.1 最低配置
- 作業系統：macOS 13.0 (Ventura) 或更高版本
- 處理器：Intel Core i5 雙核或 Apple Silicon (M1/M2/M3)
- 記憶體：4GB RAM
- 儲存空間：10GB 可用空間（應用本身約 5GB）
- 顯示器：1280 x 720 解析度
TIP
推薦配置可獲得更流暢的使用體驗，特別是在使用語音識別和 AI 生成功能時。
1.1.2 推薦配置
- 作業系統：macOS 15 (Sequoia) 或更高版本
- 處理器：Intel Core i7 四核或 Apple Silicon (M1 Pro/M2 Pro/M3 Pro)
- 記憶體：8GB RAM
- 儲存空間：15GB 可用空間
- 顯示器：1920 x 1080 解析度或更高
1.1.3 系統許可權
IMPORTANT
必需許可權（缺少這些許可權將無法使用核心功能）：
麥克風許可權 - 用於捕獲你的語音輸入
- 授權路徑：系統偏好設定 > 安全性與隱私 > 隱私 > 麥克風
螢幕錄製許可權 - 用於捕獲面試軟體的系統音訊
- 授權路徑：系統偏好設定 > 安全性與隱私 > 隱私 > 螢幕錄製
可選許可權（增強功能體驗）：
輔助功能許可權 - 用於全域性快捷鍵和懸浮窗功能
- 授權路徑：系統偏好設定 > 安全性與隱私 > 隱私 > 輔助功能
完全磁碟訪問許可權 - 用於日誌檔案讀寫
- 授權路徑：系統偏好設定 > 安全性與隱私 > 隱私 > 完全磁碟訪問
1.2 Docker Desktop 要求
CueMate 的後端服務執行在 Docker 容器中，需要安裝 Docker Desktop。
IMPORTANT
安裝包已包含 Docker Desktop
CueMate 安裝包已內建 Docker Desktop 安裝程式（根據晶片型別自動選擇 Intel 或 Apple Silicon 版本），安裝嚮導會自動檢測並引導你完成 Docker 安裝，無需手動下載。
1.2.1 Docker Desktop 配置要求
- Docker Desktop 版本：4.0 或更高
- 記憶體分配：至少 4GB（推薦 8GB）
- CPU 核心：至少 2 核（推薦 4 核）
- 儲存空間：10GB 可用空間（用於 Docker 映象和資料）
1.2.2 自動化安裝流程
- 開啟 CueMate 安裝包 DMG 檔案
- 執行 "CueMate Installer.app" 安裝嚮導
- 安裝嚮導會自動檢測 Docker Desktop 狀態
- 如果未安裝，安裝嚮導會引導你安裝內建的 Docker Desktop
- 安裝完成後，安裝嚮導會自動配置資源分配並啟動所有服務
1.3 Docker 服務資源佔用
CueMate 包含 6 個 Docker 容器：
| 序號 | 服務 | 最小記憶體 | 推薦記憶體 | CPU 佔用 |
|---|---|---|---|---|
| 1 | cuemate-web | 128MB | 256MB | 2% |
| 2 | cuemate-web-api | 256MB | 512MB | 5% |
| 3 | cuemate-llm-router | 256MB | 512MB | 5% |
| 4 | cuemate-rag-service | 256MB | 512MB | 5% |
| 5 | cuemate-asr | 1GB | 2GB | 20% |
| 6 | cuemate-chroma | 256MB | 512MB | 5% |
| 總計 | 2.13GB | 4.25GB | 42% |
WARNING
資源佔用說明：
- ASR（語音識別）服務是資源佔用最多的元件（1-2GB 記憶體 + 20% CPU）
- 如果你的裝置效能有限，建議關閉該服務，僅使用 LLM 問答功能
- 總計資源需求：推薦至少 4GB 系統記憶體（2GB 系統 + 2GB Docker）
1.4 網路要求
1.4.1 頻寬要求
- 最低頻寬：5 Mbps（用於 LLM API 呼叫）
- 推薦頻寬：10 Mbps 或更高
1.4.2 網路連線
- 本地服務：無需網際網路連線（ASR、資料庫、Web API）
- LLM 服務：需要網際網路連線（呼叫雲端大模型 API）
- 離線模式：支援本地模型（Ollama、vLLM、Xinference），無需網際網路
1.4.3 網路埠
NOTE
CueMate 使用以下本地埠，請確保埠未被其他程式佔用。
| 序號 | 埠 | 服務 | 用途 |
|---|---|---|---|
| 1 | 3001 | Web API | 業務介面服務 |
| 2 | 3002 | LLM Router | 大模型路由服務 |
| 3 | 3003 | RAG Service | 知識庫檢索服務 |
| 4 | 3004 | 主視窗服務 | 後臺管理介面 |
| 5 | 8000 | ChromaDB | 向量資料庫 |
| 6 | 10095 | cuemate-asr | 語音識別服務 |
TIP
埠衝突解決：如果埠被佔用，可以在 Docker Compose 配置檔案中修改埠對映~/Library/Application\ Support/cuemate-desktop-client/docker/docker-compose.yml。
1.5 音訊裝置要求
1.5.1 麥克風
- 型別：任何標準麥克風（內建或外接）
- 取樣率：16000 Hz 或更高
- 位深度：16 bit
- 聲道：單聲道或立體聲
推薦裝置：
- 筆記本內建麥克風（基本可用）
- USB 麥克風（更好的音質）
- 耳機麥克風（降噪效果好）
- 專業麥克風（最佳效果）
1.5.2 系統音訊捕獲
macOS 使用 AudioTee 或虛擬音訊裝置進行系統音訊捕獲。
TIP
系統音訊測試：安裝後請使用"系統音訊測試"功能驗證能否正常捕獲面試軟體的音訊。
1.6 瀏覽要求（主視窗應用）
1.6.1 支援的瀏覽器
- Chrome：版本 90 或更高（推薦）
- Edge：版本 90 或更高
- Safari：版本 14 或更高
- Firefox：版本 88 或更高
1.6.2 瀏覽器功能要求
- 支援 WebSocket
- 支援 LocalStorage
- 啟用 JavaScript
- 啟用 Cookie
1.7 外部服務要求
1.7.1 LLM API（必需其中之一）
IMPORTANT
你需要至少擁有一個大模型 API Key 才能使用 CueMate 的 AI 功能。
| 序號 | 服務商 | 說明 |
|---|---|---|
| 1 | OpenAI | GPT 系列模型的國際服務商 |
| 2 | Azure OpenAI | 微軟 Azure 平臺上的 OpenAI 服務 |
| 3 | Anthropic | Claude 系列模型的國際服務商 |
| 4 | Google Gemini | Google 推出的多模態大模型 |
| 5 | AWS Bedrock | AWS 提供的大模型服務平臺 |
| 6 | 阿里雲百鍊 | 阿里雲推出的企業級大模型服務平臺 |
| 7 | 通義千問 | 阿里雲推出的 Qwen 系列大語言模型 |
| 8 | 智譜 AI | 智譜 AI 提供的 GLM 系列模型 |
| 9 | 百川智慧 | 百川智慧推出的 Baichuan 系列模型 |
| 10 | 百度千帆 | 百度推出的大語言模型平臺 |
| 11 | 位元組豆包 | 位元組跳動旗下的豆包大模型服務 |
| 12 | 訊飛星火 | 科大訊飛推出的星火認知大模型 |
| 13 | 騰訊混元 | 騰訊自研的大語言模型 |
| 14 | 騰訊雲知識引擎 | 騰訊雲提供的大模型服務 |
| 15 | Kimi | 月之暗面推出的 Kimi 智慧助手 |
| 16 | MiniMax | MiniMax 推出的超長文字大模型 |
| 17 | DeepSeek | DeepSeek 推出的高效能大模型 |
| 18 | 商湯日日新 | 商湯科技推出的 SenseNova 系列模型 |
| 19 | 階躍星辰 | 主打長上下文的 Step 系列模型 |
| 20 | 矽基流動 | 專注於 AI 推理加速的服務平臺 |
| 21 | Regolo | 本地模型服務 |
| 22 | Ollama | 本地執行大模型的開源工具 |
| 23 | vLLM | 高效能的大模型推理引擎 |
| 24 | Xinference | 支援多種模型的推理框架 |
1.8 資料儲存空間
1.8.1 最小儲存空間
- 應用程式：500MB
- Docker 映象：> 5GB
- SQLite 資料庫：100MB（初始）
- ChromaDB 向量資料：500MB（初始）
- 日誌檔案：<= 100MB
- 總計：<= 10GB
1.8.2 推薦儲存空間
- 知識庫文件：1GB（可根據需要增加）
- 系統資料增長：1GB 預留空間
- 總計：<= 12GB
1.8.3 資料目錄位置
- 應用資料：
~/Library/Application Support/cuemate-desktop-client - SQLite 資料庫：
~/Library/Application Support/cuemate-desktop-client/data/sqlite/cuemate.db - ChromaDB 資料：Docker volume
chroma_data - 日誌檔案：
~/Library/Application Support/cuemate-desktop-client/data/logs
1.9 效能基準測試
1.9.1 桌面客戶端效能
低配裝置（4GB RAM + 雙核 CPU）：
- 應用啟動時間：3-5 秒
- 語音識別延遲：1-2 秒
- AI 回答生成延遲：1-3 秒
- CPU 佔用：20-50%
- 記憶體佔用：2-3GB
高配裝置（8GB RAM + 四核 CPU）：
- 應用啟動時間：2-3 秒
- 語音識別延遲：0.5-1 秒
- AI 回答生成延遲：1-2 秒
- CPU 佔用：15-30%
- 記憶體佔用：1.5-2.5GB
1.9.2 Docker 服務效能
低配裝置：
- Docker 啟動時間：10-20 秒
- 所有服務就緒時間：20-30 秒
- 向量檢索延遲：200-500ms
- 總 CPU 佔用：40-60%
- 總記憶體佔用：3-5GB
高配裝置：
- Docker 啟動時間：5-10 秒
- 所有服務就緒時間：10-20 秒
- 向量檢索延遲：50-150ms
- 總 CPU 佔用：20-40%
- 總記憶體佔用：4-6GB
1.10 常見問題
1.10.1 效能最佳化建議
TIP
如果裝置效能不足：
- 關閉不必要的後臺應用
- 減少 Docker 容器的資源分配
- 使用更小的 LLM 模型（如 GPT-4o-mini）
- 禁用語音合成功能
- 減少向量資料庫的文件數量
TIP
如果網路速度慢：
- 使用國內大模型服務（阿里雲、智譜等）
- 降低 LLM 的 max_tokens 引數
- 使用本地模型（Ollama、vLLM）
- 啟用 LLM 響應快取
1.10.2 相容性問題
WARNING
macOS 版本過低：
- 如果你的 macOS 版本低於 13，無法執行 CueMate
- 建議升級到最新的 macOS 版本
WARNING
Docker Desktop 無法啟動：
- 檢查是否啟用了虛擬化支援
- 確認 macOS 版本符合 Docker Desktop 要求
2. 分散式部署伺服器端要求
NOTE
如果你選擇分散式部署模式（將 Docker 服務部署到遠端伺服器），請確保伺服器滿足以下要求。本地模式無需關注此章節。
2.1 伺服器硬體要求
2.1.1 最低配置
- 處理器：2 核 CPU
- 記憶體：4GB RAM
- 儲存空間：20GB 可用空間
- 網路：公網 IP 或內網可訪問
2.1.2 推薦配置
- 處理器：4 核 CPU 或更高
- 記憶體：8GB RAM 或更高
- 儲存空間：50GB 可用空間
- 網路：穩定的網路連線，頻寬 >= 10 Mbps
2.2 伺服器軟體要求
2.2.1 作業系統
- Linux：Ubuntu 20.04/22.04、CentOS 7/8、Debian 10/11 或其他主流 Linux 發行版
- 架構：x86_64 (amd64) 或 arm64
2.2.2 必需軟體
- Docker：20.10 或更高版本
- Docker Compose：2.0 或更高版本
- SSH 服務：OpenSSH Server（用於遠端連線）
2.3 網路配置
2.3.1 SSH 連線
- 埠：預設 22，可自定義
- 認證方式：密碼認證或 SSH 私鑰認證（推薦私鑰）
- 使用者許可權：需要 Docker 操作許可權（docker 組成員或 root 使用者）
2.3.2 服務埠
IMPORTANT
分散式模式下，以下埠需要在伺服器防火牆中開放，並確保桌面客戶端能夠訪問。
| 序號 | 埠 | 服務 | 用途 |
|---|---|---|---|
| 1 | 3001 | Web API | 業務介面服務 |
| 2 | 3002 | LLM Router | 大模型路由服務 |
| 3 | 3003 | RAG Service | 知識庫檢索服務 |
| 4 | 3004 | Web 前端 | 後臺管理介面 |
| 5 | 8000 | ChromaDB | 向量資料庫 |
| 6 | 10095 | ASR | 語音識別服務 |
2.4 部署路徑
- 預設路徑：
/opt/cuemate - 資料目錄：
/opt/cuemate/data - 日誌目錄：
/opt/cuemate/logs
TIP
部署路徑可在系統設定中自定義配置。確保指定路徑有足夠的讀寫許可權。
3. Windows 平臺
3.1 桌面客戶端要求
NOTE
CueMate Windows 版本支援 x64 (AMD64) 和 arm64 (ARM64) 雙架構。下載時請選擇對應架構的安裝包。
3.1.1 最低配置
- 作業系統：Windows 10（64 位）或 Windows 11
- 處理器：x64 架構（Intel/AMD 64 位處理器）或 arm64 架構（如高通驍龍處理器）
- 記憶體：4GB RAM
- 儲存空間：10GB 可用空間（推薦 SSD）
- 顯示器：1280 x 720 解析度
TIP
推薦配置可獲得更流暢的使用體驗，特別是在使用語音識別和 AI 生成功能時。
3.1.2 推薦配置
- 作業系統：Windows 11
- 處理器：Intel Core i5/i7 或 AMD Ryzen 5/7
- 記憶體：8GB RAM
- 儲存空間：15GB 可用空間（SSD）
- 顯示器：1920 x 1080 解析度或更高
3.1.3 系統許可權
IMPORTANT
必需許可權（缺少這些許可權將無法使用核心功能）：
麥克風許可權 - 用於捕獲你的語音輸入
- 授權路徑：設定 > 隱私權與安全性 > 麥克風
音訊裝置訪問 - 用於捕獲面試軟體的系統音訊
- Windows 使用 Electron Audio Loopback，無需額外配置
3.2 Docker Desktop 要求
CueMate 的後端服務執行在 Docker 容器中，需要安裝 Docker Desktop。
IMPORTANT
Windows Docker Desktop 需要 WSL 2
Windows 上的 Docker Desktop 需要 WSL 2（適用於 Linux 的 Windows 子系統 2）作為後端。安裝嚮導會自動檢測並引導你完成安裝。
3.2.1 WSL 2 要求
- 作業系統版本：Windows 10 版本 1903 或更高，或 Windows 11
- 虛擬化：BIOS/UEFI 中必須啟用虛擬化
- 記憶體：至少 4GB RAM 用於 WSL 2
3.2.2 Docker Desktop 配置要求
- Docker Desktop 版本：4.0 或更高
- WSL 2 後端：必須啟用
- 記憶體分配：至少 4GB（推薦 8GB）
- CPU 核心：至少 2 核（推薦 4 核）
- 儲存空間：10GB 可用空間（用於 Docker 映象和資料）
3.3 網路要求
與 macOS 平臺相同，請參考 macOS 網路要求。
3.4 音訊裝置要求
3.4.1 麥克風
與 macOS 平臺要求相同，請參考 macOS 麥克風要求。
3.4.2 系統音訊捕獲
Windows 使用 Electron Audio Loopback 進行系統音訊捕獲，與 macOS 的 AudioTee 不同。
TIP
系統音訊測試：安裝後請使用「系統音訊測試」功能驗證能否正常捕獲面試軟體的音訊。
3.5 資料儲存位置
- 應用資料：
%APPDATA%\cuemate-desktop-client - SQLite 資料庫：
%APPDATA%\cuemate-desktop-client\data\sqlite\cuemate.db - ChromaDB 資料：Docker volume
chroma_data - 日誌檔案：
%APPDATA%\cuemate-desktop-client\data\logs
3.6 常見問題
3.6.1 WSL 2 安裝失敗
WARNING
WSL 2 安裝問題：
- 確保在 BIOS/UEFI 中啟用了虛擬化
- 將 Windows 更新到最新版本
- 在 PowerShell（系統管理員）中執行
wsl --install
3.6.2 Docker Desktop 無法啟動
WARNING
Docker Desktop 無法啟動：
- 檢查 WSL 2 是否正確安裝
- 確認虛擬化支援已啟用
- 嘗試重新啟動電腦
如果你的裝置滿足上述要求，可以開始 安裝 CueMate。
如有其他問題，請檢視 常見問題 或聯絡技術支援。