========================================================
              ykxmz 安装后须知（后信息文件）
========================================================

软件名称：ykxmz
版本：2.0.0
作者：小麦子

装好之后看这一页：怎么确认它在跑、怎么改设置、
怎么彻底卸载、出问题怎么查。


--------------------------------------------------------
一、确认它真的在运行
--------------------------------------------------------

被控端装好后**看不到任何窗口**，这是正常的。想确认它在跑：

  方法一（最直观）
      Ctrl+Shift+Esc 打开任务管理器
      -> "详细信息"标签 -> 找 ykxmz.exe
      有，就是在跑

  方法二（看端口）
      命令行执行：  netstat -ano | findstr 8765
      有 LISTENING，就是正常

  方法三（问程序自己）
      命令行执行：  ykxmz.exe --status
      会打印：配对码、端口、中转连接状态、已配对设备数

  方法四（从手表看）
      手表上点"自动连接"，能连上就说明在跑


--------------------------------------------------------
二、常用操作
--------------------------------------------------------

重新打开设置窗口
      ykxmz.exe --setup

换一个配对码
      在设置窗口里改，或者：
      ykxmz.exe --new-code          （随机生成一个）
      换完之后，手表那边要用新码重连

看看当前状态
      ykxmz.exe --status

临时允许新设备配对（默认关着）
      ykxmz.exe --add-device 10     （开放 10 分钟）
      过了时间自动关回去

关掉/打开开机自启
      ykxmz.exe --autostart off
      ykxmz.exe --autostart on

网络自检（连不上时先跑这个）
      双击 wlzj.bat
      或  ykxmz.exe --netcheck 90

修复防火墙（要管理员）
      右键 xffhq.bat -> 以管理员身份运行
      或  ykxmz.exe --fix-firewall


--------------------------------------------------------
三、彻底卸载
--------------------------------------------------------

一条命令清干净：

      ykxmz.exe --uninstall

它会依次：
  1. 停掉正在跑的进程
  2. 删掉开机自启项
  3. 删掉数据目录（配对码、已配对手表全没了）
  4. 安排删除程序目录本身（退出后几秒自动删）

**想保留数据**（比如以后还要用，只是换个位置装）：
      先手动把 data 目录复制出来，再卸载。

**手动卸载也可以**（如果程序已经删了）：
  1. 任务管理器结束 ykxmz.exe
  2. 删除注册表项
     HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
     下的 ykxmz
  3. 删除整个程序目录
  4. （可选）删除防火墙规则：netsh advfirewall firewall
     delete rule name="LAN Remote TCP"


--------------------------------------------------------
四、连不上怎么查
--------------------------------------------------------

按顺序排查，绝大多数问题在前三步就解决了：

  第 1 步  被控端在跑吗？
           任务管理器里有没有 ykxmz.exe
           没有 -> ykxmz.exe --setup

  第 2 步  防火墙放行了吗？
           右键 xffhq.bat -> 以管理员身份运行

  第 3 步  网络通不通？
           双击 wlzj.bat 做自检
           它会生成一份《网络自检结果.txt》

  第 4 步  跨网络的话，中转通不通？
           浏览器打开  http://<随身WiFi的IP>:8080/url
           看它有没有返回公网地址

  第 5 步  手表上点"连不上？点这里诊断"

  常见现象对照：

    "连接失败，配对码错误"
        -> 手表上的码和电脑上的不一样，对一下

    "该配对码已被使用，请换一个配对码"
        -> 这个码被另一台电脑占了。换一个，
           或者去中转管理页把占用它的那台设备删掉

    "设备不在线"
        -> 电脑上的程序没跑，或者网络断了

    "连不上中转服务器"
        -> 随身 WiFi 那台机器上的中转没起来，
           或者隧道挂了。SSH 上去执行 lanremote-status 看看


--------------------------------------------------------
五、服务器端（随身 WiFi）日常维护
--------------------------------------------------------

  三个服务都是开机自启，正常情况下不用管：

      lanremote-relay           中转服务
      lanremote-tunnel          Cloudflare 隧道
      lanremote-watchdog.timer  每 30 秒检查一次隧道连接

  想一眼看清状态：
      lanremote-status

  常用命令：
      lanremote-url              打印当前公网地址
      lanremote-key              打印管理页钥匙
      systemctl restart lanremote-tunnel    手动换个地址
      journalctl -u lanremote-relay -f      看实时日志

  管理页：
      浏览器打开 <公网地址>，用管理密码登录（默认 120830）
      能看：设备列表、在线状态、配对码、流量、会话数
      能做：删除设备（连配对码一起清）、踢会话、查看当前地址

  忘了公网地址？
      打开  http://<随身WiFi的IP>:8080/url  —— 直接返回当前地址，
      不用登录。


--------------------------------------------------------
六、已知限制
--------------------------------------------------------

  1. 一条隧道同时只服务一台手表
     新连上来的会顶掉旧的，旧的那台会提示"已被另一台手表接管"。

  2. 跨网络时的延迟
     经 Cloudflare 隧道走一圈，一来一回约 0.6 秒；
     局域网直连只有几十毫秒。**程序和手表会自动判断**：
     发现两边在同一个网络就切直连，断了自动切回中转。

  3. 网络环境的影响
     如果随身 WiFi 用的 4G 卡对 UDP 有限制，隧道可能偶尔抖。
     程序里有看门狗会自动重启隧道，通常 1 分钟内恢复。

  4. 杀毒软件误报
     见《安装前必读》第六节。作者不提供绕过杀软的功能。


--------------------------------------------------------
七、出问题时怎么反馈
--------------------------------------------------------

请带上这几样，作者才能定位：

  1. ykxmz.exe --status 的输出
  2. wlzj.bat 生成的《网络自检结果.txt》
  3. 手表上的诊断结果（手表首页"连不上？点这里诊断"）
  4. 问题什么时候开始的、之前做过什么


--------------------------------------------------------
八、版本记录
--------------------------------------------------------

  2.0.0
    * 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
    * 跨网络更稳：隧道**两种协议同时跑**（QUIC + HTTP/2，
      合计 10 条连接），一种协议犯病另一种还在服务
    * 修网卡 MTU 和 QUIC 不匹配（QUIC 走 UDP，之前不受 MSS 钳制保护），
      隧道建连明显加快
    * 修偶发"已断开"误报：连续失败 3 次才判离线
    * **中转地址默认为空** —— 需要跨网络时自己填

  1.7.1
    * 跨网络支持：Cloudflare 具名隧道，固定域名
    * 中转服务器：单设备单配对码
    * 手表端：自动判断局域网/中转并无缝切换
    * 被控端：所有开关和画面功能支持回退/撤销
    * 配对码被占用时弹通知提示
    * 新增 --uninstall 一键卸载
    * 针对 512MB 内存的小机器做了优化


--------------------------------------------------------
  作者：小麦子
  软件：ykxmz 2.0.0
  许可条款见《许可协议》（LICENSE.txt）
--------------------------------------------------------
