Skip to content

macOS 安裝指南

歡迎使用 CueMate!本指南將幫助你在 macOS 系統上安裝 CueMate,整個過程簡單快捷,只需幾分鐘即可完成。

1. 系統要求

IMPORTANT

請在安裝前確認你的 Mac 滿足最低配置要求,否則可能導致安裝失敗或執行異常。

在安裝 CueMate 之前,請確認你的 Mac 符合以下配置要求:

1.1 硬體與系統

序號配置項要求說明
1作業系統macOS 13.0 (Ventura) 或更高版本支援最新的 macOS 系統
2處理器Apple Silicon (M1/M2/M3) 或 Intel 晶片支援兩種架構
3記憶體>= 4GB RAM確保流暢執行
4磁碟空間>= 10GB 可用空間推薦使用 SSD 固態硬碟
5網路連線穩定的網際網路連線用於下載安裝包和 AI 服務

1.2 埠佔用檢查

CueMate 需要使用以下埠,請確保這些埠未被其他程式佔用:

序號埠號服務名稱用途說明
13001Web API 服務業務介面服務
23002LLM Router 服務大語言模型路由
33003RAG 知識庫服務知識檢索服務
43004主視窗服務提供主視窗介面訪問
58000ChromaDB 向量資料庫向量資料儲存
610095語音辨識服務即時語音轉文字

注意:安裝精靈會自動檢測埠佔用情況,如有衝突會提供解決方案。詳見 步驟 7:埠檢查

1.3 依賴環境

序號依賴項版本要求說明
1Docker Desktop>= 4.0CueMate 後端服務執行環境

TIP

  • 離線包:包含 Docker Desktop 安裝包,無需提前安裝
  • 線上包:需要使用者自行安裝 Docker Desktop

注意:如果未安裝 Docker Desktop,安裝精靈會提供自動安裝選項。詳見 步驟 6:Docker 檢查

2. 下載安裝包

2.1 選擇安裝包類型

CueMate 提供兩種安裝包類型,請根據你的需求選擇:

類型說明體積適用場景
離線包 (Offline)包含 Docker Desktop、所有 Docker 映像和語音模型,開箱即用約 4.4GB無網路環境、首次安裝
線上包 (Online)需自行安裝 Docker Desktop,安裝時從網路拉取映像和語音模型約 670MB網路良好、已有 Docker

TIP

  • 首次安裝推薦使用離線包,包含所有依賴,無需額外下載
  • 已安裝 Docker Desktop 的使用者可使用線上包,下載更快

IMPORTANT

線上包使用者注意:首次啟動 CueMate 時,語音辨識服務(cuemate-asr)會自動下載 FunASR 語音模型(約 1.7GB)。下載期間語音辨識功能暫時不可用,請確保網路暢通並耐心等待下載完成。

離線包已內建語音模型,無需額外下載,啟動即可使用。

2.2 選擇部署模式

CueMate 支援兩種部署模式,安裝時可以選擇:

模式說明適用場景
本地模式所有服務執行在本地 Mac 上個人使用、本地開發
伺服器模式後端服務部署到遠端 Linux 伺服器,本地僅執行輕量用戶端多裝置共享、伺服器資源更強

詳細的部署模式選擇介面請參考 步驟 3:部署模式

NOTE

  • 本地模式:開箱即用,所有資料儲存在本地
  • 伺服器模式:需要一台 Linux 伺服器,用戶端透過 SSH 連線伺服器管理後端服務

2.3 確定你的 Mac 晶片類型

點選螢幕左上角的 Apple 選單關於本機,檢視 晶片處理器 資訊:

  • 如果看到 "Apple M1"、"Apple M2" 或 "Apple M3",下載 Apple Silicon 版本(arm64)
  • 如果看到 "Intel",下載 Intel 版本(x64)

檢視晶片類型

2.4 選擇下載管道

CueMate 提供兩種下載管道,請根據網路環境選擇:

方式一:百度網盤(推薦國內使用者)

下載連結https://pan.baidu.com/s/15jwZHy8YkDa4cEDLIYRo9Q?pwd=3477

提取碼3477

手機掃碼存取

百度網盤 QR Code

下載步驟

  1. 點選上方連結或掃描 QR Code 存取百度網盤
  2. 輸入提取碼 3477
  3. 選擇對應的版本資料夾(如 v0.1.0)
  4. 根據晶片類型和安裝包類型下載對應的安裝包:
