你是谁	从这里开始
老师	三步装好 → 上课时怎么用
电教 / 学校信息中心	一个学校怎么铺开 → 批量管教室
开发者	自己编译 → 通信协议
普通用户（家里自己用）	三步装好 → 连不上怎么办

这东西是干嘛的

一句话：用手表控制电脑。

为什么用手表而不是手机？因为老师上课时手上是空的，手机在兜里，掏手机的动作比抬手大得多。手表抬一下就行，还不打断讲课。

它不只能放 PPT。教室里那些事它基本都管得着：

课件全屏投到教室大屏
放听力音频（电脑音箱比手表响多了）
看看学生机是不是在打游戏，直接把游戏进程结了
课堂专注模式，下课一键恢复
下课关机、锁屏
喊一声"上课了"让电脑播音（TTS）

电脑那边不用装 Python，一个 EXE 双击就跑，绿色免安装，不留注册表。

三件套

一套完整的部署是三个程序，装在三个地方：

装在哪	是什么	文件
教室电脑（Windows）	被控端	`ykxmz-agent-1.5.0.zip`
小服务器（随身 WiFi / 云主机 / 树莓派）	中转站	`ykxmz-server-1.5.0.zip`
手表（安卓）	控制端	`ykxmz-watch-1.5.0.apk`

只在一个教室用？ 那第三件（中转站）可以先不装，手表和电脑连同一个 WiFi 就能直连。

要在办公室管教室？ 那必须装中转站（见跨网络）。

三步装好

第一步：电脑上装被控端

解压 ykxmz-agent-1.5.0.zip，双击里面的 ykxmz.exe。

弹出的窗口里填两样：

6 位数字 —— 自己定，好记就行，比如 789113
两个勾：设置开机自启、放行防火墙（放行那个要过一次管理员确认）

点确定，屏幕会黑闪一下（在加防火墙规则），然后窗口消失，程序转到后台跑。

窗口关了程序还在跑，这是故意的 —— 上课时讲台上不该有个窗口杵着。想再打开窗口，再双击一次 EXE 就行，不会起第二个进程。想彻底退出，窗口上点「退出」。

第二步：手表上装 App

把 ykxmz-watch-1.5.0.apk 传到手表装上。手表可能提示"未知来源"，去设置里允许一下。

打开 App，首页有四个入口：

┌──────────────────────────┐
│      控制手表             │
│  和电脑连同一个 WiFi，不用输 IP │
├──────────────────────────┤
│   中转设置（跨网络用）      │  ← 办公室管教室才需要
│   局域网连接（同一个 WiFi）  │  ← 教室里用这个
│   输入配对码连接            │  ← 跨网络连的时候用
├──────────────────────────┤
│  服务器：还没测   检查服务器 │
└──────────────────────────┘
│  已配对的电脑（点一下直连）  │
│  DESKTOP-XXXX             │
└──────────────────────────┘

教室里（手表和电脑连同一个 WiFi）：点「局域网连接」→「自动搜索电脑」→ 点搜到的电脑 → 输第一步那 6 位数字。

不用输 IP。 App 往局域网广播一个包，电脑收到会自报家门，所以电脑上装了几块虚拟网卡、IP 是多少都不用管。

第三步：以后不用再输了

配对一次之后令牌存在手表里，下次打开 App 自动就连上，数字都不用再输。

多台电脑就多配对几次，列表里点哪个连哪个。长按删除配对。

上课时怎么用

连上之后手表上是一排标签页，左右滑动切换。下面挑上课最常用的讲。

教室

这一页是给上课准备的。

按钮	干什么
课堂专注模式	改 hosts，把常见游戏站点指到本地。学生机打开就是空白页
关闭游戏窗口	扫一遍常见游戏进程名，找到就结束掉
看有哪些限制	列出当前开了哪些限制，别自己忘了
一键恢复全部	把这节课开的所有限制撤掉，下课必点

屏蔽是改 hosts 文件，不是装驱动，所以：

学生自己删掉 hosts 里那几行就绕过去了 —— 它挡的是"随手点开"，不是防作弊
换个游戏站就得重新加，这个列表是写死的常见站点
重启电脑有的会保留、有的不会，取决于你们学校的还原卡

屏幕

实时屏幕镜像 —— 手表上看教室里那台电脑在显示什么。默认 4 fps，在手表上太小看不清，主要是"看一眼有没有人乱动"
一键截屏 —— 存到手表相册

⚠️ 屏幕只要被看，电脑右上角就有一条红色提示条，关不掉。 这是刻意做的：教室里那台电脑是公家的，谁在看必须让人知道。电脑前面的人随时可以点提示条上的「停止共享」把你掐断。

媒体 / 音频

放课件自带的音频，或者直接放电脑上的音乐。音量、静音、上一曲下一曲都在这一页。

放音到电脑走的是系统自带的播放器，不会弹出一个播放器窗口盖住课件。

投影

投图到电脑 —— 手表上选一张图，全屏显示在教室大屏上。点一下或者按 Esc 关掉。

考试时贴个"考试中，请勿喧哗"的图，比在黑板写快。

系统

