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 兼容校验通过

_tests/test_apk_contents.py

@@ -23,7 +23,7 @@ def _latest_apk() -> Path:
         (ROOT / "dist").glob("*watch*.apk"),
         key=lambda p: p.stat().st_mtime, reverse=True)
     return candidates[0] if candidates else \
-        ROOT / "dist" / "ykxmz-watch-2.1.7.apk"
+        ROOT / "dist" / "ykxmz-watch-2.1.8.apk"
 
 
 APK = _latest_apk()

_tests/test_package_remote.py

@@ -26,9 +26,9 @@ ROOT = Path(__file__).resolve().parent.parent
 #   被控端 -> 一个 zip
 #   服务器端 -> 一个 zip
 #   控制端 -> 直接给 APK（不打 zip）
-AGENT_ZIP = ROOT / "dist" / "ykxmz-agent-2.1.7.zip"
-SERVER_ZIP = ROOT / "dist" / "ykxmz-server-2.1.7.zip"
-WATCH_APK = ROOT / "dist" / "ykxmz-watch-2.1.7.apk"
+AGENT_ZIP = ROOT / "dist" / "ykxmz-agent-2.1.8.zip"
+SERVER_ZIP = ROOT / "dist" / "ykxmz-server-2.1.8.zip"
+WATCH_APK = ROOT / "dist" / "ykxmz-watch-2.1.8.apk"
 TOOLCHAIN = Path(r"C:\Users\shu\Desktop\deepseekagent\starklink\toolchain")
 JAVAC = TOOLCHAIN / "jdk17" / "bin" / "javac.exe"
 JAVA = TOOLCHAIN / "jdk17" / "bin" / "java.exe"
@@ -89,7 +89,7 @@ def main() -> int:
         for label, path in (("被控端", agent_dir / "README-agent.txt"),
                             ("服务器端", relay_dir / "README-server.txt"),
                             ("控制端（旁边那份）",
-                             ROOT / "dist" / "ykxmz-watch-2.1.7-说明.txt")):
+                             ROOT / "dist" / "ykxmz-watch-2.1.8-说明.txt")):
             raw = path.read_bytes() if path.is_file() else b""
             check(f"{label}说明有 UTF-8 BOM",
                   raw[:3] == b"\xef\xbb\xbf", raw[:3])

_tests/test_quickbar.py

@@ -3,31 +3,38 @@ r'''验「手表快捷栏」和「允许新设备连接」。
 
 == 验什么 ==
 
-  一、手表端源码
-      * 快捷栏建出来了，4 个格子（3 自定义 + 1 固定显示桌面）
-      * 固定那个**不给改**（用户明确要求"其中有一个按钮不能改"）
-      * 挂进了 onCreate（光有方法不 addView 是白搭 —— 项目里踩过）
-      * 加进了 showOnly 的数组（漏了的话它会永远压在最上面）
-      * 7 个动作都在
-      * 设置页里有入口（没入口用户改不了）
+  一、快捷栏的形状
+      * 一共 4 格，**每格都能自定义**
+      * 「显示桌面」是普通可选动作（默认放第 4 格，但能换掉）
+      * 8 个动作都在
+      * 挂进了 onCreate、加进了 showOnly 的数组
+      * 设置页里有入口
       * 鼠标触摸板在
 
-  二、电脑端 allow_new_pairing 这个 feature
-      * 能查、能关、能开
-      * 存储里真的变了
-      * 只影响新配对，不踢现有会话（注释里写了理由）
+  二、按钮大小
+      用户反馈原话："屏幕最上面这个按钮有些按不到，按钮太小了，做大一点"
 
-== 为什么专门验"固定那个不给改" ==
+      * 栏高做成常量（>= 44dp），而且**栏高 / 面板 margin / addView
+        三处用同一个常量** —— 分三处写的话改一个忘一个，
+        表现是"内容被盖住"或"上面空一条"
 
-用户原话："最多可以加 4 个，其中有一个按钮不能改，功能就是一键返回桌面"。
+  三、电脑端 allow_new_pairing 这个 feature
 
-如果哪天有人"顺手"把它也做成可配置的，用户点了半天发现
-"显示桌面"没了 —— 而这种回归不会报错，只会让人困惑。
-所以这里断言：第 4 格永远是 desktop，且 QUICK_ACTIONS 里**没有**它。
+== 这条断言改过一次，值得记下来 ==
+
+用户最早说："最多可以加 4 个，其中有一个按钮不能改，
+             功能就是一键返回桌面"。
+第一版就按"第 4 格写死 desktop"实现，也按那个断言测。
+
+后来用户看到实物改了主意："第一个第二个第三个第四个都能换东西"。
+
+所以现在验的是**相反**的事。教训：
+**别把"用户当时的一句话"当成永久约束焊进结构里**；
+真是约束的话，注释里要写清是什么时候的要求，
+下次他改主意时才知道该动哪儿。
 '''
 from __future__ import annotations
 