晶片類型離線包線上包
Apple Silicon (M1/M2/M3)CueMate-v0.1.1-macos-arm64-offline.dmgCueMate-v0.1.1-macos-arm64-online.dmg
IntelCueMate-v0.1.1-macos-x64-offline.dmgCueMate-v0.1.1-macos-x64-online.dmg
  1. 點選「下載」按鈕,儲存到本地

優勢:國內下載速度快,無需科學上網

方式二:GitHub Release(推薦海外使用者)

存取 GitHub Releases 頁面下載最新版本或歷史版本:

版本列表

版本釋出日期型別主要更新下載連結
v0.1.12025-12-26功能更新線上/離線安裝包、伺服器部署模式、多語言支援GitHub Release 頁面
v0.1.02025-12-10首發版本核心功能釋出GitHub Release 頁面

NOTE

由於安裝包體積較大(約 5GB),超過 GitHub 單檔案 2GB 限制,已拆分為多個分捲上傳。

下載步驟

  1. 訪問 GitHub Release 頁面
  2. 根據你的晶片型別,下載對應的所有分卷檔案
    • Apple Silicon (M1/M2/M3):下載所有 CueMate-vX.X.X-macos-arm64-offline.dmg.part* 檔案
    • Intel 晶片:下載所有 CueMate-vX.X.X-macos-x64-offline.dmg.part* 檔案
  3. 將所有分卷檔案放在同一個目錄下
  4. 開啟終端(Terminal),執行以下命令合併分卷:
bash
# Apple Silicon (ARM64) 版本
cat CueMate-v0.1.0-macos-arm64-offline.dmg.part* > CueMate-v0.1.0-macos-arm64-offline.dmg

# Intel (x64) 版本
cat CueMate-v0.1.0-macos-x64-offline.dmg.part* > CueMate-v0.1.0-macos-x64-offline.dmg
  1. 合併完成後,即可雙擊 .dmg 檔案開始安裝

優勢:全球 CDN 加速,版本管理清晰,支援校驗和驗證

下載完成後,安裝包會儲存在你的「下載」資料夾中。

2.5 開啟安裝包

雙擊下載的 .dmg 檔案,macOS 會自動掛載磁碟映像,彈出安裝視窗。

開啟 DMG 檔案

2.6 處理安全提示

首次執行時,macOS 可能會顯示安全提示:「無法開啟 CueMate 安裝精靈,因為它來自身份不明的開發者」。

安全提示

NOTE

這是 macOS 的 Gatekeeper 安全機制。CueMate 安裝精靈是安全的,但因未經過 Apple 公證,首次開啟需要手動授權。

