适用范围与准备

适用于当前Mihomo版本支持provider.override.override-expr,但节点字段结果与固定override不一致,或表达式被拒绝。先保留原provider与可用输出;这是受限表达式功能,不等于在配置中运行完整yq命令。

先区分原因

官方说明表达式在固定字段覆写之后生效,数组中的表达式按顺序执行,而且每一项最终必须产生一个mapping。把筛选结果输出成多个值、删除整个对象,或粘贴yq命令行参数,都可能违反这项约定。

按顺序操作

  1. 先核对实际内核是否支持override-expr。GUI可保存YAML不代表内核识别它;不支持时恢复既有固定override,不把字段放到节点或策略组任意位置尝试。
  2. 检查固定override与表达式是否修改同一字段。记录原节点、固定覆写后预期值、表达式后预期值,按执行顺序判断;不能把后一次有意覆盖误判成订阅更新丢失设置。
  3. 从一条只改显示名称的非敏感表达式开始,在隔离provider副本中检查。不要先改认证、证书或服务器地址;节点改名也会影响按名称引用它的策略组,应使用独立测试范围。
  4. 核对表达式每一步是否仍返回一个对象。官方支持的是列出的yq风格子集,变量、递归下降、外部文件与环境访问等不在支持范围;普通yq里能运行不能证明内核里可用。
  5. 重载副本后查看实际提供的节点字段与解析日志,保留更新前后差异。若表达式过滤出零项、多项或非对象结果,先改表达式,不靠关掉校验或删除原订阅掩盖错误。
结构片段:放在一个provider内;只演示非敏感名称覆写,不是完整配置
override:
  override-expr:
    - '.name = "REVIEW_ONLY"'

怎样确认有效

验收包括内核接受表达式、结果仍为完整节点对象、目标字段符合顺序预期,以及所有引用继续有效。YAML语法检查只验证外层结构,不执行表达式;本批没有运行Mihomo表达式引擎。

无效时恢复与下一步

删除本轮测试表达式并恢复原固定覆写和节点名称,检查组引用。需要复杂变换时先确认需求能在官方子集中表达,不通过从网络粘贴未知脚本扩展能力。本篇未对真实订阅作转换。