mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
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 文件语法通过
This commit is contained in:
xmz7891
+39
-10
@@ -430,7 +430,7 @@ $stageOut = & python (Join-Path $root "_tests\test_lan_path.py") 2>&1
|
||||
Record "局域网直连路径" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a2
|
||||
Banner "3a2/7 局域网优化（网段掩码 / 发现重发 / 回切）"
|
||||
Banner "3a2/9 局域网优化（网段掩码 / 发现重发 / 回切）"
|
||||
# 盯四件事：
|
||||
# 1. 网段判断按网卡真实掩码，不再写死 /24（/16 网络下能直连却去走中转）
|
||||
# 2. 广播发现重发 + 多网段（原来只发一次、只探一个网段）
|
||||
@@ -441,7 +441,7 @@ $stageOut = & python (Join-Path $root "_tests\test_lan_optimize.py") 2>&1
|
||||
Record "局域网优化" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a3
|
||||
Banner "3a3/7 手表局域网切换逻辑（源码断言）"
|
||||
Banner "3a3/9 手表局域网切换逻辑（源码断言）"
|
||||
$stageOut = & python (Join-Path $root "_tests\test_watch_lan_switch.py") 2>&1
|
||||
Show-Fails $stageOut
|
||||
Record "手表局域网切换" ($LASTEXITCODE -eq 0)
|
||||
@@ -459,7 +459,7 @@ $stageOut = & python (Join-Path $root "_tests\test_rescue_section.py") 2>&1
|
||||
Record "抢救报告分区" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a4
|
||||
Banner "3a4/7 编码与换行（.java/.py 必须 UTF-8 无 BOM + LF）"
|
||||
Banner "3a4/9 编码与换行（.java/.py 必须 UTF-8 无 BOM + LF）"
|
||||
# 踩过的坑：edit 工具会把行尾写成 CRLF，而仓库约定是 LF。
|
||||
# 这个检查专门盯住，免得改动悄悄把整个文件的行尾换掉。
|
||||
$stageOut = & python (Join-Path $root "_tests\check_encoding.py") 2>&1
|
||||
@@ -467,7 +467,7 @@ $stageOut = & python (Join-Path $root "_tests\check_encoding.py") 2>&1
|
||||
Record "编码与换行" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a7
|
||||
Banner "3a7/7 Python 语法（必须用 compile，不能用 ast.parse）"
|
||||
Banner "3a7/9 Python 语法（必须用 compile，不能用 ast.parse）"
|
||||
# 这一轮被同一件事咬了三次：补丁脚本把 import 插到 from __future__
|
||||
# 前面，整个文件就废了。而更糟的是 ast.parse 查不出来（它只解析，
|
||||
# 不做编译期检查）—— 前几次「全仓语法检查 0 问题」都是假绿。
|
||||
@@ -476,13 +476,13 @@ $stageOut = & python (Join-Path $root "_tests\check_python_syntax.py") 2>&1
|
||||
Record "Python 语法检查" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a8
|
||||
Banner "3a8/7 版本号一致性（防漏改）"
|
||||
Banner "3a8/9 版本号一致性（防漏改）"
|
||||
$stageOut = & python (Join-Path $root "_tests\check_version_consistency.py") 2>&1
|
||||
Show-Fails $stageOut
|
||||
Record "版本号一致性" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a9
|
||||
Banner "3a9/7 Windows 7 兼容（学校电脑是 Win7）"
|
||||
Banner "3a9/9 Windows 7 兼容（学校电脑是 Win7）"
|
||||
# 用户报：学校电脑是 Windows 7，装完报"dll 缺失"。
|
||||
#
|
||||
# 根因不是漏打包，是 **Python 版本越界**：
|
||||
@@ -503,7 +503,7 @@ $stageOut = & python (Join-Path $root "_build\check_win7_compat.py") 2>&1
|
||||
Record "Windows 7 兼容" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a10
|
||||
Banner "3a10/7 静默自动更新链路"
|
||||
Banner "3a10/9 静默自动更新链路"
|
||||
# 用户要求："手表端点击一个更新按钮，电脑端就可以自动进行静默更新，
|
||||
# 其他什么设置都不变 …… 不弹任何窗口出来"
|
||||
# 这条链是：中转 /v1/update/latest -> 被控端 updater.py 下载校验
|
||||
@@ -516,7 +516,7 @@ $stageOut = & python (Join-Path $root "_tests\test_update_flow.py") 2>&1
|
||||
Record "静默自动更新" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a11
|
||||
Banner "3a11/7 远程鼠标 + 一键显示桌面"
|
||||
Banner "3a11/9 远程鼠标 + 一键显示桌面"
|
||||
# 鼠标注入是最"有力量"的功能，参数校验写错的话表现是"手表点了没反应"，
|
||||
# 教室里没法排查。这里盯坐标归一化（除以 宽-1 那条规则）、
|
||||
# 滚轮夹取、Win+D 的事件顺序、以及非法参数必须被拒。
|
||||
@@ -525,8 +525,37 @@ $stageOut = & python (Join-Path $root "_tests\test_mouse_control.py") 2>&1
|
||||
Record "远程鼠标控制" ($LASTEXITCODE -eq 0)
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 3a12
|
||||
Banner "3a12/9 后台更新按钮 + 弹窗位置/大小"
|
||||
# 用户要求：后台能点一下让电脑自己更新；弹文字窗口位置和大小可自定义。
|
||||
# 后台那条链路横跨三端（JS -> 中转 -> 被控端），错了的表现是
|
||||
# "我点了更新，电脑没反应"，所以几个边界必须卡死：
|
||||
# 设备不存在 / 离线 / 重复点 / 在线。
|
||||
$stageOut = & python (Join-Path $root "_tests\test_admin_update.py") 2>&1
|
||||
Show-Fails $stageOut
|
||||
Record "后台更新按钮" ($LASTEXITCODE -eq 0)
|
||||
|
||||
$stageOut = & python (Join-Path $root "_tests\test_notice_options.py") 2>&1
|
||||
Show-Fails $stageOut
|
||||
Record "弹窗位置和大小" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a13
|
||||
Banner "3a13/9 手表快捷栏 + 允许新设备连接"
|
||||
# 用户要求："手表端不管干什么，上面都有一栏，栏里的按钮可以在设置页
|
||||
# 自定义，最多可以加 4 个，其中有一个按钮不能改，
|
||||
# 功能就是一键返回桌面"。
|
||||
#
|
||||
# 四个地方最容易漏，漏了都不会报错、只会让人困惑：
|
||||
# 1. buildQuickBar 没挂进 onCreate -> 栏根本不显示
|
||||
# 2. 没加进 showOnly 的数组 -> 面板永远压在上面
|
||||
# 3. 第 4 格做成了可配置 -> 用户找半天"显示桌面"没了
|
||||
# 4. 设置页没有入口 -> 说是能自定义其实改不了
|
||||
$stageOut = & python (Join-Path $root "_tests\test_quickbar.py") 2>&1
|
||||
Show-Fails $stageOut
|
||||
Record "手表快捷栏" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a5
|
||||
Banner "3a5/7 局域网/中转对比基准（防测试自己骗人）"
|
||||
Banner "3a5/9 局域网/中转对比基准（防测试自己骗人）"
|
||||
# 这个基准一度是红的，而且报告里写着「这是中转链路的产品 bug」——
|
||||
# 实际是基准自己有两个 bug：两条路用了同一个配对码、
|
||||
# 以及 attach 用了旧码（打到已经死掉的设备上）。
|
||||
@@ -537,7 +566,7 @@ $stageOut = & python (Join-Path $root "_tests\test_lan_bench_guard.py") 2>&1
|
||||
Record "局域网对比基准" ($LASTEXITCODE -eq 0)
|
||||
|
||||
# ---------------------------------------------------------------- 3a6
|
||||
Banner "3a6/7 管理页 JS 语法（防按钮全死）"
|
||||
Banner "3a6/9 管理页 JS 语法（防按钮全死）"
|
||||
# 踩过两次的坑：admin.py 的 ADMIN_JS 是普通三引号字符串，
|
||||
# 里面写 \n 会被 Python 变成真实换行；而 JS 的行注释 // 不能跨行，
|
||||
# 一断行整段 <script> 语法错误 -> 页面上所有按钮失效。
|
||||
|
||||
Reference in New Issue
Block a user