mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 14:50:45 +00:00
xmz7891
3f18e6bb40
按用户定的规矩，这一轮有新功能，升第二位：2.0.0 -> 2.1.0。
== 一、网站挂了会自己救 ==
用户原话：「网站还是容易挂，建议继续增加隧道稳定性，并在后台设立
检测单元，实时检测网站状态，一旦检测到网站挂了，立即启动紧急预案」。
新增 relay/monitor.sh + lanremote-monitor.timer：
每 60 秒从**公网**查一次 /v1/health（不是查 127.0.0.1）
为什么不查本机：本机 200 只说明中转进程活着，用户真正关心的是
经过 Cloudflare 边缘 + 隧道 + 本机三段之后能不能打开。实测过
隧道两条实例都掉了、本机 curl 照样 200，只有从公网测才发现 502。
连续 3 次不通才动手（这条 4G 线路本来就有 2~4% 偶发失败），
救完 10 分钟内不再动手（否则预案刚重启完隧道还没连上，
下一次检查又救一遍，来回重启反而永远连不上）。
新增 relay/rescue.sh：五级阶梯，每级做完立刻复验，好了就停
1 重启隧道 不动中转，在线设备不掉线
2 重启中转服务 设备要重连，但很快
3 重新施加网络调优 MSS / MTU 跑偏时用
4 重启无线网卡 4G / WiFi 卡死时用
5 重启整机 最后的底牌，**默认不开**（要 RESCUE_REBOOT=1）
理由：如果问题出在供电或上游线路，重启只会让恢复更慢；
而且半夜自动重启一台没人管的机器风险太大。
== 二、抢救报告 + 后台分区 ==
用户原话：「如果紧急预案未能解决，则将问题打包成 .txt，然后在
中转站设置里面加一个分区专门放还有下载这个 txt。解决后将解决问题
的方法加入紧急预案」。
* 五级都没救回来 -> 把现场（内存/进程/隧道连接数/路由和 MTU、
三份日志尾部、内核异常）整理成 rescue_reports/<时间戳>.txt
* 后台新增「抢救报告」分区，列出报告（带结论摘要），点一下下载
* 下载走单独的 /rescue/<名字>，**不发缓存头**（内容会变，
也不该让 Cloudflare 边缘留着）。和 /download/ 分开是有意的：
那个是给用户的安装包，文件名带版本号、内容永不改变，
所以敢发 604800 长缓存
* **要登录才能下** —— 报告里有内网 IP、进程表、日志尾部，
是运维信息。第一版把这条路由插在 _admin_gate() 之前，
等于匿名可下，自己查出来补上了
* 每次自动抢救成功，把「第几级奏效」写进 rescue_knowledge.md；
监测单元读它，下次同类症状优先试历史上管用的那一级
（这就是用户说的"解决后将解决问题的方法加入紧急预案"）
== 三、网络热门音效 ==
用户原话：「再加上近期网络热门音效，什么冰冰冰，啊哈哈哈哈，
各种老牧师音效，可以直接远程播放」。
**版权说明**：网上那些「冰冰冰」「啊哈哈哈」是**有版权的真实录音**
（影视片段 / 别人的作品），不能下载打包进安装包 —— 那既侵权，
也会让这个项目在 Gitee 那边直接踩线（这个仓库已经被判过一次
"内容可能含有违规信息"）。
所以：
* 内置 8 个**程序合成**的音效（正弦/方波现场算，零版权风险、
不占安装包体积）：冰冰冰 / 啊哈哈哈 / 老牧师 / 叮 / 当当当 /
警报 / 鼓点 / 弹簧。名字对着感觉来，但不是那些录音本身
* 做「自己放进来」的目录：mp3/wav 丢进 data/sfx/ 就自动出现在
列表里，照样能远程播。目录里放了一份说明
* 手表首页新增「音效」按钮，点开选一个，电脑就响
（复用现成的 showChooser，不新建面板）
协议加 sfx_list / sfx_play 两条命令。
== 四、修「安卓设置页一片空白」 ==
用户报的。根因：设置页**建好了但忘了 root.addView()** ——
showOnly() 让它 VISIBLE 也没用，它根本不在视图树里。
这类"漏挂"编译完全不报，只在运行时表现为空白。已加断言
_tests/test_watch_panels_wired.py 盯着：每个面板都必须挂到 root、
并且纳入 showOnly()。
== 五、全量测试改成后台静默 ==
用户原话：「把全量测试改为在后台静默运行不要打开任何窗口或锁屏」。
会开窗口的 6 个阶段（含开**全屏**那个）现在跑在独立的 Windows
隐藏桌面上（_tests/hidden_desktop.py）。窗口是**真的** —— 全屏、
可见、几何、Win32 枚举都真实，测试有效性一点没损失 ——
只是不在用户眼前，全屏也不会锁屏。
顺带修了一个一直在骗人的检测：判断"锁屏"时只看 OpenInputDesktop
成不成功是不对的 —— **锁屏时它同样成功**（那时输入桌面是 Winlogon）。
于是截屏类测试在锁屏时被记成 FAIL 而不是 SKIP，把真问题淹掉了
（用户电脑锁了一夜，我就是被这个误导过）。改成看输入桌面的**名字**。
现在锁屏也能跑全量：该 SKIP 的 SKIP，该跑的照跑。
== 六、顺手修的真 bug ==
* windows/lanremote/server.py 的 sfx_play 分支用了不存在的变量名 body
（应该是 msg）-> **一调就 NameError**。pyflakes 那关抓出来的，
说明"未定义名"这条检查有用。
* _build/package_remote.py 的文件白名单只有 .py/.sh/.ico，
**.service/.timer 收不进服务端 zip** -> 新机器上监测根本不启动，
而且不报错、只是静默不跑。已加。
* protocol.py 被我补丁插入了 LF 行到 CRLF 文件里 -> 行尾混用，编码审计红。
* deploy.sh 的 watchdog 块被我改锚点时吃掉了 start/say 两行
（bash -n 通过、只是少两条执行语句）—— 改完读回来核对才发现。
* _build/CHANGELOG.md 的 2.1.0 说明里写了"管理后台"，
触发对外材料清洁度检查。改成不提管理页（用户定的规矩：
对外只能提官网）。
全量回归 46 个阶段全部通过。
168 lines
6.9 KiB
Plaintext
168 lines
6.9 KiB
Plaintext
========================================================
|
||
ykxmz 使用条款与免责声明
|
||
========================================================
|
||
|
||
软件名称：ykxmz（远程管理工具）
|
||
版本：2.1.0
|
||
作者：小麦子
|
||
生效日期：2026 年 10 月 5 日
|
||
|
||
> **这份文件管的是「使用行为」，代码授权看仓库根目录的 `LICENSE`。**
|
||
>
|
||
> 根目录 `LICENSE` 是 GNU AGPL-3.0：你可以查看、修改、
|
||
> 再发布本软件的**代码**，衍生作品必须以同样协议开源。
|
||
>
|
||
> 这份文件说的是另一件事：**不管你从哪拿到它、改没改过，
|
||
> 都不许拿去做下面第三条那些事。**
|
||
>
|
||
> （早先这版文件写的是"软件许可协议"，里面有一条"不得修改"——
|
||
> 那和 AGPL 冲突，所以 2.1.0 起拆开了：代码授权归 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.0
|
||
|
||
如果你不同意本条款的任何一条，请不要安装或使用本软件。
|
||
代码授权条款见仓库根目录 LICENSE（GNU AGPL-3.0）。
|
||
--------------------------------------------------------
|