2.1.8:修 Win7 语音播报 + 快捷栏按钮做大且4格全能换

用户这一轮报了两个问题,都修了。

== 一、Win7 上语音播报不能用 ==

用户原话:"我 win7 上的语音播报好像不能用,你再试一下别的版本能不能用"

**原来只有一条路**:

    powershell -NoProfile -WindowStyle Hidden -Command
        "Add-Type -AssemblyName System.Speech; $s = New-Object ...; $s.Speak('...')"

这在 Win7 上有三个坑,任何一个都能让它彻底不出声:

  1. **`powershell` 只按名字找**
     Win7 的 powershell.exe 在 `%SystemRoot%\System32\WindowsPowerShell\v1.0\`。
     精简版系统、或从服务/计划任务拉起时 PATH 里可能没有 ——
     CreateProcess 按名字找不到时是**静默失败**的。

  2. **Win7 默认 PowerShell 2.0,它按 ANSI 代码页解析 `-Command`**
     PS 3.0 起才按 UTF-16 处理。中文经 `-Command` 传进去容易乱码 ——
     表现是念出来是乱码,或者干脆不念。

  3. **`System.Speech` 需要 .NET Framework 3.0+**
     而系统自带的 **SAPI5** 从 Windows XP 就有,**根本不需要 .NET**。

**改成多方案降级**,按"依赖越少越优先"排:

    1. cscript + VBScript + SAPI5      <- Win98 起就有,不用装任何东西
    2. wscript + VBScript + SAPI5      <- 上一条被安全软件拦时的备选
    3. powershell + SAPI5 (COM)        <- 绕开 .NET
    4. powershell + System.Speech      <- 原来的做法,改用绝对路径
    5. powershell(PATH) + System.Speech <- 最原始的,兜底

一条通了**记住它**,以后直接用(不用每次从头试)。

**顺带修掉一个"骗人"的行为**:原来 `say()` 用 `Popen` 不等进程结束,
失败了也返回"已播报" —— 明明没出声却报成功。
现在等退出码,**全失败会明确报错并列出试过哪几条**。
代价是同步等待(念多久等多久),但"报成功其实没出声"比"慢一点"糟糕得多。

还加了 `_build/diag_tts.py`:在一台机器上把 5 条方案全试一遍并报告
哪条能用 —— 下次再有"某台机器上不行",跑一下就知道。

VBScript 的细节:**必须用 ANSI(mbcs) 写**,写成 UTF-8 的话
cscript 读出来中文是乱码(VBScript 的老规矩,很隐蔽)。
长文本还要分句 —— VBScript 单行有长度上限。

== 二、快捷栏按钮太小 + 4 格都要能换 ==

用户原话:"屏幕最上面这个按钮有些按不到,按钮太小了,做大一点,
           然后呢,这个每每个四格算换一下吧,第一个第二个第三个
           第四个都能换东西"

  * **按钮做大**:30dp -> 46dp(接近 Android 建议的最小可点区域 48),
    字号 11 -> 14。30dp 在表盘上手指按上去一半在栏外。
    **栏高做成常量 QUICK_BAR_DP,栏高 / 面板 topMargin / addView
    三处用同一个值** —— 分三处写的话改一个忘一个,
    表现是"内容被盖住"或"上面空一条"。

  * **4 格全部可自定义**。用户最早说"其中有一个按钮不能改,
    功能就是一键返回桌面",第一版就按"第 4 格写死 desktop"做的。
    现在他改主意了 —— 所以 desktop 变成**普通可选动作**,
    默认仍放第 4 格(习惯不用改),但想换也能换。
    可选动作从 7 个变成 8 个。

  **教训(写进测试注释了)**:别把"用户当时的一句话"当成永久约束
  焊进结构里;真是约束的话,注释里要写清是什么时候的要求,
  下次他改主意时才知道该动哪儿。

== 三、修一个"测试自己没擦干净"造成的假 bug ==

全量回归报:

    [FAIL] 配对码正确写入  实际 '(旧的残留值)'

而 `(旧的残留值)` 是**上一次测试遗留**的配对码 —— 数据目录
`C:\ProgramData\ykxmz\data` 在卸载时**故意不删**(那里存着用户的
中转地址、配对码等,卸载不该删),所以机器上会留着上一轮的
settings.json。测试装的时候虽然传了 `/CODE=517284`,但环境没擦干净时
就可能读到旧值 —— 表现成"安装包有 bug"。

**修法**:`test_installer_cycle.py` 加一步"装前先清残留"
(正规卸载 -> 杀进程 -> 删安装目录 -> **删数据目录**)。
数据目录那一步是关键 —— 卸载器不删它。

== 四、其他 ==

  * `docs/项目规矩.md` 第一节改成**按预案执行**:
    预案一 = 做完测试没问题就上传;预案二 = 做完测试但不上传,直接给用户。
    用户没说预案几时默认按预案一,并在交付时说明。
  * 顺手把那份文档里的老域名 `relay.xxmxxs.top` 改成现在的
    `yk.xxmxxs.top`(老服务器早就退役了)。
  * 修掉自己造的重复定义:往 actions.py 插降级链时,
    `list_voices` / `say` 各插了两份(pyflakes 报 redefinition)。
  * 一次危险的误操作:`Path.write_text(..., newline='\n')` 会**先截断文件
    再校验参数**,参数非法时文件已经空了 —— 我用它把
    `_tests/test_quickbar.py` 清空了。已重写。
    **以后不给 write_text 传 newline。**

== 验证 ==

    全量回归(21 关)全部 PASS
    新增关卡:3a13 手表快捷栏 / 3a14 语音播报降级
    安装包周期 23 项全过(装 -> 验 -> 卸 -> 再验)
    Java 编译通过(android-34, --release 8)
    本机实测语音播报:cscript 那条通了(2.4 秒)
    全部产物重建,Win7 兼容校验通过
This commit is contained in:
xmz7891
2026-10-09 23:30:05 +08:00
parent f0c05079f7
commit fd8be87209
28 changed files with 2078 additions and 385 deletions
+117
View File
@@ -0,0 +1,117 @@
# -*- coding: utf-8 -*-
r'''清掉 actions.py 里重复的 list_voices 和残留的旧 say 前半段。
== 怎么弄出来的 ==
fix_tts_fallback.py 里我写了两处替换,但 `NEW` 那个大块**自己也带了一份
list_voices**:
t.replace(OLD_VOICES, NEW_VOICES) # 这是第一份 list_voices
t.replace(OLD_SAY, NEW) # NEW 里又有一份 list_voices
于是 pyflakes 报:
redefinition of unused 'list_voices' from line 540
redefinition of unused 'say' from line 575
local variable 'chosen' is assigned to but never used
第三条是**旧 say 的前半段残留** —— `chosen` / `speed` 算完就不用了,
真正干活的在后面那份里。
== 这一版怎么改 ==
把**后面**那份 list_voices(`NEW` 带进来的)删掉,保留前面 NEW_VOICES 那份;
再把旧的 say 前半段(算 chosen/speed 那几行)删掉 —— 那些在新 say 里
已经算过一遍了。
**先全部定位好再动手**,避免又改一半。
'''
from __future__ import annotations
import re
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
ACTIONS = ROOT / "windows" / "lanremote" / "actions.py"
def main() -> int:
print("=" * 58)
print(" 清掉重复定义")
print("=" * 58)
print()
raw = ACTIONS.read_bytes()
bom = raw.startswith(b"\xef\xbb\xbf")
t = raw.decode("utf-8-sig")
lines = t.split("\n")
# ---- 1. 找所有 list_voices / say 定义 ----
defs = {}
for i, ln in enumerate(lines):
m = re.match(r" def (list_voices|say|_tts_commands|_write_vbs|"
r"_powershell_path)\(self", ln)
if m:
defs.setdefault(m.group(1), []).append(i)
print(" 定义位置:")
for name, spots in sorted(defs.items()):
print(" %-18s %s" % (name, [s + 1 for s in spots]))
# ---- 2. 删掉重复的 list_voices(保留第一个)----
dup_lv = defs.get("list_voices", [])
if len(dup_lv) != 2:
print(" ⚠ list_voices 有 %d 个定义,期望 2 个" % len(dup_lv))
else:
start = dup_lv[1]
# 找到下一个同级 def
end = len(lines)
for j in range(start + 1, len(lines)):
if re.match(r" def \w+\(", lines[j]):
end = j
break
# 往上把紧邻的注释也吃掉(那是我写的那段说明)
s = start
while s > 0 and (lines[s - 1].strip().startswith("#")
or lines[s - 1].strip() == ""):
s -= 1
if lines[s].strip() == "" and s + 1 < start:
s += 1
break
print(" 删除重复的 list_voices:第 %d-%d 行" % (start + 1, end))
del lines[start:end]
# ---- 3. 删掉旧 say 的前半段(算 chosen/speed 那段)----
t2 = "\n".join(lines)
old_head = ''' chosen = (voice or "").strip() or str(self.store.get("tts_voice") or "").strip()
try:
speed = int(rate) if rate else int(self.store.get("tts_rate", 0) or 0)
except (TypeError, ValueError):
speed = 0
speed = max(-10, min(10, speed))
'''
n = t2.count(old_head)
print(" 旧 say 前半段残留:%d 处" % n)
if n:
# 只删最后一处之前的那一坨(如果出现两次,说明新 say 里也有一份,
# 那份是**要保留的**)—— 所以删第一处。
t2 = t2.replace(old_head, "", 1)
ACTIONS.write_bytes((b"\xef\xbb\xbf" if bom else b"") + t2.encode("utf-8"))
print(" ✓ 清完了")
# ---- 4. 复核 ----
back = ACTIONS.read_text(encoding="utf-8-sig")
lv = len(re.findall(r"\n def list_voices\(self", back))
sy = len(re.findall(r"\n def say\(self", back))
tc = len(re.findall(r"\n def _tts_commands\(self", back))
print()
print(" 复核:list_voices=%d(应 1) say=%d(应 1) _tts_commands=%d(应 1)"
% (lv, sy, tc))
return 0 if (lv == 1 and sy == 1 and tc == 1) else 1
if __name__ == "__main__":
sys.exit(main())