mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 18:20:43 +00:00
xmz7891
4295b482a1
按用户定的版本规矩，这一轮既有新内容又有重构，所以升第二位： 1.9.0 -> 2.0.0（最后一位清 0）。 == 一、安装时就能设中转服务器（用户要求）== 安装向导那一页现在是两个输入框：配对码 + 中转服务器。 装的时候是"第一次设置"，最该一次把地址填好，不然装完还得去 双击 exe 找设置窗口，很容易漏。 只填域名就行（自动补 https://），留空 = 只走局域网。 批量静默部署同样支持： ykxmz-setup-2.0.0.exe /VERYSILENT /CODE=246810 /RELAY=relay.你的域名 为此新增了一个 --relay-url 参数： --relay 连接一次、打印状态、然后退出（人工排查用） --relay-url 只写进配置，不连接、不退出（安装流程用） 用错那个的话，安装包的命令链会在中间就 return，后面的 --silent 根本跑不到 —— 所以必须分开。 == 二、手表端新增「设置」页（用户要求）== 用户原话："安卓端加一个设置，各种设置就在这里面调"。 以前设置散在首页（只有一个"中转设置"按钮），现在统一收进设置页： * 中转服务器（填写 / 一键清空） * 记住的配对码（显示 / 清除） * 已配对的电脑（看数量 / 清空，带二次确认） * 关于（版本号从 APK 读，不会和代码对不上） == 三、中转地址默认留空 + 一次性迁移（用户报的问题）== 用户原话："安卓端为什么还是默认填的我的中转站，以后改成手动填"。 代码里的默认值早就是空的了，但用户看到的还是那个地址 —— 因为**老版本 1.5.0 把作者的域名硬编码成了默认值**，第一次运行就 存进了 SharedPreferences。装新 APK 不会清偏好，所以那个值一直留着。 用户其实从来没"选"过这个地址，是程序硬塞的。 所以加了 migrateLegacyRelay()：存的值如果正好等于当时内置的域名， 就当成没设过、清掉。只清完全相等的，用户手填的不会动。 == 四、两个测试自身的毛病 == * test_lan_optimize 那条"没有把旧公网域名当默认值"太粗 —— 它查的是源码里任何位置，于是迁移注释里引用那行老代码就把它判红了。 改成先剥掉注释再查（断言要测的是"有没有把它当默认值"）。 * test_image_modes 偶发红：它开真实 Tk 全屏窗口，在全量套件里跑 偶尔起不来（单独跑 19/19 全过）。加了有界重试。 偶发红的测试会让"全量通过"失去意义。 == 五、新增防复发断言 == _tests/test_relay_default_blank.py（15 项，回归阶段 3a3b）： * 默认值必须是空串 * 除了迁移清单，源码里不许有写死的中转域名 * 迁移必须真的被调用（不是只定义） * 迁移必须是 remove，不能换成另一个硬编码值 * Windows 端的默认也得是空 理由：用户说过"这个中转站我就自己用，不对外" —— 值得用断言钉死。 == 六、顺手修的 == * release_all.py 崩在 Gitee 那一步：Gitee 的 GET /releases/tags/{tag} 在"标签存在、但还没发行版"时返回的是 **HTTP 200 + JSON null**（不是 404），于是 .get("id") 直接 AttributeError。发 1.9.0 时踩到，已改成容忍 None。 * installer/build_installer.py 里 license-combined.txt 是从 docs/ 三份文档重新生成的，所以光改生成物没用（下次构建又变回去）。 改成在 build_license() 里统一注入当前版本。 * ExE 文件属性里的版本（version_info.txt）从 1.7.1 起就一直没跟上。 全量回归 43 个阶段全部通过。
170 lines
6.7 KiB
Plaintext
170 lines
6.7 KiB
Plaintext
========================================================
|
||
ykxmz 安装前必读（前信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.0.0
|
||
作者：小麦子
|
||
|
||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||
提醒，尤其是第三节和第五节。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、这是什么
|
||
--------------------------------------------------------
|
||
|
||
ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
|
||
|
||
1-agent（被控端） 装在你**要管理**的电脑上（Windows）
|
||
2-server（服务器端）装在一台能上外网的 Linux 小机器上
|
||
（随身 WiFi、树莓派、VPS 都行）
|
||
3-watch（控制端） 装在你的安卓手表上
|
||
|
||
装好之后，你在手表上就能看到并操作那台电脑：屏幕、文件、
|
||
音量、电源、剪贴板……共两百多个功能。
|
||
|
||
**关键点：所有数据都走你自己搭的那台服务器，
|
||
作者碰不到你的任何内容。** 详见《许可协议》第五条。
|
||
|
||
**再强调一次：软件里不带任何中转地址，作者也不对外提供中转服务。**
|
||
只在同一个 WiFi 下用的话，压根不需要中转站，装完就能连；
|
||
要跨网络就必须自己部署一台（看下面第四节的第 1 步）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、装机前对照检查
|
||
--------------------------------------------------------
|
||
|
||
请先确认：
|
||
|
||
[ ] 这台电脑是**你自己的**，或者设备主人明确同意你远程管理
|
||
[ ] 电脑是 Windows 10 / 11（64 位）
|
||
[ ] 手表是安卓 7.0（API 24）或更高版本
|
||
[ ] 服务器端那台机器是 Linux（Debian 12 实测通过），
|
||
能上外网，内存 512MB 够用
|
||
[ ] 你有一个 Cloudflare 账号和一个域名（跨网络才需要）
|
||
|
||
**不需要**装 Python、不需要 root、不需要 ADB。
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、【重要】三条必须知道的事
|
||
--------------------------------------------------------
|
||
|
||
① 被控端默认是"静默"运行的
|
||
|
||
装完之后**没有窗口、没有托盘图标、没有终端**，
|
||
任务管理器里能看到一个叫 ykxmz.exe 的进程，
|
||
开机自启项里也显示 ykxmz。
|
||
|
||
这么做是为了不打扰用电脑的人，**不是**为了藏起来。
|
||
如果你要在这台电脑上装给别人用，你有义务告诉对方：
|
||
|
||
怎么查看（任务管理器 -> 详细信息 -> ykxmz.exe）
|
||
怎么关闭（任务管理器 -> 结束任务）
|
||
怎么卸载（ykxmz.exe --uninstall）
|
||
|
||
② 配对码是唯一的口令，请设一个别人猜不到的
|
||
|
||
配对码是 6 位数字，**它就是你电脑的钥匙**。
|
||
不要用 123456、000000、生日、手机号后六位这类。
|
||
|
||
一个配对码同时只能绑定一台电脑。如果别人先用了你想要的码，
|
||
后装的这台会被拒绝，并在屏幕上弹出提示：
|
||
「该配对码已被使用，请换一个配对码」
|
||
换个没人用的码就行。
|
||
|
||
③ 连接时屏幕上有提示
|
||
|
||
只要手表或控制端连上来，被控端会在屏幕右下角弹一个提示。
|
||
这是**故意保留**的功能，请不要关掉它——
|
||
它保证了设备使用者知道"现在有人在看这台电脑"。
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、安装顺序
|
||
--------------------------------------------------------
|
||
|
||
按这个顺序来，别跳：
|
||
|
||
第 1 步 架服务器端（只做一次，**跨网络才需要**）
|
||
如果只在同一个 WiFi 下用（手表和电脑连同一个路由器），
|
||
这一步可以跳过。
|
||
要跨网络的话，把 2-server 整个目录拷到那台 Linux 小机器上：
|
||
bash deploy.sh
|
||
它会把中转服务、网络调优、Cloudflare 隧道一次装好，
|
||
最后打印一个**属于你自己的公网地址**。记住它。
|
||
|
||
第 2 步 装被控端（每台要管理的电脑做一次）
|
||
双击安装包 -> 输 6 位配对码 -> 勾上开机自启和
|
||
放行防火墙 -> 确定。会弹一次管理员确认。
|
||
|
||
第 3 步 装控制端
|
||
把 3-watch 里的 APK 装到手表上。
|
||
|
||
第 4 步 跨网络的话，把中转地址填上
|
||
**注意：软件里没有内置任何中转地址。**
|
||
同一个 WiFi 下用不用填；跨网络的话必须填你自己第 1 步
|
||
装出来的那个地址：
|
||
电脑： ykxmz.exe --relay https://你的域名
|
||
手表： 首页点「中转设置」，填同一个地址
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、会改你系统的哪些东西
|
||
--------------------------------------------------------
|
||
|
||
安装和使用过程中，被控端会做这些改动，**请你知情**：
|
||
|
||
1. 写一条开机自启项
|
||
位置：HKEY_CURRENT_USER\...\CurrentVersion\Run
|
||
名称：ykxmz
|
||
内容："...\ykxmz.exe" --silent
|
||
|
||
2. 添加 Windows 防火墙放行规则
|
||
规则名：LAN Remote TCP / LAN Remote UDP / LAN Remote App TCP
|
||
/ LAN Remote App UDP
|
||
作用：允许 8765（TCP）和 8766（UDP）端口通信
|
||
|
||
3. 在程序目录下建一个 data 子目录
|
||
里面存：配对码、已配对设备、设置
|
||
卸载时会一并删除
|
||
|
||
4. 说明：部分功能（关机、改注册表、隐藏任务栏等）
|
||
需要管理员权限，会弹 UAC 确认，**不会**偷偷提权。
|
||
|
||
**以上全部可撤销**：卸载时自启项和防火墙规则会一起清掉。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、杀毒软件可能报警
|
||
--------------------------------------------------------
|
||
|
||
本软件没有购买代码签名证书（那是要花钱的），
|
||
加上它确实具备"远程控制 + 开机自启"这类能力，
|
||
所以**部分杀毒软件可能会报可疑**。
|
||
|
||
这是误报。你可以：
|
||
1. 在杀毒软件里把 ykxmz 整个目录加入信任/排除项；
|
||
2. 或者先看完《许可协议》，确认用途正当后再决定是否放行。
|
||
|
||
**作者不会、也没有办法让本软件绕过杀毒软件。**
|
||
如果你需要"绝对不被杀软发现"，那本软件不适合你。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、接下来看什么
|
||
--------------------------------------------------------
|
||
|
||
装完之后请看《安装后须知》（AFTER-INSTALL.txt），
|
||
里面有：怎么确认它在正常运行、怎么换配对码、
|
||
怎么彻底卸载、连不上怎么排查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.0.0
|
||
继续安装，即表示你已阅读并同意《许可协议》。
|
||
--------------------------------------------------------
|