繁體中文

简体中文
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