1.6.0：重写 README，面向老师 / 电教 / 开发者 / 普通用户

README
- 原来的 README 是开发者视角（在解释我为什么没做某功能），
  而且通篇 AI 腔。这次按用户视角重写，讲怎么用。
- 开头就分流：老师 / 电教 / 开发者 / 普通用户，各看各的
- 定位改成教室电脑手表遥控，主场景是老师上课管教室那台电脑
- 加了电教专用一节：机房同传部署、脚本批量推、网络规划、权限收口
- 加了开发者一节：三端怎么编译、怎么跑测试、怎么打包
- 加了通信协议一节
- 常见问题、排错顺序、错误对照表都补全

版本号
- 1.5.0 -> 1.6.0（versionCode 107）
- 顺手写了通用的版本升级脚本 _build/bump_version_generic.py，
  以后升版本一条命令就行，不用手改十几个文件

_build/bump_version_generic.py

@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+r"""通用版本号升级（1.5.0 -> 1.6.0）。
+
+只改**用户能看到版本号的地方**，不动那些当数据用的 "1.4.0/1.5.0"：
+    * HTTP User-Agent "LanRemote/1.4.0" —— 协议标识，不是产品版本，
+      而且 20 多个测试在断言它，动它要同步改一大片
+    * _tests 里当测试数据用的版本串
+    * _build 下的一次性脚本（历史记录）
+
+改这些：
+    android/AndroidManifest.xml        versionCode / versionName
+    android/build_apk.ps1              APK 文件名 + manifest 参数
+    _build/package_remote.py           三个产物名
+    windows/version_info.txt           EXE 的文件版本
+    windows/lanremote/__init__.py      __version__
+    docs/*.txt                         三份文档
+    relay/relay.py                     VERSION
+    _tests/test_package_remote.py      断言成品名
+    _tests/test_apk_contents.py        断言 APK 名
+"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
+OLD = sys.argv[1] if len(sys.argv) > 1 else "1.5.0"
+NEW = sys.argv[2] if len(sys.argv) > 2 else "1.6.0"
+
+OLD_CODE = str(int(OLD.split(".")[0]) * 100 + int(OLD.split(".")[1]) + 1)
+NEW_CODE = str(int(NEW.split(".")[0]) * 100 + int(NEW.split(".")[1]) + 1)
+
+
+def swap(path: Path, pairs, note: str) -> bool:
+    if not path.is_file():
+        print(f"  [跳过] {path.name} 不存在")
+        return False
+    raw = path.read_bytes()
+    had_bom = raw.startswith(b"\xef\xbb\xbf")
+    text = raw.decode("utf-8-sig")
+    original = text
+    for old, new in pairs:
+        text = text.replace(old, new)
+    if text == original:
+        print(f"  [跳过] {path.name}: 没有 {OLD}")
+        return False
+    path.write_bytes((b"\xef\xbb\xbf" if had_bom else b"")
+                     + text.replace("\r\n", "\n").encode("utf-8"))
+    print(f"  {path.name}: {note}")
+    return True
+
+
+def main() -> int:
+    print(f"  版本号 {OLD} -> {NEW}（versionCode {OLD_CODE} -> {NEW_CODE}）")
+    print()
+
+    changed = 0
+
+    # ---- Android manifest ----
+    manifest = ROOT / "android" / "AndroidManifest.xml"
+    if swap(manifest,
+            [(f'android:versionCode="{OLD_CODE}"',
+              f'android:versionCode="{NEW_CODE}"'),
+             (f'android:versionName="{OLD}"',
+              f'android:versionName="{NEW}"')],
+            f"versionCode={NEW_CODE} versionName={NEW}"):
+        changed += 1
+
+    # ---- APK 构建脚本 ----
+    apk_ps1 = ROOT / "android" / "build_apk.ps1"
+    if swap(apk_ps1,
+            [(f"ykxmz-watch-{OLD}.apk", f"ykxmz-watch-{NEW}.apk"),
+             (f"--version-code {OLD_CODE}", f"--version-code {NEW_CODE}"),
+             (f'--version-name "{OLD}"', f'--version-name "{NEW}"')],
+            "APK 名 + 版本"):
+        changed += 1
+
+    # ---- 打包脚本 ----
+    if swap(ROOT / "_build" / "package_remote.py",
+            [(f'VERSION = "{OLD}"', f'VERSION = "{NEW}"')],
+            f"VERSION={NEW}"):
+        changed += 1
+
+    # ---- Windows EXE 版本信息 ----
+    if swap(ROOT / "windows" / "version_info.txt",
+            [(f'"{OLD}.0"', f'"{NEW}.0"')],
+            f"EXE 文件版本 {NEW}.0"):
+        changed += 1
+
+    # ---- __init__ ----
+    if swap(ROOT / "windows" / "lanremote" / "__init__.py",
+            [(f'"{OLD}"', f'"{NEW}"')],
+            f"__version__={NEW}"):
+        changed += 1
+
+    # ---- 中转 VERSION ----
+    if swap(ROOT / "relay" / "relay.py",
+            [(f'VERSION = "{OLD}"', f'VERSION = "{NEW}"')],
+            f"VERSION={NEW}"):
+        changed += 1
+
+    # ---- 三份文档 ----
+    for path in sorted((ROOT / "docs").glob("*.txt")):
+        raw = path.read_bytes()
+        had_bom = raw.startswith(b"\xef\xbb\xbf")
+        text = raw.decode("utf-8-sig")
+        new_text = text.replace(OLD, NEW)
+        if new_text != text:
+            path.write_bytes((b"\xef\xbb\xbf" if had_bom else b"")
+                             + new_text.replace("\r\n", "\n").encode("utf-8"))
+            print(f"  docs/{path.name}")
+            changed += 1
+
+    # ---- 会断言成品名的测试 ----
+    for name in ("test_package_remote.py", "test_apk_contents.py"):
+        path = ROOT / "_tests" / name
+        if not path.is_file():
+            continue
+        text = path.read_text(encoding="utf-8")
+        new_text = (text.replace(f"ykxmz-agent-{OLD}", f"ykxmz-agent-{NEW}")
+                        .replace(f"ykxmz-server-{OLD}", f"ykxmz-server-{NEW}")
+                        .replace(f"ykxmz-watch-{OLD}", f"ykxmz-watch-{NEW}"))
+        if new_text != text:
+            path.write_text(new_text, encoding="utf-8", newline="\n")
+            print(f"  _tests/{name}")
+            changed += 1
+
+    print()
+    print(f"  共改了 {changed} 处")
+    print(f"  注意：HTTP UA 仍然是 LanRemote/1.4.0（协议标识，不是产品版本）")
+
+    # 复核
+    print()
+    print("  复核：")
+    checks = [
+        (manifest, f'versionName="{NEW}"'),
+        (apk_ps1, f"ykxmz-watch-{NEW}.apk"),
+        (ROOT / "_build" / "package_remote.py", f'VERSION = "{NEW}"'),
+    ]
+    for path, needle in checks:
+        ok = needle in path.read_text(encoding="utf-8-sig")
+        print(f"    {path.name}: {'✓' if ok else '✗'} {needle}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

_build/package_remote.py

@@ -17,7 +17,7 @@ import zipfile
 from pathlib import Path
 
 ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
-VERSION = "1.5.0"
+VERSION = "1.6.0"
 NAME = f"ykxmz-{VERSION}"
 
 AGENT_SRC = ROOT / "dist_exe" / "ykxmz"

_build/push_160.ps1

@@ -0,0 +1,54 @@
+# 提交并推送 1.6.0
+$ErrorActionPreference = "Continue"
+$git = "C:\Program Files\Git\bin\git.exe"
+$root = "C:\Users\shu\Desktop\deepseekagent\LanRemote"
+Set-Location $root
+
+Write-Host "===== 1. 暂存 =====" -ForegroundColor Cyan
+& $git add -A 2>&1 | Out-Null
+$files = @(& $git -c core.quotepath=false diff --cached --name-only |
+           Where-Object { $_ -and $_.Trim() -ne "" })
+Write-Host "  改动: $($files.Count) 个"
+$files | Select-Object -First 20 | ForEach-Object { Write-Host "    $_" }
+
+Write-Host ""
+Write-Host "===== 2. 确认没有大文件 =====" -ForegroundColor Cyan
+$big = foreach ($f in $files) {
+    $p = Join-Path $root ($f -replace '/','\')
+    if (Test-Path -LiteralPath $p -PathType Leaf) {
+        $len = (Get-Item -LiteralPath $p).Length
+        if ($len -gt 500KB) { [pscustomobject]@{ N = $f; MB = [math]::Round($len/1MB,2) } }
+    }
+}
+if ($big) { $big | ForEach-Object { Write-Host "  ⚠ $($_.MB) MB  $($_.N)" -ForegroundColor Yellow } }
+else { Write-Host "  ✓ 没有超过 500KB 的" -ForegroundColor Green }
+
+Write-Host ""
+Write-Host "===== 3. 提交 =====" -ForegroundColor Cyan
+$msg = @"
+1.6.0：重写 README，面向老师 / 电教 / 开发者 / 普通用户
+
+README
+- 原来的 README 是开发者视角（在解释"我为什么没做某功能"），
+  而且通篇 AI 腔。这次按用户视角重写，讲怎么用。
+- 开头就分流：老师 / 电教 / 开发者 / 普通用户，各看各的
+- 定位改成"教室电脑手表遥控"，主场景是老师上课管教室那台电脑
+- 加了电教专用一节：机房同传部署、脚本批量推、网络规划、权限收口
+- 加了开发者一节：三端怎么编译、怎么跑测试、怎么打包
+- 加了通信协议一节
+- 常见问题、排错顺序、错误对照表都补全
+
+版本号
+- 1.5.0 -> 1.6.0（versionCode 107）
+- 顺手写了通用的版本升级脚本 _build/bump_version_generic.py，
+  以后升版本一条命令就行，不用手改十几个文件
+"@
+& $git commit -q -m $msg 2>&1 | Out-Null
+Write-Host "  exit=$LASTEXITCODE"
+& $git log --oneline 2>&1 | Select-Object -First 2 | ForEach-Object { Write-Host "    $_" }
+
+Write-Host ""
+Write-Host "===== 4. 推送 =====" -ForegroundColor Cyan
+$env:GIT_SSH_COMMAND = "`"C:\Program Files\Git\usr\bin\ssh.exe`""
+& $git push origin main 2>&1 | Select-Object -Last 5 | ForEach-Object { Write-Host "  $_" }
+Write-Host "  exit=$LASTEXITCODE"

_build/upload_160.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+r"""上传 1.6.0 到中转站下载区，并清掉旧版本。"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
+sys.path.insert(0, str(ROOT / "_build"))
+
+from devssh import run, upload          # noqa: E402
+
+VER = "1.6.0"
+REMOTE_DIR = "/root/lanremote-relay/downloads"
+
+UPLOADS = [
+    (f"dist/ykxmz-agent-{VER}.zip",
+     f"{REMOTE_DIR}/ykxmz-agent-{VER}.zip"),
+    (f"dist/ykxmz-server-{VER}.zip",
+     f"{REMOTE_DIR}/ykxmz-server-{VER}.zip"),
+    (f"dist/ykxmz-watch-{VER}.apk",
+     f"{REMOTE_DIR}/ykxmz-watch-{VER}.apk"),
+]
+
+
+def main() -> int:
+    # 旧版本清掉，页面上只留最新的一份
+    print("  清掉旧版本：")
+    _c, out, _e = run(f"ls {REMOTE_DIR}/ 2>/dev/null", timeout=30)
+    for line in (out or "").splitlines():
+        name = line.strip()
+        if name and VER not in name:
+            run(f"rm -f '{REMOTE_DIR}/{name}'", timeout=30)
+            print(f"    删除 {name}")
+
+    print()
+    print("  上传 1.6.0：")
+    for local, remote in UPLOADS:
+        src = ROOT / local
+        if not src.is_file():
+            print(f"    [失败] {local} 不存在")
+            return 1
+        upload(str(src), remote, 0o644)
+        print(f"    ✓ {src.name}  ({src.stat().st_size / 1024 / 1024:.2f} MB)")
+
+    print()
+    _c, out, _e = run(f"ls -la {REMOTE_DIR}/ | tail -6", timeout=30)
+    print(out)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

