Skip to content

v4.8.1

Choose a tag to compare

@adaex adaex released this 12 Sep 03:36
· 270 commits to main since this release
v4.8.1
d8e7949

用户实测:同机场两条订阅只有一条有某个分组,覆写补丁把另一条的配置搞成内核拒绝加载。新增 ~?key 表达「只改已有、不新增」,并补上「报错指不出覆写」的可诊断性缺口。单测 340(+15)。

新增

  • ~?key:按 name 就地合并,匹配不到同名元素就跳过。~key 的「未命中则追加」是有意设计,ssh 出口那类用法靠它新增节点,不能改;但同一个语法还承担着另一种意图——「订阅下发了这个分组我才改它」,补丁往往只带 name 和一两个要改的字段。这两种意图方向相反,此前挤在一个操作符里。

    实测现场:同一机场的两条订阅 URL 同域名,覆写按 url-domain 对两条都生效,其中精简套餐没有 Developer 分组,于是 ~proxy-groups: [{name: Developer, default-selected: TW Fixed IP}] 被追加成一个只有 name 和 default-selected、缺 type 的分组,mihomo 报 ProxyGroup Developer: '' has unset fields: type 并拒绝加载整份配置——切到这条订阅就再也起不来。

    改用 ~?proxy-groups 后,作用域一个字不用改:有该分组的订阅照常合并,没有的自动跳过。被跳过时打印一行提示(「已跳过」+ 补丁名 + 来源文件),因为静默跳过与「分组名拼错」在用户眼里完全一样。解析放在剥掉 ~ 之后判断,真以 ? 开头的键名仍可用 <~?key> 转义。

    为什么不改 ~key 自身的行为:README 明确承诺「找不到则追加」,ssh 出口章节的 ~proxies 示例依赖它,三条既有测试锁着它。也不按「补丁是否带 type」自动推断意图——那是猜,而分组必填字段随内核版本漂移,猜错的方向是静默丢掉用户的配置。让用户显式表达意图更可靠。

修复

  • 内核报错指不出「这个键是覆写加进来的」:用户能看到的只有 ProxyGroup Developer: '' has unset fields: type 这一行,看不出这个分组是覆写追加的。现在校验失败时附上本次实际生效的覆写文件与作用域(已按 ow 开关与 match 过滤),并提示可改用 ~?key。清单为空时不加该段(问题就在订阅本身,多打一段只会把方向引偏);超时分支同样不加(与配置内容无关)。

    教训:这类问题的本质是错误信息缺少产生它的上下文,而不是校验不够严——继续在 CLI 里加字段校验只会与内核重复一份必然漂移的规则,把上下文补回去、再给用户一个表达意图的语法,才是对的方向。

  • doctor 把失败项的 hint 整个丢掉:cmdDoctor 只取 message.split('\n')[0],于是配置校验失败时连内核原文都不显示,只剩一句「内核拒绝加载配置」。Check 加 notes 字段透传 CliError.hint,否则上面那条改进在 doctor 里完全不可见。

测试

  • ~?key 四条行为用例:命中时与 ~key 一致、未命中跳过且记录、目标键整体不存在时也跳过(不凭空造数组)、~key 未命中仍追加(锁住 ssh 场景不受影响);另加 <~?key> 转义与解析用例
  • 端到端两条走 buildConfig:未命中时订阅原有分组不受影响且 warnings 含补丁名与来源文件、命中时正常合并且不告警
  • 反向验证过:把 ~? 的跳过分支短路成「照常追加」,精确只有三条 ~? 用例失败,~key 的既有语义(含 ssh 追加)全部照过
  • 文案收口成纯函数 buildKernelRejectHint 后逐行锁定(目标形态、空清单不加该段、多行内核输出的缩进、覆写摘要经终端消毒)
  • buildConfig 带出的覆写清单按作用域过滤:把真实事故现场(同域名两条订阅 + url-domain 限定)写成回归用例
  • 用户真实数据实测:overwrite.glados.yaml 保持 url-domain 作用域不变、仅把 ~ 换成 ~?,mini1 通过内核校验且不含残缺分组,edu1 的 default-selected: TW Fixed IP 照常注入

变更

  • README 的覆写示例改用 ~?proxy-groups 并保留 url-domain 作用域:此前建议「收窄 match 避险」,但那是让用户改作用域去绕开语法缺陷,方向不对