-import json
 import re
 import sys
 import tempfile
@@ -67,45 +74,72 @@ def main() -> int:
     ]:
         check(label, token in main_java)
 
-    # 4 个格子
-    check("格子数 = 3 自定义 + 1 固定",
-          "QUICK_CUSTOM_SLOTS + 1" in main_java
-          and "QUICK_CUSTOM_SLOTS = 3" in main_java)
-
-    # 固定那个
-    m = re.search(r'String id = \(slot < QUICK_CUSTOM_SLOTS\) \? quickSlots\[slot\]'
-                  r' : "desktop"', main_java)
-    check("★ 第 4 格固定是 desktop（不给改）", m is not None,
-          "第 4 格不是写死的 desktop —— 用户要求它不能改")
-    check("★ QUICK_ACTIONS 里没有 desktop（否则它会出现在可选列表里）",
-          not re.search(r'\{"desktop"', main_java),
-          "desktop 出现在可选动作里了，用户就能把它改掉")
+    # 4 格，全部可自定义。这条断言改过一次，见文件头。
+    check("★ 一共 4 格", "QUICK_SLOTS = 4" in main_java, "用户要求 4 格")
+    check("★ 旧的 3+1 分法已经不在了",
+          "QUICK_CUSTOM_SLOTS" not in main_java, "还有残留说明没改干净")
+    check("★ 没有把 desktop 写死在某格",
+          ': "desktop";' not in main_java,
+          "还有地方把 desktop 写死成某一格")
+    check("★ desktop 在可选动作里（能换到任意一格）",
+          bool(re.search(r'\{"desktop",\s*"显示桌面"\}', main_java)),
+          "不在 QUICK_ACTIONS 里的话用户没法把它放到别的格")
+    check("四格平等：都从 quickSlots 取",
+          "String id = quickSlots[i];" in main_java
+          and "String id = quickSlots[slot];" in main_java,
+          "还有特殊分支")
+    check("默认值就是那 4 个",
+          'new String[]{"file", "mirror", "sfx", "desktop"}' in main_java)
     check("desktop 走的是 show_desktop 命令",
-          '"cmd", "show_desktop"' in main_java,
-          "固定按钮应该让电脑 Win+D")
+          '"cmd", "show_desktop"' in main_java)
 
-    # 7 个动作
     print()
-    print("  7 个可选动作：")
+    print("  8 个可选动作：")
     for aid, label in [("file", "传文件"), ("mirror", "屏幕镜像"),
                        ("mouse", "鼠标控制"), ("sfx", "音效"),
                        ("power", "关机"), ("tts", "语音播报"),
-                       ("image", "投图到电脑")]:
-        ok = ('{"%s", "%s"}' % (aid, label)) in main_java
-        check("    %s（%s）" % (aid, label), ok)
+                       ("image", "投图到电脑"), ("desktop", "显示桌面")]:
+        check("    %s（%s）" % (aid, label),
+              ('{"%s", "%s"}' % (aid, label)) in main_java)
 
-    # 挂接
+    # ---------------- 二、按钮大小 ----------------
     print()
