2 Commits

Include renames

Author	SHA1	Message	Date
xmz7891	fd8be87209	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 兼容校验通过	2026-10-09 23:30:05 +08:00
xmz7891	f0c05079f7	2.1.7：手表快捷栏 + 鼠标触摸板 + 弹窗可配 + 后台远程更新 ... 用户这次提了一整套升级，这是最后一批。 == 一、手表端顶部快捷栏 == 用户原话："手表端不管干什么，上面都有一栏，栏里的按钮可以在设置页 自定义，最多可以加 4 个，其中有一个按钮不能改，功能就是一键返回桌面"。 （"返回桌面"经确认 = **让被控电脑显示桌面**，即 Win+D。） * 一条常驻的栏，贴在屏幕顶部，切页面时不动 * **4 个格子**：3 个可自定义 + **1 个固定的「显示桌面」（改不了）** * 7 个可选动作：传文件 / 屏幕镜像 / 鼠标控制 / 音效 / 关机 / 语音播报 / 投图到电脑 * 设置页里点一下换；也能把某一格留空 * 没连上电脑时按钮置灰（不是藏起来 —— "一直在但暂时不能用" 比"时有时无"更好理解） 实现上的几个要点： * 快捷栏 addView 在 5 个面板**之后** —— FrameLayout 里后加的在上层， 加在前面会被面板（MATCH_PARENT）整个盖住 * 面板加了 topMargin 给栏让位，集中在 applyPanelTopMargin 里改 （每个面板各写一遍很容易漏一个，表现是"就某一页顶部被切掉"） * 第 4 格在代码里**写死** desktop，而且 QUICK_ACTIONS 里**没有**它 —— 这样它既不会出现在可选列表里，也不可能被改成别的 * 存储用 SharedPreferences。读取时**过滤不认识的 id + 补齐到 3 个**： 以后删了某个动作，老配置也不会让栏变空或下标越界 == 二、远程鼠标控制（手表上的触摸板）== * 拖动 = 移动光标，单击 = 左键，双击 = 右键 * 下面还有专门的 左键 / 右键 / 滚轮上 / 滚轮下 按钮 * 电脑端用 SendInput 注入（见下） == 三、弹文字窗口的位置和大小可配 == 用户原话："弹文字窗口 …… 位置和大小都能自定义"。 * 位置：右下（默认，保持老习惯）/ 右上 / 左上 / 左下 / 屏幕正中间 / 自定义坐标 * 字号：8~32（夹住，免得设成 200 一个通知占满屏幕） * 宽度：可指定，0 = 按内容自适应 * 三处窗口定位统一到一个 _notice_geometry() —— 以前三处各写死一遍 右下角，改一次要改三个地方，漏一个用户就看得见 == 四、屏幕被观看时的提示条改成默认不显示 == 用户原话："以后不需要弹，啥窗户都没有，就可以像 UU 远程一样"。 * 默认**连窗口都不建** * **但保留成开关**，设置里可以打开 关于这条：那条提示原来是**故意加**的（有人在看屏幕时，电脑前面的人 应该知道）。用户要求去掉，这是他自己的电脑、自己的教室， 属于正当的远程管理需求。所以能力保留、默认关闭 —— 这软件应该始终有一个"让本机用户看得见正在被控制"的选项可查。 == 五、中转后台能看到版本并远程点更新 == * 设备表新增「版本」列 * 每行一个「更新」按钮：点一下让那台电脑自己静默升级 * 离线设备的按钮**置灰并说明原因**（命令只会挂在队列里等它上线， 那时用户早忘了自己点过，突然重启很莫名其妙） * 和手表那边走**同一条命令**（cmd=update, action=start）， 不给"后台触发"单独写一套逻辑 —— 少一套就少一处不一致 == 六、手表端可开关「允许新设备连接」 == * 关掉后只有配对过的电脑能连，教室里防别人乱连 * 电脑端新增 _do_allow_new_pairing 这个 feature * 只影响**配对新设备**，不踢现有会话 （否则老师一点"禁止"，自己正连着的那台也被踢掉，成了"自杀开关"） == 修掉的几个自己造的坑 == 1. **管理页 JS 裸换行** —— 最严重的一个。 ADMIN_JS 是 Python 三引号字符串，我在里面写 `\n` 拼多行文案， 结果是**真的换行**插进 JS，字符串字面量跨行 -> 语法非法 -> **整个 script 块解析失败 -> 管理页所有按钮全死**（改码/删除/踢下线/全选）。 改成 String.fromCharCode(10)，不依赖任何转义层。 2. **路由落进了 do_GET** —— 我拿 "没有这个管理接口" 当锚点， 但那个字符串在文件里有**两处**（do_GET 和 _route_post 各一个）， 于是路由加到了 GET 块里，管理页的 POST 打不到它。 表现是"点了更新没反应"。 3. **isConnected() 根本不存在** —— 写快捷栏时凭直觉调了个方法名， 编译才发现。顺手包了一层并加上说明。 4. **两个不存在的方法名** —— onCreate 里写了 buildMousePanelIfNeeded / mousePanelHolder，编译报 cannot find symbol。 5. **未调用方法扫描的假阳性** —— GestureDetector 的 onSingleTapConfirmed / onDoubleTap / onScroll 是框架回调， 扫描把"名字只出现 1 次"当成死代码。改成**跳过 @Override 的方法**。 这种假阳性最坏的结果是有人为了让它变绿把回调删了，手势就失灵了。 6. **测试断言太严导致误报** —— "不能有写死的 240"， 但 helper 里 `auto = max(240, ...)` 是自适应的兜底，故意的。 7. **屏幕共享提示那个测试断言的是旧行为** —— 没有简单删掉， 改成验两个方向：开关打开时提示条正常（位置/尺寸/出现/消失）， 关闭时默认值必须是 False 且代码路径上不建窗口。 == 验证 == 全量回归（19 关）全部 PASS，零失败 新增关卡：3a10 静默更新 / 3a11 鼠标控制 / 3a12 后台更新+弹窗 / 3a13 手表快捷栏 Java 编译通过（android-34, --release 8） APK / 安装包 / 服务端包 全部重建，Win7 兼容校验通过 623 个 Python 文件语法通过	2026-10-09 22:55:28 +08:00