Списки и правила

Эта страница посвящена модификаторам списков. Во всех примерах предполагается, что соответствующие поля уже существуют в исходной конфигурации.

ДЕРЖАТЬ_0

Вставьте элемент массива в начало исходного списка.

插入列表开头.yaml

rules-start:
  - DOMAIN-SUFFIX,first.example,DIRECT

key-start 结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,first.example,DIRECT
  - DOMAIN-SUFFIX,old.example,DIRECT
  - MATCH,PROXY

Неправильное или недопустимое использование:

key-start 无效类型.yaml

mixed-port-start: 7890
dns-start:
  enable: true

Эти два элемента не сообщают об ошибке, но mixed-port является скаляром, а dns — объектом, поэтому вставка списка не произойдет.

ДЕРЖАТЬ_18

Добавляет элементы массива в конец исходного списка. Для rules раздел терминала MATCH в исходной конфигурации останется после нового содержимого; внутренний порядок нового контента остается неизменным.

追加列表末尾.yaml

rules-end:
  - DOMAIN-SUFFIX,last.example,DIRECT

key-end 结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,old.example,DIRECT
  - DOMAIN-SUFFIX,last.example,DIRECT
  - MATCH,PROXY

Неправильное или недопустимое использование:

key-end 无效类型.yaml

mode-end: global

mode является скаляром, mode-end не преобразует его в список и не переопределяет mode.

ДЕРЖАТЬ_37

key-merge дает разные результаты для разных типов полей:

Тип поля	Результат
Обычный список	Добавить элементы массива.
Список именованных объектов	Нажмите `name` после добавления, чтобы удалить дубликаты.
`rules`	После добавления поместите `MATCH` обратно в конец.
Сопоставление объектов	Рекурсивное сопоставление слияний.
Обычные предметы	Вложенные модификаторы, объединенные литеральными ключами, больше не анализируются.
Скаляр	Игнорируется.

Добавление списка

key-merge 列表.yaml

rules-merge:
  - DOMAIN-SUFFIX,merge.example,DIRECT

key-merge 列表结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,old.example,DIRECT
  - DOMAIN-SUFFIX,merge.example,DIRECT
  - MATCH,PROXY

Объединение карт

key-merge 映射.yaml

proxy-providers-merge:
  extra:
    type: file
    path: extra.yaml

key-merge 映射结果 diff.yaml

proxy-providers:
  base:
    type: http
  extra: 
    type: file
    path: extra.yaml

Неправильное или недопустимое использование:

key-merge 标量.yaml

mixed-port-merge:
  value: 7890

mixed-port — скаляр, key-merge будет игнорироваться, а порт не будет преобразован в объект.

`key-force`

key-force напрямую заменяет все поле и пропускает обработку типа поля. Он подходит для очистки исходного списка, замены всего объекта или перезаписи неизвестных структур.

key-force 列表.yaml

rules-force:
  - DOMAIN-SUFFIX,new.example,DIRECT
  - MATCH,PROXY

key-force 结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,old.example,DIRECT
  - MATCH,OLD
  - DOMAIN-SUFFIX,new.example,DIRECT
  - MATCH,PROXY

Когда с одним и тем же базовым ключом одновременно выполняется несколько операций, приоритет имеет force:

force 优先.yaml

rules-start:
  - DOMAIN-SUFFIX,ignored.example,DIRECT

rules-force:
  - MATCH,PROXY

В конце концов останется только MATCH,PROXY, и rules-start не будет продолжать выполняться.

Аббревиатура

Эти два метода записи являются сокращением операций со списками:

Аббревиатура	Эквивалентное написание	Результат
`+key`	`key-start`	Вставьте начало.
`key+`	`key-end`	Дописать в конец.

列表简写.yaml

+rules:
  - DOMAIN-SUFFIX,first.example,DIRECT

rules+:
  - DOMAIN-SUFFIX,last.example,DIRECT

列表简写结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,first.example,DIRECT
  - DOMAIN-SUFFIX,old.example,DIRECT
  - DOMAIN-SUFFIX,last.example,DIRECT
  - MATCH,PROXY

Неправильное или недопустимое использование:

简写用于标量.yaml

+mode: rule
mode+:
  - global

+mode и mode+ будут распознаваться только как операции со списком, скаляр mode не будет изменен.

`null` элемент списка

Значением модификатора списка может быть одно значение, массив или null:

ценность	результат
Массив	Развернуть список на несколько элементов.
Один скаляр или объект	как элемент списка.
`null`	Не генерирует элементы списка.

null 列表项.yaml

rules-end: null

rules-start:
  - DOMAIN-SUFFIX,example.com,DIRECT

В конечном итоге будет вставлено только DOMAIN-SUFFIX,example.com,DIRECT.

Последовательность нескольких операций

В одном файле YAML можно одновременно использовать несколько операций. Порядок полей списка следующий:

多个列表操作.yaml

rules:
  - MATCH,REPLACED

+rules:
  - DOMAIN-SUFFIX,plus-start.example,DIRECT

rules-start:
  - DOMAIN-SUFFIX,start.example,DIRECT

rules-merge:
  - DOMAIN-SUFFIX,merge.example,DIRECT

rules+:
  - DOMAIN-SUFFIX,plus-end.example,DIRECT

rules-end:
  - DOMAIN-SUFFIX,end.example,DIRECT

多个列表操作结果 diff.yaml

rules:
  - DOMAIN-SUFFIX,plus-start.example,DIRECT
  - DOMAIN-SUFFIX,start.example,DIRECT
  - DOMAIN-SUFFIX,merge.example,DIRECT
  - DOMAIN-SUFFIX,plus-end.example,DIRECT
  - DOMAIN-SUFFIX,end.example,DIRECT
  - MATCH,REPLACED

Если для того же базового ключа существует key-force, все вышеперечисленные операции будут пропущены.

`MATCH` Правила

В качестве правил терминала будут распознаваться только строки в исходном списке, первый сегмент которых разделен запятыми — MATCH (без учета регистра). Объекты, числа и другие правила не вызывают движения; правила, добавленные путем перезаписи файлов, не будут сканироваться повторно.

终端规则判断.yaml

rules-end:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,PROXY
  - match,FINAL

YumeBox начнет с первой распознанной позиции в исходном списке и сохранит последующий контент как сегмент правила терминала в конце.

Начало

Руководства

Переопределения

Другое

Списки и правила

ДЕРЖАТЬ_0

ДЕРЖАТЬ_18

ДЕРЖАТЬ_37

Добавление списка

Объединение карт

`key-force`

Аббревиатура

`null` элемент списка

Последовательность нескольких операций

`MATCH` Правила

​ДЕРЖАТЬ_0

​ДЕРЖАТЬ_18

​ДЕРЖАТЬ_37

​Добавление списка

​Объединение карт

​key-force

​Аббревиатура

​null элемент списка

​Последовательность нескольких операций

​MATCH Правила

ДЕРЖАТЬ_0

ДЕРЖАТЬ_18

ДЕРЖАТЬ_37

Добавление списка

Объединение карт

`key-force`

Аббревиатура

`null` элемент списка

Последовательность нескольких операций

`MATCH` Правила