简体中文

繁體中文
English

简体中文

繁體中文
English

Appearance

v0.1.1 版本说明 ​

发布日期: 2025-12-26 版本类型: 功能更新 稳定性: 稳定

版本概述 ​

CueMate v0.1.1 是首个功能更新版本，重点增强了安装部署体验和国际化支持。本版本新增在线/离线安装包选项、服务器部署模式、多语言界面等功能，并修复了多项已知问题。

新增功能 ​

1. feat(installer): 支持在线/离线两种安装包，在线包约 670MB 需网络拉取镜像，离线包约 4.4GB 开箱即用 ​

为满足不同网络环境用户的需求，v0.1.1 提供两种安装包类型：

类型大小特点适用场景
离线包~4.4GB包含所有 Docker 镜像和语音模型，开箱即用网络不稳定、带宽有限、企业内网
在线包~670MB安装时从网络拉取镜像网络稳定、需快速下载安装包

两种安装包的应用功能完全相同，仅在安装过程中的镜像加载方式不同。安装向导会自动识别安装包类型，并在界面左上角显示「离线安装」或「在线安装」标签。

安装向导欢迎界面

2. feat(installer): 新增服务器部署模式，支持将后端服务部署到远程 Linux 服务器，本地仅运行轻量客户端 ​

v0.1.1 引入全新的分布式部署架构，将桌面客户端和后端服务分离：

模式说明适用场景
本地模式桌面客户端 + 后端服务均在本地 Mac 运行个人使用、Mac 内存充足（≥16GB）
服务器模式后端服务部署到远程 Linux 服务器，本地仅运行轻量客户端Mac 内存有限、已有 Linux 服务器

服务器模式需要 Linux 服务器（推荐 Ubuntu 20.04+，4 核 8GB 以上配置），桌面客户端通过网络连接后端服务，大幅降低 Mac 的内存和 CPU 占用。

选择部署模式

3. feat(installer): 服务器配置页面，填写 SSH 连接信息并测试连接，验证远程服务器环境 ​

选择服务器部署模式后，安装向导会显示服务器配置页面：

SSH 连接配置

  • 服务器地址：远程服务器 IP 或域名
  • SSH 端口：默认 22
  • 用户名：SSH 登录用户
  • 认证方式：密码认证 / 私钥认证

高级选项

  • 部署路径：后端服务的安装目录（默认 /opt/cuemate）
  • 私钥密码：如私钥有密码保护

点击「测试连接」按钮验证 SSH 连接，系统会自动检测 SSH 连接、操作系统版本、Docker 环境、可用磁盘空间等。测试通过后才能继续下一步安装。

服务器配置页面

4. feat(installer): 安装向导多语言支持，支持简体中文、繁体中文、英文三种语言切换 ​

安装向导现已支持三种语言界面：

  • 简体中文：默认语言
  • 繁体中文：适合港澳台用户
  • English：适合国际用户

语言选项位于安装向导右上角，点击即可切换。所有安装步骤、提示信息、错误消息均已完成翻译。

安装向导语言切换

5. feat(desktop): 托盘菜单新增服务器配置卡片，显示和编辑当前服务器连接信息及端口配置 ​

托盘菜单新增「服务器配置」区域，方便用户快速查看和管理服务器设置：

显示信息

  • 当前部署模式（本地 / 服务器）
  • 服务器地址和 SSH 端口
  • 各服务的端口配置

操作功能

  • 编辑服务器连接信息
  • 重新测试 SSH 连接
  • 切换部署模式（需重新配置）

托盘菜单服务器配置

6. feat(desktop): SSH 连接测试功能，验证远程服务器连接并检测 Docker 环境、磁盘空间等 ​

桌面客户端内置 SSH 连接测试功能，用于验证和诊断服务器环境：

测试项目

  • SSH 连接：验证认证信息是否正确
  • 操作系统：显示 Linux 发行版和版本
  • Docker 环境：检测 Docker 和 Docker Compose 是否安装
  • 磁盘空间：显示可用空间是否满足要求（≥10GB）

测试结果以状态指示器显示，成功为绿色、失败为红色，并附带详细说明。

SSH 连接测试成功

7. feat(desktop): 动态服务 URL，根据部署模式自动切换本地或远程服务器的 API 地址 ​

桌面客户端现在能根据部署模式自动切换服务 URL：

