Windows 安裝指南
歡迎使用 CueMate！本指南將幫助你在 Windows 系統上安裝 CueMate，整個過程簡單快捷，只需幾分鐘即可完成。
推薦部署方式
建議將後端服務部署到 Linux 伺服器，Windows 本地僅執行輕量桌面客戶端。
CueMate 支援「伺服器部署模式」，可將 Docker 後端服務部署到遠端 Linux/macOS 伺服器，本地 Windows 僅作為客戶端使用。這種方式有以下優勢：
| 對比項 | Windows 本地部署 | Linux 伺服器部署 |
|---|---|---|
| Docker 效能 | 依賴 WSL2 虛擬化，效能損耗約 10-20% | 原生執行，效能最優 |
| 記憶體佔用 | WSL2 + Docker Desktop 額外佔用 2-4GB | 無額外開銷 |
| 系統穩定性 | WSL2 偶發網路/檔案系統問題 | 穩定可靠 |
| 啟動速度 | Docker Desktop 啟動較慢（30-60 秒） | 服務常駐，即開即用 |
| 資源釋放 | 需手動退出 Docker Desktop 釋放記憶體 | 不佔用本地資源 |
| 多裝置共享 | 僅限本機使用 | 多台電腦可共享同一後端 |
如果你有閒置的 Linux 伺服器（雲端伺服器、NAS、樹莓派等），強烈建議使用伺服器部署模式。安裝時選擇「伺服器模式」並配置 SSH 連線即可。
以下指南適用於選擇在 Windows 本地部署的使用者。
1. 系統要求
IMPORTANT
請在安裝前確認你的電腦滿足最低配置要求，否則可能導致安裝失敗或執行異常。
在安裝 CueMate 之前，請確認你的電腦符合以下配置要求：
1.1 硬體與系統
| 序號 | 配置項 | 要求 | 說明 |
|---|---|---|---|
| 1 | 作業系統 | Windows 10 (64 位) 或 Windows 11 | 需要 64 位系統 |
| 2 | 處理器 | x64 架構 CPU | Intel 或 AMD 64 位處理器 |
| 3 | 記憶體 | >= 8GB RAM（推薦 16GB） | Docker + WSL2 需要較多記憶體 |
| 4 | 磁碟空間 | >= 10GB 可用空間 | 推薦使用 SSD 固態硬碟 |
| 5 | 網路連線 | 穩定的網際網路連線 | 用於下載安裝包和 AI 服務 |
IMPORTANT
關於 WSL2 的說明
CueMate 依賴 Docker Desktop 執行後端服務，而 Docker Desktop 在 Windows 上需要 WSL2（Windows Subsystem for Linux 2）作為執行環境。
安裝/更新 WSL2：以系統管理員身分開啟 PowerShell，執行以下命令：
wsl --update如果提示未安裝 WSL，請先執行：
wsl --install安裝完成後需要重新啟動電腦。
1.2 連接埠占用檢查
CueMate 需要使用以下連接埠，請確保這些連接埠未被其他程式占用：
| 序號 | 連接埠 | 服務名稱 | 用途說明 |
|---|---|---|---|
| 1 | 3001 | Web API 服務 | 業務介面服務 |
| 2 | 3002 | LLM Router 服務 | 大語言模型路由 |
| 3 | 3003 | RAG 知識庫服務 | 知識檢索服務 |
| 4 | 3004 | 主視窗服務 | 提供主視窗介面存取 |
| 5 | 8000 | ChromaDB 向量資料庫 | 向量資料儲存 |
| 6 | 10095 | 語音辨識服務 | 即時語音轉文字 |
注意：安裝精靈會自動檢測連接埠占用情況，如有衝突會提供解決方案。詳見 步驟 7：連接埠檢查。
1.3 依賴環境
| 序號 | 依賴項 | 版本要求 | 說明 |
|---|---|---|---|
| 1 | Docker Desktop | >= 4.0 | CueMate 後端服務執行環境 |
TIP
- 離線包：包含 Docker Desktop 安裝包，無需提前安裝
- 線上包：需要使用者自行安裝 Docker Desktop
注意：如果未安裝 Docker Desktop，安裝精靈會提供自動安裝選項。詳見 步驟 8：Docker 檢查。
2. 下載安裝包
2.1 選擇安裝包類型
CueMate 提供兩種安裝包類型，請根據你的需求選擇：
| 類型 | 說明 | 體積 | 適用場景 |
|---|---|---|---|
| 離線包 (Offline) | 包含 Docker Desktop、所有 Docker 映像檔和語音模型，開箱即用 | 約 4.5GB | 無網路環境、首次安裝 |
| 線上包 (Online) | 需自行安裝 Docker Desktop，安裝時從網路拉取映像檔和語音模型 | 約 700MB | 網路良好、已有 Docker |
TIP
- 首次安裝推薦使用離線包，包含所有依賴，無需額外下載
- 已安裝 Docker Desktop 的使用者可使用線上包，下載更快
IMPORTANT
線上包使用者注意：首次啟動 CueMate 時，語音辨識服務（cuemate-asr）會自動下載 FunASR 語音模型（約 1.7GB）。下載期間語音辨識功能暫時不可用，請確保網路暢通並耐心等待下載完成。
離線包已內建語音模型，無需額外下載，啟動即可使用。
2.2 選擇部署模式
CueMate 支援兩種部署模式，安裝時可以選擇：
| 模式 | 說明 | 適用場景 |
|---|---|---|
| 本地模式 | 所有服務執行在本機電腦上 | 個人使用、本機開發 |
| 伺服器模式 | 後端服務部署到遠端 Linux 伺服器，本機僅執行輕量用戶端 | 多裝置共享、伺服器資源更強 |
詳細的部署模式選擇介面請參考 步驟 3：部署模式。
NOTE
- 本地模式：開箱即用，所有資料儲存在本機
- 伺服器模式：需要一台 Linux 伺服器，用戶端透過 SSH 連線伺服器管理後端服務
2.3 選擇下載管道
CueMate 提供兩種下載管道，請根據網路環境選擇：
方式一：百度網盤（推薦中國大陸使用者）
下載連結：https://pan.baidu.com/s/15jwZHy8YkDa4cEDLIYRo9Q?pwd=3477
提取碼：3477
手機掃碼存取：
下載步驟：
- 點擊上方連結或掃描 QR Code 存取百度網盤
- 輸入提取碼
3477 - 選擇對應的版本資料夾（如 v0.2.0）
- 下載 Windows 安裝包：
| 安裝包類型 | 檔案名稱 |
|---|---|
| 離線包 | CueMate-v0.2.0-windows-x64-offline.exe |
| 線上包 | CueMate-v0.2.0-windows-x64-online.exe |
- 點擊「下載」按鈕，儲存到本機
優勢：中國大陸下載速度快，無需科學上網
方式二：GitHub Release（推薦海外使用者）
存取 GitHub Releases 頁面下載最新版本或歷史版本：
版本列表：
| 版本 | 釋出日期 | 型別 | 主要更新 | 下載連結 |
|---|---|---|---|---|
| v0.2.0 | 2026-01-31 | 功能更新 | Windows 版本首發、線上/離線安裝包、伺服器部署模式、多語言支援 | GitHub Release 頁面 |
| v0.1.1 | 2025-12-26 | 功能更新 | 線上/離線安裝包、伺服器部署模式、多語言支援 | GitHub Release 頁面 |
| v0.1.0 | 2025-12-10 | 首發版本 | 核心功能釋出 | GitHub Release 頁面 |
選擇安裝包類型：
- 線上包（約 700MB）：下載快，安裝時需要網路拉取 Docker 映像檔和語音模型
- 離線包（約 4.5GB）：體積大，開箱即用無需網路
線上包下載（推薦網路良好的用戶）：
- 訪問 GitHub Release 頁面
- 下載 Windows x64 線上安裝包：
CueMate-vX.X.X-windows-x64-online.exe - 下載完成後，雙擊
.exe檔案開始安裝
離線包下載（推薦網路不穩定的用戶）：
NOTE
由於離線包體積較大（約 4.5GB），超過 GitHub 單檔案 2GB 限制，已拆分為多個分卷上傳。
- 訪問 GitHub Release 頁面
- 下載所有 Windows x64 離線安裝包分卷檔案：
CueMate-vX.X.X-windows-x64-offline.part*.exe - 將所有分卷檔案放在同一個目錄下
- 雙擊第一個分卷檔案（
.part1.exe），解壓程式會自動合併所有分卷 - 解壓完成後，雙擊
.exe檔案開始安裝
優勢：全球 CDN 加速，版本管理清晰，支援校驗和驗證
下載完成後，安裝包會儲存在你的「下載」資料夾中。
2.4 開啟安裝包
雙擊下載的 .exe 檔案，Windows 會啟動安裝精靈。
3. 安裝步驟
安裝精靈包含 11 個步驟，會自動引導你完成整個安裝過程。
安裝精靈介面提供以下資訊和功能：
- 語言切換（右上角）：支援簡體中文、繁體中文、English 三種語言，可隨時切換
- 安裝模式（頂部標籤）：顯示當前安裝包類型，如「離線安裝」或「線上安裝」
- 部署模式（頂部標籤）：顯示當前部署模式，如「本地模式」或「伺服器模式」，可在步驟 3 中修改
- 版本資訊（左下角）：顯示當前安裝精靈的版本號
3.1 步驟 1：歡迎
安裝精靈啟動後，首先顯示歡迎介面，介紹 CueMate 的功能和安裝前準備事項。
閱讀歡迎資訊後，點擊 下一步 按鈕繼續。
3.2 步驟 2：許可協議
閱讀 CueMate 的軟體許可協議。
如果你同意合約條款，勾選「我同意許可協議」，然後點擊 下一步 按鈕。
3.3 步驟 3：部署模式
選擇 CueMate 的部署模式。
| 模式 | 說明 | 適用場景 |
|---|---|---|
| 本地模式 | 所有服務執行在本機電腦上，開箱即用 | 個人使用、本機開發、首次體驗 |
| 伺服器模式 | 後端服務部署到遠端 Linux 伺服器，本機僅執行輕量用戶端 | 多裝置共享、伺服器資源更強、團隊協作 |
本地模式（預設推薦）：
- 所有服務執行在本機，無需額外配置
- 資料儲存在本機，隱私性更好
- 適合大多數使用者
伺服器模式：
- 需要一台 Linux 伺服器（Ubuntu 20.04+ 或 CentOS 7+）
- 本機電腦僅作為用戶端，資源占用少
- 支援多台電腦共享同一個後端服務
- 安裝精靈會引導你配置伺服器 SSH 連線資訊
TIP
如果你不確定選擇哪種模式，建議選擇 本地模式。後續可以在系統設定中切換到伺服器模式。
伺服器模式配置要求
如果選擇 伺服器模式，需要確保遠端 Linux 伺服器滿足以下條件：
伺服器硬體要求：
| 配置項 | 最低要求 | 推薦配置 |
|---|---|---|
| CPU | 2 核 | 4 核或以上 |
| 記憶體 | 4GB | 8GB 或以上 |
| 磁碟 | 20GB 可用空間 | 50GB SSD |
| 系統 | Ubuntu 20.04+ / CentOS 7+ | Ubuntu 22.04 LTS |
伺服器軟體要求：
- Docker 20.10+ 和 Docker Compose 2.0+
- 安裝精靈會自動檢測，未安裝時會提示
安全群組/防火牆連接埠配置：
伺服器需要開放以下連接埠，供本機用戶端存取後端服務：
| 連接埠 | 協定 | 服務 | 用途 | 必須開放 |
|---|---|---|---|---|
22 | TCP | SSH | 安裝精靈連線伺服器 | 是 |
3001 | TCP | Web API | 業務介面 | 是 |
3002 | TCP | LLM Router | 大模型路由 | 是 |
3003 | TCP | RAG Service | 知識檢索 | 是 |
3004 | TCP | Web 服務 | 主介面存取 | 是 |
8000 | TCP | ChromaDB | 向量資料庫 | 是 |
10095 | TCP | ASR | 語音辨識 | 是 |
選擇部署模式後，點擊 下一步 按鈕繼續。
3.4 步驟 4：伺服器配置（僅伺服器模式）
如果選擇了伺服器模式，需要配置遠端伺服器的 SSH 連線資訊。
遠端伺服器配置：
- 伺服器位址：遠端伺服器的 IP 位址或網域
- SSH 連接埠：預設 22
- 使用者名稱：SSH 登入使用者名稱（如 root）
- 伺服器名稱：自訂名稱，便於識別
- 認證方式：密碼認證或金鑰認證
- 部署路徑（進階選項）：後端服務在伺服器上的安裝路徑，預設
/opt/cuemate
填寫完成後，點擊 測試連線 按鈕驗證配置，測試通過後點擊 下一步 繼續。
3.5 步驟 5：安裝位置
選擇 CueMate 的安裝目錄。
- 預設路徑：
C:\Program Files\CueMate - 自訂路徑：點擊 瀏覽 按鈕選擇其他目錄
TIP
建議：不要安裝到 C 槽（系統槽），以避免系統槽空間不足導致系統變慢。建議選擇 D 槽或其他非系統槽。
磁碟空間要求：
- 本地模式：約 10GB（應用程式 + Docker 映像檔）
- 伺服器模式：本機約 2GB + 伺服器約 10GB
選擇安裝位置後，點擊 下一步 按鈕繼續。
3.6 步驟 6：磁碟空間檢測
安裝精靈會自動檢測磁碟空間是否滿足安裝要求。
本地模式
檢測本機電腦的磁碟空間，顯示：
- 總空間、已使用空間、可用空間
- 作業系統版本、架構、記憶體大小
伺服器模式
同時檢測兩個位置的磁碟空間：
- 本機磁碟 (Windows)：用於安裝桌面用戶端，需要約 2GB
- 伺服器磁碟：用於部署後端服務，需要約 10GB
檢測通過後自動進入下一步。如果空間不足，請清理磁碟後點擊「重新檢測」。
3.7 步驟 7：連接埠檢查
安裝精靈會檢測 CueMate 需要使用的網路連接埠是否被占用。
檢測的連接埠：
| 連接埠 | 服務 | 狀態顯示 |
|---|---|---|
3001 | Web API 服務 | (可用) 或 (不可用) |
3002 | LLM Router 服務 | (可用) 或 (不可用) |
3003 | RAG 服務 | (可用) 或 (不可用) |
3004 | Web 服務 | (可用) 或 (不可用) |
8000 | ChromaDB 向量資料庫 | (可用) 或 (不可用) |
10095 | 語音辨識服務 | (可用) 或 (不可用) |
如果檢測到連接埠衝突：
- 點擊連接埠旁的「結束程序」按鈕終止占用該連接埠的程式
- 或點擊「自動解決所有衝突」按鈕批次處理
連接埠檢測通過後，點擊 下一步 按鈕繼續。
3.8 步驟 8：Docker 檢查
安裝精靈會檢測 Docker 環境是否就緒。
本地模式
檢測本機電腦的 Docker Desktop：
- Docker Desktop 是否已安裝
- Docker Engine 是否正在執行
- Docker Compose 是否可用
如果 Docker 未安裝：
- 離線包：點擊「安裝到本機」按鈕，自動安裝內建的 Docker Desktop
- 線上包：點擊「下載 Docker Desktop」按鈕，跳轉到官方下載頁面
IMPORTANT
Docker Desktop for Windows 需要啟用 WSL 2（Windows Subsystem for Linux 2）。如果未啟用，安裝精靈會提示你啟用 WSL 2。
伺服器模式
檢測遠端 Linux 伺服器的 Docker：
- Docker Engine 是否已安裝
- Docker 服務是否正在執行
- Docker Compose 是否可用
檢測通過後，點擊 下一步 按鈕繼續。
處理 Windows 防火牆提示
首次執行 Docker Desktop 時，Windows 防火牆可能會彈出安全提示，詢問是否允許 Docker Desktop Backend 進行網路通訊。
處理方法：
- 勾選 私人網路，例如家用或工作網路
- 點擊 允許存取 按鈕
IMPORTANT
必須允許 Docker 通過防火牆，否則 Docker 的網路功能會受限，容器之間無法正常通訊，CueMate 後端服務將無法正常運作。
3.9 步驟 9：映像檔載入
安裝精靈開始載入 CueMate 的後端服務映像檔。
本地模式
映像檔載入到本機電腦的 Docker 環境：
- 離線包：執行
docker load從安裝包中載入預置映像檔 - 線上包：執行
docker pull從 Docker Hub 拉取映像檔
預計時間：1-2 分鐘（離線）或 5-10 分鐘（線上，取決於網路速度）
伺服器模式
映像檔載入到遠端 Linux 伺服器：
- 離線包：透過 SCP 上傳映像檔 tar 檔案到伺服器，然後 SSH 執行
docker load - 線上包：透過 SSH 在伺服器上執行
docker pull
預計時間：5-15 分鐘（取決於網路速度和伺服器效能）
WARNING
請不要關閉安裝精靈，否則需要重新開始載入。
映像檔載入完成後，點擊 下一步 按鈕繼續。
3.10 步驟 10：安裝用戶端
映像檔載入完成後，安裝精靈會進入桌面用戶端安裝步驟。
本地模式
執行 5 個步驟：
- 檢查 Visual C++ 執行階段：檢測系統是否已安裝 Visual C++ Redistributable，如未安裝會自動安裝
- 複製 CueMate 應用程式：將 CueMate 桌面用戶端複製到選擇的安裝目錄
- 配置 Docker Compose：複製 docker-compose.yml 設定檔到使用者資料目錄
- 掛載語音辨識和向量模型：解壓縮 ASR 語音辨識模型和向量模型到資料目錄
- 儲存版本資訊：記錄當前安裝的版本號
伺服器模式
執行 5 個步驟：
- 檢查 Visual C++ 執行階段：檢測系統是否已安裝 Visual C++ Redistributable，如未安裝會自動安裝
- 複製 CueMate 應用程式：將 CueMate 桌面用戶端複製到本機選擇的安裝目錄
- 上傳 Docker Compose 設定：透過 SSH 將 docker-compose.yml 設定檔上傳到遠端伺服器
- 上傳並掛載語音辨識和向量模型：透過 SCP 將模型檔案（約 1GB）上傳到伺服器並解壓縮
- 儲存版本資訊：記錄當前安裝的版本號
NOTE
伺服器模式需要上傳約 1GB 的模型檔案到遠端伺服器，根據網路速度可能需要數分鐘時間。
TIP
請確保完成此步驟後再關閉精靈，否則桌面用戶端將不會被正確安裝。
安裝完成後，點擊 下一步 按鈕進入最後一步。
3.11 步驟 11：完成
當所有步驟完成後，安裝精靈會顯示成功介面。
點擊 完成 按鈕，安裝精靈會自動：
- 關閉安裝視窗
- 啟動 CueMate 桌面應用程式
4. 首次使用
4.1 登入系統
安裝完成後，在開始功能表搜尋 CueMate 或在桌面找到 CueMate 捷徑，雙擊開啟應用程式。
應用程式啟動後會開啟登入介面。
內建帳戶資訊：
- 使用者名稱：
admin - 密碼：
cuemate
在登入介面輸入上述帳戶資訊，點擊 登入 按鈕即可進入系統。
4.2 開始使用
登入成功後，CueMate 的控制視窗會懸浮在螢幕正上方。
控制視窗按鈕說明（從左到右）：
- CueMate 圖示：點擊開啟 CueMate 官方網站
- 語音辨識：點擊啟動語音辨識功能，開啟面試功能視窗
- 提問 AI：點擊開啟 AI 提問視窗，快速向 AI 提問
- 互動模式：切換視窗的點擊穿透模式（互動/穿透）
- 主應用程式視窗：點擊開啟主應用程式視窗，進入後台管理介面
- 顯示/隱藏：點擊隱藏或顯示控制列及所有視窗
此外，CueMate 也會在系統匣顯示圖示，點擊可以快速存取常用功能。
5. 常見問題
5.1 安裝精靈無法開啟
問題：雙擊安裝程式後沒有反應或被封鎖
解決方法：
- 右鍵點擊安裝程式，選擇「以系統管理員身分執行」
- 如果 Windows Defender 封鎖，點擊「其他資訊」然後「仍要執行」
- 暫時關閉防毒軟體後重試
- 如果仍然無法開啟，請重新下載安裝包
5.2 磁碟空間不足
問題：安裝精靈提示磁碟空間不足
解決方法：
- 清理磁碟，確保至少有 10GB 可用空間
- 刪除不需要的檔案和應用程式
- 清空資源回收筒
- 選擇其他磁碟作為安裝位置
- 返回安裝精靈，點擊「重新檢測」
5.3 Docker Desktop 無法啟動
問題：安裝精靈提示 Docker 無法啟動
可能原因：
- WSL 2 未啟用
- Windows 版本過低
- 虛擬化功能未啟用
- Docker Desktop 安裝不完整
解決方法：
- 確認 Windows 版本符合要求（Windows 10 64 位或更高）
- 啟用 WSL 2：以系統管理員身分開啟 PowerShell，執行
wsl --install - 在 BIOS 中啟用虛擬化功能（VT-x/AMD-V）
- 重新安裝 Docker Desktop
- 重新啟動電腦後再次嘗試
5.4 連接埠衝突無法解決
問題：安裝精靈提示連接埠被占用，且自動解決失敗
解決方法：
- 記下衝突的連接埠和程式名稱
- 手動結束占用連接埠的程式：
- 開啟工作管理員（Ctrl + Shift + Esc）
- 找到占用連接埠的程式
- 選中程式，點擊「結束工作」
- 返回安裝精靈，點擊「重新檢測」
5.5 映像檔載入失敗
問題：安裝精靈在「映像檔載入」步驟失敗
可能原因：
- 網路連線中斷
- Docker 服務異常
- 磁碟空間不足
解決方法：
- 檢查網路連線
- 確認 Docker Desktop 正在執行
- 檢查磁碟空間
- 點擊「重試」按鈕，重新執行載入
5.6 主應用程式視窗無法開啟
問題：點擊控制視窗的「主應用程式視窗」按鈕後無反應
解決方法：
- 確認 CueMate 應用程式正在執行（系統匣有圖示）
- 確認後端服務正常執行（點擊匣圖示查看服務狀態）
- 如果服務異常，點擊匣圖示，選擇「重新啟動服務」
- 等待服務重新啟動完成（約 30 秒），再次嘗試開啟主應用程式視窗
6. 解除安裝 CueMate
6.1 解除安裝步驟
- 結束 CueMate 應用程式（點擊系統匣圖示 > 結束）
- 結束時會自動停止所有後端 Docker 服務
- 開啟 Windows 設定 > 應用程式 > 已安裝的應用程式
- 找到 CueMate，點擊右側的「...」，選擇「解除安裝」
- 清理資料檔案（選用）：
- 開啟檔案總管
- 在位址列輸入
%APPDATA% - 找到
cuemate-desktop-client資料夾，刪除它
注意：
- 刪除
cuemate-desktop-client資料夾會清除你的所有面試記錄、配置和語音辨識模型（約 1.6GB） - 如果將來想重新安裝 CueMate，建議保留這個資料夾，可以節省重新下載/解壓縮模型的時間
下一步
安裝完成後，建議你：
如果遇到問題，可以查看 常見問題 或聯繫技術支援。
祝你使用愉快，面試順利！