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 需要使用以下端口，请确保这些端口未被其他程序占用：

序号	端口号	服务名称	用途说明
1	80	主窗口服务	提供主窗口界面访问
2	3001	Web API 服务	业务接口服务
3	3002	LLM Router 服务	大语言模型路由
4	3003	RAG 知识库服务	知识检索服务
5	8000	ChromaDB 向量数据库	向量数据存储
6	10095	语音识别服务	实时语音转文字

注意：安装向导会自动检测端口占用情况，如有冲突会提供解决方案。详见 步骤 6：端口检查。

1.3 依赖环境

序号	依赖项	版本要求	说明
1	Docker Desktop	>= 4.0	CueMate 后端服务运行环境

注意：如果未安装 Docker Desktop，安装向导会提供自动安装选项。详见 步骤 5：Docker 检查。

2. 下载安装包

2.1 确定你的 Mac 芯片类型

点击屏幕左上角的 Apple 菜单 → 关于本机，查看 芯片 或 处理器 信息：

• 如果看到 "Apple M1"、"Apple M2" 或 "Apple M3"，下载 Apple Silicon 版本（arm64）
• 如果看到 "Intel"，下载 Intel 版本（x64）

2.2 选择下载渠道

CueMate 提供两种下载渠道，请根据网络环境选择：

方式一：百度网盘（推荐国内用户）

下载链接：https://pan.baidu.com/s/1cKVLf2_1BnRBgEkdL35K4Q?pwd=3477

提取码：3477

手机扫码访问：

下载步骤：

1. 点击上方链接或扫描二维码访问百度网盘
2. 输入提取码 3477
3. 选择对应的版本文件夹（如 v0.1.0）
4. 根据你的芯片类型下载对应的安装包：
   • Apple Silicon (M1/M2/M3)：CueMate-v0.1.0-macos-arm64-offline.dmg
   • Intel 芯片：CueMate-v0.1.0-macos-x64-offline.dmg
5. 点击「下载」按钮，保存到本地

优势：国内下载速度快，无需科学上网

方式二：GitHub Release（推荐海外用户）

访问 GitHub Releases 页面下载最新版本或历史版本：

版本列表：

版本	发布日期	类型	主要更新	下载链接
v0.1.0	2025-12-01	首发版本	核心功能发布	Apple Silicon / Intel

优势：全球 CDN 加速，版本管理清晰，支持校验和验证

下载完成后，安装包会保存在你的"下载"文件夹中。

2.3 打开安装包

双击下载的 .dmg 文件，macOS 会自动挂载磁盘镜像，弹出安装窗口。

2.4 处理安全提示

首次运行时，macOS 可能会显示安全提示："无法打开 CueMate 安装向导，因为它来自身份不明的开发者"。

NOTE

这是 macOS 的 Gatekeeper 安全机制。CueMate 安装向导是安全的，但因未经过 Apple 公证，首次打开需要手动授权。

解决方法：

1. 打开 系统设置（或 系统偏好设置）
2. 进入 隐私与安全性
3. 向下滚动，找到提示信息"CueMate 安装向导已被阻止"
4. 点击 仍要打开 按钮

3. 安装步骤

安装向导包含 8 个步骤，会自动引导你完成整个安装过程。

3.1 步骤 1：欢迎

安装向导启动后，首先显示欢迎界面，介绍 CueMate 的功能。

阅读欢迎信息后，点击 下一步 按钮继续。

3.2 步骤 2：许可协议

阅读 CueMate 的软件许可协议。

如果你同意协议条款，勾选"我同意许可协议"，然后点击 下一步 按钮。

3.3 步骤 3：安装位置

选择 CueMate 的安装位置。

• 默认位置：/Applications（推荐）
• 如需自定义，点击"选择其他位置"按钮

确认后，点击 下一步 按钮。

3.4 步骤 4：磁盘空间检测

安装向导会自动检测选择的安装位置是否有足够的磁盘空间。

IMPORTANT

空间需求：

• 应用本身：约 1GB
• Docker 镜像：>= 8GB
• 运行数据和日志：< 0.5GB
• 总计需要：约 10GB 可用空间

