Skip to content

fix(say): 待合成文本改走标准输入与临时文件,不再拼进命令行参数 - #12

Open
modusensus wants to merge 2 commits into
mainfrom
fix/say-text-stdin
Open

modusensus wants to merge 2 commits into
mainfrom
fix/say-text-stdin

Conversation

@modusensus

Copy link
Copy Markdown
Member

为什么改

say.ps1 原来靠命令行 -Text <回复> 收待合成文本。PowerShell 在 -File 模式下会把以 - 开头的值当成参数名解析,所以回复里一旦出现 -Text / -Out / --text 这类字样,脚本就报:

Missing an argument for parameter 'Text'. Specify a parameter of type "System.String" and try again.
FullyQualifiedErrorId : MissingArgument,say.ps1

三个调用点(lib/chat.js 的语音条、lib/index.js 的 say_aloud 工具、lib/rules-remote.js 的面板试听)都是 await + 外层 try/catch,异常被吞成「语音条生成失败,回退文字」——没有声音,但对话照常继续,从外面看不出来。

待合成的正好是模型回复,QQ 里对方说的话会进来,内容不由我们决定。

同一个坑在下游还有两处:tts-volc.py 用 argparse、edge-tts 用 click,--text -Text 同样会被判成缺参数。实测这一路会一路降级到 Windows SAPI——不是没声音,而是悄悄换了音色和引擎。

改法

层 改了什么
lib/say.js(新增) runSay({ sayScript, text, out }):spawn 起 powershell,只传脚本路径与 -Out,正文写 stdin。带 EPIPE 兜底、超时 kill、退出码与 stderr 透传,回读脚本报告的产物路径
say.ps1 $Text 去掉 Mandatory;没给 -Text 时用 StreamReader 按 UTF-8 读 stdin;显式设 OutputEncoding 为无 BOM UTF-8;空文本 exit 2
tts-volc.py 新增 --text-file,--text 改为非必填;文本按 utf-8-sig 读
edge-tts 调用 改用 -f $textFile
三个调用点 全部走 runSay,产物路径以脚本回报为准(兜底层可能回 .wav)

两个非显然的点:

  1. stdin 必须显式按 UTF-8 解码。默认的 [Console]::In 走控制台代码页(中文机器是 GBK),调用方按 UTF-8 写入,读出来就是「浣犲ソ」——念出来是一串噪音。
  2. stdout 也必须设成 UTF-8。产物路径经 stdout 回给调用方,默认按代码页输出,调用方按 UTF-8 解就把路径里的中文解成乱码,于是「文件明明在,却找不到」。所以单测的临时目录名故意带中文。

正文另外落成一个 UTF-8 临时文件供下游 CLI 读,用 PowerShell.Exiting 事件清理,不留垃圾。

测试

新增 tests/test-say.mjs(68 条断言),已并入 tests/all.mjs(现 11 套)。四组:

  1. 静态 lib/:say.js 必须 spawn + -File、无 -Command、无 -Text、stdio pipe、stdin.end、stdin.on('error')、setTimeout;三个调用点都得有 runSay 且不得再自己拼 powershell 参数;再按正则扫全 lib/ 兜底。
  2. 静态 say.ps1:ContainsKey('Text')、OpenStandardInput()、StreamReader + Encoding]::UTF8、IsNullOrWhiteSpace、exit 2、不再是 Mandatory、OutputEncoding 是 UTF-8。
  3. 动态(仅 Windows + 有 powershell):用 stub 跑 10 个用例——普通中文 / -Text / --out / -NoProfile -File 这种东西 / 多行 / 引号反斜杠 / $(New-Item x) / 反引号制表 / emoji 全角 / 3000 字长文本——逐字节比对回读。另测空文本拒绝、bad.ps1 exit 7 的报错透传、老写法 -Text "..." 仍兼容。
  4. 下游 CLI:say.ps1 必须用 --text-file / -f;tts-volc.py 必须有 --text-file 且 --text 不再 required;动态验证 --text -Text 确实被 argparse 拦下(这条记录了我们为什么改走文件)。

第 3 组直接 import lib/say.js 调 runSay,不是自己复刻一遍调用逻辑——否则测试绿了也不代表生产代码对。

变异自证(3 次,均被抓)

变异 抓它的断言
say.js 把 '-Text', text 塞回 spawn argv 「say.js 的参数数组里不该再有 '-Text'」
say.ps1 把 StreamReader 退回 [Console]::In.ReadToEnd() 「say.ps1 要从标准输入读全文」
tts-volc.py 把 --text 改回 required=True 「--text 不该还是 required」

每次变异后都已还原。

验证

node tests/all.mjs → 11 套全过(约 40 秒):

rules 96 / cycle 111 / plugin 22770 / brain 212 / care 70 / travel 300
luckin 274 / remote 524 / release-body 239 / tts-inject 9241(49 断言)/ say 8554(68 断言)

真机端到端(直调 runSay + 真 say.ps1):普通中文 → Tier 0 火山出 mp3 21357B;文本恰为 -Text → 同样 Tier 0 出 mp3 9837B。改之前这一例会静默降级甚至失败。

没做的事

  • CI 跑不到第 3、4 组的动态部分:runner 是 ubuntu,没有 powershell。这两段会自我跳过并打印原因,不计入通过。想真覆盖只能上 Windows runner,成本另说。
  • tts-volc.py 不在版本库里(.gitignore 第 19 行,它是本机的复刻音脚本,不带凭据也跑不了),所以测试里对它只在文件存在时校验。
  • 老写法 -Text "..." 保留兼容,只是不再推荐;文档已改为 stdin 示例。

三处调用点(lib/chat.js 的语音条、lib/index.js 的 say_aloud 工具、
lib/rules-remote.js 面板试听)原本都是 powershell -File say.ps1 -Text <回复>。
PowerShell 在 -File 模式下会把以 "-" 开头的值当作参数名解析,待合成文本
恰好是 "-Text" / "-Out" / "--text" 时直接报 MissingArgument 退出 1。三处
都是 await + try/catch,异常被吞成「语音条生成失败,回退文字」,表现为
没声音但对话照常继续——静默失败。

改法:

- 新增 lib/say.js 的 runSay(),统一用 spawn 起 powershell,只传脚本路径
  与 -Out,正文经 stdin 写入;带 EPIPE 兜底、超时 kill、退出码与 stderr
  透传,并回读脚本报告的产物路径。
- say.ps1 去掉 $Text 的 Mandatory,未给 -Text 时用 StreamReader 按 UTF-8
  读标准输入;显式设置 OutputEncoding 为无 BOM UTF-8,否则中文产物路径
  经 stdout 回来是乱码;空文本直接 exit 2,不再往下走四层链产出静音。
- 正文落成临时文件供下游 CLI 读取:Tier 0 的 tts-volc.py 增加 --text-file
  并把 --text 改为非必填,Tier 2 的 edge-tts 改用 -f;两者都把以 "-" 开头
  的文本当作选项,同样会失败。临时文件用 PowerShell.Exiting 事件清理。
- 三处调用点改用 runSay,产物路径以脚本回报的为准。

测试:新增 tests/test-say.mjs(68 条断言),静态钉住三处调用点与 say.ps1
的传输方式,动态用 stub 跑十组恶意文本逐字节比对回读,并验证退出码与
stderr 透传、空文本拒绝、旧 -Text 写法仍兼容;已并入 tests/all.mjs。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant