8 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	b90811fae4	docs(voice): 收口「没会话/没绑定就走 default」的镜像注释（r4） ... 唯一 finding：audio.go 的 speechRequest.SessionID 注释原本写「省略它时本口没有会话 概念 ⇒ 走 emotionTTS 的 default 分支」——**反了**。真实链路是 effectivePersona(ctx,"") → sessionPersona("") 为空**不是终点** → Effective = defaultPersonaID() → 常规安装必有全局默认人格 ⇒ personaId 非空 ⇒ 走 personas 映射。 照那句话改的人会写出 `if req.SessionID == "" { personaID = "" }`，正是 r2 修掉的病。 改为：省略时按**全局默认人格**选发音人（会话绑定 → 全局默认人格 → 两者都没有才落到 default 字符），并显式写了"不要写成 if SessionID == \"\" { personaID = \"\" }"。 顺手同根三处（不留第四轮）： - tts/config.go 的 Config.Default 注释：成因表「会话无绑定 / 读取失败 / 该出口本身 没有会话」已过时 ⇒ 改为「空串的唯一合法成因是连全局默认人格都没有」，并写明不是 "会话未绑定"、也不是"出站口没有会话"。 - runtimeconfig/voicetts.go 的 Default 字段注释与文件头同族措辞同步； - selection.go 的 WithPersonaID / Resolve 分支表、service.go 的分支小标把 「解析不到」统一改成「连全局默认人格都没有」； - voice_emotiontts_test.go 的 TestSpeechEndpointNoSessionUsesDefault 注释同步（该用例 没接人格库，所以确实落到 default —— 但成因写对了）； - wire_voice_tts_test.go nit：改成「已废弃的全局 `character` 不生效」（墓碑键仍在）。 纯注释：`git diff` 里非注释改动行为空。go build/vet 通过；四包 go test -count=1 全绿。	2026-10-26 13:40:00 +08:00
AskaEth	e684061e56	fix(voice): 主/子系统会话的发音人跟「生效人格」走（r2 P2-1）+ 错误码可区分 ... P2-1（实质）：主会话（web）的 persona_id 恒为空且无重绑路径，而"空"的真实语义是 「继承全局默认人格」（loop/persona.go 回退 Options.PersonaID；前端 lib/persona.ts 的 bound ?? defaultPersona(personas) 是同一口径）。此前只有 TTS 把空读成"没有生效人格" ⇒ 落到 voice-tts.json 的 default：主会话聊天是 furina、声音却是 default 那个人， 换全局人格后也不跟声 —— 正是主人抱怨的那件事，且发生在唯一能给普通聊天出声的路径。 修法： - turnEnvResolver 新增 resolvePersona/effectivePersona（绑定 → 全局默认人格 → ""）， 默认人格扫描抽成 defaultPersonaIDFrom 一处（*Server.defaultPersonaID 转调它）； - ownerWithPersona 复用**同一次**会话读取同时给出 loop 用的 binding 与呈现用的 effective —— WS 语音回合为选音色不新增任何 I/O； - REST：现有闸内改用 effectivePersona；WS：voice.go 那次 env 解析处取一次传给 sink。 因此 `default` 只剩"连默认人格都没有"这一种用途。 - service.go 那句"换人格后用老角色声音不可能发生"收回为限定说法：本包无缓存、无兜底 角色、未映射即拒绝，但**调用方必须传生效人格**（网关两处已修）。 回归锁：voice_persona_inherit_test.go 复现复审用例（名字不同、两条口各一条）—— 未绑定会话 + 全局默认 furina + default 指向 cyrene ⇒ 必须用 furina 的声音； 变异（effectivePersona 退回「空 = 无」）实测两条都红，报文与复审一致。 建议 3（顺手做）：persona 未映射时状态码仍 500（服务端配置缺失），但错误码换成 tts_persona_unmapped / tts_no_character，不再与一般合成失败混成一个码； 用例 TestSpeechEndpointPersonaUnmappedErrorCode 钉住。 P2-2（nit）：voicetts.go 开头删掉「格式、」两字（该键已删除）。 go build ./... + go vet ./... + go test（含 -race）全绿。	2026-10-26 13:21:44 +08:00
AskaEth	8820b0b316	fix(voice): 修 r1 复审四条（正文进日志的隐私泄漏 / format 假开关 / Stats 无消费者 / redactURL 兜底） ... 上一版把 r1 的三条 finding 静默漏了（我在交付前没读 inbox），本提交逐条补齐： 1. 🔴 隐私：upstreamStatus 不再读也不记响应体 FastAPI 的 422 会把请求体里的 input 整段回显，原来「错误体前 512 字节进 WARN」 等于把她的原话写进日志。现在只记 status / content_type / response_bytes （字节数优先取 Content-Length，缺失时有界排空取上界，读到即丢）。 新用例 TestSpeechRejectLogOmitsRequestText 用**回显正文**的假上游抓它； 变异（把 body 塞回 WARN）实测打红。 2. format 键彻底删除（假开关） 上游只拿 response_format 改自报 media_type，产物恒 .wav 无转码，我方只按字节 嗅探裁决 ⇒ wav/mp3/ogg 交付字节与响应头完全相同。删 tts.Config.Format 与 VoiceTTSTuning.Format，encodeSpeech 硬编码 requestFormat="wav"（不可配置）。 用例钉住请求体恒为 wav；变异（改成 mp3）打红。旧文件里残留的 format 键被忽略。 3. Stats 接进 degrade 的 WARN（attempts/failures） 否则统计在生产日志里没有消费者。TestServiceDegradeLogsCounters 钉住； 变异（去掉两个字段）打红。 4. redactURL 兜底含 "@" 整体打码 解析失败/无 host 时原来原样返回，user:pass@ 会漏凭据。TestRedactURLCredentials 覆盖合法 URL 去 userinfo、非法含 @ 打码；变异（退回原样返回）打红。 另：关闭态零行为变化的**当前 tip 重跑**—— - handleSpeech 的 persona 解析改为只在语音服务实现 personaVoice 且 PrimaryActive 时才查库；未接 emotionTTS（既有链/stub）时零额外 I/O、ctx 不改、音频字节相同。 用例 TestSpeechEndpointDisabledVoiceDoesNotReadPersona（含对照组证明闸不是恒关）； 变异（去掉闸）打红。 - voice.go 在 dev 基线里本就有 env.PersonaID 解析（无人格解析新增 I/O），本次未改。 Config.Normalized 去掉未使用的 logger 参数。go build/vet/test（含 -race）全绿； 真机 live 复测：cyrene 264104 B、furina 221194 B。	2026-10-26 13:06:39 +08:00
AskaEth	efc25c6a7f	feat(voice): emotionTTS 发音人绑定会话人格（不再全局定死一个 character） ... 主人 2026-10-26 逐字：「TTS 的人物选择是要绑定后端的角色的，不然会出现以后换了 别的角色(人格配置)，还是用老角色的 TTS 角色」——上一版把 character 写在面板文件 里当全局值，换人格后声音不变，是真缺陷。 配置形状（单一真源 = $DATA_DIR/config/voice-tts.json）： {"enabled":true, "personas":{"<personaId>":"<characterId>"}, "default":"<characterId>", // 只服务「解析不到 personaId」 "format":"wav","timeoutSec":60} - 旧的全局 `character` 键**废弃并被忽略**（启动 WARN 提示改用 personas）； Config.Normalized 不给任何角色兜底（代码里写死默认角色=病害本身）； - configs/personas/*.yaml 不参与（塔裁定：避免启动期静态配置与面板两处漂移）； - 零新 .env 键。 选角四条分支（Config.Resolve，纯函数、无缓存）： ① persona 有映射 ⇒ 用它； ② personaId 为空/解析不到 + 配了 default ⇒ 用 default； ③ personaId 为空 + 没配 default ⇒ 不合成（ErrNoCharacter，上游 0 请求）； ④ persona 无映射（含映射值为空）⇒ 拒绝（ErrPersonaUnmapped）， **绝不**拿 default 或别的角色顶 —— 主人担心的病害本身。 两条既有出站口各自按当次请求解析 persona（不在 SetVoice 时算一次缓存成全局）： - WS voice_output：用本回合的 env.PersonaID（runVoiceTurn/runVoiceTurnDirect）， 经 voiceReplySink 传给 synthesizeVoiceReply，再 WithPersonaID 交给语音面； - POST /api/v1/audio/speech：请求体新增**可选** sessionId（纯增量）， 经 turnEnvResolver.sessionPersona 解析；省略 ⇒ 走 default 分支。 Client.Speech 改为**每次传入 character**（内部不缓存发音人）；Provider 适配同样按 ctx 的 personaId 现算。选不到发音人时**不回落既有链**（回落=用另一个声音说话）， 上游拒绝(404/500)仍按既有口径回落既有链+WARN。 测试：四条分支各自可变异打红，断言打在「上游请求体里的 voice」与帧/响应字节上； 含「同一进程先后两个 persona，第二次绝不沿用第一次 voice」的回归锁， 以及两条出站口的端到端 persona 切换。四条变异（未映射回落 default / 客户端缓存 voice / REST 不看会话 / 选不到时回落底链）均已实测打红后还原。 go build ./... / go vet ./... / go test -race 全绿；真机 live 证据： cyrene(char_84fb88a3)=254630 B、furina(char_5314489e)=213392 B。	2026-10-26 12:57:35 +08:00
AskaEth	074ffc4ebf	docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动） ... 主人 2026-10-03 拍板「注释一律中文」；gateway 至此整包注释中文化完成（本会话共 3 批： 已推库 16 个文件 + 本批剩余文件）。 校验：机械校验（非注释改动行）= 空；剥注释后代码文本逐行比对全等（不一致文件数 0）； 全树 go test ./... 58 包 ok / 0 FAIL；交叉编译绿。	2026-10-03 22:28:25 +08:00
AskaEth	99f222761e	feat(voice): 语音silent降级信号(C2) — provider仅在结果为空时出现 ... - voice/Chain+Service: STTWithProvider/TTSWithProvider(真实档位cloud/local/edge-tts/espeak/silent), 旧方法改薄包装 - gateway: transcribe空文本带{text,provider} / voice_output空音频带provider / speech空音频tts_empty+X-Voice-Provider头 - middleware: CORS Access-Control-Expose-Headers: X-Voice-Provider - 可选接口 voiceProviderReporter(type断言透传), 自定义实现回退silent - 新增测试10个(provider_signal/voice_signal), build/vet/test全绿+交叉编译 - Docs/api-client v0.23 + api-reference CORS 同步	2026-09-08 21:23:12 +08:00
Aska	03d7050e1e	feat(voice): 百炼声音复刻create_voice + TTS instruction情绪驱动(主TTS-昔涟复刻音色)	2026-09-08 06:48:15 +08:00
Aska	73dabb9dde	feat(voice): 阿里百炼 STT/TTS 主链路接通(base64 STT + cosyvoice TTS按voice_id + REST /audio/* + voice_input.deviceId) ... - voice/dashscope.go 新建：DashscopeSTT(qwen-audio-3.0-asr-flash, base64 data URI→text) + DashscopeTTS(cosyvoice 按 voice_id, 取非流式 24h URL 下载字节) - cloud.go newDashboardSTT/TTS 由空 endpoint stub 改为真实百炼 adapter - chain.go gating 从 DashscopeAPIKey!="" 改为 voiceConfigured(cfg); silent 兜底保留 - config.VoiceConfig 扩展 DASHSCOPE_BASE_URL/VOICE_STT_*/VOICE_TTS_* 字段(必填 DASHSCOPE_API_KEY) - gateway: POST /api/v1/audio/{transcribe,speech} (owner+审计+MaxBytesReader); voiceInputRequest 增 deviceId 并透传 runner.Run - 实测: cosyvoice-v3.5-plus+longxiaochun 回 418(引擎拒绝), 改用 cosyvoice-v3-flash+longxiaochun_v3; TTS 你好我是昔涟->106124B wav -> STT 回 你好我是西联, 链返回真实字节/文本 - 单测: dashscope_test/config voice defaults/gateway audio_test; go build/vet/test 全绿 - 声音复刻(响昔涟音色)待公网参考音频; 不做 create_voice	2026-09-08 06:06:02 +08:00