检测内容：

• 可用空间：显示当前可用的磁盘空间
• 所需空间：显示安装 CueMate 需要的空间

如果空间不足，请清理磁盘后点击"重新检测"。检测通过后自动进入下一步。

3.5 步骤 5：Docker 检查

安装向导会检测 Docker Desktop 是否已安装并运行。

如果 Docker 未安装：

1. 安装向导会显示提示信息
2. 点击"自动安装"按钮，安装向导会打开 Docker Desktop 下载页面
3. 下载并安装 Docker Desktop
4. 安装完成后，回到安装向导，点击"重新检测"

如果 Docker 未启动：

• 安装向导会自动尝试启动 Docker Desktop
• 等待 Docker 启动完成（通常需要 5-10 秒）

3.6 步骤 6：端口检查

安装向导会检测 CueMate 需要使用的网络端口是否被占用。

检测的端口：

• 80 - 主窗口服务
• 3001 - Web API 服务
• 3002 - LLM Router 服务
• 3003 - RAG 服务
• 8000 - ChromaDB 向量数据库
• 10095 - 语音识别服务

如果检测到端口冲突：

1. 安装向导会显示占用端口的程序名称
2. 点击"自动解决"按钮，安装向导会尝试关闭占用端口的程序
3. 或者手动关闭这些程序，然后点击"重新检测"

端口检测通过后自动进入下一步。

3.7 步骤 7：镜像加载

安装向导开始加载 CueMate 的后端服务镜像。

这个步骤会：

1. 加载服务镜像：从安装包中加载 Docker 镜像（约 10-20 秒）
2. 启动服务：启动 CueMate 的各个后端服务（约 5-10 秒）
3. 健康检查：确认所有服务正常运行

安装向导会实时显示：

• 当前正在处理的镜像
• 加载进度百分比
• 预计剩余时间

注意：这个步骤可能需要 30 秒 - 1 分钟，请保持网络连接，不要关闭安装向导。

3.8 步骤 8：完成

当所有步骤完成后，安装向导会显示成功界面。

点击 完成 按钮，安装向导会自动：

1. 关闭安装窗口
2. 启动 CueMate 桌面应用

4. 首次使用

4.1 系统权限授权

CueMate 使用语音识别功能时，需要授予必要的系统权限。

4.1.1 麦克风权限

首次使用麦克风功能时，系统会自动弹出授权提示框，请点击 允许 按钮授予 CueMate 访问麦克风的权限。

如果误点了"不允许"或意外关闭了授权窗口：

1. 打开 系统设置 > 隐私与安全性
2. 在左侧菜单中找到并点击 麦克风

3. 在右侧应用列表中找到 CueMate，勾选其右侧的开关以启用麦克风权限

4.1.2 录屏与系统录音权限

为了实现面试官语音识别功能，CueMate 需要"录屏与系统录音"权限来捕获系统音频。

NOTE

为什么需要这个权限？

• CueMate 使用"录屏与系统录音"权限来捕获系统音频
• 仅用于音频捕获，不会录制屏幕画面
• 用于识别面试软件（如腾讯会议、钉钉等）播放的面试官语音

首次使用扬声器测试功能时，系统会自动弹出授权提示框，请点击 允许 按钮授予 CueMate 访问系统音频的权限。

如果误点了"不允许"或意外关闭了授权窗口：

1. 打开 系统设置 > 隐私与安全性
2. 在左侧菜单中找到并点击 录屏与系统录音

3. 在右侧应用列表中找到 CueMate，勾选其右侧的开关以启用系统音频捕获权限
4. 如果列表中没有 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 文件夹会清除你的所有面试记录和配置
• 如果将来想重新安装 CueMate，建议保留这个文件夹

下一步

安装完成后，建议你：

1. 阅读 快速开始指南，了解基本使用方法
2. 查看 功能手册，探索 CueMate 的所有功能
3. 配置 AI 模型，开始使用智能功能
4. 进行 语音测试，确保音频设备正常

如果遇到问题，可以查看 常见问题 或联系技术支持。

祝你使用愉快，面试顺利！