关机、重启、锁屏、睡眠，都有二次确认。定时关机可以设"30 分钟后关"，下课忘了也不怕。

另外这一页最上面有三个按钮：

回退上一步 —— 刚才手滑点错了，撤销
回退全部 —— 把能撤的都撤了
看能回退什么 —— 列出还能撤哪些

能撤的是各种开关和画面。关机和删文件这类撤不了，也不会出现在列表里，免得你以为按了就能回来。

其他几页

文件 —— 往电脑传文件、从电脑拿文件（课件来回倒腾用）
语音 —— 让电脑念一段字。"上课了，请回到座位"这种
剪贴板 —— 手表上的字发到电脑剪贴板，或者把电脑复制的字拿到手表
通知 —— 在电脑上弹个提示
效率 —— 待办清单
娱乐 —— 掷骰子、抽奖、抛硬币（课堂互动随机点名能用）

跨网络：在办公室管教室

教室的电脑和你在的办公室不是一个网，直连不可能。这时候要装中转站。

原理说白了就是：两边都主动连到那台小服务器上，服务器按配对码把两条线接起来。

   手表  ──┐                    ┌── 教室电脑
           ├── 中转站（公网） ──┤
   办公室 ──┘                    └── 你手机

中转站只是水管子，它不认识里面流的是什么。 配对、令牌校验、权限判断全在电脑那边做。所以就算中转机被人拿走了，也进不了你的电脑。

装中转站

把 ykxmz-server-1.5.0.zip 解压到那台小机器上（随身 WiFi、树莓派、云主机都行，Debian/Ubuntu 系统），然后：

sudo bash install.sh

装完会打印一个公网地址，长这样：

https://relay.你的域名

记住这个地址，电脑和手表都要填它。忘了就打开 http://<小机器的IP>:8080/url 查。

告诉电脑中转地址

在电脑上（cmd 或 PowerShell）：

ykxmz.exe --relay "192.168.1.50:8080;https://relay.你的域名"

两个地址用分号隔开，按顺序试，第一个通的就用。这样在教室里走局域网（快、稳），出了学校自动切隧道。

告诉手表中转地址

手表首页点「中转设置」，填上面同一个地址。

然后回家首页点「输入配对码连接」，填电脑上那 6 位数字。

中转站怎么管

浏览器打开中转站的公网地址，用管理密码登录（默认 120830，装完后强烈建议改）。

能看：哪些电脑在线、配对码是什么、有多少会话、内存用了多少。能做：踢掉某个会话、删掉某个配对码绑定、跑个网络体检。下载区：最新版的三个文件都挂在上面，点一下就能下。

一个学校怎么铺开

如果是一个学校几十间教室，上面那套手工装会很累。这一节给电教。

被控端

ykxmz.exe 是绿色单文件，整个文件夹拷过去就能用。批量装有两种办法：

办法一：机房同传 / 还原卡

把文件夹放进母盘镜像，开机自启那条在程序里勾上就行。注意 data/ 目录里存着这台机器的配对码和令牌，母盘里别带上别的机器的 data/，否则一堆机器共用一个码。

办法二：脚本推

