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 文件语法通过

windows/lanremote/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
 """局域网遥控 · Windows 被控端。"""
 
-__version__ = "2.1.6"
+__version__ = "2.1.7"
 APP_NAME = "ykxmz"

windows/lanremote/config.py

@@ -47,6 +47,26 @@ DEFAULT_SETTINGS = {
     # 取 12：够顺，又给抓屏留了余量，不至于把 CPU 占满。
     # （画面静止时会自动降频，见 screen.py 的 _loop）
     "screen_fps": 12,
+    # ---- 弹窗外观（用户要求"位置和大小都能自定义"）----
+    #
+    # 位置：bottom-right / top-right / top-left / bottom-left / center / custom
+    # 默认保持右下角 —— 不改变老用户的使用习惯。
+    "notice_position": "bottom-right",
+    "notice_x": 0,              # position=custom 时的横坐标（像素）
+    "notice_y": 0,              # position=custom 时的纵坐标（像素）
+    "notice_width": 0,          # 0 = 按内容自适应（240 起）
+    "notice_font_size": 11,     # 标题字号；正文自动小 1 号
+    # 屏幕被观看时是否在本机弹提示条。
+    #
+    # ⚠ 原来这个提示条是**强制显示**的（"有人在看你的屏幕，
+    #   电脑前面的人必须知道"）。用户要求去掉，理由是"像 UU 远程一样
+    #   不要任何窗口"。
+    #
+    # 这是用户自己的电脑，属于正当的远程管理需求
+    # （极域电子教室这类校园软件也都是无提示的）。
+    # 所以能力保留、**默认关闭** —— 需要的话在设置里打开，
+    # 这样这软件始终有一个"可见性开关"可查。
+    "show_screen_notice": False,
 }
 
 

windows/lanremote/features.py

@@ -658,6 +658,28 @@ class Features:
         entry = stack.pop()
         return self._apply_undo(entry)
 
+    def _do_allow_new_pairing(self, params) -> str:
+        """远程开关「允许新设备连接」。
+
+        手表端和设置窗口里那个勾选框是**同一件事**：
+        关掉之后，没配对过的新设备会被拒。
+
+        为什么做成远程可改：老师在教室里，可能整节课都不回电脑前面
+        —— 想临时允许/禁止别人连，总不能跑回讲台点鼠标。
+
+        ⚠ 这个开关只影响**配对新设备**，已经在用着的会话不受影响。
+          否则老师一点"禁止"，自己手里正连着的那台也被踢掉，那就成了"自杀开关"。
+        """
+        want = params.get("allow")
+        if want is None:
+            # 没给参数就报告当前状态（方便手表端先查再改）
+            now = bool(self.store.get("allow_new_pairing", True))
+            return f"新设备连接现在是{'允许' if now else '不允许'}"
+        want = bool(want)
+        self.store.set("allow_new_pairing", want)
+        return ("已允许新设备连接" if want
+                else "已禁止新设备连接（只有配对过的设备能连）")
+
     def _do_undo_all(self, params) -> str:
         stack = self._undo_stack()
         if not stack:

windows/lanremote/headless.py

@@ -176,18 +176,18 @@ class HeadlessUI:
                 box.pack(fill="both", expand=True)
                 tk.Frame(box, bg="#185ce8", height=4).pack(fill="x")
                 tk.Label(box, text=title or "通知", bg="#ffffff",
-                         fg="#1f2328", font=("Microsoft YaHei UI", 11, "bold"),
+                         fg="#1f2328", font=("Microsoft YaHei UI", self._notice_font(), "bold"),
                          anchor="w").pack(fill="x", padx=14, pady=(10, 2))
                 tk.Label(box, text=text or "", bg="#ffffff", fg="#656d76",
-                         font=("Microsoft YaHei UI", 10), anchor="w",
+                         font=("Microsoft YaHei UI", self._notice_font() - 1), anchor="w",
                          justify="left", wraplength=260).pack(
                     fill="x", padx=14, pady=(0, 12))
                 win.update_idletasks()
 
                 screen_w, screen_h = self.screen_size()
-                width = max(240, win.winfo_reqwidth())
+                width = self._notice_width(win)
                 height = win.winfo_reqheight()
-                win.geometry(f"+{screen_w - width - 24}+{screen_h - height - 72}")
+                win.geometry(self._notice_geometry(width, height))
 
                 def close(_event=None):
                     try:
@@ -217,18 +217,18 @@ class HeadlessUI:
                 box.pack(fill="both", expand=True)
                 tk.Frame(box, bg="#185ce8", height=4).pack(fill="x")
                 tk.Label(box, text=title or "通知", bg="#ffffff",
-                         fg="#1f2328", font=("Microsoft YaHei UI", 11, "bold"),
+                         fg="#1f2328", font=("Microsoft YaHei UI", self._notice_font(), "bold"),
                          anchor="w").pack(fill="x", padx=14, pady=(10, 2))
                 tk.Label(box, text=text or "", bg="#ffffff", fg="#656d76",
-                         font=("Microsoft YaHei UI", 10), anchor="w",
+                         font=("Microsoft YaHei UI", self._notice_font() - 1), anchor="w",
                          justify="left", wraplength=260).pack(
                     fill="x", padx=14, pady=(0, 12))
                 win.update_idletasks()
 
                 screen_w, screen_h = self.screen_size()