解決方法

  1. 開啟 系統設定(或 系統偏好設定
  2. 進入 隱私與安全性
  3. 向下捲動,找到提示資訊「CueMate 安裝精靈已被阻止」
  4. 點選 仍要開啟 按鈕

允許開啟應用

3. 安裝步驟

安裝精靈包含 10 個步驟,會自動引導你完成整個安裝過程。

安裝精靈介面提供以下資訊和功能:

  • 語言切換(右上角):支援簡體中文、繁體中文、English 三種語言,可隨時切換
  • 安裝模式(頂部標籤):顯示當前安裝包類型,如「離線安裝」或「線上安裝」
  • 部署模式(頂部標籤):顯示當前部署模式,如「本地模式」或「伺服器模式」,可在步驟 3 中修改
  • 版本資訊(左下角):顯示當前安裝精靈的版本號

3.1 步驟 1:歡迎

安裝精靈啟動後,首先顯示歡迎介面,介紹 CueMate 的功能和安裝前準備事項。

歡迎介面

閱讀歡迎資訊後,點選 下一步 按鈕繼續。

3.2 步驟 2:許可協議

閱讀 CueMate 的軟體許可協議。

許可協議

如果你同意協議條款,勾選「我同意許可協議」,然後點選 下一步 按鈕。

3.3 步驟 3:部署模式

選擇 CueMate 的部署模式。

部署模式選擇

模式說明適用場景
本地模式所有服務執行在本地 Mac 上,開箱即用個人使用、本地開發、首次體驗
伺服器模式後端服務部署到遠端 Linux 伺服器,本地僅執行輕量用戶端多裝置共享、伺服器資源更強、團隊協作

本地模式(預設推薦):

  • 所有服務執行在本地,無需額外配置
  • 資料儲存在本地,隱私性更好
  • 適合大多數使用者

伺服器模式

  • 需要一台 Linux 伺服器(Ubuntu 20.04+ 或 CentOS 7+)
  • 本地 Mac 僅作為用戶端,資源佔用少
  • 支援多台 Mac 共享同一個後端服務
  • 安裝精靈會引導你配置伺服器 SSH 連線資訊

TIP

如果你不確定選擇哪種模式,建議選擇 本地模式。後續可以在系統設定中切換到伺服器模式。

伺服器模式配置要求

如果選擇 伺服器模式,需要確保遠端 Linux 伺服器滿足以下條件:

伺服器硬體要求

配置項最低要求推薦配置
CPU2 核4 核或以上
記憶體4GB8GB 或以上
磁碟20GB 可用空間50GB SSD
系統Ubuntu 20.04+ / CentOS 7+Ubuntu 22.04 LTS

伺服器軟體要求

  • Docker 20.10+ 和 Docker Compose 2.0+
  • 安裝精靈會自動檢測,未安裝時會提示

安全群組/防火牆埠配置

伺服器需要開放以下埠,供本地用戶端存取後端服務:

協定服務用途必須開放
22TCPSSH安裝精靈連線伺服器
3001TCPWeb API業務介面
3002TCPLLM Router大模型路由
3003TCPRAG Service知識檢索
3004TCPWeb 服務主介面存取
8000TCPChromaDB向量資料庫
10095TCPASR語音辨識

IMPORTANT

雲端伺服器安全群組配置

  • 阿里雲/騰訊雲/華為雲等雲端伺服器,需要在控制台的「安全群組」中新增入站規則
  • 授權對象可設定為 0.0.0.0/0(允許所有 IP)或指定你的本地公網 IP
  • 建議僅開放給你的辦公網路 IP,提高安全性

雲端伺服器安全群組配置範例(以阿里雲為例)

  1. 登入阿里雲控制台,進入 ECS 執行個體頁面
  2. 點選執行個體 ID,進入執行個體詳情
  3. 點選左側「安全群組」選單
  4. 點選「配置規則」按鈕
  5. 點選「手動新增」,新增以下入站規則:
協定類型: 自訂 TCP
埠範圍: 22,3001-3004,8000,10095
授權對象: 0.0.0.0/0(或你的公網 IP)
描述: CueMate 服務埠

安全群組配置範例

選擇部署模式後,點選 下一步 按鈕繼續。

3.4 步驟 4:安裝位置

根據上一步選擇的部署模式,介面會有所不同。

本地模式

安裝位置 - 本地模式

  • 安裝路徑:固定為 /Applications,macOS 應用必須安裝到此目錄
  • 磁碟空間要求:約 10GB(應用程式 + Docker 映像)

TIP

Docker 映像和執行資料將自動儲存在系統目錄中,無需手動配置。

伺服器模式

伺服器模式需要配置遠端伺服器的 SSH 連線資訊。

安裝位置 - 伺服器模式

本地用戶端安裝路徑

  • 固定為 /Applications,與本地模式相同

遠端伺服器配置

  • 伺服器地址:遠端伺服器的 IP 地址或域名
  • SSH 埠:預設 22
  • 使用者名稱:SSH 登入使用者名稱(如 root)
  • 伺服器名稱:自訂名稱,便於識別
  • 認證方式:密碼認證或金鑰認證(點選小眼睛可檢視輸入內容)
  • 部署路徑(進階選項):後端服務在伺服器上的安裝路徑,預設 /opt/cuemate

TIP

伺服器配置資訊儲存在 ~/Library/Application Support/cuemate-desktop-client/config/server.json,可以手動編輯此檔案修改配置。安裝完成後,也可以透過托盤選單修改伺服器配置,詳見 托盤選單 - 伺服器配置

填寫完成後,點選 測試連線 按鈕驗證配置:

測試連線成功

測試透過後,點選 下一步 按鈕繼續。

3.5 步驟 5:磁碟空間檢測

安裝精靈會自動檢測磁碟空間是否滿足安裝要求。

本地模式

磁碟空間檢測 - 本地模式

檢測本地 Mac 的磁碟空間,顯示:

  • 總空間、已使用空間、可用空間
  • 作業系統版本、架構、記憶體大小

伺服器模式

磁碟空間檢測 - 伺服器模式

同時檢測兩個位置的磁碟空間:

  • 本地磁碟 (macOS):用於安裝桌面用戶端,需要約 2GB
  • 伺服器磁碟:用於部署後端服務,需要約 10GB

IMPORTANT

空間需求

  • 本地模式:約 10GB(應用 + Docker 映像 + 資料)
  • 伺服器模式:本地約 2GB + 伺服器約 10GB

檢測透過後自動進入下一步。如果空間不足,請清理磁碟後點選「重新檢測」。

3.6 步驟 6:Docker 檢查

安裝精靈會檢測 Docker 環境是否就緒。

本地模式

Docker 檢查 - 本地模式

檢測本地 Mac 的 Docker Desktop:

  • Docker Desktop 是否已安裝
  • Docker Engine 是否正在執行
  • Docker Compose 是否可用

如果 Docker 未安裝

  • 離線包:點選「安裝到本地」按鈕,自動安裝內建的 Docker Desktop
  • 線上包:點選「下載 Docker Desktop」按鈕,跳轉到官方下載頁面

伺服器模式

Docker 檢查 - 伺服器模式

檢測遠端 Linux 伺服器的 Docker:

  • Docker Engine 是否已安裝
  • Docker 服務是否正在執行
  • Docker Compose 是否可用

如果 Docker 未安裝

  • 離線包:點選「安裝到伺服器」按鈕,自動透過 SSH 在遠端伺服器上安裝 Docker
  • 線上包:點選「檢視 Docker 文件」按鈕,跳轉到 Docker Engine 安裝文件

Docker 安裝 - 伺服器模式

檢測透過後,點選 下一步 按鈕繼續。

3.7 步驟 7:埠檢查

安裝精靈會檢測 CueMate 需要使用的網路埠是否被佔用。

本地模式

埠檢查 - 本地模式

檢測本地 Mac 的埠佔用情況,需要檢查 6 個埠:

服務狀態顯示
3001Web API 服務(可用) 或 (不可用)
3002LLM Router 服務(可用) 或 (不可用)
3003RAG 服務(可用) 或 (不可用)
3004Web 服務(可用) 或 (不可用)
8000ChromaDB 向量資料庫(可用) 或 (不可用)
10095語音辨識服務(可用) 或 (不可用)

伺服器模式

埠檢查 - 伺服器模式

檢測遠端伺服器的埠佔用情況,檢查的埠與本地模式相同:

服務狀態顯示
3001Web API 服務(可用) 或 (不可用)
3002LLM Router 服務(可用) 或 (不可用)
3003RAG 服務(可用) 或 (不可用)
3004Web 服務(可用) 或 (不可用)
8000ChromaDB 向量資料庫(可用) 或 (不可用)
10095語音辨識服務(可用) 或 (不可用)

如果檢測到埠衝突

  • 點選埠旁的「結束程序」按鈕終止佔用該埠的程式
  • 或點選「自動解決所有衝突」按鈕批次處理

埠檢測透過後,點選 下一步 按鈕繼續。

3.8 步驟 8:映像載入

安裝精靈開始載入 CueMate 的後端服務映像。頁面標題旁會顯示當前的部署環境標籤。

本地模式

映像載入 - 本地模式

標籤顯示「本地環境」,映像載入到本地 Mac 的 Docker 環境:

  • 離線包:執行 docker load 從安裝包中載入預置映像
  • 線上包:執行 docker pull 從 Docker Hub 拉取映像

預計時間:1-2 分鐘(離線)或 5-10 分鐘(線上,取決於網路速度)

伺服器模式

映像載入 - 伺服器模式

標籤顯示「伺服器」,映像載入到遠端 Linux 伺服器:

  • 離線包:透過 SCP 上傳映像 tar 檔案到伺服器,然後 SSH 執行 docker load
  • 線上包:透過 SSH 在伺服器上執行 docker pull

預計時間:5-15 分鐘(取決於網路速度和伺服器效能)

WARNING

請不要關閉安裝精靈,否則需要重新開始載入。

映像載入完成後,點選 下一步 按鈕繼續。

3.9 步驟 9:安裝用戶端

映像載入完成後,安裝精靈會進入桌面用戶端安裝步驟。

本地模式

安裝用戶端 - 本地模式

執行 4 個步驟:

  1. 複製 CueMate.app:安裝到 /Applications 目錄
  2. 配置 Docker Compose:複製 docker-compose.yml 到本地資料目錄
  3. 掛載 ASR 語音模型:解壓模型到 ~/Library/Application Support/cuemate-desktop-client/data/funasr_models/
  4. 儲存版本資訊:記錄安裝版本

預計時間:約 1 分鐘

伺服器模式

安裝用戶端 - 伺服器模式

執行 4 個步驟:

  1. 複製 CueMate.app:安裝到本地 /Applications 目錄
  2. 配置 Docker Compose:透過 SSH 上傳 docker-compose.yml 到遠端伺服器 /opt/cuemate/
  3. 掛載 ASR 語音模型:透過 SCP 上傳約 1GB 模型檔案到伺服器,並解壓到 /opt/cuemate/data/funasr_models/
  4. 儲存版本資訊:記錄安裝版本

預計時間:幾分鐘到十幾分鐘(取決於網路速度)

TIP

請確保完成此步驟後再關閉精靈,否則桌面用戶端將不會被正確安裝。

安裝完成後,點選 下一步 按鈕進入最後一步。

3.10 步驟 10:完成

當所有步驟完成後,安裝精靈會顯示成功介面。

安裝完成

點選 完成 按鈕,安裝精靈會自動:

  1. 關閉安裝視窗
  2. 啟動 CueMate 桌面應用

4. 首次使用

4.1 系統權限授權

CueMate 使用語音辨識功能時,需要授予必要的系統權限。

4.1.1 麥克風權限

首次使用麥克風功能時,系統會自動彈出授權提示框,請點選 允許 按鈕授予 CueMate 存取麥克風的權限。

麥克風權限請求

如果誤點了「不允許」或意外關閉了授權視窗

  1. 開啟 系統設定 > 隱私與安全性
  2. 在左側選單中找到並點選 麥克風

麥克風權限入口

  1. 在右側應用列表中找到 CueMate,勾選其右側的開關以啟用麥克風權限

啟用 CueMate 麥克風權限

4.1.2 錄屏與系統錄音權限

為了實現面試官語音辨識功能,CueMate 需要「錄屏與系統錄音」權限來捕獲系統音訊。

NOTE

為什麼需要這個權限?

  • CueMate 使用「錄屏與系統錄音」權限來捕獲系統音訊
  • 僅用於音訊捕獲,不會錄製螢幕畫面
  • 用於辨識面試軟體(如騰訊會議、釘釘等)播放的面試官語音

首次使用揚聲器測試功能時,系統會自動彈出授權提示框,請點選 允許 按鈕授予 CueMate 存取系統音訊的權限。

揚聲器授權

如果誤點了「不允許」或意外關閉了授權視窗

  1. 開啟 系統設定 > 隱私與安全性
  2. 在左側選單中找到並點選 錄屏與系統錄音

錄屏與系統錄音權限入口

  1. 在右側應用列表中找到 CueMate,勾選其右側的開關以啟用系統音訊捕獲權限
  2. 如果列表中沒有 CueMate,可以點選列表底部的 "+" 按鈕手動新增

勾選 CueMate 權限

TIP

授權後無需重啟應用,直接返回 CueMate 即可使用

4.2 登入系統

安裝完成後,在啟動台搜尋 CueMate 應用圖示,單擊左鍵開啟應用程式。

開啟應用

應用啟動後會開啟登入介面:

登入介面

內建帳戶資訊

  • 使用者名稱admin
  • 密碼cuemate

在登入介面輸入上述帳戶資訊,點選 登入 按鈕即可進入系統。

4.3 開始使用

登入成功後,CueMate 的控制視窗會懸浮在螢幕正上方。

控制視窗

控制視窗按鈕說明(從左到右):

  • CueMate 圖示:點選開啟 CueMate 官方網站
  • 語音辨識:點選啟動語音辨識功能,開啟面試功能視窗
  • 提問 AI:點選開啟 AI 提問視窗,快速向 AI 提問
  • 互動模式:切換視窗的點選穿透模式(互動/穿透)
  • 主應用視窗:點選開啟主應用視窗,進入後台管理介面
  • 顯示/隱藏:點選隱藏或顯示控制欄及所有視窗

此外,CueMate 也會在選單欄顯示圖示,點選可以快速存取常用功能。

5. 常見問題

5.1 安裝精靈無法開啟

問題:雙擊安裝精靈圖示後沒有反應

解決方法

  1. 確認你已經按照「處理安全提示」章節的步驟,在系統設定中允許開啟應用
  2. 嘗試右鍵點選安裝精靈圖示,選擇「開啟」
  3. 如果仍然無法開啟,請重新下載安裝包

5.2 磁碟空間不足

問題:安裝精靈提示磁碟空間不足

解決方法

  1. 清理磁碟,確保至少有 10GB 可用空間
  2. 刪除不需要的檔案和應用
  3. 清空垃圾桶
  4. 返回安裝精靈,點選「重新檢測」

5.3 Docker Desktop 無法啟動

問題:安裝精靈提示 Docker 無法啟動

可能原因

  • macOS 版本過低
  • 系統虛擬化功能未啟用
  • Docker Desktop 安裝不完整

解決方法

  1. 確認 macOS 版本符合要求(13 或更高)
  2. 重新安裝 Docker Desktop
  3. 重啟 Mac 後再次嘗試

5.4 埠衝突無法解決

問題:安裝精靈提示埠被佔用,且自動解決失敗

解決方法

  1. 記下衝突的埠號和程式名稱
  2. 手動退出這些程式:
    • 開啟「活動監視器」(應用程式 > 工具程式)
    • 找到佔用埠的程式
    • 選中程式,點選左上角的「×」按鈕強制退出
  3. 返回安裝精靈,點選「重新檢測」

5.5 映像載入失敗

問題:安裝精靈在「映像載入」步驟失敗

可能原因

  • 網路連線中斷
  • Docker 服務異常
  • 磁碟空間不足

解決方法

  1. 檢查網路連線
  2. 確認 Docker Desktop 正在執行
  3. 檢查磁碟空間
  4. 點選「重試」按鈕,重新執行載入

5.6 權限授予後仍無法使用

問題:已經授予了麥克風權限,但語音辨識仍不工作

解決方法

  1. 完全退出 CueMate:
    • 點選選單欄的 CueMate 圖示
    • 選擇「退出 CueMate」
  2. 重新啟動 CueMate
  3. 再次測試語音功能

如果仍然無法使用,請進入 系統設定 > 隱私與安全性 > 麥克風,確認 CueMate 已被勾選。

5.7 主應用視窗無法開啟

問題:點選控制視窗的「主應用視窗」按鈕後無反應

解決方法

  1. 確認 CueMate 應用正在執行(選單欄有圖示)
  2. 確認後端服務正常執行(點選選單欄圖示檢視服務狀態)
  3. 如果服務異常,點選選單欄圖示,選擇「重啟服務」
  4. 等待服務重啟完成(約 30 秒),再次嘗試開啟主應用視窗

6. 解除安裝 CueMate

6.1 解除安裝步驟

  1. 退出 CueMate 應用(點選選單欄圖示 > 退出)
    • 退出時會自動停止所有後端 Docker 服務
  2. 開啟「應用程式」資料夾,將 CueMate.app 拖到垃圾桶
  3. 清理資料檔案(可選):
    • 開啟 Finder
    • Command + Shift + G
    • 輸入 ~/Library/Application Support
    • 找到 cuemate-desktop-client 資料夾,刪除它
  4. 清空垃圾桶

注意

  • 刪除 cuemate-desktop-client 資料夾會清除你的所有面試記錄、配置和語音辨識模型(約 1.6GB)
  • 如果將來想重新安裝 CueMate,建議保留這個資料夾,可以節省重新下載/解壓模型的時間

下一步

安裝完成後,建議你:

  1. 閱讀 快速開始指南,瞭解基本使用方法
  2. 檢視 功能手冊,探索 CueMate 的所有功能
  3. 配置 AI 模型,開始使用智慧功能
  4. 進行 語音測試,確保音訊裝置正常

如果遇到問題,可以檢視 常見問題 或聯絡技術支援。

祝你使用愉快,面試順利!

Released under the GPL-3.0 License.