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/frontend/src/components/settings/LanguagePage.svelte | 97 ++++++++++++++++++++++++++++++++++++++++++------
1 files changed, 84 insertions(+), 13 deletions(-)
diff --git a/privatevoice.src/frontend/src/components/settings/LanguagePage.svelte b/privatevoice.src/frontend/src/components/settings/LanguagePage.svelte
index 39de74f..f989836 100644
--- a/privatevoice.src/frontend/src/components/settings/LanguagePage.svelte
+++ b/privatevoice.src/frontend/src/components/settings/LanguagePage.svelte
@@ -3,7 +3,7 @@
import { t, setLocale } from '../../lib/i18n'
import { languageMode, languageID, effectiveLanguageID, uiLocale } from '../../lib/stores/config'
import type { UILocale } from '../../lib/stores/config'
- import { engineStatus, engineHardwareInfo } from '../../lib/stores/app'
+ import { engineStatus } from '../../lib/stores/app'
interface ModelOption {
modelID: string
@@ -14,6 +14,8 @@
isDefault: boolean
downloadSize?: string
description?: string
+ supportedInBuild?: boolean
+ unsupportedReason?: string
}
interface LanguageOption {
@@ -34,6 +36,7 @@
let modelCancellingID = $state('')
let modelProgress = $state(0)
let modelError = $state('')
+ let pendingLanguageID = $state('')
const unsub1 = languageMode.subscribe(v => { languageModeVal = v })
const unsub2 = languageID.subscribe(v => { languageIDVal = v })
@@ -99,21 +102,37 @@
async function syncEngineForCurrentModel() {
try {
const current: any = await Call.ByName('voicesnap/services.EngineService.GetCurrentModelStatus')
- if (current?.installed) {
- engineStatus.set('loading')
- } else {
- engineHardwareInfo.set('')
- }
+ if (!current?.installed) return
+ engineStatus.set('loading')
await Call.ByName('voicesnap/services.EngineService.ReloadCurrentModel')
} catch {}
}
async function loadModelOptions() {
+ if (pendingLanguageID) {
+ await loadModelOptionsForLanguage(pendingLanguageID)
+ return
+ }
+ await loadCurrentModelOptions()
+ }
+
+ async function loadCurrentModelOptions() {
try {
const options: any = await Call.ByName('voicesnap/services.EngineService.ListModelOptions')
modelOptions = Array.isArray(options) ? options : []
} catch {
modelOptions = []
+ }
+ }
+
+ async function loadModelOptionsForLanguage(selection: string): Promise<ModelOption[]> {
+ try {
+ const options: any = await Call.ByName('voicesnap/services.EngineService.ListModelOptionsForLanguage', selection)
+ modelOptions = Array.isArray(options) ? options : []
+ return modelOptions
+ } catch {
+ modelOptions = []
+ return []
}
}
@@ -157,6 +176,7 @@
case 'zipformer-ja-reazonspeech': return t('models.japaneseDesc')
case 'zipformer-ko': return t('models.koreanDesc')
case 'qwen3-asr-0.6b': return t('models.qwen3Desc')
+ case 'sensevoice-yue-2025-09-09': return t('models.sensevoiceYueDesc')
default: return option.description || ''
}
}
@@ -168,12 +188,28 @@
}
function modelTierLabel(option: ModelOption): string {
+ if (!modelSupported(option)) return t('settings.modelUnavailable')
if (option.isDefault) return t('settings.modelDefault')
if (option.tier === 'advanced') return t('settings.modelAdvanced')
return option.tier || ''
}
+ function modelSupported(option: ModelOption): boolean {
+ return option.supportedInBuild !== false
+ }
+
+ function modelUnsupportedText(option: ModelOption): string {
+ if (option.unsupportedReason === 'requires_macos_14') {
+ return t('models.qwen3RequiresMacOS14')
+ }
+ if (option.unsupportedReason === 'windows_preview_unsupported') {
+ return t('models.windowsPreviewUnsupported')
+ }
+ return t('settings.modelUnavailable')
+ }
+
function modelActionLabel(option: ModelOption): string {
+ if (!modelSupported(option)) return t('settings.modelUnavailable')
if (modelBusyID === option.modelID) {
if (modelBusyKind === 'download') {
return modelCancellingID === option.modelID ? t('settings.modelCancelling') : t('settings.modelCancel')
@@ -187,6 +223,9 @@
function modelMeta(option: ModelOption): string {
let meta = option.installed ? t('settings.modelInstalled') : t('settings.modelNotInstalled')
+ if (!modelSupported(option)) {
+ return `${meta} · ${modelUnsupportedText(option)}`
+ }
if (option.downloadSize) {
meta += ` · ${option.downloadSize}`
}
@@ -249,7 +288,7 @@
}
async function onModelAction(option: ModelOption) {
- if ((option.isCurrent && option.installed) || modelBusyID) return
+ if (!modelSupported(option) || (option.isCurrent && option.installed) || modelBusyID) return
modelBusyID = option.modelID
modelBusyKind = option.installed ? 'select' : 'download'
modelProgress = 0
@@ -257,9 +296,23 @@
try {
if (option.installed) {
engineStatus.set('loading')
- await Call.ByName('voicesnap/services.EngineService.SelectModel', option.modelID)
+ if (pendingLanguageID) {
+ await Call.ByName('voicesnap/services.EngineService.SelectModelForLanguage', pendingLanguageID, option.modelID)
+ pendingLanguageID = ''
+ const settings: any = await Call.ByName('voicesnap/services.ConfigService.GetLanguageSettings')
+ applyLanguageSettings(settings)
+ } else {
+ await Call.ByName('voicesnap/services.EngineService.SelectModel', option.modelID)
+ }
} else {
- await Call.ByName('voicesnap/services.EngineService.DownloadModelByID', option.modelID)
+ if (pendingLanguageID) {
+ await Call.ByName('voicesnap/services.EngineService.DownloadModelByIDForLanguage', pendingLanguageID, option.modelID)
+ pendingLanguageID = ''
+ const settings: any = await Call.ByName('voicesnap/services.ConfigService.GetLanguageSettings')
+ applyLanguageSettings(settings)
+ } else {
+ await Call.ByName('voicesnap/services.EngineService.DownloadModelByID', option.modelID)
+ }
engineStatus.set('loading')
}
await loadModelOptions()
@@ -286,16 +339,28 @@
async function onLanguageChange(selection: string) {
const prevMode = languageModeVal
const prevID = languageIDVal
+ const prevEffectiveID = effectiveLanguageIDVal
+ const prevPendingID = pendingLanguageID
if (selection === 'auto') {
+ pendingLanguageID = ''
languageModeVal = 'auto'
languageMode.set('auto')
} else {
languageModeVal = 'manual'
languageIDVal = selection
- languageMode.set('manual')
- languageID.set(selection)
}
try {
+ if (selection !== 'auto') {
+ const options = await loadModelOptionsForLanguage(selection)
+ const defaultInstalled = options.some(option => option.isDefault && option.installed)
+ if (!defaultInstalled) {
+ pendingLanguageID = selection
+ effectiveLanguageIDVal = selection
+ await syncModelDownloadStatus()
+ return
+ }
+ }
+ pendingLanguageID = ''
const settings: any = selection === 'auto'
? await Call.ByName('voicesnap/services.ConfigService.SetLanguageAuto')
: await Call.ByName('voicesnap/services.ConfigService.SetLanguageManual', selection)
@@ -306,6 +371,8 @@
} catch {
languageModeVal = prevMode
languageIDVal = prevID
+ effectiveLanguageIDVal = prevEffectiveID
+ pendingLanguageID = prevPendingID
languageMode.set(prevMode)
languageID.set(prevID)
}
@@ -359,7 +426,7 @@
<div class="model-list">
{#each modelOptions as option}
- <div class="model-card" class:current={option.isCurrent}>
+ <div class="model-card" class:current={option.isCurrent} class:unsupported={!modelSupported(option)}>
<div class="model-main">
<div class="model-title-row">
<span class="model-title">{option.displayName}</span>
@@ -376,7 +443,7 @@
<button
class="model-action primary"
class:cancel={canCancelModel(option)}
- disabled={!!modelBusyID && modelBusyID !== option.modelID}
+ disabled={!modelSupported(option) || (!!modelBusyID && modelBusyID !== option.modelID)}
onclick={() => onModelButton(option)}
>
{modelActionLabel(option)}
@@ -502,6 +569,10 @@
background: rgba(0, 122, 255, 0.055);
}
+ .model-card.unsupported {
+ opacity: 0.76;
+ }
+
.model-card.current::before {
content: '';
position: absolute;
--
Gitblit v1.9.3