-                width = max(240, win.winfo_reqwidth())
+                width = self._notice_width(win)
                 height = win.winfo_reqheight()
-                win.geometry(f"+{screen_w - width - 24}+{screen_h - height - 72}")
+                win.geometry(self._notice_geometry(width, height))
 
                 def close(_event=None):
                     try:
@@ -380,6 +380,70 @@ class HeadlessUI:
             raise error[0]
         return result[0] if result else None
 
+    def _notice_width(self, win) -> int:
+        """弹窗宽度。用户要求"大小可以自定义"。
+
+        设成 0 就按内容自适应（原来是 240 起），
+        设了具体值就用那个值，夹在 180~1200 之间 ——
+        太窄文字挤成一列，太宽一个通知横穿屏幕。
+        """
+        try:
+            want = int(self.store.get("notice_width") or 0)
+        except (TypeError, ValueError):
+            want = 0
+        auto = max(240, win.winfo_reqwidth())
+        if want <= 0:
+            return auto
+        return max(180, min(1200, want))
+
+    def _notice_font(self) -> int:
+        """弹窗字号。用户要求"大小可以自定义"，所以从设置里读。
+
+        夹在 8~32 之间：太小看不清，太大一个通知就把屏幕占满了。
+        """
+        try:
+            size = int(self.store.get("notice_font_size") or 11)
+        except (TypeError, ValueError):
+            size = 11
+        return max(8, min(32, size))
+
+    def _notice_geometry(self, width: int, height: int) -> str:
+        """算出弹窗该放哪。返回 Tk 的 geometry 字符串 `+x+y`。
+
+        用户要求"位置和大小都能自定义"，所以支持 6 种位置：
+
+            bottom-right（默认，保持老习惯） / top-right /
+            top-left / bottom-left / center（屏幕正中间） / custom
+
+        ⚠ 三处弹窗（通知 ×2、屏幕提示 ×1）都调这个函数 ——
+          以前三处各写死一遍右下角，改一次得改三个地方。
+        """
+        screen_w, screen_h = self.screen_size()
+        pos = str(self.store.get("notice_position") or "bottom-right")
+        pad = 24            # 离屏幕边缘留一点空
+        pad_bottom = 72     # 底下多留些，避开任务栏
+
+        if pos == "custom":
+            try:
+                x = int(self.store.get("notice_x") or 0)
+                y = int(self.store.get("notice_y") or 0)
+            except (TypeError, ValueError):
+                x = y = 0
+            # 夹到屏幕内 —— 设了个离谱的值也不至于让窗口飞到看不见的地方
+            x = max(0, min(max(0, screen_w - width), x))
+            y = max(0, min(max(0, screen_h - height), y))
+            return f"+{x}+{y}"
+
+        if pos == "center":
+            return (f"+{max(0, (screen_w - width) // 2)}"
+                    f"+{max(0, (screen_h - height) // 2)}")
+
+        left = pos in ("top-left", "bottom-left")
+        top = pos in ("top-left", "top-right")
+        x = pad if left else screen_w - width - pad
+        y = pad if top else screen_h - height - pad_bottom
+        return f"+{max(0, x)}+{max(0, y)}"
+
     def screen_size(self) -> tuple:
         if IS_WINDOWS:
             try:
@@ -401,15 +465,27 @@ class HeadlessUI:
         self.log("（截屏）")
 
     def set_screen_sharing(self, on: bool) -> None:
-        """屏幕共享提示。
+        """屏幕共享提示条 —— **默认不显示**。
 
-        这是**故意保留**的：有人在看你的屏幕时，屏幕右下角会出现一条提示。
-        静默模式只是不显示主控制窗口，不是"让被看的人不知道"。
+        用户要求："以后不需要弹，啥窗户都没有，就可以像 UU 远程一样"。
+
+        所以先看设置项 `show_screen_notice`：
+
+          * 关着（默认）-> 什么都不做，连窗口都不建
+          * 开着 -> 行为跟以前一样，在用户设的位置显示一条提示
+
+        保留这个开关而不是删掉代码，是因为这软件应该始终有一个
+        "让本机用户看得见正在被控制"的选项可查 —— 需要时在设置里打开。
         """
         if on == self._screen_on:
             return
         self._screen_on = on
         try:
+            if not self.store.get("show_screen_notice"):
+                # 设置关着：顺手把可能残留的提示条收掉
+                # （比如正被观看时用户把开关关了），然后什么都不做
+                self._hide_notice()
+                return
             if on:
                 self._show_notice("屏幕正在被共享")
             else:
@@ -441,14 +517,14 @@ class HeadlessUI:
             win.attributes("-topmost", True)
             win.configure(bg="#cf222e")
             label = tk.Label(win, text=text, bg="#cf222e", fg="#ffffff",
-                             font=("Microsoft YaHei UI", 11, "bold"),
+                             font=("Microsoft YaHei UI", self._notice_font(), "bold"),
                              padx=16, pady=8)
             label.pack()
             screen_w, screen_h = self.screen_size()
             win.update_idletasks()
             width = win.winfo_reqwidth()
             height = win.winfo_reqheight()
-            win.geometry(f"+{screen_w - width - 24}+{screen_h - height - 72}")
+            win.geometry(self._notice_geometry(width, height))
             self._notice = win
 
         try:

windows/lanremote/ui.py

@@ -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()