From 0ffbf1935c9d091cce22a5583275ac0902f7a693 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Thu, 02 Jul 2026 03:04:51 +0800
Subject: [PATCH] Add Cantonese language model support
---
privatevoice.src/services/engine_service.go | 261 ++++++++++++++++++++++++++++++++++++++++++++++++---
1 files changed, 243 insertions(+), 18 deletions(-)
diff --git a/privatevoice.src/services/engine_service.go b/privatevoice.src/services/engine_service.go
index d40c951..2a93b00 100755
--- a/privatevoice.src/services/engine_service.go
+++ b/privatevoice.src/services/engine_service.go
@@ -1,6 +1,7 @@
package services
import (
+ "context"
"fmt"
"sync"
"voicesnap/internal/config"
@@ -15,13 +16,20 @@
// EngineService provides engine status and model management to the frontend.
type EngineService struct {
- cfg *config.Config
- app *application.App
- initCallback func()
- mu sync.RWMutex
- status string
- hardwareInfo string
- lastError string
+ cfg *config.Config
+ app *application.App
+ initCallback func()
+ mu sync.RWMutex
+ status string
+ hardwareInfo string
+ lastError string
+ downloadMu sync.Mutex
+ downloadID string
+ downloadCancel context.CancelFunc
+ downloadCancelling bool
+ downloadProgress float64
+ downloadDownloaded int64
+ downloadTotal int64
}
func NewEngineService(cfg *config.Config) *EngineService {
@@ -34,6 +42,10 @@
// ModelExists returns true if the ASR model files are present.
func (s *EngineService) ModelExists() bool {
return engine.ModelExists()
+}
+
+func (s *EngineService) HasAnyInstalledModel() bool {
+ return model.HasAnyUsableModel()
}
func (s *EngineService) GetStatus() map[string]interface{} {
@@ -53,6 +65,20 @@
func (s *EngineService) ListModelOptions() []map[string]interface{} {
current := s.currentModel()
+ return s.listModelOptionsForCurrent(current)
+}
+
+func (s *EngineService) ListModelOptionsForLanguage(languageID string) []map[string]interface{} {
+ current := s.currentModel()
+ activeLanguageID := current.LanguageSettings.EffectiveLanguageID
+ current.LanguageSettings = language.Resolve(config.LanguageModeManual, model.NormalizeLanguageID(languageID), nil)
+ if current.LanguageSettings.EffectiveLanguageID != activeLanguageID {
+ current.ModelID = ""
+ }
+ return s.listModelOptionsForCurrent(current)
+}
+
+func (s *EngineService) listModelOptionsForCurrent(current modelselection.CurrentModel) []map[string]interface{} {
languageProfile, err := model.GetLanguageProfile(current.LanguageSettings.EffectiveLanguageID)
if err != nil {
return nil
@@ -93,6 +119,25 @@
return nil
}
+func (s *EngineService) SelectModelForLanguage(languageID, modelID string) error {
+ languageID = model.NormalizeLanguageID(languageID)
+ profile, languageProfile, err := s.allowedModelProfileForLanguage(languageID, modelID)
+ if err != nil {
+ return err
+ }
+ resolved, err := model.ResolveModel(profile.ID)
+ if err != nil {
+ return err
+ }
+ if !resolved.IsUsable() {
+ return fmt.Errorf("model %s is not installed", profile.ID)
+ }
+
+ s.persistLanguageModelSelection(languageID, profile, languageProfile)
+ s.ReloadCurrentModel()
+ return nil
+}
+
func (s *EngineService) DownloadModelByID(modelID string) error {
profile, err := s.allowedModelProfile(modelID)
if err != nil {
@@ -102,7 +147,14 @@
return fmt.Errorf("no download URL configured for model %s", profile.ID)
}
- err = model.DownloadProfile(profile, profile.DownloadURLs, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ ctx, finish, err := s.beginModelDownload(profile.ID)
+ if err != nil {
+ return err
+ }
+ defer finish()
+
+ err = model.DownloadProfileWithContext(ctx, profile, profile.DownloadURLs, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ s.updateModelDownloadProgress(profile.ID, percent, downloaded, total)
if s.app != nil {
s.app.Event.Emit("model:download-progress", map[string]interface{}{
"percent": percent,
@@ -124,9 +176,85 @@
return nil
}
+func (s *EngineService) DownloadModelByIDForLanguage(languageID, modelID string) error {
+ languageID = model.NormalizeLanguageID(languageID)
+ profile, languageProfile, err := s.allowedModelProfileForLanguage(languageID, modelID)
+ if err != nil {
+ return err
+ }
+ if len(profile.DownloadURLs) == 0 {
+ return fmt.Errorf("no download URL configured for model %s", profile.ID)
+ }
+
+ ctx, finish, err := s.beginModelDownload(profile.ID)
+ if err != nil {
+ return err
+ }
+ defer finish()
+
+ err = model.DownloadProfileWithContext(ctx, profile, profile.DownloadURLs, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ s.updateModelDownloadProgress(profile.ID, percent, downloaded, total)
+ if s.app != nil {
+ s.app.Event.Emit("model:download-progress", map[string]interface{}{
+ "percent": percent,
+ "downloaded": downloaded,
+ "total": total,
+ "modelID": profile.ID,
+ "modelName": profile.DisplayName,
+ })
+ }
+ })
+ if err != nil {
+ return err
+ }
+
+ s.persistLanguageModelSelection(languageID, profile, languageProfile)
+ s.ReloadCurrentModel()
+ return nil
+}
+
+func (s *EngineService) persistLanguageModelSelection(languageID string, profile model.ModelProfile, languageProfile model.LanguageProfile) {
+ s.cfg.LanguageMode = config.LanguageModeManual
+ s.cfg.LanguageID = languageID
+ if profile.ID == languageProfile.DefaultModelID {
+ s.cfg.ModelSelectionMode = config.ModelSelectionModeAuto
+ s.cfg.SelectedModelID = ""
+ } else {
+ s.cfg.ModelSelectionMode = config.ModelSelectionModeManual
+ s.cfg.SelectedModelID = profile.ID
+ }
+ config.Save(s.cfg)
+}
+
+func (s *EngineService) CancelModelDownload(modelID string) bool {
+ s.downloadMu.Lock()
+ activeID := s.downloadID
+ if s.downloadCancel == nil || (modelID != "" && activeID != modelID) {
+ s.downloadMu.Unlock()
+ return false
+ }
+ s.downloadCancelling = true
+ s.downloadCancel()
+ s.downloadMu.Unlock()
+
+ if s.app != nil {
+ s.app.Event.Emit("model:download-cancelled", map[string]interface{}{
+ "modelID": activeID,
+ })
+ }
+ return true
+}
+
+func (s *EngineService) GetModelDownloadStatus() map[string]interface{} {
+ s.downloadMu.Lock()
+ defer s.downloadMu.Unlock()
+ return s.modelDownloadStatusLocked()
+}
+
func (s *EngineService) modelStatusMap(profile model.ModelProfile, current modelselection.CurrentModel) map[string]interface{} {
resolved, err := model.ResolveModel(profile.ID)
installed := err == nil && resolved.IsUsable()
+ supportedInBuild := model.IsModelSupportedInCurrentBuild(profile.ID)
status := model.ModelNotInstalled
var missing []string
var problems []string
@@ -154,25 +282,45 @@
"supportedLanguages": profile.SupportedLanguageIDs,
"recommendedLanguage": profile.RecommendedFor,
"description": profile.Description,
+ "supportedInBuild": supportedInBuild,
+ "unsupportedReason": model.ModelUnsupportedReason(profile.ID),
}
}
func (s *EngineService) SetStatus(status, hardwareInfo, lastError string) {
s.mu.Lock()
- defer s.mu.Unlock()
s.status = status
s.hardwareInfo = hardwareInfo
s.lastError = lastError
+ s.mu.Unlock()
+
+ if s.app != nil {
+ s.app.Event.Emit("engine:status", map[string]interface{}{
+ "status": status,
+ "hardwareInfo": hardwareInfo,
+ "error": lastError,
+ })
+ }
}
// DownloadModel downloads the ASR model with progress events.
func (s *EngineService) DownloadModel(primaryURL, fallbackURL string) error {
- err := model.Download(primaryURL, fallbackURL, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ profile := model.DefaultModelProfile()
+ ctx, finish, err := s.beginModelDownload(profile.ID)
+ if err != nil {
+ return err
+ }
+ defer finish()
+
+ err = model.DownloadProfileWithContext(ctx, profile, []string{primaryURL, fallbackURL}, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ s.updateModelDownloadProgress(profile.ID, percent, downloaded, total)
if s.app != nil {
s.app.Event.Emit("model:download-progress", map[string]interface{}{
"percent": percent,
"downloaded": downloaded,
"total": total,
+ "modelID": profile.ID,
+ "modelName": profile.DisplayName,
})
}
})
@@ -192,7 +340,14 @@
return fmt.Errorf("no download URL configured for model %s", current.ModelID)
}
- err := model.DownloadProfile(current.Profile, current.Profile.DownloadURLs, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ ctx, finish, err := s.beginModelDownload(current.ModelID)
+ if err != nil {
+ return err
+ }
+ defer finish()
+
+ err = model.DownloadProfileWithContext(ctx, current.Profile, current.Profile.DownloadURLs, paths.ModelsRoot(), func(percent float64, downloaded, total int64) {
+ s.updateModelDownloadProgress(current.ModelID, percent, downloaded, total)
if s.app != nil {
s.app.Event.Emit("model:download-progress", map[string]interface{}{
"percent": percent,
@@ -240,24 +395,94 @@
return modelselection.Resolve(s.cfg, language.NewSystemDetector())
}
+func (s *EngineService) beginModelDownload(modelID string) (context.Context, func(), error) {
+ s.downloadMu.Lock()
+ defer s.downloadMu.Unlock()
+ if s.downloadCancel != nil {
+ return nil, nil, fmt.Errorf("model %s is already downloading", s.downloadID)
+ }
+ ctx, cancel := context.WithCancel(context.Background())
+ s.downloadID = modelID
+ s.downloadCancel = cancel
+ s.downloadCancelling = false
+ s.downloadProgress = 0
+ s.downloadDownloaded = 0
+ s.downloadTotal = 0
+ finish := func() {
+ emitFinished := false
+ s.downloadMu.Lock()
+ if s.downloadID == modelID {
+ s.downloadID = ""
+ s.downloadCancel = nil
+ s.downloadCancelling = false
+ s.downloadProgress = 0
+ s.downloadDownloaded = 0
+ s.downloadTotal = 0
+ emitFinished = true
+ }
+ s.downloadMu.Unlock()
+ if emitFinished && s.app != nil {
+ s.app.Event.Emit("model:download-finished", map[string]interface{}{
+ "modelID": modelID,
+ })
+ }
+ }
+ return ctx, finish, nil
+}
+
+func (s *EngineService) updateModelDownloadProgress(modelID string, percent float64, downloaded, total int64) {
+ s.downloadMu.Lock()
+ if s.downloadID == modelID && s.downloadCancel != nil {
+ s.downloadProgress = percent
+ s.downloadDownloaded = downloaded
+ s.downloadTotal = total
+ }
+ s.downloadMu.Unlock()
+}
+
+func (s *EngineService) modelDownloadStatusLocked() map[string]interface{} {
+ return map[string]interface{}{
+ "active": s.downloadCancel != nil,
+ "modelID": s.downloadID,
+ "cancelling": s.downloadCancelling,
+ "percent": s.downloadProgress,
+ "downloaded": s.downloadDownloaded,
+ "total": s.downloadTotal,
+ }
+}
+
func (s *EngineService) allowedModelProfile(modelID string) (model.ModelProfile, error) {
+ current := s.currentModel()
+ profile, _, err := s.allowedModelProfileForLanguage(current.LanguageSettings.EffectiveLanguageID, modelID)
+ return profile, err
+}
+
+func (s *EngineService) allowedModelProfileForLanguage(languageID, modelID string) (model.ModelProfile, model.LanguageProfile, error) {
profile, err := model.GetModelProfile(modelID)
if err != nil {
- return model.ModelProfile{}, err
+ return model.ModelProfile{}, model.LanguageProfile{}, err
+ }
+ switch model.ModelUnsupportedReason(profile.ID) {
+ case "":
+ case model.UnsupportedReasonRequiresMacOS14:
+ return model.ModelProfile{}, model.LanguageProfile{}, fmt.Errorf("model %s requires macOS 14 or later", profile.ID)
+ case model.UnsupportedReasonWindowsPreview:
+ return model.ModelProfile{}, model.LanguageProfile{}, fmt.Errorf("model %s is not supported in the Windows preview build; use SenseVoice", profile.ID)
+ default:
+ return model.ModelProfile{}, model.LanguageProfile{}, fmt.Errorf("model %s is not supported in this build", profile.ID)
}
- current := s.currentModel()
- languageProfile, err := model.GetLanguageProfile(current.LanguageSettings.EffectiveLanguageID)
+ languageProfile, err := model.GetLanguageProfile(model.NormalizeLanguageID(languageID))
if err != nil {
- return model.ModelProfile{}, err
+ return model.ModelProfile{}, model.LanguageProfile{}, err
}
if profile.ID == languageProfile.DefaultModelID {
- return profile, nil
+ return profile, languageProfile, nil
}
for _, id := range languageProfile.UpgradeModelIDs {
if profile.ID == id {
- return profile, nil
+ return profile, languageProfile, nil
}
}
- return model.ModelProfile{}, fmt.Errorf("model %s is not available for language %s", profile.ID, current.LanguageSettings.EffectiveLanguageID)
+ return model.ModelProfile{}, model.LanguageProfile{}, fmt.Errorf("model %s is not available for language %s", profile.ID, languageProfile.ID)
}
--
Gitblit v1.9.3