mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
xmz7891
fd8be87209
用户这一轮报了两个问题，都修了。
== 一、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 兼容校验通过
170 lines
6.7 KiB
Plaintext
170 lines
6.7 KiB
Plaintext
========================================================
|
||
ykxmz 安装前必读（前信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.1.8
|
||
作者：小麦子
|
||
|
||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||
提醒，尤其是第三节和第五节。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、这是什么
|
||
--------------------------------------------------------
|
||
|
||
ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
|
||
|
||
1-agent（被控端） 装在你**要管理**的电脑上（Windows）
|
||
2-server（服务器端）装在一台能上外网的 Linux 小机器上
|
||
（随身 WiFi、树莓派、VPS 都行）
|
||
3-watch（控制端） 装在你的安卓手表上
|
||
|
||
装好之后，你在手表上就能看到并操作那台电脑：屏幕、文件、
|
||
音量、电源、剪贴板……共两百多个功能。
|
||
|
||
**关键点：所有数据都走你自己搭的那台服务器，
|
||
作者碰不到你的任何内容。** 详见《许可协议》第五条。
|
||
|
||
**再强调一次：软件里不带任何中转地址，作者也不对外提供中转服务。**
|
||
只在同一个 WiFi 下用的话，压根不需要中转站，装完就能连；
|
||
要跨网络就必须自己部署一台（看下面第四节的第 1 步）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、装机前对照检查
|
||
--------------------------------------------------------
|
||
|
||
请先确认：
|
||
|
||
[ ] 这台电脑是**你自己的**，或者设备主人明确同意你远程管理
|
||
[ ] 电脑是 Windows 10 / 11（64 位）
|
||
[ ] 手表是安卓 7.0（API 24）或更高版本
|
||
[ ] 服务器端那台机器是 Linux（Debian 12 实测通过），
|
||
能上外网，内存 512MB 够用
|
||
[ ] 你有一个 Cloudflare 账号和一个域名（跨网络才需要）
|
||
|
||
**不需要**装 Python、不需要 root、不需要 ADB。
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、【重要】三条必须知道的事
|
||
--------------------------------------------------------
|
||
|
||
① 被控端默认是"静默"运行的
|
||
|
||
装完之后**没有窗口、没有托盘图标、没有终端**，
|
||
任务管理器里能看到一个叫 ykxmz.exe 的进程，
|
||
开机自启项里也显示 ykxmz。
|
||
|
||
这么做是为了不打扰用电脑的人，**不是**为了藏起来。
|
||
如果你要在这台电脑上装给别人用，你有义务告诉对方：
|
||
|
||
怎么查看（任务管理器 -> 详细信息 -> ykxmz.exe）
|
||
怎么关闭（任务管理器 -> 结束任务）
|
||
怎么卸载（ykxmz.exe --uninstall）
|
||
|
||
② 配对码是唯一的口令，请设一个别人猜不到的
|
||
|
||
配对码是 6 位数字，**它就是你电脑的钥匙**。
|
||
不要用 123456、000000、生日、手机号后六位这类。
|
||
|
||
一个配对码同时只能绑定一台电脑。如果别人先用了你想要的码，
|
||
后装的这台会被拒绝，并在屏幕上弹出提示：
|
||
「该配对码已被使用，请换一个配对码」
|
||
换个没人用的码就行。
|
||
|
||
③ 连接时屏幕上有提示
|
||
|
||
只要手表或控制端连上来，被控端会在屏幕右下角弹一个提示。
|
||
这是**故意保留**的功能，请不要关掉它——
|
||
它保证了设备使用者知道"现在有人在看这台电脑"。
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、安装顺序
|
||
--------------------------------------------------------
|
||
|
||
按这个顺序来，别跳：
|
||
|
||
第 1 步 架服务器端（只做一次，**跨网络才需要**）
|
||
如果只在同一个 WiFi 下用（手表和电脑连同一个路由器），
|
||
这一步可以跳过。
|
||
要跨网络的话，把 2-server 整个目录拷到那台 Linux 小机器上：
|
||
bash deploy.sh
|
||
它会把中转服务、网络调优、Cloudflare 隧道一次装好，
|
||
最后打印一个**属于你自己的公网地址**。记住它。
|
||
|
||
第 2 步 装被控端（每台要管理的电脑做一次）
|
||
双击安装包 -> 输 6 位配对码 -> 勾上开机自启和
|
||
放行防火墙 -> 确定。会弹一次管理员确认。
|
||
|
||
第 3 步 装控制端
|
||
把 3-watch 里的 APK 装到手表上。
|
||
|
||
第 4 步 跨网络的话，把中转地址填上
|
||
**注意：软件里没有内置任何中转地址。**
|
||
同一个 WiFi 下用不用填；跨网络的话必须填你自己第 1 步
|
||
装出来的那个地址：
|
||
电脑： ykxmz.exe --relay https://你的域名
|
||
手表： 首页点「中转设置」，填同一个地址
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、会改你系统的哪些东西
|
||
--------------------------------------------------------
|
||
|
||
安装和使用过程中，被控端会做这些改动，**请你知情**：
|
||
|
||
1. 写一条开机自启项
|
||
位置：HKEY_CURRENT_USER\...\CurrentVersion\Run
|
||
名称：ykxmz
|
||
内容："...\ykxmz.exe" --silent
|
||
|
||
2. 添加 Windows 防火墙放行规则
|
||
规则名：LAN Remote TCP / LAN Remote UDP / LAN Remote App TCP
|
||
/ LAN Remote App UDP
|
||
作用：允许 8765（TCP）和 8766（UDP）端口通信
|
||
|
||
3. 在程序目录下建一个 data 子目录
|
||
里面存：配对码、已配对设备、设置
|
||
卸载时会一并删除
|
||
|
||
4. 说明：部分功能（关机、改注册表、隐藏任务栏等）
|
||
需要管理员权限，会弹 UAC 确认，**不会**偷偷提权。
|
||
|
||
**以上全部可撤销**：卸载时自启项和防火墙规则会一起清掉。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、杀毒软件可能报警
|
||
--------------------------------------------------------
|
||
|
||
本软件没有购买代码签名证书（那是要花钱的），
|
||
加上它确实具备"远程控制 + 开机自启"这类能力，
|
||
所以**部分杀毒软件可能会报可疑**。
|
||
|
||
这是误报。你可以：
|
||
1. 在杀毒软件里把 ykxmz 整个目录加入信任/排除项；
|
||
2. 或者先看完《许可协议》，确认用途正当后再决定是否放行。
|
||
|
||
**作者不会、也没有办法让本软件绕过杀毒软件。**
|
||
如果你需要"绝对不被杀软发现"，那本软件不适合你。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、接下来看什么
|
||
--------------------------------------------------------
|
||
|
||
装完之后请看《安装后须知》（AFTER-INSTALL.txt），
|
||
里面有：怎么确认它在正常运行、怎么换配对码、
|
||
怎么彻底卸载、连不上怎么排查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.1.8
|
||
继续安装，即表示你已阅读并同意《许可协议》。
|
||
--------------------------------------------------------
|