Repository navigation
v4.8.1
用户实测:同机场两条订阅只有一条有某个分组,覆写补丁把另一条的配置搞成内核拒绝加载。新增 ~?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 避险」,但那是让用户改作用域去绕开语法缺陷,方向不对