模式API 地址示例
本地模式http://localhost:3001、http://localhost:3002 等
服务器模式http://{server_ip}:3001、http://{server_ip}:3002 等

切换部署模式后，所有服务 URL 自动更新，无需手动配置。Web 界面和桌面客户端均支持此功能。

动态服务 URL

8. feat(web): 设置即时保存，系统偏好和浮窗设置修改后立即生效并同步到桌面客户端 ​

设置页面的修改现在会即时生效：

  • 即时保存：修改语言、主题、时区等设置后立即保存，无需点击「保存」按钮
  • 即时同步：设置变更自动同步到桌面客户端，浮窗高度、交互模式等设置即时生效

系统设置界面

9. feat(web): 设置页面新增服务器部署配置卡片，显示当前部署模式和服务器信息 ​

设置页面新增「服务器配置」卡片区域：

显示内容

  • 当前部署模式（本地模式 / 服务器模式）
  • 服务器地址（服务器模式时显示）
  • 服务器名称
  • 连接状态指示器

此卡片为只读显示，如需修改服务器配置，请通过托盘菜单进入配置页面。

设置页面服务器配置卡片

10. feat(i18n): 面试功能多语言支持，TTS、ASR、面试分析报告根据语言设置自动切换 ​

面试功能现已完整支持多语言：

功能中文English
TTS 语音合成使用「花顏」女声使用「Amy」女声
ASR 语音识别支持中文识别支持英文识别
面试分析报告中文界面和文案英文界面和文案

系统根据语言设置自动选择对应的语音和文案。

AI 模拟面试

功能优化 ​

11. refactor(infra): Web 服务端口从 80 改为 3004，避免 macOS 低端口权限问题 ​

Web 服务的默认端口从 80 改为 3004：

项目旧版本新版本
Web 界面 URLhttp://localhosthttp://localhost:3004

变更原因：macOS 对 1024 以下端口有严格的权限限制，使用 80 端口需要 root 权限或额外配置，3004 端口无需特殊权限。

Web 服务端口

12. refactor(i18n): 完善国际化翻译，设置菜单、模型配置等界面支持多语言，语言选项显示原生名称 ​

国际化覆盖范围进一步扩展：

新增翻译区域

  • 设置菜单全部选项
  • LLM 模型配置页面
  • 容器监控页面
  • 日志管理页面

语言选项优化

  • 简体中文 → 简体中文
  • 繁体中文 → 繁體中文
  • English → English

语言选项使用原生名称显示，方便各语言用户识别。

国际化翻译

13. refactor(installer): 安装向导步骤切换添加滑动动画效果，前进向左滑出、后退向右滑出，提升用户体验 ​

安装向导步骤切换现在有流畅的滑动动画：

  • 前进：当前页面向左滑出，新页面从右侧滑入
  • 后退：当前页面向右滑出，新页面从左侧滑入

动画效果提升了用户体验，使步骤切换更加自然流畅。

安装向导动画

14. refactor(installer): 新增独立的客户端安装步骤页面，将镜像加载和桌面客户端安装分离，避免用户在镜像加载完成后关闭向导导致客户端未安装 ​

将镜像加载和桌面客户端安装分离为两个独立步骤：

步骤说明
镜像加载加载/拉取 Docker 镜像到本地或服务器
客户端安装安装桌面客户端、配置 Docker Compose、挂载语音模型

分离后避免用户在镜像加载完成后关闭向导导致客户端未安装的问题。

镜像加载

15. refactor(installer): FunASR 语音模型内置到安装包，安装时自动解压到挂载目录，解决服务器内存不足无法下载模型的问题 ​

FunASR 语音模型（约 1.6GB）现已内置到离线安装包：

  • 离线包：安装时自动解压模型到挂载目录，无需网络下载
  • 在线包：首次启动时自动下载模型

此改进解决了服务器内存不足时无法在容器内下载模型的问题。

客户端安装步骤

16. refactor(build): 优化离线安装包构建流程，移除冗余的配置文件，压缩 DMG 离线包体积 ​

优化了离线安装包的构建流程：

  • 移除冗余的配置文件
  • 压缩 DMG 离线包体积
  • 优化镜像 tar 包的打包方式

构建优化

Bug 修复 ​

17. fix(desktop): 改进主窗口初始化容错处理，解决部分情况下主窗口加载失败的问题 ​

