系统要求
使用 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 | 80 | 主窗口服务 | 后台管理界面 |
| 2 | 3001 | Web API | 业务接口服务 |
| 3 | 3002 | LLM Router | 大模型路由服务 |
| 4 | 3003 | RAG Service | 知识库检索服务 |
| 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. Windows 平台
开发中
Windows 版本正在开发中，敬请期待。
如果你对 Windows 版本有任何建议或需求，欢迎通过以下方式反馈：
- GitHub Issues：https://github.com/cuemate-chat/cuemate/issues
- 邮箱：nuneatonhydroplane@gmail.com
如果你的设备满足上述要求，可以开始 安装 CueMate。
如有其他问题，请查看 常见问题 或联系技术支持。