mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 10:10:43 +00:00
用户这次提了一整套升级,这是最后一批。
== 一、手表端顶部快捷栏 ==
用户原话:"手表端不管干什么,上面都有一栏,栏里的按钮可以在设置页
自定义,最多可以加 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 文件语法通过
122 lines
4.2 KiB
Python
122 lines
4.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
r'''修 manager 页「更新」按钮那段 JS 的裸换行。
|
|
|
|
== 出了什么问题 ==
|
|
|
|
`ADMIN_JS` 是 Python 的**三引号字符串**。我在里面写:
|
|
|
|
if (!confirm('让「' + name + '」现在更新到最新版?\n\n'
|
|
+ '它会自己下载……\n'
|
|
|
|
本意是让 JS 收到 `\n`。但 Python 三引号里 `\n` 就是**真的换行**,
|
|
于是插进 JS 变成:
|
|
|
|
if (!confirm('让「' + name + '」现在更新到最新版?
|
|
(空行)
|
|
'
|
|
|
|
**字符串字面量跨行,JS 语法非法**。
|
|
|
|
后果不是"这一句坏了",而是**整个 <script> 块解析失败** ——
|
|
管理页上所有按钮(改码/删除/踢下线/全选)全部失灵。回归里的
|
|
「管理页 JS 合法性」这一关就是专门抓这个的(当初加它就是因为
|
|
踩过一次同样的坑)。
|
|
|
|
== 怎么修 ==
|
|
|
|
**不用 `\n`**。改成把文案放进数组,用 `String.fromCharCode(10)` 连起来:
|
|
|
|
const NL = String.fromCharCode(10);
|
|
const msg = ['第一行', '', '第二行'].join(NL);
|
|
|
|
这样**完全不依赖转义层** —— 不管以后谁编辑这段、用哪种
|
|
引号、经不经过别的脚本生成,都不会再变成裸换行。
|
|
'''
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
ROOT = Path(__file__).resolve().parent.parent
|
|
ADMIN = ROOT / "relay" / "admin.py"
|
|
|
|
# ⚠ 这些字符串里必须保留**真的换行**(就是要匹配源文件里那个坏掉的样子)
|
|
OLD = """document.querySelectorAll('button[data-update]').forEach((btn) => {
|
|
btn.onclick = async () => {
|
|
const name = btn.dataset.name || '这台电脑';
|
|
if (!confirm('让「' + name + '」现在更新到最新版?
|
|
|
|
'
|
|
+ '它会自己下载、静默安装并重启,全程不弹窗口,
|
|
'
|
|
+ '中转地址、配对码和各项设置都不变。')) {
|
|
return;
|
|
}"""
|
|
|
|
NEW = """document.querySelectorAll('button[data-update]').forEach((btn) => {
|
|
btn.onclick = async () => {
|
|
const name = btn.dataset.name || '这台电脑';
|
|
// ⚠ 这里**不能用反斜杠 n** 拼多行文案。
|
|
// ADMIN_JS 是 Python 三引号字符串,源码里写反斜杠 n 会变成
|
|
// **真的换行**插进 JS,于是字符串字面量跨行 —— JS 语法非法,
|
|
// 整个 script 块解析失败,管理页所有按钮全死。
|
|
// (回归里的「管理页 JS 合法性」就是抓这个的。)
|
|
//
|
|
// 用 String.fromCharCode(10) 完全不依赖转义层,
|
|
// 以后谁改这段都不会再踩。
|
|
const NL = String.fromCharCode(10);
|
|
const msg = ['让「' + name + '」现在更新到最新版?', '',
|
|
'它会自己下载、静默安装并重启,全程不弹窗口,',
|
|
'中转地址、配对码和各项设置都不变。'].join(NL);
|
|
if (!confirm(msg)) {
|
|
return;
|
|
}"""
|
|
|
|
|
|
def main() -> int:
|
|
print("=" * 58)
|
|
print(" 修管理页 JS 的裸换行")
|
|
print("=" * 58)
|
|
print()
|
|
|
|
raw = ADMIN.read_bytes()
|
|
bom = raw.startswith(b"\xef\xbb\xbf")
|
|
text = raw.decode("utf-8-sig")
|
|
|
|
if "String.fromCharCode(10)" in text and OLD not in text:
|
|
print(" 已经修好了")
|
|
return 0
|
|
|
|
if OLD not in text:
|
|
print(" ✗ 找不到坏掉的那段")
|
|
i = text.find("data-update")
|
|
print(text[max(0, i - 100):i + 700])
|
|
return 1
|
|
|
|
text = text.replace(OLD, NEW, 1)
|
|
ADMIN.write_bytes((b"\xef\xbb\xbf" if bom else b"") + text.encode("utf-8"))
|
|
print(" ✓ 替换完成")
|
|
|
|
# 复核:ADMIN_JS 里不能再有跨行的字符串字面量
|
|
sys.path.insert(0, str(ROOT / "relay"))
|
|
for name in list(sys.modules):
|
|
if name in ("admin", "relay"):
|
|
del sys.modules[name]
|
|
import admin # noqa: E402
|
|
js = admin.ADMIN_JS
|
|
bad = []
|
|
for n, ln in enumerate(js.splitlines(), 1):
|
|
s = ln.strip()
|
|
if s.startswith("//"):
|
|
continue
|
|
if s.count("'") % 2:
|
|
bad.append((n, ln[:70]))
|
|
print(" 复核:单引号落单的行 = %d 个" % len(bad))
|
|
for n, ln in bad[:5]:
|
|
print(" %4d %s" % (n, ln))
|
|
return 0 if not bad else 1
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|