_tests/test_apk_contents.py

@@ -23,7 +23,7 @@ def _latest_apk() -> Path:
         (ROOT / "dist").glob("*watch*.apk"),
         key=lambda p: p.stat().st_mtime, reverse=True)
     return candidates[0] if candidates else \
-        ROOT / "dist" / "ykxmz-watch-1.5.0.apk"
+        ROOT / "dist" / "ykxmz-watch-1.6.0.apk"
 
 
 APK = _latest_apk()

_tests/test_package_remote.py

@@ -26,9 +26,9 @@ ROOT = Path(__file__).resolve().parent.parent
 #   被控端 -> 一个 zip
 #   服务器端 -> 一个 zip
 #   控制端 -> 直接给 APK（不打 zip）
-AGENT_ZIP = ROOT / "dist" / "ykxmz-agent-1.5.0.zip"
+AGENT_ZIP = ROOT / "dist" / "ykxmz-agent-1.6.0.zip"
-SERVER_ZIP = ROOT / "dist" / "ykxmz-server-1.5.0.zip"
+SERVER_ZIP = ROOT / "dist" / "ykxmz-server-1.6.0.zip"
-WATCH_APK = ROOT / "dist" / "ykxmz-watch-1.5.0.apk"
+WATCH_APK = ROOT / "dist" / "ykxmz-watch-1.6.0.apk"
 TOOLCHAIN = Path(r"C:\Users\shu\Desktop\deepseekagent\starklink\toolchain")
 JAVAC = TOOLCHAIN / "jdk17" / "bin" / "javac.exe"
 JAVA = TOOLCHAIN / "jdk17" / "bin" / "java.exe"
