快速开始

5 分钟完成 CueMate 的安装部署。

1. 系统要求

• macOS 13.0+ 或 Windows 10/11 (64 位)
• 4GB+ 内存
• 10GB+ 磁盘空间

2. 下载安装包

2.1 macOS

根据你的芯片类型选择对应的安装包：

• Apple Silicon (M1/M2/M3)：CueMate-v0.1.1-macos-arm64-offline.dmg
• Intel 芯片：CueMate-v0.1.1-macos-x64-offline.dmg

下载地址：

• 百度网盘：https://pan.baidu.com/s/1cKVLf2_1BnRBgEkdL35K4Q?pwd=3477（提取码：3477）
• GitHub Releases：https://github.com/cuemate-chat/cuemate/releases

2.2 Windows

开发中

Windows 版本正在开发中，预计在下一个大版本发布。当前版本仅支持 macOS 平台。

3. 运行安装

3.1 macOS 安装

1. 双击下载的 .dmg 文件
2. 运行 CueMate 安装向导
3. 按照向导提示完成 8 步安装流程（约 3-5 分钟）：
   • 1.欢迎 → 2.许可协议 → 3.安装位置 → 4.磁盘空间检测
   • 5.Docker 检查 → 6.端口检查 → 7.镜像加载 → 8.完成（启动应用）

注意：

• 安装向导会自动检测并安装 Docker Desktop（如未安装）
• 安装过程会自动加载并启动所有后端服务

详细安装步骤和常见问题处理请参考 macOS 安装指南。

3.2 Windows 安装

Windows 版本安装步骤将在正式发布后更新。详见 Windows 安装指南。

4. 验证安装

安装完成后，安装向导会提示，点击启动 CueMate 应用。

4.1 检查服务状态

进入应用的「容器监控」页面（顶部下拉菜单 → 容器监控），确认所有 6 个服务都显示为"运行中"（绿色标签）：

• cuemate-web - 主窗口服务
• cuemate-web-api - 后端 API 服务
• cuemate-llm-router - 大模型路由服务
• cuemate-rag-service - 知识库检索服务
• cuemate-asr - 语音识别服务
• cuemate-chroma - 向量数据库

如有服务异常：

1. 点击服务的「日志」按钮查看错误信息
2. 点击「重启」按钮尝试修复
3. 如问题仍未解决，请参考 服务管理 文档

5. 安装完成

CueMate 已成功安装，通过安装向导启动或点击启动台的 CueMate 图标启动。

应用启动后会打开登录界面：

内置账户信息：

• 用户名：admin
• 密码：cuemate

6. 下一步

• 首次使用配置：配置 AI 模型、测试语音识别等，详见各功能文档

  • 配置 AI 模型：详见 模型设置 文档
  • 系统设置：详见 系统设置 文档
  • 语音测试：详见 语音测试 文档

• 升级版本：通过版本管理功能在线更新，详见 版本升级 文档

• 服务管理：查看服务状态、重启服务、查看日志，详见 服务管理 文档

• 卸载应用：完全卸载 CueMate，详见 卸载指南 文档

7. 常见问题

7.1 安装向导无法打开

macOS：如提示"来自身份不明的开发者"

• 打开「系统设置」→「隐私与安全性」
• 找到被阻止的提示，点击「仍要打开」

Windows：如被 SmartScreen 阻止

• 点击「更多信息」→「仍要运行」

7.2 Docker Desktop 未安装

安装向导会自动检测 Docker Desktop：

• 如未安装，会自动安装
• 或自己去下载：https://www.docker.com/products/docker-desktop/
• 安装 Docker 后返回安装向导，点击「重新检测」

7.3 端口被占用

安装向导会检测端口冲突：

• 会显示占用端口的程序名称
• 点击「自动解决」关闭占用程序
• 或手动关闭程序后点击「重新检测」

7.4 镜像加载失败

可能原因：

• 网络连接中断
• Docker 服务异常
• 磁盘空间不足

解决方法：

1. 检查网络连接和 Docker 状态
2. 确认磁盘空间充足
3. 点击「重试」按钮重新加载

更多安装问题请参考 macOS 安装指南 的常见问题章节。

8. 获取帮助

• 查看 常见问题
• 访问 GitHub Issues
• 邮件：nuneatonhydroplane@gmail.com