Add Cantonese language model support

Ariver

2026-07-02 0ffbf1935c9d091cce22a5583275ac0902f7a693

 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;