2.0.0:安装时可设中转服务器 + 手表端新增设置页 + 中转默认留空

按用户定的版本规矩,这一轮既有新内容又有重构,所以升第二位:
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 个阶段全部通过。
This commit is contained in:
xmz7891
2026-10-07 23:02:44 +08:00
parent d2243cec64
commit 4295b482a1
175 changed files with 1287 additions and 56 deletions
+45 -7
View File
@@ -70,6 +70,8 @@ def parse_args(argv=None):
help="网络自检(自开控制台,不需要装 Python)")
parser.add_argument("--fix-firewall", action="store_true",
help="提权修复防火墙")
parser.add_argument("--relay-url", default=None, metavar="地址",
help="只把中转地址写进配置,不连接、不退出(安装包用)")
parser.add_argument("--relay", default=None, metavar="地址",
help="设置中转服务器地址(跨网络用)。"
"可用分号分隔多个,按顺序尝试,例如:"
@@ -274,19 +276,39 @@ def cli_fix_firewall() -> int:
return 0 if ok else 1
def normalize_relay_url(raw: str) -> str:
"""把用户填的中转地址规范化。
规则(和安装向导、设置窗口保持**完全一致**):
* 去掉首尾空白
* 没有 http:// / https:// 就补 https://
(用户基本只会填个域名,逼他打协议头没意义)
* 去掉末尾斜杠(拼接 "/v1/health" 时不会变成双斜杠)
* 空字符串 = 关掉中转,只走局域网
⚠ 为什么抽成函数:原来这段逻辑散在 cli_relay 里,安装向导
再写一份就容易两边不一致。现在统一走这里。
"""
url = (raw or "").strip()
if not url:
return ""
# 先去掉末尾斜杠,再补协议头(顺序反了会把 "https://" 的斜杠也削掉)
url = url.rstrip("/")
if not url.startswith(("http://", "https://")):
url = "https://" + url
return url
def cli_relay(url: str) -> int:
"""设置中转地址。传空字符串就关掉。"""
store = Store(data_dir())
url = (url or "").strip().rstrip("/")
url = normalize_relay_url(url)
store.set("relay_url", url)
attach_console()
if not url:
print("已关闭中转(以后只在局域网内可用)")
wait_key()
return 0
if not url.startswith(("http://", "https://")):
url = "https://" + url
store.set("relay_url", url)
print(f"中转地址已设为:{url}")
print()
print("正在测试能不能连上…")
@@ -782,14 +804,30 @@ def main(argv=None) -> int:
args = parse_args(argv)
# --code / --name 要**最先**处理 —— 它们会改配置,
# --code / --name / --relay-url 要**最先**处理 —— 它们会改配置,
# 而 --status / --autostart 这些是"看一眼就退出"的命令。
# 安装包的调用链是:
# ykxmz.exe --code 789113 --name 三年二班 --autostart on --silent
# ykxmz.exe --code 789113 --name 三年二班 --relay-url https://... --autostart on --silent
# 如果先把 --autostart 处理掉就 return 了,配对码根本写不进去。
if args.code is not None or args.name:
if (args.code is not None or args.name
or args.relay_url is not None):
store = Store(data_dir())
wrote = False
# ---- 中转服务器(安装向导那一页填的)----
# ⚠ 和 --relay 的区别很重要:
# --relay 连接一次、打印状态、然后 return
# (人工排查用,**不能**和 --code 连用,
# 因为它会提前退出,后面的 --silent 就不跑了)
# --relay-url 只写进配置,不连接、不退出
# (安装包用:要和 --code/--autostart/--silent
# 串在一条命令里跑完)
if args.relay_url is not None:
url = normalize_relay_url(str(args.relay_url))
store.set("relay_url", url)
print(f"中转服务器已设为 {url or '(空 —— 只走局域网,不跨网络)'}")
wrote = True
if args.code is not None:
digits = "".join(ch for ch in str(args.code) if ch.isdigit())
if len(digits) != 6: