mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-19 09:30:44 +00:00
xmz7891
f0c05079f7
用户这次提了一整套升级，这是最后一批。
== 一、手表端顶部快捷栏 ==
用户原话："手表端不管干什么，上面都有一栏，栏里的按钮可以在设置页
自定义，最多可以加 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 文件语法通过
168 lines
6.9 KiB
Plaintext
168 lines
6.9 KiB
Plaintext
========================================================
|
||
ykxmz 使用条款与免责声明
|
||
========================================================
|
||
|
||
软件名称：ykxmz（远程管理工具）
|
||
版本：2.1.7
|
||
作者：小麦子
|
||
生效日期：2026 年 10 月 5 日
|
||
|
||
> **这份文件管的是「使用行为」，代码授权看仓库根目录的 `LICENSE`。**
|
||
>
|
||
> 根目录 `LICENSE` 是 GNU AGPL-3.0：你可以查看、修改、
|
||
> 再发布本软件的**代码**，衍生作品必须以同样协议开源。
|
||
>
|
||
> 这份文件说的是另一件事：**不管你从哪拿到它、改没改过，
|
||
> 都不许拿去做下面第三条那些事。**
|
||
>
|
||
> （早先这版文件写的是"软件许可协议"，里面有一条"不得修改"——
|
||
> 那和 AGPL 冲突，所以 2.1.7 起拆开了：代码授权归 LICENSE，
|
||
> 使用约束归这份文件。）
|
||
|
||
|
||
--------------------------------------------------------
|
||
第一条 条款的范围
|
||
--------------------------------------------------------
|
||
|
||
本条款是你（以下称"使用者"）与作者小麦子之间就 ykxmz 软件
|
||
（含被控端程序、中转服务器程序、手表端应用及相关文档，
|
||
以下统称"本软件"）达成的**使用约定**。
|
||
|
||
下载、安装、复制或以任何方式使用本软件，即表示你已阅读、
|
||
理解并同意本条款全部内容。如不同意，请不要安装或使用。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第二条 你可以做的
|
||
--------------------------------------------------------
|
||
|
||
本软件**免费**使用，作者不收取任何费用。你可以：
|
||
|
||
1. 在**你自己拥有或已获得明确授权**的设备上安装和使用本软件；
|
||
2. 在教室、机房、家庭等场景中，用于管理**你负责管理**的设备；
|
||
3. 复制并分发本软件 —— 分发时请保留作者署名，不要去掉版权声明；
|
||
4. 查看、修改其**源代码**并再发布，具体条件见根目录 `LICENSE`
|
||
（AGPL-3.0：衍生作品要同样开源，且不能拿去闭源商用）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第三条 【重要】使用红线
|
||
--------------------------------------------------------
|
||
|
||
本软件是一套远程控制工具，被控端可以被远程操作屏幕、文件、
|
||
音量、电源等。正因为能力较强，以下行为**严格禁止**：
|
||
|
||
1. **禁止**在未经设备所有者或管理者明确同意的情况下，
|
||
在他人的电脑、手机、平板上安装被控端；
|
||
|
||
2. **禁止**用于偷窥、跟踪、监视他人（包括配偶、家人、
|
||
同事、同学、下属）的隐私；
|
||
|
||
3. **禁止**用于窃取账号密码、聊天记录、照片、文件等
|
||
任何个人信息；
|
||
|
||
4. **禁止**将本软件伪装成系统组件、隐藏其存在、
|
||
故意使设备使用者无法发现或无法卸载；
|
||
|
||
5. **禁止**用于任何违反所在地法律法规的活动。
|
||
|
||
**一句话：只能管你自己的设备，或者别人明确同意你管的设备。**
|
||
|
||
违反上述任何一条，本条款立即终止，且由此产生的全部法律
|
||
责任由使用者自行承担，与作者无关。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第四条 使用者应尽的通知义务
|
||
--------------------------------------------------------
|
||
|
||
如果你在被控端所在的设备上使用本软件，你有义务确保：
|
||
|
||
1. 该设备的使用者知道这台设备可以被远程管理；
|
||
2. 该设备的使用者知道如何查看、关闭或卸载本软件；
|
||
3. 被控端保持"连接时可见提示"功能开启（默认开启）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第五条 隐私说明
|
||
--------------------------------------------------------
|
||
|
||
本软件的设计原则是**数据不经过作者的服务器**：
|
||
|
||
1. 被控端与手表/控制端之间的所有数据（画面、文件、剪贴板、
|
||
语音等）通过你自己部署的中转服务器或局域网直连传输，
|
||
作者**不会**收到、存储或分析任何内容；
|
||
|
||
2. 中转服务器只转发加密连接中的字节流，不解析内容；
|
||
它记录的信息仅限于：设备名称、配对码、在线状态、
|
||
流量大小、连接时间——用于你在管理页上查看自己的设备；
|
||
|
||
3. 中转服务器部署在**你自己的设备**上，数据存在你自己的
|
||
硬盘里，作者无法访问；
|
||
|
||
4. 本软件不包含任何统计上报、行为采集、广告推送代码。
|
||
|
||
关于本软件需要使用的权限（网络访问、屏幕读取、文件读写等），
|
||
详见《安装前必读》。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第六条 无担保声明
|
||
--------------------------------------------------------
|
||
|
||
本软件按"现状"提供，作者不对以下事项作出任何明示或默示的
|
||
担保，包括但不限于：
|
||
|
||
1. 软件无错误、不中断、能满足你的特定用途；
|
||
2. 与你的操作系统、杀毒软件、网络环境完全兼容；
|
||
3. 因网络运营商限制、Cloudflare 服务调整、系统更新等
|
||
外部原因导致的服务不可用。
|
||
|
||
**使用本软件的风险由你自行承担。**
|
||
|
||
|
||
--------------------------------------------------------
|
||
第七条 责任限制
|
||
--------------------------------------------------------
|
||
|
||
在适用法律允许的最大范围内，作者不对因使用或无法使用本软件
|
||
而产生的任何直接、间接、偶然、特殊或后果性损失负责，包括
|
||
但不限于数据丢失、业务中断、设备损坏、利润损失。
|
||
|
||
若适用法律不允许完全排除责任，作者承担的责任总额不超过
|
||
你为获得本软件所支付的费用（本软件免费，故为零）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第八条 条款终止
|
||
--------------------------------------------------------
|
||
|
||
出现下列情形之一，本条款自动终止：
|
||
|
||
1. 你违反本条款任何内容；
|
||
2. 你将本软件用于第三条约定的禁止用途。
|
||
|
||
条款终止后，你应当立即停止使用并卸载本软件。第二条中关于
|
||
分发的许可同时失效（代码授权是否终止以根目录 `LICENSE` 为准）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
第九条 其他
|
||
--------------------------------------------------------
|
||
|
||
1. 本条款适用中华人民共和国法律；
|
||
2. 因本条款产生的争议，双方应友好协商解决；协商不成的，
|
||
提交作者所在地有管辖权的人民法院；
|
||
3. 作者保留在后续版本中调整本条款的权利，调整后的条款
|
||
随新版本一同发布；继续使用新版本即视为接受新条款；
|
||
4. 本条款部分内容无效，不影响其余内容的效力。
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.1.7
|
||
|
||
如果你不同意本条款的任何一条，请不要安装或使用本软件。
|
||
代码授权条款见仓库根目录 LICENSE（GNU AGPL-3.0）。
|
||
--------------------------------------------------------
|