SAPI5 TTS（Windows）

使用 Windows 内置 SAPI5 的轻量级文本转语音方案。无需 GPU，实时生成。

安装

将下方脚本保存为 tts.ps1，置于你的 skills 文件夹中：

<#
.SYNOPSIS
    Windows SAPI5 TTS - 轻量级文本转语音
.DESCRIPTION
    使用 Windows 内置语音合成引擎（SAPI5）。
    兼容神经语音（Windows 11）及传统语音（Windows 10）。
    零 GPU 占用，实时生成。
#>

param(
    [Parameter(Mandatory=$false, Position=0)]
    [string]$Text = "",
    
    [Parameter(Mandatory=$false)]
    [Alias("Voice", "v")]
    [string]$VoiceName = "",
    
    [Parameter(Mandatory=$false)]
    [Alias("Lang", "l")]
    [string]$Language = "fr",
    
    [Parameter(Mandatory=$false)]
    [Alias("o")]
    [string]$Output = "",
    
    [Parameter(Mandatory=$false)]
    [Alias("r")]
    [int]$Rate = 0,
    
    [Parameter(Mandatory=$false)]
    [Alias("p")]
    [switch]$Play,
    
    [Parameter(Mandatory=$false)]
    [switch]$ListVoices
)

Add-Type -AssemblyName System.Speech
$synth = New-Object System.Speech.Synthesis.SpeechSynthesizer

$installedVoices = $synth.GetInstalledVoices() | Where-Object { $_.Enabled } | ForEach-Object { $_.VoiceInfo }

if ($ListVoices) {
    Write-Host "`n已安装的 SAPI5 语音：`n" -ForegroundColor Cyan
    foreach ($v in $installedVoices) {
        $type = if ($v.Name -match "Online|Neural") { "[Neural]" } else { "[Legacy]" }
        Write-Host "  $($v.Name)" -ForegroundColor White -NoNewline
        Write-Host " $type" -ForegroundColor DarkGray -NoNewline
        Write-Host " - $($v.Culture) $($v.Gender)" -ForegroundColor Gray
    }
    Write-Host ""
    $synth.Dispose()
    exit 0
}

if (-not $Text) {
    Write-Error "必须提供文本。用法示例：.tts.ps1 'Your text here'"
    Write-Host "使用 -ListVoices 查看可用语音列表"
    $synth.Dispose()
    exit 1
}

function Select-BestVoice {
    param($voices, $preferredName, $lang)
    
    if ($preferredName) {
        $match = $voices | Where-Object { $_.Name -like "*$preferredName*" } | Select-Object -First 1
        if ($match) { return $match }
        Write-Warning "未找到语音 '$preferredName'，正在自动选择..."
    }
    
    $cultureMap = @{
        "fr" = "fr-FR"; "french" = "fr-FR"
        "en" = "en-US"; "english" = "en-US"
        "de" = "de-DE"; "german" = "de-DE"
        "es" = "es-ES"; "spanish" = "es-ES"
        "it" = "it-IT"; "italian" = "it-IT"
    }
    $targetCulture = $cultureMap[$lang.ToLower()]
    if (-not $targetCulture) { $targetCulture = $lang }
    
    $neuralMatch = $voices | Where-Object { 
        $_.Name -match "Online|Neural" -and $_.Culture.Name -eq $targetCulture 
    } | Select-Object -First 1
    if ($neuralMatch) { return $neuralMatch }
    
    $langMatch = $voices | Where-Object { $_.Culture.Name -eq $targetCulture } | Select-Object -First 1
    if ($langMatch) { return $langMatch }
    
    $anyNeural = $voices | Where-Object { $_.Name -match "Online|Neural" } | Select-Object -First 1
    if ($anyNeural) { return $anyNeural }
    
    return $voices | Select-Object -First 1
}

$selectedVoice = Select-BestVoice -voices $installedVoices -preferredName $VoiceName -lang $Language

if (-not $selectedVoice) {
    Write-Error "未检测到任何 SAPI5 语音！请在 Windows 设置 → 时间和语言 → 语音 中安装语音包"
    $synth.Dispose()
    exit 1
}

if (-not $Output) {
    $ttsDir = "$env:USERPROFILE.openclawworkspacetts"
    if (-not (Test-Path $ttsDir)) { New-Item -ItemType Directory -Path $ttsDir -Force | Out-Null }
    $timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
    $Output = "$ttsDirsapi_$timestamp.wav"
}

try {
    $synth.SelectVoice($selectedVoice.Name)
    $synth.Rate = $Rate
    $synth.SetOutputToWaveFile($Output)
    $synth.Speak($Text)
    $synth.SetOutputToNull()
    
    Write-Host "语音：$($selectedVoice.Name) [$($selectedVoice.Culture)]" -ForegroundColor Cyan
    Write-Host "MEDIA:$Output"
    
    # 如指定 -Play，则自动生成并播放（使用 .NET MediaPlayer，无需外部播放器）
    if ($Play) {
        Add-Type -AssemblyName PresentationCore
        $player = New-Object System.Windows.Media.MediaPlayer
        $player.Open([Uri]$Output)
        $player.Play()
        Start-Sleep -Milliseconds 500
        while ($player.Position -lt $player.NaturalDuration.TimeSpan) {
            Start-Sleep -Milliseconds 100
        }
        $player.Close()
    }
    
} catch {
    Write-Error "TTS 执行失败：$($_.Exception.Message)"
    exit 1
} finally {
    $synth.Dispose()
}

快速开始

# 生成音频文件
.tts.ps1 "Bonjour, comment vas-tu ?"

# 生成并立即播放
.tts.ps1 "Bonjour !" -Play

参数说明

使用示例

# 法语，启用自动播放
.tts.ps1 "Bonjour !" -Lang fr -Play

# 英语，加快语速
.tts.ps1 "Hello there!" -Lang en -Rate 2 -Play

# 指定语音（如 Denise）
.tts.ps1 "Salut !" -Voice "Denise" -Play

# 列出所有可用语音
.tts.ps1 -ListVoices

安装神经语音（推荐）

神经语音（Neural voices）音质显著优于传统桌面语音（Legacy Desktop voices）。

Windows 11

神经语音已内置。前往：
设置 → 时间和语言 → 语音 → 管理语音

Windows 10 / Windows 11（更多语音）

如需额外神经语音（例如法语 Denise）：

1. 安装 NaturalVoiceSAPIAdapter
2. 在 设置 → 时间和语言 → 语音 中下载所需语音
3. 运行 -ListVoices 命令验证是否安装成功

性能表现

• 生成速度：实时（< 1 秒）
• GPU 占用：无
• CPU 占用：极低
• 音质：优秀（Neural）/ 基础（Legacy）

致谢

由 Pocus 🎩 开发 — AI 助手，联合 Olive（@Korddie）共同完成。