-    print("二、挂接（漏了就白写）")
-    oncreate = main_java[main_java.find("protected void onCreate"):
-                         main_java.find("protected void onCreate") + 6000]
-    check("★ onCreate 里调了 buildQuickBar()",
-          "buildQuickBar();" in oncreate,
-          "没挂上去的话栏根本不显示")
-    check("★ onCreate 里调了 loadQuickSlots()",
-          "loadQuickSlots();" in oncreate)
-    check("★ 快捷栏**最后** addView（保证在最上层）",
-          oncreate.find("root.addView(quickBar") > oncreate.find("root.addView(mousePanel"),
+    print("二、按钮大小（用户反馈「太小了、按不到」）")
+    m = re.search(r"QUICK_BAR_DP = (\d+)", main_java)
+    check("★ 栏高做成常量 QUICK_BAR_DP", m is not None,
+          "没有常量的话栏高和面板 margin 会各写各的")
+    h = int(m.group(1)) if m else 0
+    check("★ 栏高 >= 44dp（接近 Android 建议的可点区域 48）", h >= 44,
+          "现在是 %d" % h)
+    check("★ 面板 topMargin 用同一个常量",
+          "flp.topMargin = dp(QUICK_BAR_DP);" in main_java,
+          "分两处写的话改一个忘一个")
+    check("★ addView 也用同一个常量",
+          "MATCH_PARENT, dp(QUICK_BAR_DP)));" in main_java)
+    check("★ 按钮字号 >= 13（原来是 11）",
+          "b.setTextSize(14f);" in main_java)
+    # ⚠ 只查**代码**，不查注释。
+    #   第一版这里是 `"dp(30)" not in main_java`，结果被
+    #   applyPanelTopMargin 的 javadoc 里那句旧说明误报了 ——
+    #   注释里提一下旧值是很正常的事（"以前是 30dp"），
+    #   不该因为它变红。
+    code_lines = [ln for ln in main_java.splitlines()
+                  if not ln.strip().startswith(("*", "//", "/*"))]
+    hard = [ln.strip() for ln in code_lines if "dp(30)" in ln]
+    check("没有残留的 dp(30)（旧栏高）", not hard,
+          "还有代码用旧的 30dp：%s" % hard)
+
+    # ---------------- 三、挂接 ----------------
+    print()
+    print("三、挂接（漏了就白写）")
+    i0 = main_java.find("protected void onCreate")
+    oncreate = main_java[i0:i0 + 7000]
+    check("★ onCreate 里调了 buildQuickBar()", "buildQuickBar();" in oncreate,
+          "没挂上去栏根本不显示")
+    check("★ onCreate 里调了 loadQuickSlots()", "loadQuickSlots();" in oncreate)
+    check("★ 快捷栏最后 addView（保证在最上层）",
+          oncreate.find("root.addView(quickBar")
+          > oncreate.find("root.addView(mousePanel"),
           "加在面板之前会被面板整个盖住")
     check("★ showOnly 的数组里有 mousePanel",
           "settingsPanel, mousePanel};" in main_java,
@@ -113,23 +147,23 @@ def main() -> int:
     check("有 applyPanelTopMargin（面板给栏让位）",
           "private void applyPanelTopMargin" in main_java)
 
-    # 设置页入口
+    # ---------------- 四、设置页 ----------------
     print()
-    print("三、设置页入口（没入口用户改不了）")
-    check("有 fillSettingsExtra", "private void fillSettingsExtra()" in main_java)
+    print("四、设置页入口（没入口用户改不了）")
+    check("有 fillSettingsExtra",
+          "private void fillSettingsExtra()" in main_java)
     check("有 pickQuickSlot（选动作）",
           "private void pickQuickSlot(final int slot)" in main_java)
     check("设置页里加了「快捷栏」小节",
           'sectionTitle("快捷栏")' in main_java)
     check("设置页里加了「允许新设备连接」小节",
           'sectionTitle("允许新设备连接")' in main_java)
-    check("界面上说明了第 4 格改不了",
-          "固定的、改不了" in main_java,
-          "不说明的话用户会一直找怎么改第四个")
+    check("界面上说明了四格都能换", "每一个都能换" in main_java,
+          "不说明的话用户不知道第四格也能改")
 
-    # 鼠标触摸板
+    # ---------------- 五、鼠标触摸板 ----------------
     print()
-    print("四、鼠标触摸板")
+    print("五、鼠标触摸板")
     check("有 buildMousePanel", "private void buildMousePanel()" in main_java)
     check("用 GestureDetector（单击/双击/拖动）",
           "GestureDetector" in main_java
@@ -141,31 +175,29 @@ def main() -> int:
     check("滚轮上/下", 'sendMouse("scroll", "", 3)' in main_java
           and 'sendMouse("scroll", "", -3)' in main_java)
     check("拖动 -> moveby", '"moveby"' in main_java)
-    check("isConnected() 存在（我第一版漏了，编译才发现）",
+    check("isConnected() 存在（第一版漏了，编译才发现）",
           "private boolean isConnected()" in main_java)
 
-    # ---------------- 五、电脑端 allow_new_pairing ----------------
+    # ---------------- 六、电脑端 allow_new_pairing ----------------
     print()
-    print("五、电脑端 allow_new_pairing feature")
+    print("六、电脑端 allow_new_pairing feature")
     from lanremote.config import Store
     from lanremote.features import Features
 
     class FakeActions:
         """Features 要的是 actions 对象，不是 store（第一版就是这里传错了）。"""
+
         def __init__(self, store):
             self.store = store
             self.ui = None
 
-    d = Path(tempfile.mkdtemp())
-    st = Store(d)
+    st = Store(Path(tempfile.mkdtemp()))
     feats = Features(FakeActions(st))
 
-    check("能查到当前状态",
-          "允许" in feats.run("allow_new_pairing", {}))
+    check("能查到当前状态", "允许" in feats.run("allow_new_pairing", {}))
     out = feats.run("allow_new_pairing", {"allow": False})
     check("能关掉", "禁止" in out, "拿到 %r" % out)
-    check("  ★ 存储里真的变了",
-          st.get("allow_new_pairing") is False,
+    check("  ★ 存储里真的变了", st.get("allow_new_pairing") is False,
           "拿到 %r" % st.get("allow_new_pairing"))
     check("  关掉之后再查也是关",
           "不允许" in feats.run("allow_new_pairing", {}))
@@ -173,7 +205,6 @@ def main() -> int:
     check("能打开", "已允许" in out, "拿到 %r" % out)
     check("  存储里也变了", st.get("allow_new_pairing") is True)
 
-    # 不存在名字要报错（别静默成功）
     try:
         feats.run("allow_new_pairing_typo", {})
         check("不认识的名字会报错", False, "它竟然没报错")

_tests/test_tts.py

@@ -0,0 +1,208 @@
+# -*- coding: utf-8 -*-
+r'''验「语音播报降级链」。
+
+== 为什么要测 ==
+
+用户反馈：**Win7 上语音播报不能用**。
+
+原来的实现只有一条路（PowerShell + System.Speech），而 Win7 上
+PowerShell 2.0 + 中文 + PATH 三样都可能出问题。改成降级链之后，
+必须保证：
+
+  1. **方案按"依赖越少越优先"排** —— cscript/VBScript 排最前，
+     因为它从 Windows 98 就有，SAPI5 是系统组件，两样都不用装。
+  2. **真的会降级** —— 前一条失败要接着试下一条，不是试一条就放弃。
+  3. **一条通了要记住** —— 不然每播一次都要把几条全试一遍。
+  4. **失败了要报错**，不能像原来那样 `Popen` 不等待、
+     明明没出声却返回"已播报"。
+  5. **VBScript 用 ANSI 编码写** —— 写成 UTF-8 的话 cscript 读出来
+     中文是乱码。这是 VBScript 的老规矩，很隐蔽。
+
+== 怎么测"会降级" ==
+
+不能真把 cscript 弄坏。所以对方案列表做**结构断言**：
+确认它列出了 >= 3 条、顺序正确；再单独构造一条必失败的链
+验证"失败会继续往下试"这个逻辑（用一个假的 subprocess）。
+
+真出声的部分只在最后一节做（本机有 cscript 的话）。
+'''
+from __future__ import annotations
+
+import re
+import sys
+import tempfile
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(ROOT / "windows"))
+
+FAILS: list = []
+
+
+def check(name: str, ok: bool, why: str = "") -> None:
+    print("  [%s] %s%s" % ("PASS" if ok else "FAIL", name,
+                          ("  —— " + why) if why else ""))
+    if not ok:
+        FAILS.append(name)
+
+
+class FakeUi:
+    """Actions 需要一个 ui，TTS 用不到它的任何东西。"""
+
+    def log(self, *_a, **_k):
+        pass
+
+    def notify(self, *_a, **_k):
+        pass
+
+
+def main() -> int:
+    print("=" * 58)
+    print("  语音播报降级链")
+    print("=" * 58)
+    print()
+
+    from lanremote.actions import Actions
+    from lanremote.config import Store
+
+    a = Actions(FakeUi(), Store(Path(tempfile.mkdtemp())))
+
+    # ---------------- 一、方法都在 ----------------
+    print("一、方法")
+    for name in ("_powershell_path", "_write_vbs", "_tts_commands"):
+        check("有 %s" % name, hasattr(a, name))
+
+    # ---------------- 二、方案顺序 ----------------
+    print()
+    print("二、降级顺序（依赖越少越优先）")
+    cmds = a._tts_commands("测试一二三", "", 0)
+    names = [c[0] for c in cmds]
+    print("    顺序: %s" % " -> ".join(names))
+    check("至少 3 条方案", len(cmds) >= 3, "只有 %d 条" % len(cmds))
+    if names:
+        check("★ 第一条是 cscript（不依赖 PowerShell / .NET）",
+              names[0] == "cscript",
+              "第一条是 %r —— cscript 最该排前面" % names[0])
+    if len(names) > 1:
+        check("第二条是 wscript（cscript 被拦时的备选）",
+              names[1] == "wscript", "第二条是 %r" % names[1])
+    check("★ 有 ps-sapi 那条（绕开 .NET 只用系统 SAPI5）",
+          "ps-sapi" in names, "方案 %s" % names)
+    check("★ 保留了原来的 System.Speech 那条（兜底）",
+          "ps-speech" in names or "ps-path" in names,
+          "把老办法删了的话，老机器上本来能用的反而不能用")
+    check("cscript 那条带 //nologo（不然会弹横幅）",
+          any("//nologo" in " ".join(c[1]) for c in cmds))
+
+    # ---------------- 三、VBScript 编码 ----------------
+    print()
+    print("三、VBScript（中文必须用 ANSI 写）")
+    p = a._write_vbs("中文测试", "", 0)
+    raw = p.read_bytes()
+    check("生成了 .vbs", p.is_file(), str(p))
+    check("★ 不是 UTF-8（UTF-8 的中文在 cscript 里是乱码）",
+          not raw.startswith(b"\xef\xbb\xbf") and raw.count(b"\xe4\xb8") == 0,
+          "文件开头 %r" % raw[:8])
+    check("★ 用 mbcs 能解回原文",
+          "中文测试" in raw.decode("mbcs", errors="replace"))
+    txt = raw.decode("mbcs", errors="replace")
+    check("用的是 SAPI.SpVoice（系统原生，不需要 .NET）",
+          "SAPI.SpVoice" in txt)
+    check("CRLF 换行（VBScript 的老规矩）", "\r\n" in txt)
+
+    # 音色 / 语速要能写进去
+    p2 = a._write_vbs("有音色和语速", "Huihui", 3)
+    t2 = p2.read_bytes().decode("mbcs", errors="replace")
+    check("音色写进去了", "Huihui" in t2)
+    check("语速写进去了", "v.Rate = 3" in t2)
+
+    # 长文本要分句（VBScript 单行有长度上限）
+    long_text = "这是一句很长的话。" * 100
+    p3 = a._write_vbs(long_text, "", 0)
+    t3 = p3.read_bytes().decode("mbcs", errors="replace")
+    speak_lines = [ln for ln in t3.splitlines() if ln.strip().startswith("v.Speak")]
+    check("★ 长文本被切成多句（VBScript 单行长度有限）",
+          len(speak_lines) > 1,
+          "只有 %d 行 v.Speak —— 太长会报错" % len(speak_lines))
+    check("  每句不超过 400 字",
+          all(len(ln) < 420 for ln in speak_lines),
+          "最长 %d" % max((len(x) for x in speak_lines), default=0))
+
+    # 引号要转义（不然 VBScript 语法错）
+    p4 = a._write_vbs('他说"你好"', "", 0)
+    t4 = p4.read_bytes().decode("mbcs", errors="replace")
+    check("双引号被转义成两个", '""' in t4 or '"你好"' not in t4)
+
+    # ---------------- 四、会降级（不是试一条就放弃）----------------
+    print()
+    print("四、降级行为")
+    import lanremote.actions as A
+    real_run = A.subprocess.run
+    calls = []
+
+    class R:
+        def __init__(self, code, err=""):
+            self.returncode = code
+            self.stdout = ""
+            self.stderr = err
+
+    def fake_run(cmd, **kw):
+        calls.append(cmd[0])
+        # 让前两条"失败"，第三条"成功" —— 验证它会继续往下试
+        if len(calls) <= 2:
+            return R(1, "模拟失败")
+        return R(0)
+
+    A.subprocess.run = fake_run
+    try:
+        out = a.say("降级测试")
+        check("★ 前两条失败后会继续试第三条", len(calls) >= 3,
+              "只试了 %d 次：%s" % (len(calls), calls))
+        check("★ 成功了就返回成功", "已播报" in out, "拿到 %r" % out)
+    finally:
+        A.subprocess.run = real_run
+
+    # 全失败要抛错（不能像原来那样骗人）
+    calls.clear()
+
+    def always_fail(cmd, **kw):
+        calls.append(cmd[0])
+        return R(1, "全失败")
+
+    A.subprocess.run = always_fail
+    try:
+        a.say("全失败测试")
+        check("★ 全失败时必须抛错（原来会假报成功）", False,
+              "它竟然返回了成功")
+    except Exception as exc:                              # noqa: BLE001
+        check("★ 全失败时必须抛错（原来会假报成功）", True)
+        check("  错误里列出了试过哪些", "试过" in str(exc), "拿到 %r" % exc)
+    finally:
+        A.subprocess.run = real_run
+    check("  确实把每条都试过了", len(calls) >= 3, "只试了 %d 次" % len(calls))
+
+    # ---------------- 五、本机真播一次 ----------------
+    print()
+    print("五、本机真播一次（有 cscript 的话）")
+    import shutil
+    if shutil.which("cscript"):
+        try:
+            out = a.say("语音播报测试")
+            check("真的播报成功", "已播报" in out, "拿到 %r" % out)
+            check("  报告里说了用的是哪条", "用 " in out, "拿到 %r" % out)
+        except Exception as exc:                          # noqa: BLE001
+            check("真的播报成功", False, str(exc)[:120])
+    else:
+        print("  [SKIP] 这台没有 cscript")
+
+    print()
+    print("=" * 58)
+    if FAILS:
+        print("  失败 %d 项：%s" % (len(FAILS), ", ".join(FAILS)))
+        return 1
+    print("  全部通过")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

_tests/verify_all.ps1

@@ -554,6 +554,20 @@ $stageOut = & python (Join-Path $root "_tests\test_quickbar.py") 2>&1
     Show-Fails $stageOut
 Record "手表快捷栏" ($LASTEXITCODE -eq 0)
 
+# ---------------------------------------------------------------- 3a14
+Banner "3a14/9 语音播报降级链（修 Win7 上用不了）"
+# 用户反馈："我 win7 上的语音播报好像不能用，你再试一下别的版本能不能用"。
+#
+# 原来只有一条路（powershell + System.Speech），而 Win7 上
+# PowerShell 2.0 + 中文 + PATH 三样都可能出问题。改成降级链之后必须保证：
+#   * cscript/VBScript 排最前（从 Win98 就有，SAPI5 是系统组件，不用装东西）
+#   * 前一条失败要接着试下一条，不是试一条就放弃
+#   * 全失败要**报错**，不能像原来那样 Popen 不等待、明明没出声却说"已播报"
+#   * VBScript 用 ANSI 写（UTF-8 的话 cscript 读出来中文是乱码）
+$stageOut = & python (Join-Path $root "_tests\test_tts.py") 2>&1
+    Show-Fails $stageOut
+Record "语音播报降级" ($LASTEXITCODE -eq 0)
+
 # ---------------------------------------------------------------- 3a5
 Banner "3a5/9 局域网/中转对比基准（防测试自己骗人）"
 # 这个基准一度是红的，而且报告里写着「这是中转链路的产品 bug」——