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
2026-10-09 22:55:28 +08:00
parent 3f543b274a
commit f0c05079f7
39 changed files with 3542 additions and 67 deletions
+92
View File
@@ -359,6 +359,72 @@ class SetupWindow:
bg=CARD, fg=MUTED, font=FONT_SMALL, justify="left",
wraplength=396).pack(anchor="w", pady=(6, 0))
# ================= 显示卡片 =================
#
# 用户要求:
# * "那个弹文字窗口 …… 位置和大小都能自定义"
# * "屏幕已被共享的提示以后不需要弹,像 UU 远程一样啥窗口都没有"
#
# 所以这里三件事:
# 1. 提示条开关(**默认关**,见 config.py 的 show_screen_notice)
# 2. 弹窗位置:右下(默认) / 右上 / 左上 / 左下 / 正中间 / 自定义
# 3. 弹窗字号
#
# 「自定义」的坐标现在没有界面输入框 —— 先用一组合理的坐标占位,
# 需要精确控制的人可以改 data/settings.json 里的 notice_x / notice_y。
# 这样界面不至于塞一堆输入框,而高级用户仍有办法。
display = self._card(page)
display.pack(fill="x", pady=(12, 0))
disp_inner = tk.Frame(display.winfo_children()[0], bg=CARD)
disp_inner.pack(fill="x", padx=16, pady=12)
tk.Label(disp_inner, text="显示", bg=CARD, fg=FG,
font=FONT_LABEL).pack(anchor="w", pady=(0, 6))
self.var_screen_notice = tk.BooleanVar(
value=bool(self.store.get("show_screen_notice", False)))
self._check(disp_inner, "屏幕被观看时在本机显示提示条",
self.var_screen_notice,
"默认关闭(和 UU 远程一样不弹任何窗口)")
pos_row = tk.Frame(disp_inner, bg=CARD)
pos_row.pack(fill="x", pady=(8, 0))
tk.Label(pos_row, text="弹窗位置", bg=CARD, fg=FG,
font=FONT_UI).pack(side="left")
self.var_notice_pos = tk.StringVar(
value=str(self.store.get("notice_position") or "bottom-right"))
# 值 -> 给人看的名字。顺序就是下拉里的顺序。
self._pos_labels = [
("bottom-right", "右下角"), ("top-right", "右上角"),
("top-left", "左上角"), ("bottom-left", "左下角"),
("center", "屏幕正中间"), ("custom", "自定义坐标"),
]
label_to_val = {v: k for k, v in self._pos_labels}
current_label = label_to_val.get(self.var_notice_pos.get(), "右下角")
pos_menu = tk.OptionMenu(
pos_row, self.var_notice_pos, *[v for _k, v in self._pos_labels])
pos_menu.configure(bg=CARD, fg=FG, font=FONT_SMALL, bd=0,
highlightthickness=0, activebackground=CARD,
relief="flat", cursor="hand2")
pos_menu["menu"].configure(font=FONT_SMALL)
pos_menu.pack(side="left", padx=(8, 0))
# OptionMenu 存的是**给人看的名字**,保存时再翻回内部的英文值。
# 这样用户看到的是中文,配置里存的仍是稳定的英文(以后改文案
# 不会把老配置弄坏)。
self.var_notice_pos.set(current_label)
size_row = tk.Frame(disp_inner, bg=CARD)
size_row.pack(fill="x", pady=(8, 0))
tk.Label(size_row, text="弹窗字号", bg=CARD, fg=FG,
font=FONT_UI).pack(side="left")
self.var_notice_font = tk.IntVar(
value=int(self.store.get("notice_font_size") or 11))
tk.Spinbox(size_row, from_=8, to=32, width=4,
textvariable=self.var_notice_font, font=FONT_SMALL,
justify="center").pack(side="left", padx=(8, 4))
tk.Label(size_row, text="(8~32)", bg=CARD, fg=MUTED,
font=FONT_SMALL).pack(side="left")
# ================= 按钮区 =================
buttons = tk.Frame(page, bg=BG)
buttons.pack(fill="x", pady=(16, 0))
@@ -386,6 +452,26 @@ class SetupWindow:
root.bind("<Escape>", lambda _e: self._cancel())
root.protocol("WM_DELETE_WINDOW", self._cancel)
def _pos_value(self, label: str) -> str:
"""把下拉里的中文标签翻回内部英文值。
⚠ 为什么不直接把英文值塞进下拉:用户看的是中文界面。
为什么配置里存英文:以后改文案不会把老配置弄坏。
"""
for val, lab in self._pos_labels:
if lab == label:
return val
return "bottom-right"
@staticmethod
def _safe_int(value, low: int, high: int, fallback: int) -> int:
"""Spinbox 里用户可能删空或手打字母,夹一下别让配置变脏。"""
try:
n = int(value)
except (TypeError, ValueError):
return fallback
return max(low, min(high, n))
def _check(self, parent, title: str, variable, hint: str) -> None:
"""一行勾选框 + 灰字说明。"""
row = tk.Frame(parent, bg=CARD)
@@ -467,6 +553,12 @@ class SetupWindow:
"relay": relay,
"allow_new": (None if self.var_allow_new is None
else bool(self.var_allow_new.get())),
"screen_notice": bool(self.var_screen_notice.get()),
# 下拉里存的是中文标签,这里翻回稳定的英文值
"notice_position": self._pos_value(
self.var_notice_pos.get()),
"notice_font_size": self._safe_int(
self.var_notice_font.get(), 8, 32, 11),
}
try:
self.root.quit()