refactor(adapter): 抽出 provider 抽象层(阶段0),controller 不再依赖火山实现

- 新增 adapter/provider:Provider/Capabilities/Request/Credentials/MetricsRecorder/UpstreamError + 注册表
- 火山实现 Provider(provider.go),Synthesis 收敛为私有 synthesize,提供 BuildRequest 过渡映射
- controller 经 provider.Get(name).Synthesize 调用,voice 路由改在 Request 上覆盖
- UpstreamError 上移到 provider 包,火山用类型别名沿用旧名
- setting 新增 GetTTSRequest/GetDefaultFormat/GetDefaultProviderName
- main.go 空导入注册火山
- docs/UPSTREAM_ADAPTER_GUIDE.md 更新为 v1.1(阶段0已落地)
This commit is contained in:
dev
2026-10-11 13:39:09 +08:00
parent ec82e895c3
commit 5c130f0be4
10 changed files with 386 additions and 101 deletions
+22
View File
@@ -11,6 +11,7 @@ import (
"sync"
"time"
"github.com/volcano-tts/tts-api/adapter/provider"
"github.com/volcano-tts/tts-api/adapter/volcano"
"github.com/volcano-tts/tts-api/common"
"github.com/volcano-tts/tts-api/telemetry"
@@ -55,6 +56,27 @@ func GetTTSOptions() volcano.Options {
return ttsOptions
}
// GetTTSRequest 返回运行时 TTS 配置映射成的 provider.Request 快照。
// 阶段0过渡:setting 内部仍构造 volcano.Options,经 volcano.BuildRequest 映射成
// provider.Request 交给主干;controller 拿到后按本次请求填 Text/Format/Speed,并做 voice 路由覆盖。
// 阶段2(配置命名空间化)后,此处改为直接构造 provider.Request,不再触碰火山类型。
func GetTTSRequest() provider.Request {
ttsMu.RLock()
defer ttsMu.RUnlock()
return volcano.BuildRequest(ttsOptions)
}
// GetDefaultFormat 返回默认输出格式(客户端未指定 response_format 时回退用)。
func GetDefaultFormat() string {
ttsMu.RLock()
defer ttsMu.RUnlock()
return ttsOptions.Format
}
// GetDefaultProviderName 返回当前默认上游适配器名。
// 阶段0:仅火山,恒为 "volcano";阶段2 后改从库表 default_provider 读。
func GetDefaultProviderName() string { return "volcano" }
// SetTTSOptions 整体替换 TTSOptions。LoadRuntimeConfig 写路径专用。
func SetTTSOptions(o volcano.Options) {
ttsMu.Lock()