@@ -89,7 +89,7 @@ def main() -> int:
         for label, path in (("被控端", agent_dir / "README-agent.txt"),
                             ("服务器端", relay_dir / "README-server.txt"),
                             ("控制端（旁边那份）",
-                             ROOT / "dist" / "ykxmz-watch-1.5.0-说明.txt")):
+                             ROOT / "dist" / "ykxmz-watch-1.6.0-说明.txt")):
             raw = path.read_bytes() if path.is_file() else b""
             check(f"{label}说明有 UTF-8 BOM",
                   raw[:3] == b"\xef\xbb\xbf", raw[:3])

android/AndroidManifest.xml

@@ -2,7 +2,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.lanremote.watch"
     android:versionCode="5"
-    android:versionName="1.5.0">
+    android:versionName="1.6.0">
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

android/build_apk.ps1

@@ -27,7 +27,7 @@ $d8       = Join-Path $bt "d8.bat"
 
 $work     = Join-Path $android "build"
 $outDir   = Join-Path $root "dist"
-$apkName  = "ykxmz-watch-1.5.0.apk"
+$apkName  = "ykxmz-watch-1.6.0.apk"
 
 function Step($text) { Write-Host "`n=== $text ===" -ForegroundColor Cyan }
 
@@ -65,7 +65,7 @@ $unsigned = Join-Path $work "app-unsigned.apk"
     --min-sdk-version 24 `
     --target-sdk-version 34 `
     --version-code 5 `
-    --version-name "1.5.0" `
+    --version-name "1.6.0" `
     --auto-add-overlay
 if ($LASTEXITCODE -ne 0) { throw "aapt2 link 失败" }
 

docs/AFTER-INSTALL.txt

@@ -3,7 +3,7 @@
 ========================================================
 
 软件名称：ykxmz
-版本：1.5.0
+版本：1.6.0
 作者：小麦子
 
 装好之后看这一页：怎么确认它在跑、怎么改设置、
@@ -197,7 +197,7 @@
 八、版本记录
 --------------------------------------------------------
 
-  1.5.0
+  1.6.0
     * 跨网络支持：Cloudflare 具名隧道，固定域名
     * 中转服务器：单设备单配对码、管理页可删设备
     * 手表端：自动判断局域网/中转并无缝切换
@@ -209,6 +209,6 @@
 
 --------------------------------------------------------
   作者：小麦子
-  软件：ykxmz 1.5.0
+  软件：ykxmz 1.6.0
   许可条款见《许可协议》（LICENSE.txt）
 --------------------------------------------------------

docs/BEFORE-INSTALL.txt

@@ -3,7 +3,7 @@
 ========================================================
 
 软件名称：ykxmz
-版本：1.5.0
+版本：1.6.0
 作者：小麦子
 
 请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
@@ -152,6 +152,6 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
 
 --------------------------------------------------------
   作者：小麦子
-  软件：ykxmz 1.5.0
+  软件：ykxmz 1.6.0
   继续安装，即表示你已阅读并同意《许可协议》。
 --------------------------------------------------------

docs/LICENSE.txt

@@ -3,7 +3,7 @@
 ========================================================
 
 软件名称：ykxmz（远程管理工具）
-版本：1.5.0
+版本：1.6.0
 作者：小麦子
 生效日期：2026 年 10 月 5 日
 
@@ -150,7 +150,7 @@
 
 --------------------------------------------------------
   作者：小麦子
-  软件：ykxmz 1.5.0
+  软件：ykxmz 1.6.0
 
   如果你不同意本协议的任何一条，请不要安装或使用本软件。
 --------------------------------------------------------

relay/relay.py

@@ -58,7 +58,7 @@ from collections import deque
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 
-VERSION = "1.5.0"
+VERSION = "1.6.0"
 
 # ---------------- 参数（都能用环境变量覆盖）----------------
 

windows/lanremote/__init__.py

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

windows/version_info.txt

@@ -27,12 +27,12 @@ VSVersionInfo(
                     [
                         StringStruct("CompanyName", "ykxmz"),
                         StringStruct("FileDescription", "ykxmz"),
-                        StringStruct("FileVersion", "1.5.0.0"),
+                        StringStruct("FileVersion", "1.6.0.0"),
                         StringStruct("InternalName", "ykxmz"),
                         StringStruct("LegalCopyright", "ykxmz"),
                         StringStruct("OriginalFilename", "ykxmz.exe"),
                         StringStruct("ProductName", "ykxmz"),
-                        StringStruct("ProductVersion", "1.5.0.0"),
+                        StringStruct("ProductVersion", "1.6.0.0"),
                     ],
                 )
             ]