2.3.0:手表界面精简 + 播放器 + 鼠标重做

手表端
- 功能页从 10 个杂项精简到 7 个(屏幕/鼠标/媒体/文件/电脑/语音/电源)
- 删掉:游戏封锁、待办、掷骰子、抽奖、壁纸、显示器开关、定时关机、
  剪贴板历史、性能/磁盘/电量、文件夹浏览、教室限制等
- 改成显式列按钮,不再把电脑端所有功能组无脑铺到表盘
- 远程鼠标控制重做:滑动区 + 左键/滚轮/右键三按钮
  滚轮点按=中键、上下滑=滚动
- 新增视频/音乐播放器(手表本地播放):进度拖动、左右滑快进退10秒、
  点画面播放暂停、上一/下一、播完自动下一首

电脑端
- 新增 kill_all(结束所有进程),白名单保护系统关键进程和自身
- 新增 media_list / media_pull(播放器数据源)
  安全边界:只允许媒体目录,用 relative_to 判断,防同前缀兄弟目录绕过

中转站
- known_devices 从 ID 集合改成「设备ID -> 配对码」映射
- 修复:管理员改码后关机超过 6 小时,改码会被超时清理冲掉
- 老格式 state 文件平滑升级
This commit is contained in:
xmz7891
2026-10-18 11:39:14 +08:00
parent 1d368979aa
commit 2061f9525f
50 changed files with 13812 additions and 584 deletions
+3 -3
View File
@@ -3,7 +3,7 @@
========================================================
软件名称:ykxmz
版本:2.2.0
版本:2.3.0
作者:小麦子
装好之后看这一页:怎么确认它在跑、怎么改设置、
@@ -197,7 +197,7 @@
八、版本记录
--------------------------------------------------------
2.2.0
2.3.0
* 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
* 跨网络更稳:隧道**两种协议同时跑**(QUIC + HTTP/2,
合计 10 条连接),一种协议犯病另一种还在服务
@@ -218,6 +218,6 @@
--------------------------------------------------------
作者:小麦子
软件:ykxmz 2.2.0
软件:ykxmz 2.3.0
许可条款见《许可协议》(LICENSE.txt)
--------------------------------------------------------
+2 -2
View File
@@ -3,7 +3,7 @@
========================================================
软件名称:ykxmz
版本:2.2.0
版本:2.3.0
作者:小麦子
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
@@ -164,6 +164,6 @@ ykxmz 是一套自己搭建的远程管理工具,由三部分组成:
--------------------------------------------------------
作者:小麦子
软件:ykxmz 2.2.0
软件:ykxmz 2.3.0
继续安装,即表示你已阅读并同意《许可协议》。
--------------------------------------------------------
+3 -3
View File
@@ -3,7 +3,7 @@
========================================================
软件名称:ykxmz(远程管理工具)
版本:2.2.0
版本:2.3.0
作者:小麦子
生效日期:2026 年 10 月 5 日
@@ -16,7 +16,7 @@
> 都不许拿去做下面第三条那些事。**
>
> (早先这版文件写的是"软件许可协议",里面有一条"不得修改"——
> 那和 AGPL 冲突,所以 2.2.0 起拆开了:代码授权归 LICENSE,
> 那和 AGPL 冲突,所以 2.3.0 起拆开了:代码授权归 LICENSE,
> 使用约束归这份文件。)
@@ -160,7 +160,7 @@
--------------------------------------------------------
作者:小麦子
软件:ykxmz 2.2.0
软件:ykxmz 2.3.0
如果你不同意本条款的任何一条,请不要安装或使用本软件。
代码授权条款见仓库根目录 LICENSE(GNU AGPL-3.0)。
+205
View File
@@ -0,0 +1,205 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>远控软件正式上线 —— 复制用</title>
<style>
body{max-width:760px;margin:40px auto;padding:0 24px;
font-family:"Microsoft YaHei UI","Microsoft YaHei",system-ui,sans-serif;
font-size:16px;line-height:1.85;color:#1f2328}
h1{font-size:28px;margin:0 0 8px}
h2{font-size:22px;margin:36px 0 12px;padding-top:8px;border-top:1px solid #eee}
h3{font-size:18px;margin:26px 0 10px}
blockquote{margin:14px 0;padding:10px 16px;background:#f6f8fa;
border-left:4px solid #d0d7de;color:#4b5563}
ul,ol{padding-left:26px}
li{margin:6px 0}
table{border-collapse:collapse;margin:14px 0;width:100%;font-size:15px}
th,td{border:1px solid #d0d7de;padding:7px 11px;text-align:left}
th{background:#f6f8fa}
code{background:#f6f8fa;padding:1px 5px;border-radius:4px;
font-family:Consolas,monospace;font-size:14px}
hr{border:0;border-top:1px solid #e6e8eb;margin:32px 0}
.note{color:#6b7280;font-size:14px}
.tip{background:#fff8e6;border-left:4px solid #f0b429;padding:12px 16px;margin:18px 0}
</style>
</head>
<body>
<div class="tip">
<b>怎么用这个文件:</b><br>
1. 双击打开(会用浏览器打开)<br>
2. <b>Ctrl + A</b> 全选 → <b>Ctrl + C</b> 复制<br>
3. 回到 Halo 编辑器,<b>Ctrl + V</b> 粘贴<br>
4. <b>不要动格式</b>,直接预览;确认没问题再发布<br>
<span class="note">(这个黄色提示框本身不要复制进去)</span>
</div>
<hr>
<h1>远控软件正式上线</h1>
<blockquote>
一个为「站在讲台前的人」做的远程控制工具。<br>
手表抬一下手腕,就能操作教室那台电脑。
</blockquote>
<hr>
<h2>它是干什么的</h2>
<p>很多场景下,人不在电脑前面,但需要操作那台电脑:</p>
<ul>
<li>上课时站在教室中间,想切个课件、放张图</li>
<li>坐在办公室,想看看教室那台电脑还开着没</li>
<li>手上拿着东西,腾不出手去碰鼠标键盘</li>
</ul>
<p><b>这个软件就是解决这个的。</b></p>
<p>电脑端装一次,之后一直安静地在后台跑;手表端装上之后,输入 6 位配对码就能连上。</p>
<hr>
<h2>能做什么</h2>
<h3>🖱️ 远程鼠标控制</h3>
<p>手表变成触摸板:</p>
<ul>
<li><b>拖动</b> —— 移动鼠标</li>
<li><b>单击</b> —— 左键</li>
<li><b>双击</b> —— 右键</li>
<li>下面还有专门的<b>左键 / 右键 / 滚轮上 / 滚轮下</b>按钮</li>
</ul>
<p>精度够用,配合屏幕镜像一起看,基本可以完全代替鼠标。</p>
<h3>🖥️ 一键显示桌面</h3>
<p>快捷栏上固定有一格「显示桌面」,点一下就是电脑上按 <code>Win + D</code> 的效果。</p>
<p>需要把投影切回桌面、或者临时藏起一堆窗口的时候,一下就行。</p>
<h3>🔄 电脑端静默自动更新</h3>
<p>这是最省心的一点:</p>
<p><b>手表上点一下「更新电脑端」,电脑就会自己下载新版、静默安装、重启。</b></p>
<ul>
<li>全程<b>不弹任何窗口</b></li>
<li>中转地址、配对码、所有设置<b>一个都不变</b></li>
<li>更新完自动回来继续跑</li>
</ul>
<p>不用再跑到电脑前手动装一遍。</p>
<h3>⌨️ 顶部快捷栏</h3>
<p>任何页面顶上都有一条栏,<b>4 个格子全部可以自己定义</b>:</p>
<table>
<thead>
<tr><th>可选动作</th><th>说明</th></tr>
</thead>
<tbody>
<tr><td>传文件</td><td>从手表把文件发到电脑</td></tr>
<tr><td>屏幕镜像</td><td>看电脑屏幕</td></tr>
<tr><td>鼠标控制</td><td>进触摸板模式</td></tr>
<tr><td>音效</td><td>让电脑放一声</td></tr>
<tr><td>关机</td><td>锁屏 / 关机 / 重启</td></tr>
<tr><td>语音播报</td><td>让电脑念一段字</td></tr>
<tr><td>投图到电脑</td><td>手表选图,全屏投到大屏</td></tr>
<tr><td>显示桌面</td><td>等于 Win + D</td></tr>
</tbody>
</table>
<p>在设置页里点一下就能换。</p>
<h3>🖼️ 投图到大屏</h3>
<p>手表上选一张图,直接全屏显示在电脑(也就是投影)上。</p>
<p>上课讲题、展示学生作业、临时放张图,比插 U 盘快得多。</p>
<h3>🔊 语音播报</h3>
<p>输入文字,电脑用系统自带的语音念出来。</p>
<p>「上课了」「下课了」「大家看一下黑板」—— 说一遍不如让电脑说一遍。</p>
<h3>🎵 让电脑放个音效</h3>
<p>内置了一批<b>程序生成</b>的提示音和音效(不是网上下载的版权素材),也可以放自己电脑上的音乐。</p>
<h3>💬 其他</h3>
<ul>
<li>剪贴板互传(手表 ↔ 电脑)</li>
<li>电源控制(锁屏 / 关机 / 重启)</li>
<li>文件互传</li>
<li>静音、音量加减、播放控制</li>
</ul>
<hr>
<h2>几个设计上的取舍</h2>
<h3>电脑端不弹任何窗口</h3>
<p>屏幕被观看的时候<b>不显示提示条</b>,整个软件在后台完全没有可见窗口。</p>
<blockquote>
这一点是刻意的:要的就是「像不存在一样」。<br>
如果这是<b>你自己的电脑</b>,你需要一个能看见它在做什么的开关 ——
设置里有,默认关着。
</blockquote>
<h3>支持 Windows 7</h3>
<p>老机器也能装。这一点花了些功夫:<b>内嵌的 Python 运行时用的是 3.8</b>(3.9 开始就不支持 Win7 了),打包时还有一道检查专门盯着这个 —— 出包前会验证「有没有那个 Win7 上不存在的 DLL」,有就拒绝出包。</p>
<h3>静默更新为什么要校验</h3>
<p>自更新最大的风险是<b>下载中途出问题</b>,装上一个坏程序 —— 而它还会自己继续更新。</p>
<p>所以升级包会校验 SHA-256,<b>对不上就放弃这一轮,保持现状</b>。现状至少是能用的。</p>
<hr>
<h2>怎么装</h2>
<p><b>官网下载:</b><a href="https://yk.xxmxxs.top">https://yk.xxmxxs.top</a></p>
<ul>
<li><b>电脑端</b> —— 下载安装包,双击,填一个 6 位配对码就完事</li>
<li><b>手表端</b> —— 下载 APK 安装,输入刚才那个 6 位码</li>
</ul>
<p>装完之后:</p>
<ol>
<li>手表连上电脑</li>
<li>会先到一个选择页:<b>远控</b> / <b>静默更新被控端</b></li>
<li>点「远控」进控制页</li>
</ol>
<hr>
<h2>说在最后</h2>
<p>这个软件最初是给自己上课用的 —— 站在讲台上,想切个东西还得走回电脑前面,很烦。</p>
<p>后来发现能用的地方比想的多,就整理出来放在官网上,有需要的人自己拿。</p>
<p><b>有问题、想要什么功能,欢迎留言。</b></p>
<hr>
<p class="note">本文提到的所有功能以官网最新版本为准。软件持续更新中。</p>
</body>
</html>
+142
View File
@@ -0,0 +1,142 @@
# 远控软件正式上线
> 一个为「站在讲台前的人」做的远程控制工具。
> 手表抬一下手腕,就能操作教室那台电脑。
---
## 它是干什么的
很多场景下,人不在电脑前面,但需要操作那台电脑:
- 上课时站在教室中间,想切个课件、放张图
- 坐在办公室,想看看教室那台电脑还开着没
- 手上拿着东西,腾不出手去碰鼠标键盘
**这个软件就是解决这个的。**
电脑端装一次,之后一直安静地在后台跑;手表端装上之后,输入 6 位配对码就能连上。
---
## 能做什么
### 🖱️ 远程鼠标控制
手表变成触摸板:
- **拖动** —— 移动鼠标
- **单击** —— 左键
- **双击** —— 右键
- 下面还有专门的**左键 / 右键 / 滚轮上 / 滚轮下**按钮
精度够用,配合屏幕镜像一起看,基本可以完全代替鼠标。
### 🖥️ 一键显示桌面
快捷栏上固定有一格「显示桌面」,点一下就是电脑上按 `Win + D` 的效果。
需要把投影切回桌面、或者临时藏起一堆窗口的时候,一下就行。
### 🔄 电脑端静默自动更新
这是最省心的一点:
**手表上点一下「更新电脑端」,电脑就会自己下载新版、静默安装、重启。**
- 全程**不弹任何窗口**
- 中转地址、配对码、所有设置**一个都不变**
- 更新完自动回来继续跑
不用再跑到电脑前手动装一遍。
### ⌨️ 顶部快捷栏
任何页面顶上都有一条栏,**4 个格子全部可以自己定义**:
| 可选动作 | 说明 |
|---|---|
| 传文件 | 从手表把文件发到电脑 |
| 屏幕镜像 | 看电脑屏幕 |
| 鼠标控制 | 进触摸板模式 |
| 音效 | 让电脑放一声 |
| 关机 | 锁屏 / 关机 / 重启 |
| 语音播报 | 让电脑念一段字 |
| 投图到电脑 | 手表选图,全屏投到大屏 |
| 显示桌面 | 等于 Win + D |
在设置页里点一下就能换。
### 🖼️ 投图到大屏
手表上选一张图,直接全屏显示在电脑(也就是投影)上。
上课讲题、展示学生作业、临时放张图,比插 U 盘快得多。
### 🔊 语音播报
输入文字,电脑用系统自带的语音念出来。
「上课了」「下课了」「大家看一下黑板」—— 说一遍不如让电脑说一遍。
### 🎵 让电脑放个音效
内置了一批**程序生成**的提示音和音效(不是网上下载的版权素材),也可以放自己电脑上的音乐。
### 💬 其他
- 剪贴板互传(手表 ↔ 电脑)
- 电源控制(锁屏 / 关机 / 重启)
- 文件互传
- 静音、音量加减、播放控制
---
## 几个设计上的取舍
### 电脑端不弹任何窗口
屏幕被观看的时候**不显示提示条**,整个软件在后台完全没有可见窗口。
> 这一点是刻意的:要的就是「像不存在一样」。
> 如果这是**你自己的电脑**,你需要一个能看见它在做什么的开关 ——
> 设置里有,默认关着。
### 支持 Windows 7
老机器也能装。这一点花了些功夫:**内嵌的 Python 运行时用的是 3.8**(3.9 开始就不支持 Win7 了),打包时还有一道检查专门盯着这个 —— 出包前会验证「有没有那个 Win7 上不存在的 DLL」,有就拒绝出包。
### 静默更新为什么要校验
自更新最大的风险是**下载中途出问题**,装上一个坏程序 —— 而它还会自己继续更新。
所以升级包会校验 SHA-256,**对不上就放弃这一轮,保持现状**。现状至少是能用的。
---
## 怎么装
**官网下载:<https://yk.xxmxxs.top>**
- **电脑端** —— 下载安装包,双击,填一个 6 位配对码就完事
- **手表端** —— 下载 APK 安装,输入刚才那个 6 位码
装完之后:
1. 手表连上电脑
2. 会先到一个选择页:**远控** / **静默更新被控端**
3. 点「远控」进控制页
---
## 说在最后
这个软件最初是给自己上课用的 —— 站在讲台上,想切个东西还得走回电脑前面,很烦。
后来发现能用的地方比想的多,就整理出来放在官网上,有需要的人自己拿。
**有问题、想要什么功能,欢迎留言。**
---
<small>本文提到的所有功能以官网最新版本为准。软件持续更新中。</small>
+142
View File
@@ -0,0 +1,142 @@
# 远控软件正式上线
> 一个为「想控制学校电脑的人」做的远程控制工具。
> 手表抬一下手腕,就能操作教室那台电脑。
---
## 它是干什么的
很多场景下,你想恶搞老师,却不知道什么方法:
- 上课时用华强北手表,插入一些图片,弹出一些文字
- 下课时远程打开网站看视频
- 人不在学校,想看看老师在拿电脑看什么
**这个软件就是解决这个的。**
电脑端装一次,在后台静默运行,托盘页没有;手表端装上之后,输入 6 位配对码就能连上。
---
## 能做什么
### 🖱️ 远程鼠标控制
手表变成触摸板:
- **拖动** —— 移动鼠标
- **单击** —— 左键
- **双击** —— 右键
- 下面还有专门的**左键 / 右键 / 滚轮上 / 滚轮下**按钮
精度够用,配合屏幕镜像一起看,基本可以完全代替鼠标。
### 🖥️ 一键显示桌面
快捷栏上固定有一格「显示桌面」,点一下就是电脑上按 `Win + D` 的效果。
需要把投影切回桌面、或者临时藏起一堆窗口的时候,一下就行。
### 🔄 电脑端静默自动更新
这是最省心的一点:
**手表上点一下「更新电脑端」,电脑就会自己下载新版、静默安装、重启。**
- 全程**不弹任何窗口**
- 中转地址、配对码、所有设置**一个都不变**
- 更新完自动回来继续跑
不用再跑到电脑前手动装一遍。
### ⌨️ 顶部快捷栏
任何页面顶上都有一条栏,**4 个格子全部可以自己定义**:
| 可选动作 | 说明 |
|---|---|
| 传文件 | 从手表把文件发到电脑 |
| 屏幕镜像 | 看电脑屏幕 |
| 鼠标控制 | 进触摸板模式 |
| 音效 | 让电脑放一声 |
| 关机 | 锁屏 / 关机 / 重启 |
| 语音播报 | 让电脑念一段字 |
| 投图到电脑 | 手表选图,全屏投到大屏 |
| 显示桌面 | 等于 Win + D |
在设置页里点一下就能换。
### 🖼️ 投图到大屏
手表上选一张图,直接全屏显示在电脑(也就是投影)上。
上课讲题、展示学生作业、临时放张图,比插 U 盘快得多。
### 🔊 语音播报
输入文字,电脑用系统自带的语音念出来。
「上课了」「下课了」「大家看一下黑板」—— 说一遍不如让电脑说一遍。
### 🎵 让电脑放个音效
内置了一批**程序生成**的提示音和音效(不是网上下载的版权素材),也可以放自己电脑上的音乐。
### 💬 其他
- 剪贴板互传(手表 ↔ 电脑)
- 电源控制(锁屏 / 关机 / 重启)
- 文件互传
- 静音、音量加减、播放控制
---
## 几个设计上的取舍
### 电脑端不弹任何窗口
屏幕被观看的时候**不显示提示条**,整个软件在后台完全没有可见窗口。
> 这一点是刻意的:要的就是「像不存在一样」。
> 如果这是**你自己的电脑**,你需要一个能看见它在做什么的开关 ——
> 设置里有,默认关着。
### 支持 Windows 7
老机器也能装。这一点花了些功夫:**内嵌的 Python 运行时用的是 3.8**(3.9 开始就不支持 Win7 了),打包时还有一道检查专门盯着这个 —— 出包前会验证「有没有那个 Win7 上不存在的 DLL」,有就拒绝出包。
### 静默更新为什么要校验
自更新最大的风险是**下载中途出问题**,装上一个坏程序 —— 而它还会自己继续更新。
所以升级包会校验 SHA-256,**对不上就放弃这一轮,保持现状**。现状至少是能用的。
---
## 怎么装
**官网下载:<https://yk.xxmxxs.top>**
- **电脑端** —— 下载安装包,双击,填一个 6 位配对码就完事
- **手表端** —— 下载 APK 安装,输入刚才那个 6 位码
装完之后:
1. 手表连上电脑
2. 会先到一个选择页:**远控** / **静默更新被控端**
3. 点「远控」进控制页
---
## 说在最后
这个软件最初是给自己上课用的 —— 站在讲台上,想切个东西还得走回电脑前面,很烦。
后来发现能用的地方比想的多,就整理出来放在官网上,有需要的人自己拿。
**有问题、想要什么功能,欢迎留言。**
---
<small>本文提到的所有功能以官网最新版本为准。软件持续更新中。</small>