快速开始
5分钟快速上手 CueMate，开始你的第一次面试训练。
1. 概述
CueMate 是一款智能语音面试助手 - AI 驱动的实时面试训练工具，专注于帮助求职者通过系统化的模拟面试训练和面试准备，提升面试技能和表现。本指南将带你快速完成首次配置并开始训练。
2. 准备工作
2.1 启动 CueMate
在启动台搜索 CueMate 应用图标，单击左键打开应用程序。
启动 CueMate 桌面应用后，会在屏幕顶部显示悬浮控制栏。点击控制栏最右侧的按钮（主应用窗口按钮），即可打开主应用窗口。
操作步骤：
- 确保 CueMate 桌面应用已启动（顶部状态栏显示 CueMate 图标）
- 在屏幕顶部找到 CueMate 悬浮控制栏
- 点击控制栏最右侧的主应用窗口按钮
如果是首次使用，应用启动后会打开登录界面：
内置账户信息：
- 用户名：
admin - 密码：
cuemate
在登录界面输入上述账户信息，点击 登录 按钮即可进入系统。
打开后，默认显示主页界面：
2.2 配置 AI 模型（必选）
面试训练需要 AI 模型提供智能回答，至少配置一个模型。
NOTE
为什么需要配置？
AI 模型是 CueMate 的"大脑"，负责：
- 理解你的回答
- 提供实时建议
- 生成参考答案
- 评分和反馈
如何配置？ 进入 模型设置 页面，选择一个模型配置 API Key：
配置步骤:
- 点击右上角头像 > 模型设置
- 选择服务商（如智谱 AI）
- 输入 API Key
- 点击"测试连接"
- 保存配置
点击顶部下拉列表菜单中的"模型设置"，进入模型管理页面。
右侧以卡片形式展示模型，每个卡片包含：
- 序号和服务商图标
- 模型名称和类型标签
- 连通状态（绿色"已连通"/红色"不可用"）
- 详细信息（服务商、基础模型、版本、创建者、时间）
响应式布局
- 大屏幕：2 列卡片
- 小屏幕：1 列卡片
提示：API Key 在各服务商官网获取，首次注册通常有免费额度。
详细配置教程请查看 模型设置 页面。
2.3 语音识别设置（可选）
语音识别设置用于配置麦克风和扬声器设备，确保面试训练中音频设备能够正常工作。
NOTE
为什么是可选的？
语音识别设置可以在面试开始前配置，也可以在面试过程中配置。如果现在不配置，系统会在面试训练时提示你进行配置。
如何配置？
- 点击顶部下拉列表菜单 > 语音设置
- 在"设备配置"标签页中：
- 选择麦克风设备（用于识别“面试者”语音输入）
- 选择扬声器设备（用于识别“面试官”语音输入）
- 点击保存
配置建议：
- 麦克风：优先使用电脑内置麦克风，简单方便
- 扬声器：优先使用电脑内置扬声器，无需额外设备
- 环境嘈杂时可选择头戴式耳机，降噪效果更好
提示：可以在面试训练时通过 语音测试 功能测试音频设备是否正常。
详细配置请查看 语音设置 页面。
2.4 系统设置（必选）
系统设置用于配置界面语言、主题、时区和默认模型等基础参数。
如何配置？
- 点击顶部下拉列表菜单 > 系统设置
- 配置以下参数：
- 语言：选择界面显示语言（简体中文/繁體中文/English）
- 主题：选择界面主题（浅色/深色/自动）
- 时区：选择显示时区（北京时间/香港时间/日本时间等）
- 大模型服务商：选择默认使用的 LLM 模型
- 点击保存设置
配置建议：
- 语言设置会影响 AI 回答语言和 TTS 语音语言
- 主题建议选择"自动"，根据环境光线自动切换
- 大模型服务商选择已配置的模型作为默认模型 *
提示：系统设置中的语言选择与右上角的语言选择是同一数据源，修改任意一处，另一处自动刷新。
详细配置请查看 系统设置 页面。
2.5 导入 License（订阅用户使用）
License 用于激活 CueMate 的订阅功能，包括预置题库等高级功能。
NOTE
是否必须导入 License？
- 开源版用户：无需导入 License，核心功能完全可用
- 订阅版用户：需要导入 License 才能使用预置题库等订阅功能
如何导入 License？
联系 CueMate 团队获取 License.key 文件
- 邮箱：nuneatonhydroplane@gmail.com
点击顶部下拉列表菜单 > License 管理
- 点击「上传 License.key 文件」区域，选择本地的 .key 文件
- 等待上传完成，系统自动验证并激活
订阅功能：预置题库
激活 License 后，您可以使用预置题库功能：
- 海量题库：涵盖各类技术岗位的常见面试题
- 持续更新：题库内容定期更新，紧跟行业趋势
- 一键导入：在 License 管理页面点击「导入预置题库」即可
提示：开源版用户可以自行添加面试题目到题库中，功能同样强大。
详细说明请查看 License 管理 页面。
3. 第一步：创建岗位
创建一个面试职位，告诉 AI 你要面试什么岗位。
NOTE
为什么要创建职位？
职位信息帮助 AI：
- 匹配相关的面试题目
- 调整题目难度
- 生成针对性的建议
- 评估回答质量
快速创建:
- 点击顶部导航 新建岗位
- 填写职位基本信息：
示例:
职位名称: Java 开发工程师
工作年限: 3-5年
必备技能: Spring/SpringBoot/MyBatis
职位描述: 负责系统需求分解、方案讨论、概要设计、技术调研等文档规划以及编写...
- 填写简历基本信息 (可选：上传简历，AI 会自动提取信息)
- 点击下一步自动保存
提示：职位信息越详细，AI 推荐的题目越精准。
详细说明请查看 新建岗位 页面。
4. 第二步：添加面试押题
面试押题是面试训练的核心内容，提前准备好题目可以让 AI 提供更准确的答案建议。
NOTE
为什么要添加面试押题？
面试押题帮助你：
- 针对性准备常见面试题
- AI 从题库检索相关答案，回答更准确
- 系统化梳理知识点
- 反复练习薄弱环节
如何添加面试押题？
- 点击顶部导航 > 面试押题
- 左侧选择刚创建的岗位
- 点击「创建新题目」按钮
- 填写题目信息：
- 题目标题：简洁明确的问题（如："解释 Spring Boot 自动配置原理"）
- 题目标签：选择或创建标签（如：Java、SpringBoot）
- 题目描述：详细的问题内容和参考答案
- 点击「创建」保存题目，自动「同步到向量库」
- 手动点击「同步到向量库」，将题目同步到 RAG 检索系统（可选）
题目来源建议：
- 从招聘网站收集该岗位的高频面试题
- 参考技术博客和面经分享
- 整理自己过往的面试经历
- 订阅用户可使用预置题库（在 License 管理 中一键导入）
提示：题目越多、越详细，AI 提供的答案建议越准确。建议每个岗位准备 20-50+ 道题目。
详细说明请查看 面试押题 页面。
5. 第三步：测试语音识别
确保麦克风和扬声器工作正常，语音识别准确。
IMPORTANT
为什么要测试？
CueMate 通过语音识别你的回答，语音识别质量直接影响：
- AI 能否正确理解你的回答
- 评分是否准确
- 训练体验是否流畅
5.1 系统权限授权
在开始测试之前，需要先授予 CueMate 必要的系统权限。
IMPORTANT
语音测试功能需要以下系统权限：
- 麦克风权限：用于麦克风音频采集（麦克风测试）
- 录屏与系统录音权限：用于系统音频捕获（扬声器测试）
请按照以下步骤完成授权，否则测试功能将无法正常使用。
麦克风权限授权
首次使用麦克风功能时，系统会自动弹出授权提示框，请点击"允许"按钮授予 CueMate 访问麦克风的权限。
如果误点了"不允许"或意外关闭了授权窗口：
- 打开"系统偏好设置 > 隐私与安全性"
- 在左侧菜单中找到并点击"麦克风"
- 在右侧应用列表中找到 CueMate，勾选其右侧的开关以启用麦克风权限
扬声器权限授权
扬声器测试需要使用 macOS 的系统音频捕获功能（AudioTee），该功能需要"录屏与系统录音"权限才能正常工作。
首次使用扬声器测试功能时，系统会自动弹出授权提示框，请点击"允许"按钮授予 CueMate 访问系统音频的权限。
如果误点了"不允许"或意外关闭了授权窗口：
- 打开"系统偏好设置 > 隐私与安全性"
- 在左侧菜单中找到并点击"录屏与系统录音"
- 在右侧应用列表中找到 CueMate，勾选其右侧的开关以启用系统音频捕获权限
- 如果列表中没有 CueMate，可以点击列表底部的"+"按钮手动添加
注意："录屏与系统录音"权限仅用于系统音频捕获，CueMate 不会录制您的屏幕画面。
5.2 打开语音测试页面
点击悬浮控制栏上的"语音识别"按钮（麦克风图标），打开面试功能窗口。
在面试功能窗口顶部，点击"语音测试"标签页，进入语音测试页面。
5.3 麦克风测试
操作步骤：
- 在"麦克风设备"下拉框中选择你的麦克风设备
- 点击"测试"按钮（蓝色按钮）
- 对着麦克风清晰地说一句完整的话（5-30 个字，如"今天天气真不错"）
- 系统会实时显示识别的文字
- 测试自动结束，显示成功或失败状态
测试成功：
- 显示绿色勾号 ✓
- 展示识别的文字内容
- 显示测试用时
测试失败：
- 显示红色叉号 ✗
- 显示错误原因
- 常见错误：权限未授予、服务未启动
5.4 扬声器测试
扬声器测试实际上是测试系统音频捕获能力，用于面试训练中识别面试官的语音。
操作步骤：
- 在"扬声器设备"下拉框中选择你的扬声器设备
- 点击"测试"按钮（蓝色按钮）
- 播放一段包含语音的音频或视频
推荐测试方法：
打开 百度翻译页面，粘贴一段文字，点击语音播放按钮：
或使用 谷歌翻译页面：
- 系统会实时显示识别的文字
- 测试自动结束，显示成功或失败状态
5.5 测试建议
麦克风测试：
- 保持麦克风距离适中（10-30 厘米）
- 说话清晰，语速适中
- 选择安静的环境，避免噪音干扰
扬声器测试：
- 播放清晰的中文或英文语音内容
- 音量适中，不要静音或过大
- 确保音频内容包含完整的语句
提示：如果测试失败，请检查系统权限设置，确保 cuemate-asr 服务正常运行。详细说明请查看 语音测试 页面。
6. 第四步：开始面试训练
一切就绪，开始你的第一次面试训练！
6.1 选择训练模式
CueMate 提供两种训练模式：
1. 模拟面试（推荐新手）
- 完整的面试流程
- AI 扮演面试官
- 多道题目连续答题
- 最后生成完整报告
2. 面试押题（针对性练习）
- 查看常见题目
- 选择感兴趣的题目
- 单独练习
- 查看参考答案
6.2 开始模拟面试
操作步骤:
- 点击顶部导航 面试押题
- 选择刚创建的职位
- 点击"开始训练"按钮
- AI 会开始提问
6.3 答题过程
答题界面:
- 左侧：题目内容
- 中间：录音按钮和实时识别
- 右侧：AI 实时建议（可选）
答题步骤:
- 仔细阅读题目
- 思考 10-20 秒组织答案
- 点击"开始录音"（或按空格键）
- 开始口述答案
- 答完后点击"停止录音"
- 查看 AI 实时反馈
- 点击"下一题"继续
答题技巧:
- 回答要点清晰，分点叙述
- 先说结论，再说理由
- 结合具体项目经验
- 注意时间控制（2-3分钟/题）
提示：第一次训练不要追求完美，重点是熟悉流程和找到感觉。
详细说明请查看 面试押题 页面。
7. 第五步：查看复盘报告
面试结束后，查看详细的复盘报告。
复盘报告包含:
- 每道题的回答得分
- AI 评价和改进建议
- 参考答案和答题要点
- 技能掌握度分析
- 薄弱知识点总结
如何查看？
- 面试结束后自动跳转到报告页
- 或点击顶部导航 面试复盘
- 选择想查看的面试记录
- 查看详细报告
复盘重点:
- 对比自己的回答和参考答案
- 找出遗漏的关键点
- 记录不熟悉的知识点
- 制定下次改进计划
提示：复盘比训练本身更重要，及时复盘效果最好。
详细说明请查看 面试复盘 页面。
8. 常见问题
8.1 Q: 必须配置 AI 模型吗？
A: 是的，AI 模型是核心功能，必须配置。建议优先选择国内服务商（智谱、Kimi），访问更稳定。
8.2 Q: 语音识别不准确怎么办？
A:
- 检查麦克风权限是否授予
- 选择安静的环境
- 调整麦克风音量
- 在 语音设置 中启用降噪
8.3 Q: 第一次训练应该准备什么？
A:
- 准备好职位信息
- 测试好语音识别
- 选择安静的环境
- 预留 30-60 分钟时间
8.4 Q: 可以中途暂停吗？
A: 可以。点击"暂停训练"保存进度，下次可以继续。
8.5 Q: 训练记录会保存吗？
A: 会。所有训练记录都保存在本地，可以随时在 面试复盘 中查看。
9. 进阶功能
熟悉基本流程后，可以探索更多功能：
9.1 优化 AI 回答质量
通过以下方式提升 AI 表现：
上传专业文档 到 向量知识库
- 上传技术文档、面经、笔记
- AI 会从中检索相关知识
- 回答更专业、更准确
配置提示词 在 Prompt 管理
- 自定义 AI 回答风格
- 调整评分标准
- 优化反馈内容
管理题库 在 预置题库
- 导入自己的题目
- 补充参考答案
- 按需分类管理
9.2 跟踪学习进度
在 主页 查看：
- 训练统计数据
- 技能掌握情况
- 进步曲线
- 学习建议
9.3 系统设置
在 系统设置 中：
- 修改个人信息
- 调整界面语言
- 设置主题
- 数据备份
获取帮助
遇到问题？
- 查看 帮助中心 获取详细文档
- 查看 常见问题 找到解决方案
- 提交 GitHub Issues
- 发送邮件到 nuneatonhydroplane@gmail.com
下一步
完成首次训练后，建议：
- 多练习几次，熟悉流程
- 针对薄弱知识点重点训练
- 定期复盘，持续改进
- 探索更多高级功能
祝你面试顺利！