修复了主窗口在某些情况下无法加载的问题：

问题现象

  • 点击托盘图标打开主窗口无响应
  • 主窗口显示空白页面

修复内容

  • 增加窗口初始化的异常捕获
  • 新增加载超时重试机制
  • 优化窗口创建顺序

18. fix(installer): 修复 electron-builder 打包时工作区符号链接导致的 external path 错误 ​

修复了 Monorepo 项目打包时的符号链接问题：

问题现象

  • pnpm build 打包时报 external path 错误
  • 工作区依赖无法正确解析

修复方案

  • 在 afterPack hook 中处理符号链接
  • 将符号链接替换为实际文件
  • 确保打包产物独立完整

19. fix(installer): 修复 Docker 检查页面只做检测未触发安装的问题，离线模式下支持一键安装内置 Docker（本地安装 macOS Docker Desktop，服务器模式安装 Linux Docker） ​

修复了 Docker 检查页面的安装功能：

问题现象

  • Docker 未安装时，点击「安装」按钮无反应
  • 只显示检测结果，无法触发安装流程

修复内容

  • 离线模式下支持一键安装内置 Docker
  • 本地模式：安装 macOS Docker Desktop
  • 服务器模式：通过 SSH 安装 Linux Docker

20. fix(installer): 修复点击上一步/左侧菜单返回后再进入会重新执行检测的问题，添加步骤缓存机制保留所有已完成步骤的数据和日志 ​

修复了安装向导的步骤缓存问题：

问题现象

  • 完成某步骤后返回上一步
  • 再次进入该步骤时，检测重新执行
  • 之前的检测结果和日志丢失

修复内容

  • 添加步骤缓存机制
  • 保留所有已完成步骤的数据和日志
  • 返回后再进入直接显示缓存结果

21. fix(installer): 新增 FastEmbed 嵌入模型支持，离线包包含预训练模型文件 ​

离线安装包现已包含 FastEmbed 嵌入模型：

  • 预训练模型文件内置到离线包
  • 安装时自动解压到挂载目录
  • 无需首次启动时下载模型

22. fix(desktop): 通过渲染进程获取音频设备列表，修复 ASR 设置页面设备检测问题 ​

修复了 ASR 设置页面无法正确检测音频设备的问题：

  • 改用渲染进程获取音频设备列表
  • 解决主进程权限限制导致的设备检测失败
  • 提升跨架构兼容性

23. fix(web): 新增初始化 API 请求重试机制和 HTTP 环境剪贴板回退 ​

改进 Web 前端的容错处理：

  • 初始化 API 请求失败时自动重试
  • 非 HTTPS 环境下提供剪贴板回退方案
  • 提高首次加载成功率

24. fix(infra): 降低 SSH、WebSocket、JWT 等非关键错误的日志级别，减少日志噪音 ​

优化日志输出级别：

  • SSH 连接错误从 error 降为 warn
  • WebSocket 断开重连从 error 降为 warn
  • JWT 验证和文件解析错误降为 warn
  • 减少非关键错误的日志干扰

升级说明 ​

从 v0.1.0 升级 ​

  1. 下载 v0.1.1 安装包
  2. 运行安装向导，选择「升级」
  3. 现有数据（岗位、简历、押题等）将自动保留
  4. 仅更新应用程序和 Docker 镜像

注意事项 ​

  • 升级后 Web 服务端口变更为 3004，请更新书签
  • 如需使用服务器模式，需重新运行安装向导

下载地址 ​

macOS 安装包 ​

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

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

提取码：3477

下载步骤：

  1. 点击上方链接访问百度网盘
  2. 输入提取码 3477
  3. 选择 v0.1.1 版本文件夹
  4. 选择安装包类型：
    • 离线包（推荐）：约 4.4GB，无需网络
    • 在线包：约 670MB，需网络拉取镜像
  5. 根据芯片类型下载：
    • Apple Silicon (M1/M2/M3)：arm64 版本
    • Intel 芯片：x64 版本

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

下载地址：https://github.com/cuemate-chat/cuemate/releases/tag/v0.1.1

反馈渠道 ​

发现问题或有建议？欢迎通过以下方式反馈：

感谢使用 CueMate！

Released under the GPL-3.0 License.

Copyright © 2025-present CueMate Team