# 把文件夹拷到目标机，然后静默设置配对码和自启
Copy-Item -Recurse "\\服务器\share\ykxmz" "C:\ykxmz"
Start-Process "C:\ykxmz\ykxmz.exe" -ArgumentList `
    '--code 789113', '--relay 192.168.1.50:8080;https://relay.你的域名', '--auto-start', '--silent'

--silent 不弹窗口，适合批量。静默模式下配对码一定要用参数指定，不然每台机器随机生成一个，你也不知道是多少。

配一次码，服务器就记住了

这是这套东西比较省心的一点：一台电脑第一次设的配对码，服务器会记住。

以后同一台电脑再报别的码（重装、误操作、母盘没清干净），服务器会自动改回原来那个。所以你不会因为手抖把一台机器的码搞乱，手表永远认得出它。

反过来，一个码不能同时属于两台电脑，服务器会拒绝后来那个。这也是为什么母盘里不能带别人的 data/。

网络规划

中转站放在学校出口能上外网的地方，带宽不用大，它是控制通道不是视频通道
走局域网时是手表直连电脑，完全不经过中转站，所以一个班几十只手表也不挤服务器
教室之间如果是隔离的 VLAN，那手表和电脑得在同一个 VLAN 里，或者干脆都走中转

权限怎么收

被控端窗口上有几个权限开关，随时关，关了远程立刻执行不了：

允许自定义命令
允许电源操作
允许屏幕镜像 / 截屏

给班主任的电脑可以把"自定义命令"和"电源操作"关掉，只留日常那几个按钮。

连不上怎么办

按这个顺序排查，九成问题在第二步。

第一步：程序在跑吗

电脑任务管理器里找 ykxmz.exe。没有就双击 EXE 启动。

第二步：防火墙放行了吗

被控端窗口上如果显示橙色提示"防火墙未放行"，点旁边的一键修复，过一次管理员确认。

或者用目录里的 工具箱.bat → 选 2。

这一条是最常见的坑。很多学校的电脑装了第三方安全软件，它会把新程序的入站连接全挡了。一键修复会加一条程序级的放行规则（不是端口级），这个才管用。

第三步：还是不行就跑网络自检

工具箱.bat → 选 3，然后到手表上点「检查服务器」。

看电脑窗口：

出现 >>> 收到 TCP 连接 <<< → 包到电脑了，问题在电脑本机（程序没跑 / 端口被占）
一个包都没收到 → 包没到电脑，八成是路由器开了**「AP 隔离」**（也叫客户端隔离），去路由器后台关掉

手表上会显示具体原因

App 把错误翻译成人话了，看到哪句就照做：

手表上显示	什么意思
证书校验失败	手表系统太旧，或者网络被人劫持
证书时间不对	把手表的日期时间调成自动获取，这个很常见
连接超时	网络慢，或者被防火墙挡了
电脑拒绝连接	电脑上 ykxmz 没开
域名解析不了	手表没联网，检查 WiFi
连不上中转	中转站挂了，或者地址填错了

首页那个「检查服务器」能测出到中转的延迟，快/一般/慢会用不同颜色标出来。

安全

教室里那台电脑是公家的东西，所以这套工具的安全设计偏"让人知道"而不是"藏起来"。

每次连接都要配对。 电脑上生成 6 位数字，只在窗口上显示，手表输对了才连得上。

配对之后发令牌。 32 位随机串存在手表上，之后靠它登录，不用每次输数字。

没通过握手，一条命令都不执行。 服务端直接拒。

屏幕被看，电脑上一定有提示条。 关不掉，没有开关。电脑前面的人随时能掐断。

权限开关实时生效。 窗口上关掉哪一项，远程立刻做不了那一项。

不写注册表。 数据全在程序目录下的 data/ 里，拔了硬盘拷走就能换台机器跑。

不在后台偷偷上传。 局域网模式下完全不联外网。跨网络模式只连你自己那台中转站。

这个工具不藏自己。 没有"任务管理器里看不见"，没有"免杀对抗"，没有伪装成系统进程。被控端全程可见、可随时断开、权限可随时关掉。因为管的是教室的电脑，藏起来只会让老师不放心。

自己编译

给开发者。三端都是零第三方依赖，不用 npm、不用 Gradle 拉一堆东西。

被控端（Windows）

Python 3.11 + tkinter + Pillow。打包用 PyInstaller。

windows\build_exe.ps1
# 产物：dist_exe\ykxmz\ykxmz.exe

控制端（安卓手表）

纯 Java，没有 Gradle，直接命令行编：

android\build_apk.ps1
# 流程：aapt2 → javac → d8 → zipalign → apksigner
# 产物：dist\ykxmz-watch-1.5.0.apk

最低支持 Android 7.0（API 24），targetSdk 34。

服务器端

Python 3 标准库，没有第三方包。

bash relay/install.sh

跑测试

_tests\verify_all.ps1

会跑编码审计、协议回归、打包验证、Java 编译、端到端，最后打一张汇总表。

打包三个成品

python _build\package_remote.py

出三个文件：ykxmz-agent-*.zip、ykxmz-server-*.zip、ykxmz-watch-*.apk。

通信协议

给要改代码或者做二次开发的人。

传输是 TCP 上的换行分隔 UTF-8 JSON，一行一个消息。

{"cmd": "handshake", "code": "789113", "deviceId": "..."}
{"ok": true, "token": "32位随机串", "serverName": "DESKTOP-XXXX"}

二进制数据（图片、文件、音频）走 Base64 分块传输，单次会话上限 256 MB。

跨网络时同样的消息套在 HTTP 长轮询里，中转站按配对码把两端字节对接，它不解析内容。

Java 和 Python 两端都实现了同一套协议，_tests/java/ 下有互相打通的测试。

常见问题

问：手表能连多台电脑吗？ 能。配对多台，列表里点哪个连哪个。

问：一台电脑能被几只手表连？ 可以多只，屏幕镜像会显示"几台设备正在观看"。教室场景一般一只就够。

问：换台电脑要重新配对吗？ 要。配对码跟着电脑走，不是跟着手表走。

问：电脑重装系统了，配对码会变吗？ 不会。只要 data/ 目录还在，服务器就认原来那个码。母盘部署时注意别把 data/ 一起发出去。

问：走中转会不会很慢？ 实测局域网 3 毫秒左右，公网中转 1~3 秒（取决于你那台小机器的线路）。所以同一个 WiFi 一定走局域网，程序会优先选它。

问：能在手机上用吗？ 协议是通的，但界面是按手表的小屏幕设计的（大按钮、两列、可滚动），手机上会显得按钮特别大。要做手机版得重写布局。

问：收费吗？ 看 LICENSE.txt。里面有使用红线，装之前看一眼。

出问题了

先看连不上怎么办。

还不行的话，把这几样发过来，能定位得快很多：

手表上显示的那句错误（App 现在是中文的，直接念出来就行）
电脑上 工具箱.bat → 选 5 的日志内容
中转站的公网地址（不用给密码）

作者：小麦子许可见 LICENSE.txt

README.md Unescape Escape

ykxmz · 教室电脑手表控制

先看这个：你是哪一类人